为什么需要监控 SEFAZ 接口
巴西 27 个州 + 联邦区各自维护独立的 NF-e 接口。稳定性差异极大：
- 圣保罗（SP）、米纳斯（MG）等大州相对稳定（99%+ 可用率）
- 里约（RJ）、巴伊亚（BA）等偶发故障（98% 左右）
- 北部 / 东北部小州（AC、RR、AP、TO）波动较大（97% 以下）
- 每月例行维护窗口、节日延长维护、突发故障
如果您自己开票，遇到接口失败时第一反应往往是"是我的代码错了？"，实际上 80% 的失败源于税局接口本身。盲目重试会被税局限流，加剧失败率。
TF NFE SEFAZ 监控核心能力
1. 全州 + 联邦区 60 秒一次探测
对每个州的 4 个标准接口（NfeAutorizacao、NfeRetAutorizacao、NfeStatusServico、NfeConsulta）每 60 秒主动探测一次，记录响应时间与状态码。
2. 多维监控指标
- 可用率：成功响应数 / 总探测数（分钟 / 小时 / 日 / 月）
- 响应延迟：P50 / P95 / P99 分位数
- 错误分类：超时、5xx、SEFAZ 业务错误码
- 历史回放：可查看任意时段的接口表现
3. 异常自动重试 + 指数退避
检测到接口异常后，您的开票请求会被排队 → 接口恢复后自动续推。不会因短期故障导致业务停摆。
4. 关键告警 Webhook
当某州接口连续 5 分钟故障，自动推送 Webhook 到您配置的 URL，方便您：
- 暂停受影响州的订单开票
- 给客户推送通知（"发票将延迟开具"）
- 提前安排人工运维
5. SLA 月度报告
每月自动生成各州可用率报告，作为您内部 SLA 报告或与上游供应商沟通的依据。
6. 公开状态页
开放 status.tfnfe.com（待上线）页面实时显示所有州接口状态，所有人可访问，免费。
典型应用场景
- 大促前一周的接口压测计划
- 跨州业务时智能选择"哪个州优先发货"
- 识别"我开票失败到底是谁的问题"
- 给上层业务推送"延迟开票"的事件
- 财务月报中的 SLA 数据来源
价格
- 公开状态页：所有人免费访问
- API 程序化告警：包含在 TF NFE 付费套餐中，详见价格方案
- 大型企业定制化方案：含自定义告警规则、独立 SLA 月度报告、独立监控仪表盘、跨业务线状态聚合等高级能力。联系销售获取报价 →
常见问题
Q：你们怎么知道 SEFAZ 接口故障？
通过定期主动探测（synthetic monitoring）+ 真实业务调用统计两种方式交叉验证。任何一种方式发现异常都会触发告警。
Q：故障时我的开票会丢失吗？
不会。所有请求进入持久化队列，故障恢复后按顺序续推。客户端通过 Webhook 收到最终结果。
Q：SEFAZ 接口故障期间法定该如何处理？
巴西税法允许"应急模式"（Contingência）：先生成本地编号继续业务，待接口恢复后再补充正式授权。TF NFE 自动处理这个流程。
相关解决方案