Por que monitorar as interfaces da SEFAZ
Os 27 estados + o Distrito Federal do Brasil mantêm, cada um, sua própria interface de NF-e. A diferença de estabilidade é enorme:
- Estados grandes como São Paulo (SP) e Minas Gerais (MG) são relativamente estáveis (disponibilidade acima de 99%)
- Rio de Janeiro (RJ), Bahia (BA), entre outros, têm falhas ocasionais (cerca de 98%)
- Estados menores do Norte / Nordeste (AC, RR, AP, TO) oscilam mais (abaixo de 97%)
- Janelas mensais de manutenção de rotina, manutenções estendidas em feriados e falhas inesperadas
Quando você emite por conta própria, a primeira reação diante de uma falha costuma ser "será que é erro do meu código?". Na verdade, 80% das falhas têm origem na própria interface do fisco. Repetir tentativas às cegas leva à limitação de taxa pelo fisco, agravando a taxa de falhas.
Principais recursos do monitoramento da SEFAZ da TF Fiscal
1. Sondagem a cada 60 segundos em todos os estados + Distrito Federal
Para cada estado, sondamos ativamente as 4 interfaces padrão (NfeAutorizacao, NfeRetAutorizacao, NfeStatusServico, NfeConsulta) a cada 60 segundos, registrando o tempo de resposta e o código de status.
2. Indicadores de monitoramento multidimensionais
- Disponibilidade: respostas bem-sucedidas / total de sondagens (por minuto / hora / dia / mês)
- Latência de resposta: percentis P50 / P95 / P99
- Classificação de erros: timeout, 5xx, códigos de erro de negócio da SEFAZ
- Replay histórico: é possível consultar o desempenho da interface em qualquer período
3. Nova tentativa automática + backoff exponencial
Ao detectar uma falha na interface, sua requisição de emissão é colocada em fila → e reenviada automaticamente quando a interface se recupera. Falhas de curta duração não interrompem a operação.
4. Webhook de alertas críticos
Quando a interface de um estado falha por 5 minutos consecutivos, enviamos automaticamente um Webhook para a URL que você configurar, facilitando:
- Pausar a emissão de notas dos pedidos do estado afetado
- Enviar avisos aos clientes ("a nota será emitida com atraso")
- Acionar a equipe de operação com antecedência
5. Relatório mensal de SLA
Geramos automaticamente, todo mês, um relatório de disponibilidade por estado, que serve de base para o seu relatório interno de SLA ou para a comunicação com fornecedores upstream.
6. Página de status pública
Disponibilizamos a página status.tfnfe.com (em breve), que mostra em tempo real o status das interfaces de todos os estados, acessível a qualquer pessoa e gratuita.
Cenários típicos de uso
- Planejamento de testes de carga na semana que antecede grandes promoções
- Escolha inteligente de "qual estado priorizar para o envio" em operações interestaduais
- Identificar "de quem é a culpa pela falha na emissão"
- Enviar ao negócio eventos de "emissão com atraso"
- Fonte de dados de SLA para o relatório financeiro mensal
Preços
- Página de status pública: acesso gratuito para todos
- Alertas programáticos por API: incluídos nos planos pagos da TF Fiscal, veja os detalhes em Planos e preços
- Solução corporativa personalizada: inclui recursos avançados como regras de alerta personalizadas, relatório mensal de SLA dedicado, painel de monitoramento dedicado e agregação de status entre linhas de negócio. Fale com o time comercial para receber uma proposta →
Perguntas frequentes
P: Como vocês sabem que uma interface da SEFAZ está com falha?
Por meio de sondagem ativa periódica (synthetic monitoring) + estatísticas de chamadas reais de negócio, com verificação cruzada entre as duas fontes. Qualquer uma delas que detecte uma anomalia dispara o alerta.
P: Minhas emissões se perdem durante uma falha?
Não. Todas as requisições entram em uma fila persistente e são reenviadas em ordem após a recuperação da falha. O cliente recebe o resultado final por Webhook.
P: Como proceder legalmente durante uma falha da interface da SEFAZ?
A legislação fiscal brasileira permite o "modo de contingência" (Contingência): gera-se um número local para dar continuidade à operação e, recuperada a interface, completa-se a autorização oficial. A TF Fiscal trata esse fluxo automaticamente.
Soluções relacionadas