Amazon SP-API 接続：注文取込と履行実績の返送

Seller Central で Seller ID・LWA 認証情報・refresh token を取得し、AWS IAM 署名キーを用意して、8 項目すべてを Integration に入力、テスト・マッピング・有効化。

Amazon SP-API コネクタは Amazon 注文を OMS に取り込み、履行実績・商品・在庫を Amazon に返送します。返品の取得も可能です。出品者配送（MFN）注文向けです。1 接続で 1 販売アカウント・1 マーケットプレイスをカバーします。

前提条件#

• Seller Central にアクセスできる Amazon 販売アカウントで、MFN 注文を扱っていること。
• Seller Central でアプリ開発とアプリ認可ができる権限（Apps & Services → Develop apps）。
• IAM を使える AWS アカウント。アクセスキーを作成し、署名用の SP-API IAM ポリシーを付与できること。
• 店舗のマーケットプレイスを確認。Marketplace ID はそのサイトと一致が必要（米国：ATVPDKIKX0DER）。

認証情報の取得#

1. ステップ 1 — Seller ID：Seller Central の Settings → Account info で Merchant token をコピー。これが Seller ID で、A で始まります。
2. ステップ 1 — アプリ認証情報：Seller Central の Apps & Services → Develop apps でアプリを開き、LWA Client Identifier（amzn1.application-oa2-client. で始まる）と LWA Client secret をコピー。
3. ステップ 1 — Refresh token：販売アカウントでアプリを認可し、受け取った refresh token をコピー。長期トークンで、Atzr| で始まります。

1. ステップ 2 — AWS アクセスキー：AWS コンソールで IAM → Security credentials を開き、アクセスキーを作成。ID は AKIA で始まります。
2. ステップ 2 — シークレットキー：同じページで AWS secret access key をコピー。一度だけ表示されます。
3. ステップ 2 — IAM ポリシー：キーの IAM ユーザー／ロールに SP-API の IAM ポリシーが付与されていることを確認。ない場合、署名できても Amazon が 403 を返します。
4. ステップ 2 — Role ARN（任意）：クロスアカウント IAM ロールで署名する場合はその role ARN を控える。アクセスキーで直接署名する場合は不要。

Integration への入力#

1. Integration → コネクタマーケットプレイス → Amazon SP-API → 新規接続。
2. Seller ID（Merchant token）— 必須：Seller Central → Settings → Account info の Merchant token。A で始まります。
3. Marketplace ID — 必須：店舗サイトの ID。米国は ATVPDKIKX0DER。その他のサイトは Amazon SP-API ドキュメントを確認。
4. LWA Client ID — 必須：Seller Central → Apps & Services → Develop apps の LWA Client Identifier。amzn1.application-oa2-client. で始まります。
5. LWA Client secret — 必須：同じ Develop apps ページの secret。暗号化保存、再表示なし。
6. Refresh token — 必須：アプリ認可時に受け取った長期リフレッシュトークン。Atzr| で始まります。
7. AWS access key ID — 必須：SigV4 署名に使う IAM アクセスキー ID。AKIA で始まります。
8. AWS secret access key — 必須：そのアクセスキーと対の secret。IAM → Security credentials でコピー。一度だけ表示されました。
9. IAM role ARN — 任意：クロスアカウント IAM ロールの ARN。入力すると署名前に STS AssumeRole で一時認証情報に交換。空欄の場合はアクセスキーで直接署名。

接続テスト#

テストは 2 段階：接続性（LWA 認可と SigV4 署名）と伝票レベルのプレビュー（実注文 1 件）。注文がない場合は先に Amazon でテスト注文を作成。失敗時は正確なエラーを控え、下の FAQ で確認。

Mapping / テンプレート選択#

Amazon SP-API 標準テンプレートを選択。MFN 注文の注文番号・行 SKU・数量・配送先・履行ステータスをマッピングします。有効化前に実注文でプレビューを確認、特に SKU の対応付けをチェック。

有効化#

有効化後、設定した頻度で新規 MFN 注文と返品を取得し、追跡付き履行実績と商品・在庫更新を Amazon に返送。最初は Runs / Logs で数件確認。

よくある質問#

テストが 403 で失敗する

原因：多くの場合、署名の問題です。AWS アクセスキーまたは secret が間違っているか、キーの IAM ユーザー／ロールに SP-API の IAM ポリシーが付与されておらず、Amazon が署名済みリクエストを拒否します。

対処法：IAM → Security credentials から AWS access key ID（AKIA で始まる）と secret を再コピーし、IAM で SP-API ポリシーがそのユーザー／ロールに付与されていることを確認。role ARN を入力した場合は、そのロールが存在し AssumeRole できることを確認して再テスト。

Refresh token が拒否される、または認可が未完了

原因：refresh token が LWA Client ID と secret に対応していないか、販売アカウントに対するアプリ認可が完了しておらず、Amazon がトークンをアクセスに交換できません。

対処法：Seller Central → Apps & Services → Develop apps で販売アカウントへのアプリ認可を完了し、新しい refresh token（Atzr| で始まる）をコピー。LWA Client ID と secret が同じアプリのものか確認し、3 点をまとめて貼り直して再テスト。

別サイトの注文が入る、または注文が全く入らない

原因：Marketplace ID が店舗の実際の販売サイトと一致していません。接続テストは通っても、Amazon が返すのは指定したマーケットプレイスの注文だけです。

対処法：店舗のサイトを確認し、そのサイトの Marketplace ID を入力。米国は ATVPDKIKX0DER、その他は Amazon SP-API ドキュメントで確認。保存後に手動取得を実行し、注文が入ることを確認。

Seller ID が受け付けられない

原因：入力値が Merchant token ではありません。例えば店舗名・メールアドレス・別のアカウント ID など。Amazon が Seller ID として期待するのはアカウント情報の Merchant token です。

対処法：Seller Central の Settings → Account info で Merchant token を表示どおりにコピー（A で始まる）し、Seller ID として貼り付けて再テスト。