Atendimento

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-8d6a0e4c7b21

O 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

StatusSignificado
PENDENTEGravada, aguardando transmissão
PROCESSANDOEm transmissão
AUTORIZADAAutorizada: XML e PDF disponíveis
REJEITADARecusada pela autoridade fiscal; motivo em erros. Corrija e emita de novo, com outra Idempotency-Key.
DENEGADADenegada pela SEFAZ (situação irregular do emitente ou destinatário). NF-e e NFC-e.
CONTINGENCIANFC-e emitida offline; segue para AUTORIZADA ou REJEITADA (NFC-e)
CANCELADACancelada depois de autorizada
SUBSTITUIDANFS-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 POST a cada mudança de status de qualquer nota. Veja Webhooks.
  • Polling: GET no Location. 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.

Nesta página