Contingência & Resiliência Fiscal

Instabilidades nos servidores das Secretarias de Fazenda estaduais (SEFAZ) são comuns no dia a dia tributário brasileiro. A Nota Fiscal API possui mecanismos inteligentes de tolerância a falhas para garantir que o seu faturamento nunca pare.

---

Modos de Contingência Suportados

1. SVC (SEFAZ Virtual de Contingência)

Quando o autorizador do estado emissor fica fora do ar por períodos prolongados, o sistema ativa a transmissão para os servidores virtuais:

• SVC-AN (Ambiente Nacional da RFB): Atende estados conveniados como SP, MG, RJ, RS, etc.
• SVC-RS (SEFAZ Virtual do Rio Grande do Sul): Atende estados conveniados sob a sua jurisdição técnica.

2. Contingência Offline da NFC-e

Para PDVs e frentes de caixa em que a internet cai ou a SEFAZ não responde em menos de 3 segundos:

• A NFC-e é gerada em modo offline (tpEmis = 9).
• O DANFE simplificado com indicação de contingência é impresso imediatamente para o cliente.
• O XML é armazenado em fila persistente para sincronização automática com a SEFAZ assim que a conexão for reestabelecida.

---

Verificação de Status SEFAZ

Você pode verificar a saúde dos servidores da SEFAZ em tempo real pelo endpoint:

curl --request GET \
  --url http://localhost:3333/v1/status/sefaz?uf=SP \
  --header 'x-api-key: fylee_live_...'

Resposta

{
  "uf": "SP",
  "status": "OPERACIONAL",
  "tempoRespostaMs": 320,
  "autorizador": "SEFAZ-SP",
  "contingenciaAtiva": false
}