Shopify 接続：注文取込と履行実績の返送
最終更新 2026-11-01
Shopify 管理画面でカスタムアプリを作成し、Admin API トークンを Integration に貼り、テスト・マッピング・有効化。
Shopify コネクタは注文を OMS に取り込み、在庫と履行実績を Shopify に返送します。ストアごとに 1 接続。
前提条件#
- 任意プランの Shopify ストア、管理者アクセス。
- そのストアでカスタムアプリを作成する権限。
- 最初の接続はテストストア / 開発ストアで検証。本番ストアで Mapping を試さないこと。
認証情報の取得——新モデル（推奨）#
- Shopify Dev Dashboard（dev.shopify.com）→ アプリ → API 認証情報。
- Client ID と Client Secret をコピー。Secret は一度だけ表示されるので安全に保管。
- アプリに必要な API スコープがあることを確認：read_orders、read_products、read_inventory、write_inventory、read_fulfillments、write_fulfillments。
認証情報の取得——旧モデル（カスタムアプリのトークン）#
- Shopify 管理画面：Settings → Apps → Develop apps → Create an app。
- Admin API integration で必要なスコープを付与：read_orders、read_products、read_inventory、write_inventory、read_fulfillments、write_fulfillments。
- アプリをインストールし、Admin API access token をコピー（shpat_ で始まる）。
Admin API トークンは一度だけ表示。紛失したらアプリを再インストールして新規取得（旧トークンは無効化）。
新トークンモデル（Dev Dashboard アプリ）：Shopify は永続的な shpat_ トークンを発行しなくなりました。Client ID＋Client Secret を入力してください（Dev Dashboard → アプリ → API 認証情報）。システムが自動で 24 時間アクセストークンに交換し、バックグラウンドで更新します。shpat_ トークン保存済みの既存接続はそのまま動作します。
Integration への入力#
- Integration → コネクタマーケットプレイス → Shopify → 新規接続。
- ストアドメイン：your-store.myshopify.com など。
- 認証情報：2 つのモデルのどちらかを選択。新モデル（推奨）：Dev Dashboard → アプリ → API 認証情報の Client ID＋Client Secret。システムが自動で 24 時間トークンに交換・更新。旧モデル：カスタムアプリの Admin API access token（shpat_）。どちらも暗号化保存、再表示なし。
接続テスト#
テストは 2 段階：接続性と伝票レベルのプレビュー（実注文 1 件）。注文がない場合は先にテスト注文を作成。
Mapping / テンプレート選択#
Shopify 標準テンプレートを選択。バンドルやカスタム行属性がある場合は有効化前にプレビューで確認。
有効化#
有効化後、設定した頻度で注文を取得し、在庫変更を返送、追跡番号付きの履行実績を報告。最初は Runs / Logs で数件確認。
よくある質問#
テストが 401 で失敗する
トークンの誤り・期限切れ・スコープ不足のいずれかです。
アプリを再インストールしてトークンをコピーし直し、認証情報の手順のスコープを確認してください。
注文が取り込まれない
接続は正常で、ストアに新しい注文がないだけです。
ストアでテスト注文を作成し、手動で取得を実行してください。
SKU が未マッピングと表示される
チャネル SKU が OMS の製品にまだ紐付いていません。
製品マッピングの保留タブを開き、各チャネル SKU を OMS 製品に紐付けてください。