Contingência
Quando um autorizador fica lento ou cai, a MadNotas decide sozinha entre esperar, tentar de novo ou emitir em contingência. O seu sistema só precisa tratar os estados da nota e os webhooks.
Primeiro: nunca duplicar
Se o envio não teve resposta, a MadNotas consulta a chave na SEFAZ antes de reenviar. Se a nota já tinha sido autorizada, ela anexa o protocolo existente. Por isso uma queda de rede no meio do envio não gera nota em dobro nem rejeição por duplicidade.
Novas tentativas
Erros temporários (serviço paralisado, sobrecarga, rede) levam a novas tentativas com intervalo crescente, de 5 segundos até 30 minutos. Durante esse tempo a nota fica em processando.
NF-e: SVC
Com o autorizador da UF fora do ar e a contingência automática ligada no emitente, a NF-e é transmitida pelo SEFAZ Virtual de Contingência da UF — SVC-AN ou SVC-RS. A nota sai autorizada normalmente, com o tipo de emissão de contingência registrado no XML, e chega o webhook nfe.contingencia.
NFC-e: offline
A NFC-e não tem SVC. Ela é emitida offline: assinada, impressa e entregue ao consumidor no estado contingencia. Quando a SEFAZ responde, a MadNotas transmite e a nota vira autorizada (ou rejeitada, com webhook), dentro do prazo legal de transmissão.
Como aparece para você
| Situação | Status da nota | Webhook |
|---|---|---|
| SEFAZ lenta, ainda dentro do tempo | processando | — |
| NF-e enviada pelo SVC | autorizada | nfe.contingencia e nfe.autorizada |
| NFC-e offline | contingencia | nfce.contingencia |
| NFC-e offline transmitida | autorizada ou rejeitada | nfce.autorizada ou nfce.rejeitada |
| Autorizador muda de situação | — | sefaz.status_alterado |
Configuração
A contingência automática é uma opção de cada emitente, no painel ou pela API. Desligada, a nota fica em processando até a SEFAZ voltar. A situação de cada autorizador aparece em Status.
Para testar sem esperar uma queda real, use SIM-OFFLINE ou derrube uma SEFAZ simulada com POST /simulacao/sefaz (Simulação). Com o cabeçalho MadNotas-Simular-Atraso você escolhe em quantos segundos a nota offline é transmitida: veja o teste rápido.