Connection の作成：一般的な流れ
最終更新 2026-10-25
すべてのコネクタで共通する 5 ステップ：マーケットプレイスで選択、接続に名前を付ける、認証情報を入力、テスト、Mapping と有効化。キーがまだない場合はシミュレーションモードで全フローを先に確認できます。
Connection（接続）は、特定の外部システム 1 つへの設定済みリンクです：Shopify ストア 1 つ、UPS アカウント 1 つ、ERP 会社 1 つ。各コネクタのガイドとディレクトリにプラットフォームごとの正確なフィールドがあり、本記事は共通の流れを説明します。
始める前に#
- 相手プラットフォームのアカウントと管理者（または開発者）アクセス。大半の認証情報は管理者／開発者ページの奥にあります。
- コネクタディレクトリ（本セクションの 3 部）で対象コネクタのフィールド一覧を確認しておくと、集めるものが正確にわかります。
- 初回接続では、プラットフォームがテスト／サンドボックス用認証情報を提供する場合はそちらを優先してください。本番データで Mapping を練習しないこと。
ステップ 1–2：コネクタの選択と接続名#
- Integration → コネクタマーケットプレイスを開き、カテゴリで絞り込み、対象コネクタのカード → 新規接続。
- 後でチームが見てわかる名前を付けます（例：「Shopify — 米国メイン店」「UPS — 本番アカウント」）。1 プラットフォームに複数接続（2 店舗、テスト＋本番）を作れ、名前で区別します。
ステップ 3：認証情報の入力#
- ウィザードに表示されるのは、そのコネクタに必要なフィールドだけです（コネクタレジストリ由来、ディレクトリの一覧と同一）。必須フィールドには印があり、隠れた追加フィールドはありません。
- 各フィールドには、その値が相手プラットフォームのどこにあるかを示すヘルプがあります。完全な手順はディレクトリの該当項目を参照。
- シークレット（キー、トークン、パスワード）は暗号化保存され、保存後に全文が再表示されることはありません（マスクプレビューのみ）。間違えたら新しいものを貼り直してください。古いものは「表示」できません。
- 登録フィールド一覧がないコネクタ（稀）では、ウィザードは汎用 key-value エディタ＋シークレット入力にフォールバックします。キー名はプラットフォームのドキュメント表記どおりに入力してください。
ステップ 4：接続テスト#
テストは 2 段階です：接続性（認証情報が使えるか）と、伝票系コネクタでは伝票レベルのプレビュー（実伝票 1 件を取得し、プラットフォームフィールド → 標準フィールドを左右対照表示）。失敗時はどちらの段階か分かります：401 は認証情報、プレビューの不一致は Mapping の問題です。何度でも再テストでき、テストでどちら側のデータも変わりません。
実認証情報がまだなくても、接続を作成してキーを空欄にすればシミュレーションモードで動作します。ウィザード・Mapping・Flow がサンプルデータで動き、すべてシミュレーションと明示されます。本物のキーが届いたら、同じ接続を編集して貼り、再テストしてください。
テスト記録の保管場所：診断ログ
接続テストを行うたびに、接続の詳細ページにステップごとの記録が残ります。配送業者については、行の展開式診断欄に表示されます。テストが失敗したら開いてください。実行順に「どのステップで止まったか、なぜ止まったか」が示され、認証情報の問題か Mapping の問題かを推測なしで判別できます。ログに残るのはステップと結果のみで、シークレットそのものは保存されず、使用したキー名だけが記録されます。まだテストしていない場合は、その旨が明示されます。1 回テストすれば、記録がここに表示されます。
ステップ 5：Mapping と有効化#
- コネクタのプリセット Mapping テンプレートを選び、伝票プレビューをもう一度確認します。特に SKU、数量、住所、依存しているカスタムフィールドを確認。
- 製品を紐付けます：OMS 製品と一致しないチャネル SKU は製品マッピングの保留リストに入ります。そこで紐付けてください。未対応のまま注文が入ると未マッピング行が発生します。
- 有効化します。以後は設定したスケジュールで同期し、すべての実行が Integration → 実行モニターとログに表示されます。最初の数件は確認してから無人運用してください。
その後の接続管理#
- 表示と編集はそれぞれ専用ページです。Integration → 接続で接続をクリックすると詳細ページが開き、ステータス、同期設定、設定の概要、利用している Flow を一か所で確認できます。編集（名前、同期内容、頻度、認証情報）は接続の編集ページで行い、保存すると詳細ページに戻ります。
- 認証情報の編集：接続を開いて新しいシークレットを貼ります。キーのローテーションやトークン期限切れの際に必要です。編集後はすぐテストしてください。
- チャネルを止める時は削除ではなく無効化してください。無効化した接続は Mapping と履歴を保持し、ワンクリックで再有効化できます。削除すると設定が失われます。
- 意味がある場合は重複も可能です（同一プラットフォームの 2 店舗、テスト用 1 つ＋本番用 1 つ）。Flow は使う接続を明示的に選ぶため、テスト接続が誤って本番化することはありません。