Why You Need to Monitor SEFAZ Interfaces
Brazil's 27 states + the Federal District each maintain their own NF-e interface. Their stability varies enormously:
- Large states such as São Paulo (SP) and Minas Gerais (MG) are relatively stable (99%+ uptime)
- Rio de Janeiro (RJ), Bahia (BA) and others have occasional outages (around 98%)
- Small northern / northeastern states (AC, RR, AP, TO) fluctuate more (below 97%)
- Monthly routine maintenance windows, extended holiday maintenance, and sudden outages
If you do your own invoicing, your first reaction to an interface failure is often "is my code wrong?" — when in fact 80% of failures stem from the tax authority interface itself. Blindly retrying gets you rate-limited by the tax authority, making the failure rate worse.
Core Capabilities of TF Fiscal SEFAZ Monitoring
1. All States + the Federal District, Probed Every 60 Seconds
For each state's 4 standard interfaces (NfeAutorizacao, NfeRetAutorizacao, NfeStatusServico, NfeConsulta), we actively probe once every 60 seconds, recording response time and status code.
2. Multi-Dimensional Monitoring Metrics
- Uptime: successful responses / total probes (per minute / hour / day / month)
- Response latency: P50 / P95 / P99 percentiles
- Error classification: timeouts, 5xx, SEFAZ business error codes
- Historical replay: review interface performance for any time period
3. Automatic Retries on Errors + Exponential Backoff
When an interface error is detected, your invoicing requests are queued → automatically resubmitted once the interface recovers. Short-term outages won't bring your business to a halt.
4. Critical-Alert Webhooks
When a state's interface fails continuously for 5 minutes, a webhook is automatically pushed to your configured URL, so you can:
- Pause invoicing for orders in the affected state
- Notify customers ("invoices will be delayed")
- Schedule manual operations in advance
5. Monthly SLA Reports
Each month a report on each state's uptime is automatically generated, to serve as the basis for your internal SLA reporting or for discussions with upstream providers.
6. Public Status Page
The status.tfnfe.com page (coming soon) shows the real-time status of all states' interfaces, accessible to everyone, free.
Typical Use Cases
- Planning interface load tests in the week before a major sale
- Intelligently choosing "which state to ship from first" for interstate business
- Identifying "whose problem an invoicing failure really is"
- Pushing "delayed invoicing" events to upper-layer business systems
- A data source for SLA figures in monthly financial reports
Pricing
- Public status page: free for everyone
- Programmatic API alerts: included in TF Fiscal paid plans; see Pricing
- Customized enterprise solution: includes advanced capabilities such as custom alert rules, dedicated monthly SLA reports, a dedicated monitoring dashboard, and cross-business-line status aggregation. Contact sales for a quote →
FAQ
Q: How do you know when a SEFAZ interface is down?
Through cross-validation of two methods: periodic active probing (synthetic monitoring) + statistics from real business calls. An anomaly detected by either method triggers an alert.
Q: Will my invoices be lost during an outage?
No. All requests enter a persistent queue and are resubmitted in order once the outage recovers. The client receives the final result via webhook.
Q: What is the legally required way to proceed during a SEFAZ interface outage?
Brazilian tax law allows a "contingency mode" (Contingência): generate a local number to keep operating, then obtain formal authorization once the interface recovers. TF Fiscal handles this flow automatically.
Related Solutions