[{"data":1,"prerenderedAt":76},["ShallowReactive",2],{"i-mdi:magnify":3,"i-mdi:open-in-new":8,"i-mdi:menu":10,"i-mdi:download-outline":12,"i-mdi:phone":14,"guia-perguntas-frequentes":16,"i-mdi:chevron-right":66,"i-mdi:plus":68,"i-mdi:arrow-left":70,"i-mdi:arrow-right":72,"i-mdi:text-box-outline":74},{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":7},0,24,false,"\u003Cpath fill=\"currentColor\" d=\"M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5l-1.5 1.5l-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16A6.5 6.5 0 0 1 3 9.5A6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14S14 12 14 9.5S12 5 9.5 5\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":9},"\u003Cpath fill=\"currentColor\" d=\"M14 3v2h3.59l-9.83 9.83l1.41 1.41L19 6.41V10h2V3m-2 16H5V5h7V3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7h-2z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":11},"\u003Cpath fill=\"currentColor\" d=\"M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":13},"\u003Cpath fill=\"currentColor\" d=\"M13 5v6h1.17L12 13.17L9.83 11H11V5zm2-2H9v6H5l7 7l7-7h-4zm4 15H5v2h14z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":15},"\u003Cpath fill=\"currentColor\" d=\"M6.62 10.79c1.44 2.83 3.76 5.15 6.59 6.59l2.2-2.2c.28-.28.67-.36 1.02-.25c1.12.37 2.32.57 3.57.57a1 1 0 0 1 1 1V20a1 1 0 0 1-1 1A17 17 0 0 1 3 4a1 1 0 0 1 1-1h3.5a1 1 0 0 1 1 1c0 1.25.2 2.45.57 3.57c.11.35.03.74-.25 1.02z\"\u002F>",[17,30,39,45,54],{"type":18,"title":19,"items":20},"faq","Acesso e token",[21,24,27],{"question":22,"answer":23},"Existe ambiente de homologação para testes?","Não. Todas as chamadas vão para produção e trabalham com os dados reais do grupo. Os recursos da API são consultas e não alteram dados. Veja \u003Ca href=\"\u002Fapi\u002F#ambiente\">Ambiente\u003C\u002Fa>.",{"question":25,"answer":26},"Recebo 401 mesmo com um token que acabei de gerar. Por quê?","Confira se o header \u003Ccode>Authorization\u003C\u002Fcode> leva só o token, \u003Cstrong>sem o prefixo \u003Ccode>Bearer\u003C\u002Fcode>\u003C\u002Fstrong>. Com \u003Ccode>Bearer\u003C\u002Fcode>, a chamada é recusada. Se o \u003Ccode>401\u003C\u002Fcode> vier sem corpo, nenhuma empresa da integração tem a API de Integração no contrato, ou o token não é de uma integração. Veja \u003Ca href=\"\u002Fapi\u002Fautenticacao\u002F#erros-comuns\">Erros comuns\u003C\u002Fa> e, se precisar, \u003Ca href=\"#como-peco-ajuda-ao-suporte\">fale com o suporte\u003C\u002Fa>.",{"question":28,"answer":29},"Quanto tempo o token dura?","24 horas. O campo \u003Ccode>expires_in\u003C\u002Fcode> vem \u003Cstrong>em minutos\u003C\u002Fstrong> (\u003Ccode>1440\u003C\u002Fcode>), não em segundos. Não há \u003Cem>refresh token\u003C\u002Fem>: quando o token expirar, gere outro com a mesma chave. Veja \u003Ca href=\"\u002Fapi\u002Fautenticacao\u002F#renovar-o-token\">Renovar o token\u003C\u002Fa>.",{"type":18,"title":31,"items":32},"Empresas",[33,36],{"question":34,"answer":35},"Quais empresas a integração acessa?","As que o administrador escolheu ao criar a integração. Se ele não escolheu nenhuma, a integração acessa todas as empresas do grupo com contrato ativo. Em qualquer caso, a empresa precisa ter a API de Integração no contrato. Para ver a lista, use \u003Ca href=\"\u002Fapi\u002Freferencia\u002Fget-v1-empresa\u002F\">GET \u002Fv1\u002Fempresa\u003C\u002Fa>.",{"question":37,"answer":38},"Uma empresa foi liberada para a integração, mas não aparece. O que fazer?","Gere um token novo. O token guarda as empresas liberadas no momento em que foi gerado, inclusive quando a integração foi criada sem empresas escolhidas. O mesmo vale ao contrário: uma empresa removida da integração continua acessível pelos tokens gerados antes, até eles expirarem. Se a empresa não aparecer nem com um token novo, confira com o administrador se ela tem a API de Integração no contrato.",{"type":18,"title":40,"items":41},"Limites",[42],{"question":43,"answer":44},"Quantas requisições posso fazer?","Até 100 de uma vez e, depois, cerca de 100 por minuto (5 a cada 3 segundos), somando todas as integrações do grupo. Quando o limite é atingido, a API responde \u003Ccode>429\u003C\u002Fcode> com o header \u003Ccode>Retry-After\u003C\u002Fcode>, que diz quantos segundos esperar. Veja \u003Ca href=\"\u002Fapi\u002Ferros-e-limites\u002F#limite-de-requisicoes\">Limite de requisições\u003C\u002Fa>.",{"type":18,"title":46,"items":47},"Webhooks",[48,51],{"question":49,"answer":50},"Recebi o mesmo aviso de webhook duas vezes. É erro?","Não. Avisos podem chegar repetidos por causa das novas tentativas de entrega. Use \u003Ccode>evento\u003C\u002Fcode> + \u003Ccode>id\u003C\u002Fcode> para reconhecer um aviso que você já processou. Veja \u003Ca href=\"\u002Fapi\u002Fwebhooks\u002F#boas-praticas\">Boas práticas\u003C\u002Fa>.",{"question":52,"answer":53},"Recebi o webhook, mas a consulta do pedido responde \"Pedido não está aberto\". Por quê?","O orçamento foi faturado ou cancelado depois do aviso e saiu da situação de pedido em aberto. A consulta de pedido em aberto só devolve pedidos que ainda não foram faturados nem cancelados.",{"type":18,"title":55,"items":56},"Testes e suporte",[57,60,63],{"question":58,"answer":59},"Como testo sem escrever código?","Gere um token com o exemplo em curl de \u003Ca href=\"\u002Fapi\u002Fautenticacao\u002F#gerar-o-token\">Gerar o token\u003C\u002Fa>. Depois, abra o endpoint em \u003Ca href=\"\u002Fapi\u002Freferencia\u002F\">Endpoints\u003C\u002Fa> e clique em \u003Cstrong>Testar\u003C\u002Fstrong>: na primeira vez, o teste pede o token. Ele fica só naquela aba, em memória, e vale para todos os endpoints. Você também pode importar a especificação \u003Ca href=\"https:\u002F\u002Fvendasimples.com.br\u002Fajuda\u002Fapi\u002Fopenapi.json\">openapi.json\u003C\u002Fa> no Postman ou no Insomnia. Os testes são chamadas reais em produção e gastam fichas do \u003Ca href=\"\u002Fapi\u002Ferros-e-limites\u002F#limite-de-requisicoes\">limite de requisições\u003C\u002Fa> do grupo.",{"question":61,"answer":62},"Posso chamar a API direto do navegador?","O CORS da API permite, mas a chave de integração nunca pode ir para o navegador: qualquer pessoa com acesso à página consegue lê-la. Gere o token no seu servidor. Lembre que o token também dá acesso aos dados do grupo enquanto vale, por até 24 horas. No navegador, o seu código não consegue ler o header \u003Ccode>Retry-After\u003C\u002Fcode> do \u003Ccode>429\u003C\u002Fcode>: use os segundos da mensagem do erro.",{"question":64,"answer":65},"Como peço ajuda ao suporte?","Ligue para o suporte no \u003Ca href=\"tel:+551434133244\">\u003Cstrong>(14) 3413-3244\u003C\u002Fstrong>\u003C\u002Fa>. Informe o código de resposta, o horário da chamada e o \u003Ccode>sessionGuid\u003C\u002Fcode> que veio no erro, quando houver.",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":67},"\u003Cpath fill=\"currentColor\" d=\"M8.59 16.58L13.17 12L8.59 7.41L10 6l6 6l-6 6z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":69},"\u003Cpath fill=\"currentColor\" d=\"M19 13h-6v6h-2v-6H5v-2h6V5h2v6h6z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":71},"\u003Cpath fill=\"currentColor\" d=\"M20 11v2H8l5.5 5.5l-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5L8 11z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":73},"\u003Cpath fill=\"currentColor\" d=\"M4 11v2h12l-5.5 5.5l1.42 1.42L19.84 12l-7.92-7.92L10.5 5.5L16 11z\"\u002F>",{"left":4,"top":4,"width":5,"height":5,"rotate":4,"vFlip":6,"hFlip":6,"body":75},"\u003Cpath fill=\"currentColor\" d=\"M5 3c-1.11 0-2 .89-2 2v14c0 1.11.89 2 2 2h14c1.11 0 2-.89 2-2V5c0-1.11-.89-2-2-2zm0 2h14v14H5zm2 2v2h10V7zm0 4v2h10v-2zm0 4v2h7v-2z\"\u002F>",1793977941838]