AWS B2B Data Interchange

解決する課題

• 取引先と交換する **EDI 文書（X12 など）**を、社内システムが扱いやすい JSON に変換したい
• EDI のパース・変換ロジックを自前で実装・運用するのが負担で、専用ミドルウェアの保守も避けたい
• 取引先から届いたファイルの取り込み・変換・下流連携を一連の流れとして自動化したい
• EDI 連携を **AWS のデータ基盤（S3 やイベント駆動の処理）**へ素直につなぎ込みたい

主要概念と用語

• EDI（電子データ交換）: 受発注・出荷・請求などの商取引文書を、企業間で定型フォーマットでやり取りする仕組み
• トランザクションセット: EDI 規格で定義される文書種別。受発注や請求書などが番号で識別される
• 取引先（トレーディングパートナー）: 文書を交換する相手企業を表す設定。プロファイルと能力を関連付ける
• プロファイル: 自社や取引先の識別情報をまとめた設定
• トランスフォーマー: 入力 EDI を解釈し、出力フォーマット（JSON など）へ変換する定義
• 機能（ケーパビリティ）: 入力元と出力先、トランスフォーマーを結びつけ、文書処理の流れを定義する単位
• 入力 / 出力ロケーション: 取り込み元と書き出し先。一般に Amazon S3 を用いる

仕様・制限・クォータ

• 主に X12 などの EDI 規格を入力として扱い、変換結果は JSON などの構造化データとして出力する
• 入出力は Amazon S3 を中心に連携し、処理の起動はファイル到着を契機にできる
• 取引先数・トランスフォーマー数・ファイルサイズなどにサービスクォータがあり、必要に応じて引き上げ申請が可能
• 対応する規格バージョンやトランザクションセット、上限値などの具体的な数値は更新され得るため、最新の公式ドキュメントで確認する

内部の仕組み

B2B Data Interchange は、ユーザーが定義した**機能（ケーパビリティ）**に従って動作します。取引先から届いた EDI ファイルが入力ロケーション（一般に S3）に到着すると、サービスはそれを取り込み、トランスフォーマーで EDI 構造を解釈して JSON などの出力フォーマットへ変換し、出力ロケーションへ書き出します。

構成は 取引先・プロファイル・トランスフォーマー・機能といった要素に分かれ、識別情報や変換ルールを再利用できる形で管理します。EDI 特有のパースやマッピングはサービス側が肩代わりするため、利用者は専用のパーサを実装する必要がありません。変換後の JSON は、後続の Lambda・Step Functions・データ基盤などイベント駆動の処理へ素直につなげられます。

設計パターン / ベストプラクティス

• 取引先から届いた EDI を S3 に集約し、変換した JSON を分析基盤やアプリケーションの入力にする
• 変換結果の出力を契機に イベント駆動（S3 イベントや EventBridge）で後続処理を起動する
• 取引先ごとにプロファイルとトランスフォーマーを整理し、設定を散らさず再利用する
• 取り込みに失敗したファイルは隔離用の保管場所へ退避し、再処理できるようにする
• 取引先の追加・変更が見込まれる場合は、機能の構成を疎結合に保ち変更を局所化する

運用・監視

• 各機能の処理結果で、取り込み・変換の成功 / 失敗や対象ファイルを確認する
• 実行イベントは CloudWatch や CloudTrail と連携して監視・監査できる
• 失敗時は EDI の規格不一致・必須項目の欠落・トランスフォーマーの定義ずれを確認する
• S3 の入出力先の権限設定が正しいか、取り込みが滞っていないかを点検する

コスト

• 課金は主に処理した文書（トランザクション）の量に基づく考え方になる
• EDI 専用ミドルウェアの導入・保守や、自作パーサの運用と比べ、運用負荷を含めた総コストで評価する
• 不要なファイルを取り込み対象に含めないよう、入力先の構成を整理して処理量の増加を抑える
• 具体的な料金は変動するため、見積もりは公式の料金ページで確認する

セキュリティ

• 入出力に用いる Amazon S3 側で保存時の暗号化（KMS など）を構成できる
• サービスや取引先設定へのアクセスは IAM で制御し、最小権限で運用する
• 取引先ごとの識別情報をプロファイルとして整理し、設定の取り違えを防ぐ
• 入力 / 出力バケットのバケットポリシーを見直し、想定外の読み書きを防ぐ

関連サービス・比較

EDI のファイル授受そのものは AWS Transfer Family（SFTP などのファイル転送）が担い、B2B Data Interchange は受け取った EDI の変換を担当します。両者は組み合わせて使うことが多く、役割が異なります。

ハンズオン / CLI例

# 定義済みのトランスフォーマー一覧を確認する
aws b2bi list-transformers

# 取引先（パートナーシップ）の一覧を確認する
aws b2bi list-partnerships

# サンプルの EDI 入力に対しトランスフォーマーの変換結果を試す
aws b2bi test-mapping \
  --input-file-content file://sample-edi.txt \
  --mapping-template "$(cat mapping.json)" \
  --file-format JSON