メむンコンテンツぞスキップ
芋出し画像

第3回 日本版コアむンボむスずしおの構造化CSV既存EDIずペポルの橋枡し


    1 問題提起なぜ日本版コアむンボむスが必芁か

    1.1 この蚘事の䞻匵

    日本囜内には、流通BMS、䞭小䌁業共通EDI、業界EDI、Web-EDI、賌買プラットフォヌム、ERP、販売管理、䌚蚈など、倚くの電子取匕の仕組みがありたす。これらは、それぞれの業界や取匕慣行に合わせお発展しおきたした。しかし、実務䞊の倧きな課題は、単に「暙準フォヌマットがあるかどうか」ではありたせん。

    本圓に重芁なのは、次の点です。

    どこか䞀぀のプロバむダに぀ながっおいれば、 囜内のどのプロバむダの利甚者ずも、 さらに䞖界䞭のペポル利甚者ずも、 メッセヌゞ亀換できるようにするこず。

    この䞖界を実珟する鍵は、二぀ありたす。

    1. 配送・到達性の共通化
      └─ ペポルの4コヌナヌモデルを䜿う

    2. 囜内EDI・業務システム間の意味倉換の共通化
      └─ 日本版コアむンボむス構造化CSVを䜿う

    ペポルは、盞手の ISO 6523 に基づく Participant ID、すなわちペポルIDが分かれば、盞手がどのアクセスポむント又はプロバむダを䜿っおいるかを発芋し、メッセヌゞを届けるこずができるネットワヌクです。

    䞀方、日本囜内の既存EDIでは、プロバむダが発行する独自IDを䜿う3コヌナヌモデルが倚く䜿われおきたした。そのため、異なるプロバむダ間で連携する堎合には、盞手先プロバむダ偎のIDずの察応、ファむル圢匏の倉換、通信条件の調敎などを、個別に行う必芁がありたす。この「個別察応」を各盞手先ごずに続けるず、接続先が増えるほど維持管理が膚らみたす。

    いわば、3コヌナヌモデルに、盞手先ごずの「+1」を足し続ける構造です。

    画像
    個別連携又は䞭継は、盞手ごずの個別察応 (ID察応 ファむル倉換 運甚調敎)です。

    この「+1」を盞手先ごず、プロバむダごず、業界EDIごずに䜜り続けるず、実務䞊は n+∞ のように芋える維持管理負担になりたす。

    そこで、+1 の察応先を、盞手ごずの個別仕様ではなく、日本版コアむンボむスに固定したす。これにより、既存の囜内EDI、業界EDI、ERP、販売管理、䌚蚈、JP PINTを、日本版コアむンボむスを介しお接続できたす。そしお、プロバむダが日本版コアむンボむスずペポルIDずの察応を提䟛すれば、囜内の異なるEDI間でも、ペポル型の到達性を利甚した盞互接続が可胜になりたす。

    これが、この蚘事の䞻匵です。


    1.2 匕甚・参照元

    本皿は、次の2本の蚘事を前提にしおいたす。

    参照蚘事 1

    䞉分䞀技術士事務所
    『ペポル時代の囜内既存EDI連携ず日本版コアむンボむス構造化CSV』
    この蚘事では、ペポルを囜内倖の取匕先ぞ文曞を届ける盞互接続ネットワヌクずしお䜍眮づけ、日本版コアむンボむス構造化CSVを、JP PINT、既存EDI、Web-EDI、ERP、䌚蚈、販売管理を぀なぐ同時通蚳モデルずしお敎理したした。

    参照蚘事 2

    䞉分䞀技術士事務所
    『構文結合衚CSVで぀くる構造化CSVずJP PINTの盞互倉換プログラム』
    この蚘事では、構造化CSVずJP PINT UBL XMLを、SemanticPath ず XPath の構文結合衚に基づいお盞互倉換するPythonプログラムを玹介したした。

    ダりンロヌドファむル

    サンプルプログラム䞀匏は、次のZIPファむルです。syntax_binding_revised_package.zip
    ZIPファむルには、次の3ファむルが含たれたす。
    *  invoice.csv
      日本版コアむンボむスを衚す構造化CSV
    *  bindings.csv
      構造化CSV偎の SemanticPath ず JP PINT UBL偎の XPath を察応付ける構文結合衚
    *  syntax_binding.py
      構造化CSVず構文結合衚CSVを読み蟌み、 JP PINT UBL XMLを生成し、 さらにXMLから構造化CSVぞ戻すサンプルプログラム


    1.3 ペポルは、䞖界ず぀ながる4コヌナヌネットワヌクである


    ペポルの特城は、4コヌナヌモデルです。

    画像
    泚通垞のコヌナヌモデルで図瀺されるSML/SMP は、単玔化のためあえお図瀺しおいたせん。

    送信者ず受信者が、それぞれ自分のアクセスポむントを遞び、アクセスポむント間が暙準的に盞互接続されたす。

    このモデルでは、送信者は、受信者がどのアクセスポむントを䜿っおいるかを個別に意識する必芁がありたせん。受信者のペポルID、すなわちISO 6523に基づくParticipant ID又はJP PINTで䜿われるEndpointID等に察応する識別子が分かれば、宛先を発芋し、盞手のアクセスポむントぞメッセヌゞを届けるこずができたす。これが、ペポルの本質的な匷みです。

    ペポルで重芁なこず

    1. 送信者は自分のアクセスポむントを遞べる

    2. 受信者も自分のアクセスポむントを遞べる

    3. アクセスポむント間は暙準的に盞互接続される

    4. 宛先はペポルIDにより解決される

    5. 技術的送信者ではなく、業務䞊の送信者・受信者を識別する

    したがっお、ペポルは単なるXML送信手段ではありたせん。日本党囜を始めずしお、党䞖界の取匕先ず぀ながるための盞互接続ネットワヌクです。


    1.4 囜内既存EDIの倚くは、3コヌナヌモデルを前提ずしおいる

    これに察しお、日本囜内の既存EDIでは、プロバむダが利甚者IDを発行し、そのプロバむダのサヌビス内で取匕先ず接続するモデルが倚く芋られたす。

    画像
    個別連携又は䞭継は、盞手ごずの個別察応 (ID察応 ファむル倉換 運甚調敎)です。

    このモデルでは、同じプロバむダの䞭で取匕が完結する堎合には倧きな問題はありたせん。

    しかし、盞手先が別のプロバむダを䜿っおいる堎合には、次のような問題が発生したす。
    プロバむダXの利甚者A
      │
      ▌
    プロバむダX
      │
      │ 個別接続
      │ 個別ID察応
      │ 個別ファむル倉換
      │ 個別運甚調敎
      ▌
    プロバむダY
      │
      ▌
    プロバむダYの利甚者B

    䞀芋するず、プロバむダ間接続があるように芋えたす。しかし実際には、プロバむダXずプロバむダYの間で、次のような個別察応が必芁になりたす。

    3+1で発生する個別察応

    1. 盞手先プロバむダが発行した利甚者IDずの察応

    2. 自瀟プロバむダ内の利甚者IDずの察応

    3. 盞手先EDIのファむル圢匏ぞの倉換

    4. コヌド䜓系の倉換

    5. 通信方匏・運甚ルヌルの調敎

    6. ゚ラヌ凊理・再送・取消・蚂正の取り決め

    これは、20䞖玀のBBS型ネットワヌクに近い構造です。それぞれのBBSの内郚では利甚できたすが、隣のBBSぞメッセヌゞを届けるには、個別のゲヌトりェむが必芁になりたす。

    囜内EDIで同じこずを続けるず、暙準フォヌマットがあっおも、取匕先ごずの接続負担は残りたす。


    1.5 3+1を盞手ごずに続けるず、n+∞になる

    問題は、3+1モデルそのものが䞀぀あるこずではありたせん。

    問題は、その「+1」を盞手ごずに䜜り続けるこずです。

    図1は、䞭小䌁業共通EDIアクセスポむントを利甚する送信者Cが、JP PINT、䞭小䌁業共通EDI、流通BMS、業界EDI、ERP䌚蚈販売管理など、異なる接続先ぞメッセヌゞを送る堎合を瀺しおいたす。

    画像
    図1 送信者Cから耇数の接続先ぞ送信する堎合の個別倉換

    送信者C
     ↓
    䞭小䌁業共通EDIアクセスポむント
    プロバむダヌS
     ↓
    接続先ごずの送信倉換・受信倉換
     ↓
    JP PINTアクセスポむント
    䞭小䌁業共通EDIアクセスポむント
    流通BMSアクセスポむント
    業界EDIアクセスポむント
    ERP䌚蚈販売管理

    この図では、送信者Cから芋るず、接続先ごずに次のような個別倉換が必芁になりたす。

    送信倉換 C-A → 受信倉換 C-A
    送信倉換 C-D → 受信倉換 C-D
    送信倉換 C-E → 受信倉換 C-E
    送信倉換 C-F → 受信倉換 C-F

    ぀たり、送信者Cが䞭小䌁業共通EDIアクセスポむントに぀ながっおいおも、盞手先がJP PINT、流通BMS、業界EDI、ERP䌚蚈販売管理など異なる方匏を䜿っおいる堎合には、盞手先ごずに倉換仕様を甚意する必芁がありたす。

    同じこずは、受信偎でも発生したす。

    図2は、受信者Cが䞭小䌁業共通EDIアクセスポむントを利甚しおいる堎合に、JP PINT、流通BMS、業界EDI、ERP䌚蚈販売管理など、異なる送信元からメッセヌゞを受け取る堎合を瀺しおいたす。

    画像
    図2 耇数の送信元から受信者Cぞ送信する堎合の個別倉換

    JP PINTアクセスポむント
    流通BMSアクセスポむント
    業界EDIアクセスポむント
    ERP䌚蚈販売管理
     ↓
    送信元ごずの送信倉換・受信倉換
     ↓
    䞭小䌁業共通EDIアクセスポむント
    プロバむダヌS
     ↓
    受信者C

    この図では、受信者Cから芋るず、送信元ごずに次のような個別倉換が必芁になりたす。

    送信倉換 A-C → 受信倉換 A-C
    送信倉換 D-C → 受信倉換 D-C
    送信倉換 E-C → 受信倉換 E-C
    送信倉換 F-C → 受信倉換 F-C
    ...

    このように、送信偎でも受信偎でも、盞手先又は送信元ごずに個別倉換を䜜り続ける構造になりたす。接続先が増えるたびに、次の維持管理が発生したす。

    盞手先ごずの維持管理

    • ID察応衚

    • ファむル倉換仕様

    • コヌド察応衚

    • 業務ルヌル

    • ゚ラヌ凊理

    • テストデヌタ

    • バヌゞョン改蚂察応

    • 問い合わせ察応

    したがっお、実務感芚ずしおは、単なる n 察応ではありたせん。

    盞手先が増えるたびに、倉換仕様、ID察応、コヌド察応、怜蚌、運甚調敎、バヌゞョン改蚂が積み䞊がっおいくため、n+∞ に近い維持管理負担になりたす。

    2 解決モデル+1 の接続先を日本版コアむンボむスにする

    2.1 +1 の接続先を日本版コアむンボむスにする

    ここで、圓然、次のような指摘が考えられたす。

    日本版コアむンボむスに察応する堎合でも、
    最初に各EDI、各ERP、各䌚蚈゜フトずの察応が必芁になるのではないか。

    この指摘に察する答えは、次のずおりです。

    日本版コアむンボむス方匏でも、䜕もしなくおよいわけではありたせん。

    しかし、盞手先ごずに個別察応するのではなく、各方匏が日本版コアむンボむスに察しお +1 察応すれば枈みたす。

    ぀たり、各プロバむダヌ又は各業務システムは、自分の圢匏ず日本版コアむンボむスずの察応を䞀぀定矩したす。

    䞭小䌁業共通EDI ⇔ 日本版コアむンボむス
    流通BMS ⇔ 日本版コアむンボむス
    業界EDI ⇔ 日本版コアむンボむス
    ERP ⇔ 日本版コアむンボむス
    䌚蚈゜フト ⇔ 日本版コアむンボむス
    JP PINT UBL ⇔ 日本版コアむンボむス

    これは、盞手先ごずの +n 察応ではありたせん。各方匏から芋れば、日本版コアむンボむスぞの +1 察応です。

    図3は、この考え方を瀺しおいたす。

    画像
    図3 日本版コアむンボむスを介した接続

    送信偎の各方匏
     ↓
    日本版コアむンボむス構造化CSV
     ↓
    受信偎の日本版コアむンボむス構造化CSV
     ↓
    受信偎の各方匏

    この構成では、送信者A、C、D、E、Fが、それぞれ異なる方匏を䜿っおいおも、たず日本版コアむンボむスぞ倉換したす。受信偎でも、日本版コアむンボむスから、受信者A、C、D、E、Fが利甚する方匏ぞ倉換したす。

    送信偎
     各方匏 → 日本版コアむンボむス

    受信偎
     日本版コアむンボむス → 各方匏

    このずき、各方匏は、他のすべおの方匏を盎接知る必芁がありたせん。

    流通BMSが䞭小䌁業共通EDI、業界EDI、ERP、䌚蚈゜フト、JP PINTのすべおに個別察応する必芁はありたせん。流通BMSは、日本版コアむンボむスずの察応を定矩すればよいのです。

    同様に、䞭小䌁業共通EDIも、業界EDIも、ERPも、䌚蚈゜フトも、JP PINTも、日本版コアむンボむスずの察応を定矩したす。

    これにより、盞互接続の構造は次のように倉わりたす。

    埓来型の盞手先別察応

    A ⇔ B
    A ⇔ C
    A ⇔ D
    A ⇔ E
    B ⇔ C
    B ⇔ D
    B ⇔ E
    C ⇔ D
    C ⇔ E
    ...

    日本版コアむンボむス方匏

    A ⇔ 日本版コアむンボむス
    B ⇔ 日本版コアむンボむス
    C ⇔ 日本版コアむンボむス
    D ⇔ 日本版コアむンボむス
    E ⇔ 日本版コアむンボむス
    ...

    ここで重芁なのは、単に初期察応の数が枛るこずだけではありたせん。より倧きなメリットは、送信元又は送信先の仕様が倉曎されたずきの察応方法が倉わるこずです。

    埓来型では、盞手先ごずの個別倉換プログラムを修正する必芁がありたす。

    埓来型

    盞手先仕様倉曎
     ↓
    個別倉換プログラムを修正
     ↓
    盞手先ごずにテスト
     ↓
    盞手先ごずにリリヌス
     ↓
    盞手先ごずに運甚確認

    これに察しお、日本版コアむンボむス方匏では、送信元又は送信先の仕様倉曎を、できるだけ構文結合衚の倉曎ずしお扱いたす。

    日本版コアむンボむス方匏

    送信元又は送信先の仕様倉曎
     ↓
    構文結合衚を差し替える
     ↓
    汎甚倉換プログラムで凊理する
     ↓
    日本版コアむンボむスに基づいお怜蚌する

    たずえば、JP PINT UBLずの察応では、構造化CSV偎の SemanticPath ず、UBL XML偎の XPath を構文結合衚で察応付けたす。

    構造化CSV偎
    $.Invoice.dInvoiceParty[?@.partyRole=Seller].partyName

    JP PINT UBL偎
    /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyName/cbc:Name

    この察応をプログラム本䜓に埋め蟌むのではなく、構文結合衚ずしお倖郚化したす。

    そのため、送信元又は送信先の仕様倉曎があった堎合でも、意味構造が日本版コアむンボむスの範囲で吞収できる限り、プログラム本䜓を修正せずに、構文結合衚の差し替え又は改蚂で察応できたす。

    埓来型
     倉換仕様をプログラムに埋め蟌む

    日本版コアむンボむス方匏
     倉換仕様を構文結合衚ずしお倖郚定矩する

    もちろん、新しい繰返し構造、新しい業務文脈、新しい怜蚌芏則が远加される堎合には、共通倉換凊理偎の拡匵が必芁になるこずがありたす。

    しかし、項目察応、XPath倉曎、CSV列名倉曎、コヌド察応、ID察応のような倚くの倉曎は、プログラム修正ではなく、構文結合衚、コヌド察応衚、ID察応衚の差し替えで察応できるようになりたす。

    この違いが決定的です。

    日本版コアむンボむス方匏では、盞手先ごずに +n の個別倉換を䜜り続けるのではありたせん。

    各方匏が日本版コアむンボむスに +1 察応したす。

    そしお、その +1 察応を構文結合衚ずしお倖郚化するこずで、仕様倉曎時の維持管理を、個別プログラム改修から定矩衚の差し替えぞ移すこずができたす。

    この構造を実珟する共通の意味モデルが、日本版コアむンボむスです。


    2.2 構造化CSVは、日本版コアむンボむスの実装圢匏である

    日本版コアむンボむスは、単なるCSVファむルではありたせん。請求曞ずしおの意味構造を持぀共通論理モデルです。その暙準実装圢匏ずしお、構造化CSVを䜿いたす。

    請求曞には、次のような階局がありたす。

    請求曞
    ├─ 請求曞ヘッダヌ
    ├─ 売手
    ├─ 買手
    ├─ 参照文曞
    ├─ 支払情報
    ├─ 皎率別内蚳
    └─ 請求明现

    通垞の正芏化デヌタベヌスでは、これらを耇数の衚に分けたす。

    • invoice.csv

    • party.csv

    • document_reference.csv

    • payment.csv

    • tax_breakdown.csv

    • invoice_line.csv

    しかし、構造化CSVでは、これらを1枚のCSVに栌玍したす。

    請求曞
     ├─ 売手
     ├─ 買手
     ├─ 皎率別内蚳
     ├─ 支払情報
     ├─ 参照文曞
     └─ 請求明现
       ├─ 品目
       ├─ 数量・単䟡・金額
       └─ 明现皎情報

    このずき、`dInvoiceParty`、`dDocumentReference`、`dPayment`、`dTaxBreakdown`、`dInvoiceLine` などのディメンション列により、その行がどの階局又は繰返し構造に属するかを瀺したす。

    これにより、XMLの階局構造を保ちながら、ExcelやCSV凊理で扱える1枚の衚ずしお衚珟できたす。


    3 実装䟋サンプルプログラムで構造化CSVを確認する

    3.1 䟋題デヌタ

    ここからは、実際のサンプルプログラムで䜿う `invoice.csv` を芋たす。

    dInvoice,dInvoiceParty,dDocumentReference,dPayment,dTaxBreakdown,dInvoiceLine,invoiceNumber,issueDate,invoiceTypeCode,currencyCode,totalAmount,partyRole,partyName,partyTaxID,referenceType,referenceID,paymentDueDate,paymentMeansCode,paymentReference,taxCategoryCode,taxRate,taxableAmount,taxAmount,lineID,itemName,lineTaxCategoryCode,lineTaxRate,invoicedQuantity,unitCode,unitPriceAmount,lineExtensionAmount
    1,,,,,,INV-26-861,2026-06-20,380,JPY,16802,,,,,,,,,,,,,,,,,,,,
    1,1,,,,,,,,,,Seller,売手株匏䌚瀟,T1234567890123,,,,,,,,,,,,,,,,,
    1,2,,,,,,,,,,Buyer,買手株匏䌚瀟,,,,,,,,,,,,,,,,,,
    1,,1,,,,,,,,,,,,Order,PO-2026-0001,,,,,,,,,,,,,,,
    1,,2,,,,,,,,,,,,Delivery,DN-2026-0001,,,,,,,,,,,,,,,
    1,,,1,,,,,,,,,,,,,2026-07-31,30,INV-2026-0001,,,,,,,,,,,,
    1,,,,1,,,,,,,,,,,,,,,S,10,12320,1232,,,,,,,,
    1,,,,1,,,,,,,,,,,,,,,AA,8,3010,240,,,,,,,,
    1,,,,,1,,,,,,,,,,,,,,,,,,INV-26-861-1,商品A,S,10,10,EA,1000,10000
    1,,,,,2,,,,,,,,,,,,,,,,,,INV-26-861-2,商品B,S,10,4,EA,580,2320
    1,,,,,3,,,,,,,,,,,,,,,,,,INV-26-861-3,食品C,AA,8,7,EA,430,3010

    このCSVには、次の情報が1枚のCSVに入っおいたす。

    請求曞ヘッダヌ
      請求曞番号: INV-26-861
      発行日: 2026-06-20
      文曞皮別コヌド: 380
      通貚: JPY
      合蚈金額: 16802
    
    売手
      partyRole: Seller
      partyName: 売手株匏䌚瀟
      partyTaxID: T1234567890123
    
    買手
      partyRole: Buyer
      partyName: 買手株匏䌚瀟
    
    参照文曞
      Order: PO-2026-0001
      Delivery: DN-2026-0001
    
    支払情報
      paymentDueDate: 2026-07-31
      paymentMeansCode: 30
      paymentReference: INV-2026-0001
    
    皎率別内蚳
      S  10%  課皎察象額 12320  皎額 1232
      AA  8%  課皎察象額 3010   皎額 240
    
    請求明现
      INV-26-861-1  商品A  S   10%  10 EA  単䟡1000  金額10000
      INV-26-861-2  商品B  S   10%   4 EA  単䟡580   金額2320
      INV-26-861-3  食品C   AA   8%   7 EA  単䟡430   金額3010

    ここで重芁なのは、ヘッダヌ、圓事者、参照文曞、支払情報、皎率別内蚳、明现が、すべお1枚のCSVにあるこずです。

    耇数のCSVをJOINする必芁はありたせん。


    3.2 行の意味は、ディメンション列で刀定できる

    このCSVでは、各行の意味はディメンション列で刀定できたす。

    dInvoiceParty が入っおいる行
     └─ 売手又は買手などの圓事者行

    dDocumentReference が入っおいる行
     └─ 泚文曞番号又は玍品曞番号などの参照文曞行

    dPayment が入っおいる行
     └─ 支払条件行

    dTaxBreakdown が入っおいる行
     └─ 皎率別内蚳行

    dInvoiceLine が入っおいる行
     └─ 請求明现行

    たずえば、売手行は次の行です。

    1,1,,,,,,,,,,Seller,売手株匏䌚瀟,T1234567890123,,,,,,,,,,,,,,,,,

    この行では、`dInvoiceParty` に `1` が入り、`partyRole` に `Seller` が入っおいたす。したがっお、この行は「請求曞圓事者のうち、売手を衚す行」ず解釈できたす。

    買手行は次の行です。

    1,2,,,,,,,,,,Buyer,買手株匏䌚瀟,,,,,,,,,,,,,,,,,,

    この行では、`dInvoiceParty` に `2` が入り、`partyRole` に `Buyer` が入っおいたす。したがっお、この行は「請求曞圓事者のうち、買手を衚す行」ず解釈できたす。

    このように、構造化CSVでは、XMLの階局を盎接芋なくおも、行ず列の組合せで意味を刀定できたす。


    3.3 サンプルプログラムの実行

    ダりンロヌドしたZIPファむルを展開するず、次の3ファむルがありたす。

    • invoice.csv

    • bindings.csv

    • syntax_binding.py

    実行䟋は、次のずおりです。

    python3 syntax_binding.py \
      --input-csv invoice.csv \
      --bindings-csv bindings.csv \
      --xml-out invoice.xml \
      --roundtrip-csv roundtrip.csv \
      --print-xml

    Windows PowerShellで1行で実行する堎合は、次のようになりたす。

    python syntax_binding.py --input-csv invoice.csv --bindings-csv bindings.csv --xml-out invoice.xml --roundtrip-csv roundtrip.csv --print-xml

    この実行により、次の2぀のファむルが生成されたす。

    invoice.xml
     構造化CSVから生成した JP PINT UBL subset XML

    roundtrip.csv
     生成したXMLを読み戻しお再構成した構造化CSV

    ここで泚意すべき点がありたす。このサンプルプログラムは、JP PINT UBLの完党実装ではありたせん。

    目的は、次の考え方を確認するこずです。

    1. 構造化CSVを読む

    2. 構文結合衚CSVを読む

    3. SemanticPathでCSV偎の倀を取埗する

    4. XPathに埓っおXML芁玠を䜜る

    5. XMLに倀を蚭定する

    6. 逆方向ではXMLからCSV行を再構成する

    ぀たり、JP PINTの党項目を実装するこずではなく、構文結合衚に基づく汎甚倉換の考え方を実感するこずが目的です。


    3.4 構文結合衚で、プログラムから倉換仕様を远い出す

    サンプルでは、`bindings.csv` により、構造化CSV偎の SemanticPath ず、JP PINT UBL偎の XPath を察応付けおいたす。

    構文結合衚の䟋は、次のずおりです。

    semantic_path,xpath
    $.Invoice.invoiceNumber,/Invoice/cbc:ID
    $.Invoice.issueDate,/Invoice/cbc:IssueDate
    $.Invoice.invoiceTypeCode,/Invoice/cbc:InvoiceTypeCode
    $.Invoice.currencyCode,/Invoice/cbc:DocumentCurrencyCode
    $.Invoice.dInvoiceParty[?@.partyRole=Seller].partyName,/Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyName/cbc:Name
    $.Invoice.dInvoiceParty[?@.partyRole=Seller].partyTaxID,/Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
    $.Invoice.dInvoiceParty[?@.partyRole=Buyer].partyName,/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyName/cbc:Name
    $.Invoice.dInvoiceParty[?@.partyRole=Buyer].partyTaxID,/Invoice/cac:AccountingCustomerParty/cac:Party/cac:PartyTaxScheme/cbc:CompanyID
    $.Invoice.dDocumentReference[?@.referenceType=Order].referenceID,/Invoice/cac:OrderReference/cbc:ID
    $.Invoice.dDocumentReference[?@.referenceType=Delivery].referenceID,/Invoice/cac:DespatchDocumentReference/cbc:ID
    $.Invoice.paymentDueDate,/Invoice/cbc:DueDate
    $.Invoice.paymentReference,/Invoice/cac:PaymentMeans/cbc:PaymentID

    たずえば、売手名称は、構造化CSV偎では次の SemanticPath で指定したす。

    $.Invoice.dInvoiceParty[?@.partyRole=Seller].partyName

    これは、次の意味です。

    dInvoiceParty の行のうち、
    partyRole が Seller である行を遞択し、
    その行の partyName を取埗する。

    この倀を、JP PINT UBL偎の次のXPathに蚭定したす。

    /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyName/cbc:Name

    ここで重芁なのは、プログラムが「売手名称はこのXML芁玠に入れる」ず盎接知っおいるわけではないこずです。プログラムは、構文結合衚を読み、SemanticPathずXPathの察応に埓っお凊理したす。


    3.5 プログラム本䜓は、汎甚凊理に集䞭する

    埓来の倉換プログラムでは、倉換元項目ず倉換先項目をプログラム内に盎接曞き蟌むこずが倚くありたす。

    埓来型
    
    if CSVの列が partyName で role が Seller なら、
      /Invoice/cac:AccountingSupplierParty/.../cbc:Name に蚭定する

    この方匏では、倉換先の仕様が倉わるたびにプログラム修正が必芁になりたす。これに察しお、構文結合衚方匏では、プログラム本䜓は次の汎甚凊理に集䞭したす。

    構文結合衚方匏

    1. binding を1行読む

    2. semantic_path を評䟡しおCSVから倀を取る

    3. xpath に埓っおXML芁玠を䜜る

    4. 倀を蚭定する

    プログラム䞊は、抂念的には次のような凊理になりたす。

    for semantic_path, xpath in bindings:
        value = query_semantic_path(rows, semantic_path)
        set_text(invoice_xml, xpath, value)

    もちろん、実際にはXML名前空間、繰返し構造、金額属性、皎率別内蚳、明现行などの凊理が必芁です。しかし、基本的な考え方は、倉換仕様をプログラムの䞭ではなく、構文結合衚ずしお倖郚化するこずです。これにより、察応先ごずのプログラム開発や改蚂を枛らすこずができたす。

    構文結合衚では、XML文曞䞭の各芁玠を XPath で䞀意に指定し、それを構造化CSV䞊の察応する行又は項目に結び付けたす。XMLは階局構造を持ちたすが、XPathを䜿えば各芁玠の䜍眮を明確に衚せるため、構造化CSVずXML文曞の察応関係を機械的に定矩できたす。

    3.6 構造化CSVで、皎率別内蚳を怜蚌

    構造化CSVのメリットは、XMLに倉換できるこずだけではありたせん。

    請求曞ヘッダヌ、皎率別内蚳、請求明现が1枚のCSVに含たれおいるため、明现行の金額を皎区分・皎率別に集蚈し、請求曞に蚘茉された皎率別内蚳ず比范できたす。

    ここでは、次の蚘事で玹介した「5. 請求曞の構造化CSV」の怜蚌凊理を簡朔に敎理したす。
    『ペポル時代の囜内既存EDI連携ず日本版コアむンボむス構造化CSV』

    今回のサンプルでは、皎率別内蚳は `dTaxBreakdown` を持぀行ずしお蚘録され、請求明现は `dInvoiceLine` を持぀行ずしお蚘録されおいたす。

    したがっお、怜蚌凊理は次の流れになりたす。

    1. 構造化CSVを1枚読み蟌む

    2. dTaxBreakdown が空でない行を、
      皎率別内蚳ずしお抜出する

    3. dInvoiceLine が空でなく、
      lineID も空でない行を、
      請求明现ずしお抜出する

    4. 請求明现を、
      dInvoice、皎区分、皎率ごずに集蚈する

    5. 集蚈した明现合蚈 lineTotal ず、
      皎率別内蚳の taxableAmount を比范する

    6. lineTotal × taxRate / 100 で皎額を蚈算し、
      taxAmount が切捚お・切䞊げ・四捚五入の
      いずれかに䞀臎するか確認する

    今回のサンプルでは、明现行は次の3行です。

    1,,,,,1,,,,,,,,,,,,,,,,,,INV-26-861-1,商品A,S,10,10,EA,1000,10000
    1,,,,,2,,,,,,,,,,,,,,,,,,INV-26-861-2,商品B,S,10,4,EA,580,2320
    1,,,,,3,,,,,,,,,,,,,,,,,,INV-26-861-3,食品C,AA,8,7,EA,430,3010

    皎率別内蚳は、次の2行です。

    1,,,,1,,,,,,,,,,,,,,,S,10,12320,1232,,,,,,,,
    1,,,,1,,,,,,,,,,,,,,,AA,8,3010,240,,,,,,,,

    明现行を皎区分・皎率別に集蚈するず、次のようになりたす。

    S  10%
      商品A  10000
      商品B   2320
      合蚈   12320
    
    AA  8%
      食品C   3010
      合蚈    3010

    これは、皎率別内蚳の `taxableAmount` ず䞀臎したす。

    S   10%  taxableAmount 12320
    AA   8%  taxableAmount  3010

    次に、皎額を確認したす。

    S  10%
      lineTotal 12320 × 10% = 1232
      taxAmount = 1232
      OK
    
    AA  8%
      lineTotal 3010 × 8% = 240.8
      taxAmount = 240
      切捚おの堎合に䞀臎するため OK

    このように、構造化CSVであれば、明现行ず皎率別内蚳を別々のCSVからJOINしお埩元する必芁はありたせん。

    1枚のCSVから、`dInvoiceLine` を持぀行ず `dTaxBreakdown` を持぀行を抜出し、皎区分・皎率別に集蚈しお比范すればよいのです。

    実装䞊は、次のような凊理になりたす。

    line_total = (
        lines.groupby(
            ["dInvoice", "lineTaxCategoryCode", "lineTaxRate"],
            as_index=False
        )
        .agg(lineTotal=("lineExtensionAmount", "sum"))
        .rename(
            columns={
                "lineTaxCategoryCode": "taxCategoryCode",
                "lineTaxRate": "taxRate"
            }
        )
    )
    
    reported = tax_breakdown[
        ["dInvoice", "taxCategoryCode", "taxRate", "taxableAmount", "taxAmount"]
    ]
    
    check = line_total.merge(
        reported,
        on=["dInvoice", "taxCategoryCode", "taxRate"],
        how="outer"
    )

    ここで䜿っおいる `groupby().agg()` は、Pandas の暙準的な集蚈操䜜です。

    考え方は、Excel のピボットテヌブルや、SQL の `GROUP BY` に近いものです。

    今回の目的は、請求明现行を、請求曞単䜍、皎区分、皎率ごずにたずめ、その金額合蚈を求めるこずです。

    line_total = (
        lines.groupby(
            ["dInvoice", "lineTaxCategoryCode", "lineTaxRate"],
            as_index=False
        )
        .agg(lineTotal=("lineExtensionAmount", "sum"))
        .rename(
            columns={
                "lineTaxCategoryCode": "taxCategoryCode",
                "lineTaxRate": "taxRate"
            }
        )
    )

    たず、次の郚分で、請求明现 `lines` をグルヌプ化したす。

    lines.groupby(
        ["dInvoice", "lineTaxCategoryCode", "lineTaxRate"],
        as_index=False
    )

    グルヌプ化のキヌは、次の3぀です。

    dInvoice
      請求曞単䜍
    
    lineTaxCategoryCode
      明现行の皎区分
    
    lineTaxRate
      明现行の皎率

    今回のサンプルでは、明现行は次のように分かれたす。

    dInvoice = 1, lineTaxCategoryCode = S,  lineTaxRate = 10
      商品A  10000
      商品B   2320
    
    dInvoice = 1, lineTaxCategoryCode = AA, lineTaxRate = 8
      食品C   3010

    次に、`.agg()` で集蚈したす。

    .agg(lineTotal=("lineExtensionAmount", "sum"))

    これは、`lineExtensionAmount` 列を合蚈し、その結果を `lineTotal` ずいう列名で出力する、ずいう意味です。

    したがっお、集蚈結果は次のようになりたす。

    dInvoice  lineTaxCategoryCode  lineTaxRate  lineTotal
    1         S                    10           12320
    1         AA                   8            3010

    最埌に、`.rename()` で列名を倉曎しおいたす。

    .rename(
        columns={
            "lineTaxCategoryCode": "taxCategoryCode",
            "lineTaxRate": "taxRate"
        }
    )

    これは、明现行偎の列名を、皎率別内蚳偎の列名に合わせるためです。

    明现行では、皎区分ず皎率を次の列で持っおいたす。

    lineTaxCategoryCode
    lineTaxRate

    䞀方、皎率別内蚳では、次の列名です。

    taxCategoryCode
    taxRate

    このたたでは列名が異なるため、埌続の `merge()` で比范しにくくなりたす。

    そこで、明现行偎の集蚈結果の列名を、皎率別内蚳偎に合わせたす。

    lineTaxCategoryCode → taxCategoryCode
    lineTaxRate         → taxRate

    その結果、明现行の集蚈結果ず、皎率別内蚳を、次の共通キヌで結合できたす。

    dInvoice
    taxCategoryCode
    taxRate

    この結合凊理が、次の `merge()` です。

    check = line_total.merge(
        reported,
        on=["dInvoice", "taxCategoryCode", "taxRate"],
        how="outer"
    )

    `merge()` は、Pandas の衚結合操䜜です。ここでは、明现行から蚈算した集蚈結果 `line_total` ず、請求曞に蚘茉されおいる皎率別内蚳 `reported` を、同じ `dInvoice`、`taxCategoryCode`、`taxRate` の組合せで突き合わせおいたす。`how="outer"` ずしおいるのは、どちらか䞀方にしか存圚しない組合せも怜出するためです。たずえば、次のような䞍䞀臎を芋぀けるこずができたす。

    明现行には S 10% があるが、
    皎率別内蚳に S 10% がない
    
    皎率別内蚳には AA 8% があるが、
    明现行に AA 8% がない
    
    明现合蚈ず taxableAmount が䞀臎しない
    
    taxAmount が、
    lineTotal × taxRate / 100 の結果ず敎合しない

    この `check` に察しお、次の2぀を確認したす。

    taxableOK
      lineTotal ず taxableAmount が䞀臎しおいるこず
    
    taxOK
      taxAmount が、
      lineTotal × taxRate / 100 の
      切捚お・切䞊げ・四捚五入の
      いずれかに䞀臎しおいるこず

    ぀たり、刀定条件は次のように敎理できたす。

    OK = taxableOK か぀ taxOK

    XMLを盎接凊理する堎合、名前空間付きのXML芁玠をたどり、請求明现、皎区分、皎率、皎率別内蚳を取埗する必芁がありたす。

    構造化CSVでは、同じ怜蚌を、CSV行の抜出、グルヌプ化、集蚈、結合、比范ずしお蚘述できたす。

    構造化CSVを読む
     ↓
    dInvoiceLine 行を抜出する
     ↓
    groupby().agg() で皎区分・皎率別に集蚈する
     ↓
    dTaxBreakdown 行ず merge() で突き合わせる
     ↓
    taxableAmount ず taxAmount を怜蚌する

    この点が、䌚蚈、皎務、監査、システム運甚の芳点で倧きなメリットです。

    4 効果既存EDI・䌚蚈・皎務・監査ぞ広げる

    4.1 既存EDIを眮き換えるのではなく、぀なぐ

    ここで重芁なのは、日本版コアむンボむスが既存EDIを眮き換えるものではない、ずいう点です。流通BMSには、受発泚、出荷、受領、返品、怜収など、流通業務に根ざした圹割がありたす。䞭小䌁業共通EDIには、䞭小䌁業が倚様な取匕先ず電子的に受発泚等を行うための仕組みがありたす。業界EDIやWeb-EDIにも、それぞれの取匕慣行に合わせた圹割がありたす。

    したがっお、珟実的な方針は、既存EDIをすべお廃止しおJP PINTに眮き換えるこずではありたせん。

    むしろ、既存EDIを掻かしながら、請求曞、仕入明现曞、支払通知、消蟌参照などの領域で、ペポル/JP PINTず接続できるようにするこずです。

    圹割分担
    流通BMS
     受発泚、出荷、受領、返品、怜収等
    䞭小䌁業共通EDI
     䞭小䌁業間の受発泚、玍品、請求等
    ERP・販売管理
     受泚、売䞊、請求、入金、圚庫、埗意先管理
    䌚蚈
     仕蚳、債暩債務、消蟌、皎務、監査蚌跡
    JP PINT
     ペポル䞊で配送する電子むンボむス構文
    日本版コアむンボむス
     これらを請求曞ずしおの共通意味に察応付ける

    このように考えるず、日本版コアむンボむスは、既存EDIずペポルの橋枡しになりたす。

    4.2 監査・皎務・消蟌にも぀ながる

    日本版コアむンボむスずしお構造化CSVを定矩するこずには、もう䞀぀重芁な意味がありたす。

    請求曞は、単独で存圚しおいるわけではありたせん。

    泚文、玍品、怜収、請求、支払、入金、消蟌、仕蚳、皎務、監査蚌跡ず぀ながっおいたす。

    構造化CSVの䞭に、泚文番号、玍品曞番号、怜収番号、支払参照、取匕先ID、明现IDなどを保持できれば、請求曞を他の業務デヌタず関連付けるこずができたす。

    今回のサンプルCSVでも、泚文曞番号ず玍品曞番号が含たれおいたす。

    1,,1,,,,,,,,,,,,Order,PO-2026-0001,,,,,,,,,,,,,,,
    1,,2,,,,,,,,,,,,Delivery,DN-2026-0001,,,,,,,,,,,,,,,

    支払参照も含たれおいたす。

    1,,,1,,,,,,,,,,,,,2026-07-31,30,INV-2026-0001,,,,,,,,,,,,

    このような参照を保持するこずで、請求曞デヌタは、支払、入金消蟌、仕蚳、監査蚌跡ぞ接続できたす。

    ぀たり、日本版コアむンボむスは、単なる電子むンボむス亀換にずどたりたせん。将来的には、䌚蚈デヌタ、監査デヌタ、皎務報告、支払・消蟌デヌタずの連携基盀になりたす。


    4.3 このサンプルで実感しおほしいこず

    今回のサンプルプログラムで実感しおほしいこずは、次の点です。

    1. 構造化CSVは、普通のCSVずしお読める
      └─ invoice.csv を csv.DictReader で読める

    2. 1枚のCSVに請求曞党䜓を保持できる
      └─ ヘッダヌ、売手、買手、参照文曞、支払、皎内蚳、明现を栌玍できる

    3. 行の意味をディメンション列で刀定できる
      └─ dInvoiceParty、dTaxBreakdown、dInvoiceLine などを芋る

    4. SemanticPathでCSV偎の倀を指定できる
      └─ $.Invoice.dInvoiceParty[?@.partyRole=Seller].partyName

    5. XPathでJP PINT UBL偎の芁玠を指定できる
      └─ /Invoice/cac:AccountingSupplierParty/cac:Party/cac:PartyName/cbc:Name

    6. 構文結合衚を倖郚化できる
      └─ bindings.csv を倉曎するこずで察応関係を倉曎できる

    7. CSVからXMLを生成し、XMLからCSVぞ戻せる
      └─ invoice.xml ず roundtrip.csv を生成できる

    今回のサンプルプログラムは、囜内既存EDIずペポルを぀なぐずきに必芁ずなる、基本的な蚭蚈思想を瀺しおいたす。


    たずめ

    本皿の䞻匵は、次のずおりです。

    ペポルは、日本党囜を始めずしお党䞖界ず぀ながるための盞互接続ネットワヌクです。盞手のペポルIDが分かれば、どのプロバむダ又はアクセスポむント経由でメッセヌゞを届けられるかを発芋できたす。

    䞀方、日本囜内の既存EDIの倚くは、プロバむダが発行するIDを䜿う3コヌナヌモデルを前提ずしおいたす。他のプロバむダず連携する堎合には、盞手先プロバむダに登録されたIDずのマッピング、ファむル圢匏の倉換、個別運甚調敎が必芁になりたす。

    この3+1の「+1」を盞手ごずに䜜り続けるず、n+∞ のように維持管理が膚らみたす。そこで、+1 の察応先を、日本版コアむンボむス構造化CSVに固定したす。

    さらに、プロバむダが、囜内EDI利甚者IDずペポルIDずの倉換を提䟛すれば、囜内の異なるEDIプロバむダ間でも、本来の意味で、どこか䞀぀のプロバむダに぀ながっおさえいれば、囜内のどのプロバむダの利甚者ずもメッセヌゞ亀換が可胜な䞖界に近づきたす。

    構文結合の仕組みを採甚すれば、察応先ごずのプログラム開発や改蚂を、できるだけ結合衚の定矩倉曎に移すこずができたす。その結果、システムの維持管理は容易になりたす。

    今回のサンプルプログラムは、その考え方を実感するためのものです。ぜひ `syntax_binding_revised_package.zip` をダりンロヌドし、`invoice.csv`、`bindings.csv`、`syntax_binding.py` を確認しおください。

    構造化CSVが、単なるCSVではなく、既存EDI、ERP、䌚蚈、JP PINT、ペポルを぀なぐ日本版コアむンボむスずしお機胜するこずを、実際のプログラム凊理ずしお確認できたす。

    この連茉に぀いお

    第1回 なぜ今、構造化CSVが必芁なのか
    https://note.com/pont_soleil/n/n851330bcc027
    電子垳簿保存法ずAI時代が求める暙準デヌタ圢匏
    電子垳簿保存法ぞの察応、゜フト曎新埌の過去デヌタ確認、そしおAIによる倧量デヌタ凊理を螏たえ、なぜ「意味を保ったたた保存・亀換・再利甚できるデヌタ圢匏」が必芁なのかを敎理したす。

    第2回 構造化CSVずは䜕か
    https://note.com/pont_soleil/n/n308fd640cdd2
    1枚のCSVで階局構造を衚す考え方
    通垞のCSVや、ヘッダヌ衚・明现衚・皎衚に分かれた正芏化CSVず䜕が違うのかを敎理し、構造化CSVの基本的な考え方を具䜓䟋で説明したす。

    第2回 远加情報 OpenAI の倧芏暡蚀語モデルを基盀ずしたコヌディング・デヌタ分析支揎゚ヌゞェント Codex による仕蚳デヌタ怜査
    https://note.com/pont_soleil/n/n63699199aeb5
    構造化CSVで敎理した仕蚳デヌタを、OpenAI の Codex がどの皋床読み取り、怜査や分析に掻甚できるかを詊した蚘事です。AI時代における構造化CSVの実甚性を補足的に瀺したす。

    第3回 日本版コアむンボむスずしおの構造化CSV
    https://note.com/pont_soleil/n/n77810ca32953
    既存EDIずペポルの橋枡し
    構造化CSVを、日本版コアむンボむスずしお䜍眮づけ、既存EDI、業界EDI、ERP、䌚蚈、ペポル/JP PINT を぀なぐ共通デヌタ圢匏ずしお考えたす。

    第4回 構文結合衚で倉換を倖出しする
    https://note.com/pont_soleil/n/nf39f0cf81df7
    意味の察応関係ず構文の察応関係を分けお定矩する考え方
    デヌタ項目の意味ず、XMLやCSVなど個別構文ぞの察応を分けお定矩するこずで、倉換をプログラムに埋め蟌たず、柔軟に管理する方法を説明したす。

    第5回 構文結合衚で実珟する構造化CSVず JP PINT UBL の盞互倉換Python
    https://note.com/pont_soleil/n/ndca04f96d1fc
    構造化CSV、構文結合衚、Pythonプログラムを甚いお、構造化CSVず JP PINT UBL の盞互倉換を行う具䜓䟋を玹介したす。

    第6回 構造化CSVは䜕を倉えるのかhttps://note.com/pont_soleil/n/n1c00252ce0cb
    保存、亀換、監査、AI掻甚を぀なぐ基盀ぞ
    構造化CSVが、単なる亀換圢匏ではなく、長期保存、業務連携、監査、分析、AI掻甚を支える共通基盀になり埗るこずを敎理したす。

    第7回 XBRL GL ず XBRL GL Next
    https://note.com/pont_soleil/n/na110d4600fa8
    構造化CSVを支える囜際暙準の流れ
    XBRL GL が担っおきた圹割ず、xBRL-CSV を採甚する XBRL GL Next の怜蚎状況を通じお、構造化CSVの囜際的な䜍眮づけを瀺したす。

     
     
    2026幎は、監査デヌタ、デゞタルむンボむス、XBRL GL Next を軞に、日本版コアむンボむス、汎甚亀換噚、Ledger Explorer の実装像を具䜓化する幎にしたいず考えおいたす。