Ciclo de status
Emissão assíncrona, status das notas e como acompanhá-los.
A emissão é assíncrona: o POST grava a nota, responde na hora e a transmissão à SEFAZ ou à Sefin Nacional
acontece em segundo plano. Assim, uma autoridade fiscal lenta ou fora do ar não trava o seu sistema.
POST /api/v1/nfe
HTTP/1.1 202 Accepted
Location: /api/v1/nfe/0b8e1c2a-7f3d-4c1e-9b2f-8d6a0e4c7b21O corpo do 202 já é a nota, em PENDENTE. Na NF-e e na NFC-e ela já vem com a chaveAcesso (e, na NFC-e, o
qrCode).
Status
| Status | Significado |
|---|---|
PENDENTE | Gravada, aguardando transmissão |
PROCESSANDO | Em transmissão |
AUTORIZADA | Autorizada: XML e PDF disponíveis |
REJEITADA | Recusada pela autoridade fiscal; motivo em erros. Corrija e emita de novo, com outra Idempotency-Key. |
DENEGADA | Denegada pela SEFAZ (situação irregular do emitente ou destinatário). NF-e e NFC-e. |
CONTINGENCIA | NFC-e emitida offline; segue para AUTORIZADA ou REJEITADA (NFC-e) |
CANCELADA | Cancelada depois de autorizada |
SUBSTITUIDA | NFS-e substituída por outra (NFS-e) |
PENDENTE → PROCESSANDO → AUTORIZADA → CANCELADA
↘ REJEITADA ↘ SUBSTITUIDA (NFS-e)
↘ DENEGADA
↘ CONTINGENCIA → AUTORIZADA | REJEITADA (NFC-e)Como acompanhar
- Webhook (recomendado): a sua conta recebe um
POSTa cada mudança de status de qualquer nota. Veja Webhooks. - Polling:
GETnoLocation. Consulte com intervalo (por exemplo, a cada 2 a 5 segundos) e pare num status final.
Resposta perdida
Se a transmissão ficou sem retorno (timeout da autoridade fiscal) ou se a nota foi cancelada fora da API,
POST /{nfse|nfe|nfce}/{id}/sincronizar reconsulta a situação oficial e atualiza a nota. Antes de reenviar, o
servidor sempre consulta pela chave ou pelo número, para nunca autorizar a mesma nota duas vezes.