{"valid":true,"errors":[],"schema_version":"4.00","schema_kind":"nfe","municipality_specific_warnings":[]}
curl --location --request POST 'https://zylalabs.com/api/12836/comprehensive+nf-e+xml+validatorr+api/25530/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 个月 🎉)
根据当前SEFAZ模式验证巴西电子发票(NF-e,mod 55)、NFC-e(mod 65)和CT-e(mod 57)XML — 并返回失败的确切元素路径,而不是一个难以理解的拒绝代码。专为需要在SEFAZ之前捕捉格式不正确的财务文件的财税技术开发者、ERP和电子商务结账集成而打造。
大多数巴西财务API(Focus NFe,Webmania,NFe.io)是完整的发放栈 — 繁重,定价面向发票发行者,且如果您已经拥有XML并只需要验证,则显得过于繁琐。这是一个纯数据验证工具:发送XML,获取结构化的合格/不合格结果和类型错误。通用的全球验证器无法复制这些架构规则和每个市的NFS-e特性。
/NFe/infNFe/ide/nNF,带有类型编码(MISSING_REQUIRED,INVALID_FORMAT,CROSS_FIELD,UNSUPPORTED_VERSION,INVALID_ROOT)。400,对于模式有效但内容无效返回422,有效时返回200。/v1/ API,以及每天监测SEFAZ模式变化。{
"valid": true,
"errors": [],
"schema_version": "4.00",
"schema_kind": "nfe",
"municipality_specific_warnings": []
}
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”数组以获取具体问题,并解决任何与特定市政相关的合规警告
标准数据模式包括一个有效文档的“有效”标志为真,一个空的“错误”数组,以及特定的错误代码如缺少必填项或无效格式用于无效文档,提供对问题的明确反馈