ブラジル経済の全請求書を支えるSOAP 1.2、その全貌をマッピング

Every invoice in Brazil's economy runs on SOAP 1.2. We mapped it all

▲ 58lestx34 HNでの議論

ブラジルの電子税務文書NF-e、NFC-e、CT-e、MDF-eのSEFAZウェブサービスをPostmanコレクションとして完全収録。SOAP 1.2エンベロープとmTLS認証に対応し、DFe配布サービスは本番環境で検証済み。各サービスのURLやXML署名の要否など、実運用で必要な情報を一覧化している。

Integrar com a SEFAZ exige garimpar manuais (MOC NF-e/NFC-e 4.00, CT-e 4.00, MDF-e 3.00b, NT 2015.002) e portais de autorizadores para descobrir URL, envelope SOAP e peculiaridades de cada serviço.
原文を読む →HNでの議論RSS

HNでの議論

34
  1. pjmlp

    それほど悪くはない。少なくともXMLは機械に優しく、スキーマ検証をサポートし、コメントも書ける。その代替品たちが、そうした機能がなぜ重要かを再発見しなければならなかったのとは対照的だ。

    性能についても、どれも大したことがない理由を再発見した。だからgRPCはCORBA、COM、Sun RPCを再発見している。

  2. mhl47

    ブラジル子会社でERPを展開したとき、社内のコンサルティングチーム全員が、この複雑さで頭を悩ませるのはやめて、地元のコンサルタントチームを助っ人として雇おうと即座に同意した。そして地元のコンサルタントチームは、今度は即座にミドルウェアプロバイダーの使用を提案した。

  3. Muromec

    これはウクライナのレジスターと似ている。すべての小売取引は税務当局側のレジスターAPIを通る（だって、帳簿に載せない現金を少し持っておきたいのは誰だって同じだろう？）。でもそこではRESP+JSONで、それを代行するサービスという小さな産業がある。PKI全体をこっそり組み込んでいなければ、それほど難しくもないだろうに。

  4. lestx

    ブラジルは地球上最大の義務的電子請求書システムを運営している。2兆ドル経済のすべての請求書、すべてのトラック積荷、すべての小売レシートが、政府のSOAP 1.2ウェブサービスを通る。2026年になってもだ。

    統合したい？ ドキュメントは合計1,000ページを超える4つのPDFマニュアルで、別々のポータルに散らばっており、どこにも書かれていない重要な詳細がある。何時間ものデバッグで痛い目を見た2つの例：貨物文書（CT-e）とマニフェスト（MDF-e）は同じ配布仕様を実装しているのに、互換性のないエンベロープを使っている（一方はペイロードをラップし発行州コードを要求し、もう一方はそのフィールドを拒否してSOAPヘッダーに州コードを求める）。そしてSOAPアクションはContent-Typeヘッダーの中に入れなければならない。インターネット上のどのSOAPチュートリアルもそうしろと言うようにSOAPActionヘッダーを送ると、サーバーは理由も説明せずに拒否する。

    そこで我々は4つの文書モデルにまたがる29のウェブサービスをすべて1つのPostmanコレクションにマッピングした。すぐに送信できるエンベロープ、ホストごとのmTLS証明書設定を文書化し、配布サービスはマニュアルから書いただけでなく、本番の政府エンドポイントに対して検証済みだ。

    改善できる点：ブラジルには27の州があり、いくつかは独自の認証局URLを運営している（例えばサンパウロの小売請求書）。我々は共有認証局と全国環境をカバーしている。州固有のURLマッピングが最大の未解決の貢献だ。コレクションはPythonのインベントリファイルから生成されるので、PRはJSONの手術ではなく5行の差分で済む。

    ドキュメント […]

この日のほかの記事

2026-09-15