{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12825/comprehensive+nf-e+xml+validator+api/25520/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
'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 综合 NF-e XML 验证器 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
验证巴西的 Nota Fiscal Eletrônica (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 以及类型代码 (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": []
}
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”数组以获取特定问题,并解决任何特定于市政的合规警告
标准数据模式包括有效文档的“有效”标志为真、空的“错误”数组,以及针对无效文档的特定错误代码,如MISSING_REQUIRED或INVALID_FORMAT,提供清晰的问题反馈