Contingência SEFAZ

Quando a SEFAZ principal está indisponível, a API aciona automaticamente o sistema de contingência.

Como funciona

1. API detecta timeout ou erro 5xx na SEFAZ da UF
2. Consulta GET /sefaz/status/{uf} para confirmar
3. Se offline, muda automaticamente para SVC-AN (Serviço Virtual de Contingência - Ambiente Nacional) ou SVRS (São Paulo/Sul)
4. Continua emitindo sem interrupção
5. Quando SEFAZ principal volta, retoma o uso normal

NFC-e offline

NFC-e tem um modo especial de contingência totalmente offline:

1. Cliente paga no PDV
2. API monta XML com tpEmis=9 (contingência offline)
3. Gera DANFE-NFC-e e imprime para o consumidor (recibo válido)
4. Armazena XML em fila local (nfce_contingencia_fila)
5. Quando SEFAZ volta, worker envia em lote

Isso garante zero downtime no caixa, mesmo com SEFAZ caída por dias.

Monitoramento

curl https://api.nferapido.com.br/api/v1/sefaz/status/SP

{
  "uf": "SP",
  "status": "operacional",
  "tempo_resposta_ms": 1250,
  "contingencia_ativa": false,
  "autorizador_atual": "SP"
}