Skip to main content
ORCA
MES
JP

Shopify連携

GraphQL Admin APIで最新注文1件を確認するための準備手順です。

必要に応じてORCAチームが連携をサポートします。

必要なaccount・権限

  1. Shopify storeとapp開発・install権限を持つowner/admin accountが必要です。
  2. Client Credentialsではappと対象storeが同じShopify organizationに必要です。
  3. 注文取得には最低限read_orders scopeが必要です。

Dev DashboardでAPI appを作成

  1. Dev Dashboard → AppsでCreate app → Start from Dev Dashboardを選択します。
  2. Versionsでapp URLと最新Webhooks API versionを設定します。
  3. Access scopesに最低read_ordersを追加してReleaseします。
  4. VersionをReleaseした後、Home → Install appから対象storeを選択し、権限を承認してinstallします。完了前はORCAでapp_not_installedになります。
  5. SettingsからClient IDとClient Secretをコピーし、ORCA販売チャネルmodalへ貼り付けます。

Version作成画面の入力値

  1. App URL: ORCA連携では全ユーザーがhttps://shopify.dev/apps/default-app-homeを入力します。store固有のURLではありません。
  2. 独自のShopify app画面を開発・公開した場合のみ、自分のHTTPS app URLを使用します。通常のORCA連携には該当しません。
  3. Shopify adminへのembed: 選択解除します。
  4. Preferences URL: 空欄にします。
  5. Webhooks API version: 2026-07を選択します。
  6. API access scopes: read_ordersを追加します。
  7. Optional scopes、redirect URL、app proxyは空欄にします。
  8. Legacy install flow、POSは選択しません。
  9. 設定後にReleaseします。

ORCAでtokenを発行・接続確認

  1. Dev DashboardのSettingsでClient IDとClient Secretをコピーします。
  2. ORCA → 連携管理 → 販売チャネル管理 → 新しい販売チャネル追加を開き、Shopifyを選択します。
  3. チャネル名とcanonical myshopify.com Store URLを入力します。チャネル名はORCA表示用のためStore subdomainと同じでなくても構いませんが、Store URLは正確に入力します。
  4. API認証ステップでClient IDとClient Secretを貼り付けます。入力欄のコピーボタンでも再コピーでき、接続testを実行します。Platformがtokenを発行し、公式API接続を確認します。
  5. 注文収集設定と品目マッピングを確認し、最終test成功後に連携を完了します。Client Secretは暗号化保存され、token原文は表示されません。
ORCA販売チャネル追加modalの1ステップ。Shopify選択済みでチャネル名とmyshopify.com Store URLを入力した画面ORCA販売チャネル追加modalの2ステップAPI認証。接続test成功後の画面

Shopify公式参考文書

  1. Shopify APIs, libraries, and tools ↗
  2. Create apps using the Dev Dashboard ↗
  3. GraphQL Admin API 2026-07 ↗

ORCAへ登録

  1. ORCA → 連携管理 → 販売チャネル管理を開きます。
  2. 新しい販売チャネル追加でShopifyを選択し、チャネル名とmyshopify.com Store URLを入力します。
  3. API認証でClient IDとClient Secretを入力し、接続testを成功させます。
  4. 注文収集設定と品目マッピングを確認し、最終test後に連携を完了します。

ORCA Sales Channel Management →

注文収集状況

  1. 販売チャネル保存後、連携管理 → 注文収集状況を開きます。
  2. 最新の収集testで取得した1件の注文番号、販売チャネル、注文日時、商品名、収集日時、収集状態を確認します。
  3. Shopify注文番号がgid://shopify/Order/…形式の場合、ORCAは数字IDのみ表示します。元のGIDは注文番号にマウスを置くと確認できます。
  4. チャネル・状態で絞り込み、注文番号・商品名で検索できます。
ORCA注文収集状況。Shopifyから収集した注文番号、注文日時、商品名、収集日時と収集成功状態を表示した画面

セキュリティ

  1. Client Secretを文書、chat、shell history、logに残しません。
  2. 必要最小限のscopeのみ付与します。
  3. PlatformはClient Secretを暗号化し、tokenを自動再発行します。ORCAはsecretやtoken原文を表示しません。
  4. app_not_installedの場合、Dev Dashboardのapp Home → Install appから入力したStoreにinstallし、権限を承認して再testします。
  5. shop_not_permittedの場合、appとStoreが同じShopify organizationにあり、appがStoreへinstall済みか確認します。

Shopify公式認証文書 ↗