验证巴西的 电子发票 (NF-e, mod 55)、NFC-e (mod 65) 和 CT-e (mod 57) XML 是否符合当前的 SEFAZ 模式 - 并返回 具体的失败元素路径,而不是神秘的拒绝代码。为需要在 SEFAZ 之前捕获格式错误财务文件的财务科技开发者、ERP 和电子商务结账集成而构建。
大多数巴西财政 API(Focus NFe、Webmania、NFe.io)是完整的 发放 堆栈 - 繁重,针对发放方定价,如果你已经掌握了 XML 且只需 验证 它,则完全是杀鸡用牛刀。这是一个纯数据验证器:POST XML,获取带有类型化错误的结构化通过/失败消息。模式规则和每个市县 NFS-e 的特性并不被通用全局验证器所复制。
/NFe/infNFe/ide/nNF,带有类型代码 (缺少必需字段, 格式无效, 字段冲突, 不支持的版本, 根无效)。400 表示格式错误的 XML,422 表示模式有效但内容无效,200 表示有效。/v1/ API,及每日 SEFAZ 模式漂移监测。{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12681/nf-e+xml+validator+api/24570/validate+nf-e+xml' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '
35
00000001
VENDA
55
1
1
2026-05-19T10:00:00-03:00
1
1
3550308
1
1
0
2
1
0
1
0
1.0
11222333000181
EMPRESA TESTE LTDA
RUA TESTE
100
CENTRO
3550308
SAO PAULO
SP
01000000
123456789012
3
22333444000172
CLIENTE TESTE LTDA
'
| 标头 | 描述 |
|---|---|
授权
|
[必需] 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。 |
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
API返回一个JSON响应,其中包括有效性标志、每个元素错误的列表(带有路径和错误代码)、自动检测的模式版本、文档类型和任何特定于城市的警告
响应中的关键字段包括“有效的”(布尔值)“错误”(错误对象数组)“架构版本”(字符串)“架构类型”(字符串)和“特定于市的警告”(数组)
响应结构为JSON对象,包含用于有效性、错误、模式版本、模式类型和市政警告的顶级键,便于访问每个组件
API提供NF-e、NFC-e和CT-e XML文档的验证结果,包括错误细节、模式版本和特定于市政的警告,确保全面的验证反馈
通过每天监控SEFAZ模式更新来维护数据准确性,确保API使用最新的NF-e、NFC-e和CT-e文档的验证规则和结构
典型的使用案例包括在ERP系统中导入账本之前验证供应商的NF-e在电子商务结账时预先验证CT-e/NF-e以及确保文档接收流程中的合规性
用户可以通过检查“valid”标志来确定XML是否有效,查看“errors”数组以了解具体问题,并处理任何特定于市政的警告以确保合规
标准数据模式包括一个“有效”真值指示器用于有效文档 一个空的“错误”数组和特定的错误代码如缺少必需或格式无效用于无效文档提供关于问题的清晰反馈
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
383ms
服务级别:
100%
响应时间:
1,045ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
0ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
153ms
服务级别:
100%
响应时间:
383ms
服务级别:
100%
响应时间:
1,045ms