根据当前SEFAZ模式验证巴西Nota Fiscal Eletrônica (NF-e, mod 55)、NFC-e (mod 65)和CT-e (mod 57) XML——并返回失败的具体元素路径,而不是难以理解的拒绝代码。专为财政技术开发者、ERP和需要在SEFAZ之前捕获格式错误财政文件的电子商务结账集成而设计。
大多数巴西财政API(如Focus NFe,Webmania,NFe.io)都是完整的发放堆栈——体积大、价格高昂且对于已经持有XML且只需要验证的用户来说显得过于繁重。这是一个纯数据验证器:POST XML,获取结构化的通过/失败结果和类型化错误。模式规则和按市县的NFS-e特殊情况不会被通用的全球验证器复制。
/NFe/infNFe/ide/nNF,带有类型化代码(MISSING_REQUIRED、INVALID_FORMAT、CROSS_FIELD、UNSUPPORTED_VERSION、INVALID_ROOT)。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/12735/e-invoice+error+checking+validation+api/24635/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响应,其中包含有效性标志、每个元素错误的列表(包括路径和错误代码)、自动检测到的架构版本、文档类型,以及任何特定于市政府的警告
响应中的关键字段包括“valid”(布尔值)、“errors”(错误对象数组)、“schema_version”(字符串)、“schema_kind”(字符串)和“municipality_specific_warnings”(数组)
响应被构造为一个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%
响应时间:
841ms
服务级别:
100%
响应时间:
129ms
服务级别:
100%
响应时间:
159ms
服务级别:
100%
响应时间:
107ms
服务级别:
100%
响应时间:
213ms
服务级别:
100%
响应时间:
183ms
服务级别:
100%
响应时间:
1,455ms
服务级别:
100%
响应时间:
78ms
服务级别:
100%
响应时间:
726ms
服务级别:
100%
响应时间:
150ms