Sua primeira requisição

Antes de emitir um documento fiscal, faça uma chamada simples para confirmar três coisas:

1. seu sistema alcança a API;
2. a API Key está sendo enviada corretamente;
3. sua aplicação consegue interpretar a resposta.

Uma consulta de leitura é a melhor escolha para esse primeiro teste.

Listar as empresas da conta

curl -s https://api.conota.dev/v1/empresas \
  -H "X-API-Key: $CONOTA_API_KEY"

Se voltar uma lista (mesmo vazia), autenticação e conectividade estão corretas.

Consultar um CNPJ

curl -s https://api.conota.dev/v1/cnpj/11222333000181 \
  -H "X-API-Key: $CONOTA_API_KEY"

Aceita CNPJ alfanumérico.

Na URL, mande sem a barra

A barra da máscara do CNPJ (00.000.000/0001-91) é separador de caminho: a URL vira /v1/cnpj/00.000.000/0001-91 e a rota não é encontrada — você recebe 404.

Em parâmetro de caminho, envie só os dígitos. Em query string e no corpo da requisição, a máscara completa funciona normalmente.

Se preferir clicar antes de codar

Abra o Swagger UI, clique em Authorize, cole a chave e execute o endpoint. É a forma mais rápida de ver a resposta real antes de escrever código.

Depois que funcionar

Não copie a requisição do Swagger direto para produção. Implemente no backend e configure:

• timeout;
• logs sem expor segredos;
• tratamento por código HTTP;
• retentativa apenas para falhas que realmente podem ser repetidas;
• correlação entre a operação do seu sistema e a operação criada no Conota.

Nem toda falha pode ser repetida

Repetir uma consulta é inofensivo. Repetir uma emissão não é. Ver Referência externa e idempotência.