Etsy 接続：注文取込と履行実績の返送

最終更新 2026-11-01

Etsy ショップ管理 URL で数字の Shop ID を確認し、Etsy Developers で API キーをコピー、OAuth アクセストークンとともに Integration に入力、テスト・マッピング・有効化。

Etsy コネクタは Etsy ショップの注文を OMS に取り込み、履行実績を Etsy に返送します。商品・在庫の送信も可能で、出品・在庫・出荷を両側で同期できます。

Etsy 接続手順：まず Shop ID と認証情報、次にテスト、Mapping、有効化。

前提条件#

Etsy ショップ、管理 URL を確認できるショップ管理画面へのアクセス。
Etsy Developers → Your apps へのアクセス。そこにアプリの API キー（KEYSTRING）が表示されます。
そのショップの OAuth 認可フローを完了できること。アクセストークンはフロー完了後にのみ取得できます。

認証情報の取得#

Shop ID の確認：Etsy ショップ管理画面を開き、管理 URL を確認。Shop ID はその URL 内の数字 ID で、例は 12345678。数字のみをコピーし、ショップ名はコピーしないこと。
API キーのコピー：Etsy Developers → Your apps → アプリの API キー（KEYSTRING）をコピー。安全に保管し、Integration の API key フィールドに貼り付けます。
OAuth アクセストークンの取得：ショップの OAuth 認可フローを完了し、フロー後に取得したアクセストークンをコピー。Integration の OAuth access token フィールドに貼り付けます。

Integration への入力#

Integration → コネクタマーケットプレイス → Etsy → 新規接続。
Shop ID：Etsy ショップ管理 URL の数字 ID を入力、例 12345678。ショップ名は入力しないこと。このフィールドは数字のみです。
API key、必須：Etsy Developers → Your apps でコピーした API キー（KEYSTRING）を貼付。暗号化保存、再表示なし。
OAuth access token：OAuth 認可フロー後に取得したアクセストークンを貼付。上の Shop ID と同じショップのものにすること。別ショップのトークンは一致しません。

接続テスト#

接続テストをクリック。Shop ID、API キー、OAuth アクセストークンをまとめて確認し、実注文 1 件で伝票レベルのプレビューを表示して、プラットフォーム項目と標準注文を並べて確認できます。ショップにまだ注文がない場合は、先に Etsy でテスト注文を作成してください。プレビューには実伝票が必要です。失敗した場合はエラーを控え、他を変更する前に下の FAQ を確認してください。

Mapping / テンプレート選択#

Etsy 標準テンプレートを選択。注文番号、明細 SKU、数量、配送先、履行ステータスをマッピングします。有効化前に実注文 1 件でマッピングプレビューを確認し、特に各 Etsy SKU が OMS 製品に紐付いているか確認してください。注文・商品・在庫が両側で一致します。

Etsy 注文の往復：注文を取り込み、履行実績・商品・在庫を返送。

有効化#

有効化後、設定した頻度で新規注文を取得し、追跡番号付き履行実績を Etsy に返送、商品・在庫の変更を Etsy に送信します。最初は Runs / Logs で数件確認してから無人運用してください。

よくある質問#

テスト失敗：ショップが見つからない

Shop ID が間違っています。多くは数字 ID の代わりにショップ名を入力したため、実在する Shop ID と一致しません。

Etsy ショップ管理画面を開き、管理 URL の数字 ID（例 12345678）を確認し、Shop ID フィールドをその数字のみに置き換えて再テストしてください。

テストが API 認証情報エラーで失敗

API キーがアプリと一致していません。コピーが不完全、余分なスペース入り、または Etsy Developers の別アプリのキーであるため、Etsy が呼び出しを拒否しています。

Etsy Developers → Your apps に移動し、正しいアプリの API キー（KEYSTRING）を表示どおり再コピーし、余分なスペースなしで API key フィールドに貼り付けて再テストしてください。

認可の有効期限切れ

OAuth アクセストークンが無効になっています。その認可が期限切れのため、そのトークンが必要な呼び出しは、ショップが再認可されるまで拒否されます。

同じショップで OAuth 認可フローを再度完了し、フロー後に取得した新しいアクセストークンをコピーして OAuth access token フィールドを置き換え、再テストしてください。

接続済みだが注文が取り込めない

接続自体は正常です。取得範囲内にショップの新規注文がないだけです。

Etsy ショップでテスト注文を作成し、時刻が取得範囲内か確認、手動取得を実行してプレビューまたは Runs / Logs に表示されるか確認してください。