B2BGateway 接続：EDI で注文を取り込み、出荷と請求を送信

最終更新 2026-11-01

B2BGateway のアカウントチームに Base URL を確認し、B2BGateway アカウントから API Key をコピーして、両方を Integration に入力、テスト、各取引先の Mapping、有効化を行います。注文メッセージが入り、出荷・請求メッセージが出ていきます。

B2BGateway コネクタは B2BGateway 経由で取引先と EDI ドキュメントを交換します。取引先からの購買注文メッセージを取り込んで注文にし、出荷と請求のメッセージを同じ取引先に返送します。ストア接続ではありません。すべて取引先ごと・ドキュメントタイプごとに整理されるため、各取引先を個別に設定し確認します。

B2BGateway 接続手順：認証情報、テスト、取引先 Mapping、有効化。

前提条件#

B2BGateway アカウント。Base URL は自分で調べる公開アドレスではなく、B2BGateway のアカウントチームがお客様のアカウント用に提供します。
その B2BGateway アカウントの API Key を取得できること、または提供できる担当者がいること。この Key はすべてのリクエストで X-API-Key ヘッダーとして送信されます。
B2BGateway 経由でドキュメントを交換する取引先が少なくとも 1 社あること。この接続が取引先を作成するわけではありません。メッセージが流れるには、取引先側の交換関係が先に存在する必要があります。
最初の接続では、まず 1 社のテストメッセージで設定を検証してください。本番の取引先ドキュメントで新しい Mapping を試さないでください。

認証情報の取得#

B2BGateway のアカウントチームに、お客様のアカウント用の API Base URL を確認し、渡されたとおり正確にコピーしてください。https:// で始まります。アドレスが不完全に見える場合は、残りを推測せず、チームに確認してください。
B2BGateway アカウントから API Key を取得してください。アカウント内で見つからない場合は、B2BGateway のアカウントチームに、アカウントのどこに表示されるか確認してください。別のアカウントの Key を流用しないでください。
2 つの値を一緒に保管してください。Base URL は接続先を示し、API Key はお客様のアカウントであることを証明します。次の手順で両方が必要です。

Integration への入力#

Integration → コネクタマーケットプレイス → B2BGateway → 新規接続。
Base URL（必須）：アカウントチームから提供された B2BGateway API のベース URL を貼り付けてください。例：https://… アドレス全体を正確にコピーしてください。1 文字の不足、余分なスペース、別のアカウントのアドレスのいずれでも、API Key が正しくても次の手順のテストは失敗します。
API Key（必須）：B2BGateway アカウントの API Key を貼り付けてください。接続が B2BGateway と通信する際、X-API-Key ヘッダーとして送信されます。シークレットとして暗号化保存され、保存後に再表示されることはありません。
接続を保存しますが、まだ有効化しないでください。まずテストし、次に取引先の Mapping を行ってください。認証情報が正しくてもパートナーの Mapping がなければ、ドキュメントは 1 件も動きません。

接続テスト#

接続テストをクリック。テストは入力した Base URL に接続し、API Key を X-API-Key ヘッダーとして提示するため、アドレスと Key を一緒に確認します。通過すれば、B2BGateway が応答し、お客様のアカウントの Key を受け入れたということです。次に、取引先からの実際の注文メッセージ 1 件でドキュメントレベルのプレビューを実行し、本番化の前に取引先のフィールドと標準注文の対照を確認してください。まだテストメッセージを送った取引先がない場合は、取引先、または B2BGateway のアカウントチームに先に 1 件送ってもらってください。プレビューには実際のメッセージが必要です。テスト自体が失敗した場合は、下の FAQ を使ってください。両方を同時に変更する前に、Base URL と API Key のどちらに問題があるか切り分けてください。

Mapping / テンプレート選択#

B2BGateway の Mapping は接続全体で 1 つの設定ではなく、取引先ごとに設定します。取引先ごとにその取引先のテンプレートを選び、交換するドキュメントタイプを確認してください。注文メッセージは入方向、出荷と請求のメッセージは出方向です。プレビューで、取引先の識別子、品目番号、数量、配送先情報が標準注文の正しいフィールドに入ること、そして出荷・請求データがその取引先の期待するフィールドに変換されて戻ることを確認してください。取引先同士で Mapping は共有されません。Mapping が完了した取引先は本番化でき、別の取引先は設定中のままでも構いません。新規の取引先は、最初の本番ドキュメントの前に必ず自社分の Mapping 確認が必要です。

B2BGateway のドキュメント往復（取引先ごと）：注文メッセージを取り込み、出荷・請求メッセージを送信。

有効化#

有効化後、Mapping 済みの取引先からの注文メッセージが注文として流入し、それらの注文が出荷されると、出荷と請求のメッセージが B2BGateway 経由で取引先に返送されます。各取引先の最初のドキュメントを Runs / Logs で確認してください。まだ Mapping していない取引先はドキュメントを交換しません。そのため、無人で任せる前に、取引先ごとに最初の注文、最初の出荷、最初の請求を個別に確認してください。

よくある質問#

テスト失敗：API Key が拒否される

接続に入力した API Key が、B2BGateway アカウントの Key と一致していません。この Key は X-API-Key ヘッダーとして送信されるため、1 文字の誤りや不足、貼り付け時の末尾スペース、別の B2BGateway アカウントの Key のいずれでも、B2BGateway からは同じに見えます。お客様の Key ではありません。

B2BGateway アカウントから API Key を再取得してください。見つからない場合は、アカウントチームにアカウントのどこに表示されるか確認してください。前後に余分な文字が入らないよう API Key フィールドに貼り付け、保存して再テストしてください。どちらの修正が効いたか分かるよう、Base URL は同時に変更しないでください。

テスト失敗：B2BGateway に接続できない

接続に入力した Base URL が誤っているため、リクエストがお客様のアカウント用の正しい B2BGateway アドレスに届きません。アドレスを手入力した、短縮された、別のアカウントからコピーした、といった場合によくある原因です。API Key が完璧でもテストは通りません。

B2BGateway のアカウントチームに、お客様のアカウント用の正確な API Base URL を確認してもらい、Base URL フィールドをそのアドレス全体のコピーに置き換えてください。https:// で始まり、何も追加・削除しないでください。保存して再テストしてください。

テストは通るが、ある取引先のドキュメントが流れない

その取引先の Mapping がまだ設定されていないか、完了していません。接続テストはアドレスと API Key が正しいことだけを証明します。ドキュメントは取引先ごとに流れるため、Mapping が完了していない取引先は、注文メッセージを変換する手段も、出荷・請求メッセージを送る経路もありません。同じ接続の他の取引先が正常でも同様です。

その取引先の Mapping 手順を開き、取引先のテンプレートを選び、交換するドキュメントタイプ（注文は入方向、出荷と請求は出方向）をマッピングして、その取引先の実際のメッセージ 1 件でドキュメントプレビューを実行してください。プレビューですべてのフィールドが正しい場所に入った後にのみ、その取引先の交換を有効化し、最初の本番ドキュメントを Runs / Logs で確認してください。