EDI 管理：EDI 接続とパートナー設定
最終更新 2026-10-22
小売業者を EDI プラットフォーム経由で1つのウィザードで接続し、ドキュメントをノーコードでマッピング、すべての送信を平易な言葉で追えます。
EDI 管理は Integration → EDI の下にあり、連携する4つのページがあります：接続（1行 = 1小売業者 + 1プラットフォームアカウント）、マッピング（ドキュメント種別ごとの変換方法）、コード表（マッピングが参照する参照リスト）、送信ログ（送受信したすべてのドキュメント）。すべてのプラットフォームで同じウィザード、同じ詳細ビュー、同じマッピングツール、同じ平易なエラー形式を使い、プラットフォームごとの特例はありません。有効化できるドキュメント種別には、850 発注書、855 発注確認、856 出荷通知、940 / 945 倉庫出荷ドキュメント、846 在庫通知、947 在庫調整、943 / 944 在庫移動ドキュメント、810 請求書、210 運賃請求書、204 積荷入札、214 輸送ステータスが含まれます。
ステップ1：接続ウィザードを開き、プラットフォームを選ぶ#
- Integration → EDI → 接続（/integration/edi/connections）を開き、「+ 新規接続」をクリックします。すべてのプラットフォームで同じ5ステップのウィザードが開きます：1 プラットフォーム → 2 認証情報 → 3 接続テスト → 4 マッピング / テンプレート → 5 サンプルプレビュー。
- EDI プラットフォーム（コネクタ）を選び、接続名と小売業者コード（例：WALMART）を入力します。コードは直接入力します。Docklify 全体で同じ小売業者コードを使います。
- この接続で使うドキュメント種別にチェックします。インバウンドは小売業者 → Docklify、アウトバウンドは Docklify → 小売業者の意味です。有効化した種別ごとに、ステップ4でマッピングを紐付けます。
- 設定中はテストモードとサンプルモードをオンのままにします。実ドキュメントが流れる前に、サンプルドキュメントで接続の作成、テスト、プレビューができます。
ステップ2：認証情報を入力し、失敗アラートを設定する#
- 認証情報フォームはプラットフォーム自身の項目リストから生成されます。そのプラットフォームが本当に必要な項目だけが表示されます。機密項目はパスワード入力で、入力後に再表示されることはありません。
- 失敗アラートも同じステップで設定します：連続失敗 N 回でアラート（既定3）、連続失敗 N 回で自動停止（既定10）。壊れた接続がいつまでも失敗し続けて相手プラットフォームを叩き続けることがありません。
- 通知方法：アプリ内通知は既定でオン、メール通知は既定でオフです。この小売業者を担当するチームが Docklify に常駐していない場合は、メール通知をオンにしてください。
ステップ3：接続をテストする#
- 「作成して接続テスト」をクリックします。Docklify が接続を作成してすぐにテストを実行します。通過すれば「接続テスト成功」と遅延が表示され、失敗した場合は平易な言葉で（何が起きたか、次に何をするか）表示されます。スタックトレースは表示されません。
- テストでサンプルドキュメントが取得できた場合、ウィザードに表示され、マッピングチェックが実行されます。問題がリストされたら、ステップ4 / マッピングツールで修正し、再テストしてから接続を有効化してください。
ステップ4：マッピングを紐付ける、またはテンプレートを複製する#
- 有効化したドキュメント種別ごとに、既存のマッピングを紐付けるか、テンプレートライブラリからテンプレートを複製します。完了をクリックすると、複製したテンプレートがこの接続の実マッピングになります。
- 「未紐付け」のまま完了することもできますが、Integration → EDI → マッピングで紐付けるまで、その種別の送信は失敗します。実ドキュメントが来る前に紐付けてください。
ステップ5：サンプルプレビューを実行して完了する#
- プレビューするドキュメント種別を選び、サンプルドキュメント（JSON）をサンプル欄に貼り付けます。
- 「プレビュー実行」をクリックします。マッピングされた各項目について、ターゲット、ソース値、適用された関数チェーン、出力値が返り、失敗した場合は平易な言葉で理由も表示されます。
- 全項目が通過したら完了をクリックします。失敗した項目がある場合は、マッピングツールでマッピングを修正してプレビューを再実行してください。失敗したプレビューのまま完了しないでください。
日常運用：リストと詳細で接続を管理する#
- リストには接続ごとに、プラットフォーム、小売業者、有効なドキュメント種別、モード（テスト / サンプルがオンの場合はバッジ）、ステータスが表示されます。行の操作はテスト、詳細、削除です。接続を削除すると認証情報も一緒に削除されます。
- 接続のスイッチで、何も削除せずに一時停止・再開できます。小売業者からしばらく送信を止めるよう頼まれたときに使います。
- 詳細を開くと接続ドロワーが表示されます：ヘルス（過去24時間）には成功率と連続失敗回数があり、状態は正常、異常（アラート閾値に到達）、停止中のいずれかです。アラート / 自動停止の設定、前回の接続テスト、再試行とリプレイのボタン付きの最近の送信も見えます。
マッピング：コードを書かずにドキュメントを変換する#
- Integration → EDI → マッピング（/integration/edi/mappings）を開きます。「+ 新規マッピング」から始めるか、テンプレートライブラリのタブを開いて、プラットフォームとドキュメント種別に合うテンプレートを複製します。
- エディタでマッピングに名前を付け、ドキュメント種別と方向を選び、行を組み立てます：ソース項目をクリックまたは行へドラッグし、ターゲット（Canonical）項目を設定し、関数を連結します。定数、コード表の参照、任意の条件も使えます。その行が正しい値を出すまで調整します。
- エディタでサンプルを使ってテストし、有効化します。必須項目が未マッピングの間は有効化がブロックされ、エディタが不足している項目を正確にリストします。
- 保存するたびに新しいバージョンが作られます。バージョン履歴では、2つのバージョンを並べて比較（追加 / 削除 / 変更された行）したり、ロールバックしたりできます。ロールバックするとそのバージョンがエディタで開くので、他の変更と同じく、有効化前にテストします。
コード表：マッピングが参照する参照リスト#
- Integration → EDI → コード表（/integration/edi/code-tables）を開き、「+ 新規コード表」をクリックします。名前は小文字スネークケース（例：upc_to_sku、uom_map、carrier_map）で付け、分かりやすいラベルも付けます。
- エントリはシンプルなペアで編集します：From（小売業者が送る値）→ To（Docklify が使う値）、それに任意の備考。典型的な表は、小売業者の ship-to コード、計量単位、運送業者コードを変換します。運用担当がここで保守でき、コードは不要です。
- 重複する From 値は赤く表示されます。保存前に修正してください。1つの From は1つの To にしか対応できません。長いリストには CSV インポート（from,to,note の形式で1行1件貼り付け、重複はスキップ）や CSV エクスポート（表のダウンロード）を使います。
- コード表を保存すると新しいバージョンが作られます。マッピングは「表 + バージョン」を参照するため、ここで表を編集しても、有効化済みのマッピングが勝手に変わることはありません。
送信ログ：すべてのドキュメントを追い、失敗を直す#
- Integration → EDI → 送信ログ（/integration/edi/transmissions）を開きます。ステータス、ドキュメント種別、方向で絞り込むか、業務番号 / 外部IDで検索します。ステータスは平易です：受信済み、マッピング済み、完了、失敗、重複、デッド、ACK待ち。
- 送信の詳細を開くと、受信したままの生ドキュメントと、マッピング後の Canonical 形式を、ステータスと ACK と並べて確認できます。パートナーから「ドキュメントがおかしい」と言われたら、まずこのペアを確認します。
- エラーは人向けに書かれています：タイトル、何が起きたか、次に何をするか。再試行できるエラーの行には「再試行可」のバッジと再試行ボタンが付きます。再試行しても直らないエラー（認証失敗、マッピングエラー）にはボタンが表示されません。先に認証情報やマッピングを直し、リプレイで元の生ドキュメントを再実行してください（失敗とデッドの送信で利用可能）。
この記事で使った Docklify 機能#
- EDI 接続5ステップウィザード：プラットフォーム、認証情報、テスト、マッピング / テンプレート、サンプルプレビュー — Integration → EDI → 接続 → + 新規接続（/integration/edi/connections）
- 接続詳細：24時間のヘルス、連続失敗回数、アラート / 自動停止の設定、最近の送信 — Integration → EDI → 接続 → 詳細
- ノーコードのマッピングエディタ：テンプレートライブラリ、サンプルテスト、バージョン履歴、比較、ロールバック — Integration → EDI → マッピング（/integration/edi/mappings）
- バージョン管理付きコード表：重複チェック、CSV インポート / エクスポート — Integration → EDI → コード表（/integration/edi/code-tables）
- 送信ログ：平易な言葉のエラー、再試行とリプレイ — Integration → EDI → 送信ログ（/integration/edi/transmissions）