01 · Consulta sob demanda
Status real da NF-e em 1-3 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.
- Mediana ~1.2s em UF saudável; UF instável tem fallback automático SVC-AN/SVC-RS
- Retorna status (AUTORIZADA, CANCELADA, DENEGADA ou INEXISTENTE), valor, emitente e data de autorização
- 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"
}