stoix-dev/sefaz-webservices-postman

来源：https://github.com/stoix-dev/sefaz-webservices-postman

巴西联邦税务局Web服务目录（Postman集合）

完整的、文档化的Postman集合，包含巴西电子税务文档的Web服务：NF-e (55)、NFC-e (65)、CT-e (57) 和 MDF-e (58)。

文件：postman/SEFAZ-Webservices-Catalogo.postman_collection.json （包含29个项，分布在5个文件夹中：每个模型一个文件夹 + 事件参考）

为何需要这个

集成SEFAZ需要查阅繁琐的手册（MOC NF-e/NFC-e 4.00, CT-e 4.00, MDF-e 3.00b, NT 2015.002）和授权方门户，以获取URL、SOAP信封以及每个服务的独特之处。这个集合提供了现成的方案：每个请求都包含已构建好的SOAP 1.2信封和变量{{}}。

两个DFe分发服务（CT-e和MDF-e）已于2026年9月12日通过生产环境的SEFAZ验证（状态码137），并标记为 [OK testado]。

在Postman中设置

1. 导入 > postman/SEFAZ-Webservices-Catalogo.postman_collection.json。
2. 证书 (设置 > 证书 > 添加证书)：为每个主机添加您的e-CNPJ A1证书（.pfx + 密码）。对于分发服务，请为以下主机添加： www1.cte.fazenda.gov.br、mdfe.svrs.rs.gov.br、mdfe-homologacao.svrs.rs.gov.br。
3. 设置 > 常规：关闭 “SSL证书验证”（ICP-Brasil的证书颁发机构不在Postman的信任存储中）。
4. 在每个请求中，将URL（从描述中获取测试环境或生产环境的地址）复制到变量 {{url}}，调整 cnpj、cUF、tpAmb 等参数，然后发送请求。

惯例说明

• 名称中的 [cadeado]：表示数据XML需要 XMLDSig签名（授权、事件、作废）。Postman本身不能签署XML；对于这些服务，请使用签名工具或自定义代码。查询、状态和分发无需签名。
• [OK testado]：表示已通过SEFAZ验证（状态码137）。
• 所有服务均为SOAP 1.2：action 包含在 Content-Type 中，而非 SOAPAction 请求头。

实际测试中遇到的关键差异

• CT-e分发（国家环境）：distDFeInt 包含 cUFAutor，包装器为 cteDistDFeInteresse > cteDadosMsg，无需 cabecMsg。
• MDF-e分发（SVRS环境）：distDFeInt 不含 cUFAutor（cUF 放在请求头的 mdfeCabecMsg 中），mdfeDadosMsg 直接放在Body中。仅支持 distNSU 和 consNSU（没有 consChNSU）。
• NF-e分发（AN环境）：与CT-e类似（包含 cUFAutor），版本为1.01。
• CT-e 4.00：授权仅支持同步方式（SincV4/OSV4/GTVeV4）；异步批处理和作废在国家清单中不存在。
• MDF-e 3.00：同步授权，数据区域使用 GZip+base64 编码。
• NFC-e：需要CSC + 二维码（infNFeSupl）；不支持SVC（离线应急模式 tpEmis=9）；AM/GO/MS/MT/PR/RS/SP等州有独立环境。

范围和限制

• 默认URL使用 SVRS（适用于大多数州）+ 用于分发的 国家环境。未覆盖所有27个州的逐一配置；若需使用特定授权方（如NFC-e SP），请在变量中替换URL。
• 事件作为参考文件夹（包含 tpEvento 代码）；它们通过各自模型的 RecepcaoEvento 接口发送。

如何生成

真实数据来源：gen_inventario.py 生成 inventario.json；build_collection.py 构建Postman的 .json 文件。如需提议更改，请编辑 gen_inventario.py，运行两个脚本，然后提交PR。

相关仓库

• ciot-integradoras-postman (https://github.com/stoix-dev/ciot-integradoras-postman)：通过ANTT（pefServices）的CIOT和运费支付集成商
• antt-webservices-postman (https://github.com/stoix-dev/antt-webservices-postman)：ANTT的Web服务（CIOT、RNTRC、开放数据）

关于

由 Stoix (https://stoix.dev) 维护。MIT许可证。