01 · Consulta sob demanda
Status real da NF-e em ~2 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.
- Resposta em até 2s contra a SEFAZ (mediana ~1.2s)
- 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": "35240314..." }'
// resposta em 1.2s
{
"status": "AUTORIZADA",
"valor": 14759.00,
"emitente": "14201789000191",
"data_autoriz": "2026-04-15T09:42:00Z",
"uf": "SP"
}