Consultando uma emissão de NFC-e

Pelo job_id

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

A resposta traz os dois eixos de estado — o do processamento e o fiscal. Ver Status das emissões.

Esta consulta não consome cota

Ela lê o que já guardamos, não vai à SEFAZ. Pode consultar à vontade enquanto espera o resultado.

Em lote

A rota de lote é a mesma para todos os documentos — até 200 ids por chamada:

POST /v1/jobs/consultar-lote

{ "job_ids": ["6f8dc295-...", "8881bac5-..."] }

Id inexistente ou de outra conta volta como "status": "nao_encontrado" — sem 404, e sem vazar a existência de dados de terceiros.

Quando o job_id se perdeu

GET /v1/jobs/localizar?ref=pedido_98231

Também aceita período, CNPJ do emitente, documento do destinatário e valor. É o caminho de reconciliação quando a sua aplicação perdeu o job_id — ver Referência externa.

O caixa não pode esperar a consulta

NFC-e é venda no balcão, e isso muda o desenho

Na NF-e o cliente costuma tolerar alguns segundos até a autorização. No PDV, não: alguém está na fila.

A emissão devolve 202 na hora, e a autorização vem depois. Duas saídas, e a escolha é sua:

• webhook — o Conota chama o seu sistema quando termina, e o cupom sai sozinho. É o caminho que não faz o caixa esperar por polling. Ver Webhooks;
• contingência offline — quando a SEFAZ está indisponível, a legislação prevê emissão em contingência. Isso é decisão da sua operação, não da API.

Se você fizer polling, faça com intervalo — consultar em laço apertado não acelera a SEFAZ.

Consultar não é o mesmo que ter o cupom

Depois de autorizada, o cupom e o XML saem por Arquivos. A consulta diz se a nota valeu; os arquivos são o documento.