Por qué es necesario monitorear las interfaces de la SEFAZ
Los 27 estados + el Distrito Federal de Brasil mantienen cada uno su propia interfaz de NF-e independiente. Las diferencias de estabilidad son enormes:
- Estados grandes como São Paulo (SP) o Minas Gerais (MG) son relativamente estables (disponibilidad del 99%+)
- Rio de Janeiro (RJ), Bahia (BA) y otros tienen fallos esporádicos (en torno al 98%)
- Los estados pequeños del norte / nordeste (AC, RR, AP, TO) presentan mayor fluctuación (por debajo del 97%)
- Ventanas de mantenimiento rutinario mensual, mantenimiento prolongado en días festivos y fallos imprevistos
Si usted emite facturas por su cuenta, ante un fallo de la interfaz su primera reacción suele ser "¿es un error de mi código?", cuando en realidad el 80% de los fallos se origina en la propia interfaz fiscal. Reintentar a ciegas hace que la hacienda le aplique limitación de tasa, agravando la tasa de fallos.
Capacidades principales del monitoreo de SEFAZ de TF Fiscal
1. Sondeo cada 60 segundos en todos los estados + Distrito Federal
Para cada estado se sondean activamente las 4 interfaces estándar (NfeAutorizacao, NfeRetAutorizacao, NfeStatusServico, NfeConsulta) cada 60 segundos, registrando el tiempo de respuesta y el código de estado.
2. Métricas de monitoreo multidimensionales
- Disponibilidad: respuestas exitosas / total de sondeos (por minuto / hora / día / mes)
- Latencia de respuesta: percentiles P50 / P95 / P99
- Clasificación de errores: timeouts, 5xx, códigos de error de negocio de la SEFAZ
- Reproducción histórica: posibilidad de consultar el rendimiento de la interfaz en cualquier período
3. Reintento automático ante anomalías + retroceso exponencial
Al detectar una anomalía en la interfaz, su solicitud de facturación se pone en cola → y se reenvía automáticamente cuando la interfaz se recupera. Un fallo de corta duración no detiene el negocio.
4. Webhook de alertas críticas
Cuando la interfaz de un estado falla durante 5 minutos seguidos, se envía automáticamente un webhook a la URL que usted configure, lo que le permite:
- Pausar la facturación de pedidos del estado afectado
- Notificar a los clientes ("la factura se emitirá con retraso")
- Planificar con antelación una intervención manual de operaciones
5. Informe mensual de SLA
Cada mes se genera automáticamente un informe de disponibilidad por estado, que sirve como base para su informe interno de SLA o para la comunicación con proveedores aguas arriba.
6. Página de estado pública
La página abierta status.tfnfe.com (próximamente disponible) muestra en tiempo real el estado de las interfaces de todos los estados, accesible para cualquier persona y gratuita.
Escenarios de uso típicos
- Plan de pruebas de carga de las interfaces la semana previa a una gran promoción
- Elección inteligente de "desde qué estado despachar primero" en negocios interestatales
- Identificar "de quién es realmente el problema cuando falla mi facturación"
- Enviar al negocio aguas arriba el evento de "facturación retrasada"
- Fuente de los datos de SLA en el informe financiero mensual
Precios
- Página de estado pública: acceso gratuito para todos
- Alertas programáticas por API: incluidas en los planes de pago de TF Fiscal; consulte los planes y precios
- Solución personalizada para grandes empresas: incluye reglas de alerta personalizadas, informe mensual de SLA dedicado, panel de monitoreo independiente, agregación de estado entre líneas de negocio y otras capacidades avanzadas. Contacte con ventas para obtener una cotización →
Preguntas frecuentes
P: ¿Cómo saben que una interfaz de la SEFAZ está fallando?
Mediante sondeos activos periódicos (synthetic monitoring) + estadísticas de llamadas reales de negocio, verificándolo de forma cruzada. Una anomalía detectada por cualquiera de los dos métodos dispara una alerta.
P: Durante un fallo, ¿se perderá mi facturación?
No. Todas las solicitudes entran en una cola persistente y se reenvían en orden tras recuperarse el fallo. El cliente recibe el resultado final mediante webhook.
P: ¿Cómo proceder legalmente durante un fallo de la interfaz de la SEFAZ?
La legislación fiscal brasileña permite el "modo de contingencia" (Contingência): se genera primero un número local para continuar la operación y, una vez recuperada la interfaz, se completa la autorización formal. TF Fiscal gestiona este flujo automáticamente.
Soluciones relacionadas