01 · Consulta sob demanda
Status real da NF-e em segundos
Antes de antecipar, valide se a NF-e existe e está autorizada. A consulta vai direto à SEFAZ e devolve o status atual da nota — não cache, não snapshot. Ideal pra due diligence pontual em cima da mesa de operação.
- UF instável tem fallback automático para a contingência da SEFAZ (SVC-AN/SVC-RS)
- Retorna status (AUTORIZADA, CANCELADA ou INEXISTENTE), código e mensagem da SEFAZ e eventos da nota
- POST /v1/consulta com chave de acesso → JSON estruturado
- Histórico de toda consulta fica auditável por 24 meses
$ curl -X POST /v1/consulta \
-d '{ "chave": "35240300..." }'
// resposta em 1.2s
{
"status": "AUTORIZADA",
"valor": 14759.00,
"emitente": "00000000000000",
"data_autoriz": "2026-04-15T09:42:00Z",
"uf": "SP"
}