Amazon FBA 接続:FBA 在庫のみ同期
Amazon SP-API とは別の接続で、認証情報は同じものを使います。同じ 8 項目を Integration に入力し、テスト・SKU 対応付けの確認・有効化。入ってくるのは FBA 在庫だけです。
これは Amazon SP-API 接続とは別の 2 つ目の接続です。販売アカウントと認証情報は同じで、役割が異なります。Amazon FBA 接続は、Amazon が保管・発送を代行する在庫(FBA 在庫)を在庫ビューに同期するだけです。注文の取込も履行実績の送信も行いません。注文と出荷は Amazon SP-API 接続の担当です。その接続が既にある場合、新しい認証情報は不要です。同じ Seller ID・LWA ペア・refresh token・AWS キーをここでも使ってください。
前提条件#
- Seller Central にアクセスできる Amazon 販売アカウントで、FBA(Fulfillment by Amazon)に在庫を納品済みであること。
- 必須条件:SP-API アプリに Amazon Fulfillment ロールの認可が必要です。このロールがないと FBA 在庫の呼び出しは拒否されます。最も多い失敗点なので、入力を始める前にロールを確認してください。
- Amazon SP-API 接続と同じ認証情報:Seller ID、Marketplace ID、LWA Client ID と secret、refresh token、SigV4 署名用の AWS アクセスキーペア。Amazon SP-API 接続が既にあればこのセットは揃っています。そのまま再利用してください。
- FBA 在庫のマーケットプレイスを確認。Marketplace ID はそのサイトと一致が必要(米国:ATVPDKIKX0DER)。
認証情報の取得#
- Seller ID:Seller Central の Settings → Account info で Merchant token をコピー。これが Seller ID で、A で始まります。
- Fulfillment ロール:Seller Central で SP-API アプリ(Apps & Services → Develop apps)を開き、Amazon Fulfillment ロールの認可があることを確認。ロールがない場合は今追加して認可してください。これがないと FBA 在庫は読めません。
- LWA 認証情報:同じアプリページで LWA Client ID(amzn1.application-oa2-client. で始まる)と LWA Client Secret をコピー。
- Refresh token:販売アカウントでアプリを認可(Seller Central → Apps & Services → Authorize)し、受け取った refresh token をコピー。Atzr| で始まります。
- AWS キー:AWS コンソール(IAM)で SigV4 署名用のアクセスキーペアを作成またはコピー。アクセスキー ID(AKIA で始まる)とその secret access key です。
- Role ARN(任意):STS AssumeRole で IAM ロールを使って署名する場合のみ、そのロールの ARN(arn:aws:iam::…:role/…)を控えます。アクセスキーペアで直接署名する場合は不要です。
Integration への入力#
- Integration → コネクタマーケットプレイス → Amazon FBA → 新規接続。
- Seller ID(Merchant token)— 必須:Seller Central → Settings → Account info の Merchant token。A で始まります。
- Marketplace ID — 必須:FBA 在庫が属するサイトの ID。米国は ATVPDKIKX0DER。その他のサイトは Amazon SP-API ドキュメントを確認。
- LWA Client ID — 必須:SP-API アプリの LWA Client ID。Seller Central → Apps & Services → Develop apps でコピー。amzn1.application-oa2-client. で始まります。
- LWA Client Secret — 必須:その Client ID と対の secret。同じアプリページでコピー。シークレットとして保存され、再表示されません。
- Refresh Token — 必須:販売アカウントでアプリを認可した際に得た refresh token。Atzr| で始まります。
- AWS Access Key ID — 必須:SigV4 署名に使うアクセスキー ID。AKIA で始まります。
- AWS Secret Access Key — 必須:そのアクセスキーと対の secret。シークレットとして保存され、再表示されません。
- IAM Role ARN (optional) — 任意:署名が STS AssumeRole の IAM ロール経由の場合のみ入力(例:arn:aws:iam::123456789012:role/…)。アクセスキーペアで直接署名する場合は空欄のまま。通常は空欄です。
接続テスト#
テスト結果はよく読んでください。「成功」には 2 種類あります。認証情報が未入力の場合、テストはシミュレーション在庫(固定のサンプル SKU の小さなセット)で実行され、シミュレーションとしての成功が返ります。これは画面が動くことの確認にすぎず、Amazon に接続できた証明にはなりません。認証情報を入力した場合、テストは refresh token をアクセスに交換し、リクエストに署名して、Amazon に対してマーケットプレイス参加状況を実際に確認します。シミュレーション表記のない成功だけが本当の接続です。有効化の前に必ず認証情報を入力して再テストしてください。
Mapping / テンプレート選択#
この接続に注文の Mapping はありません。ここでの Mapping は在庫だけの話です。FBA 在庫は販売 SKU で対応付けます。FBA 在庫サマリーの各 Amazon SKU を、在庫製品の中で同じ SKU を持つ製品に紐付け、その FBA 数量が共有在庫ビューのその製品に反映されます。有効化前に Mapping プレビューを確認してください。製品に紐付いていない Amazon SKU は数量の反映先がありません。まずそれらの SKU を正しい製品に紐付けてください。片側だけで SKU 名を変更すると、次の同期で対応付けが壊れます。
有効化#
有効化後、Integration は設定した頻度で FBA 在庫サマリーを同期し、共有在庫ビューの FBA 数量を最新に保ちます。在庫の可視化や補充リマインダーに、Amazon が保管している分も含まれます。それ以外は何も変わりません。FBA 注文の取込も履行実績の送信もなく、その通信は Amazon SP-API 接続のままです。最初の数回の同期を Runs / Logs で確認し、いくつかの SKU を Seller Central と照合してから数値を信頼してください。
よくある質問#
FBA 在庫の呼び出しが拒否される — アプリに Amazon Fulfillment ロールがない
原因:この接続で最も多い失敗です。認証情報自体は完全に有効で、同じセットが Amazon SP-API 接続では問題なく使える場合でも、SP-API アプリに Amazon Fulfillment ロールの認可がなければ、Amazon は FBA 在庫の読み取りを拒否します。
対処法:Seller Central で SP-API アプリ(Apps & Services → Develop apps)を開き、Amazon Fulfillment ロールを追加して、販売アカウントに対する認可を完了してください。認可で新しい refresh token が発行された場合は、この接続にも新しいトークンを貼り直してください。その後、再テストします。
テストは成功したのに、実際の FBA 在庫が表示されない
原因:表示された成功はシミュレーションのものです。認証情報が未入力の場合、テストはシミュレーション在庫(固定のサンプル SKU の小さなセット)で実行され、Amazon には一切接続せずに成功を返すため、実際の在庫が続いて表示されることはありません。
対処法:認証情報の全項目(Seller ID から AWS Secret Access Key まで)を入力し、保存して再テストしてください。実際の認証情報を使い、シミュレーション表記のない成功だけが、Amazon に実際に接続できたことを意味します。その後有効化し、Runs / Logs で最初の同期を確認してください。
一部の SKU で数量が同期されない
原因:FBA 在庫は販売 SKU で反映されます。Amazon SKU が在庫製品の製品に紐付いていない場合、または SKU が片側だけで改名された場合、その数量は反映先の製品がなく、スキップされます。
対処法:Mapping プレビューを開き、未紐付けの Amazon SKU を見つけて、それぞれ正しい製品に紐付けてください。その後は両側で SKU 名を同一に保ち、再同期して数量が反映されることを確認してください。
別のマーケットプレイスの在庫が同期される
原因:入力した Marketplace ID が、FBA 在庫が実際に属するサイトと一致していません。接続テストは通っても、Amazon が返すのは指定したマーケットプレイスの FBA 在庫だけです。
対処法:FBA 在庫のサイトを確認し、そのサイトの Marketplace ID を入力。米国は ATVPDKIKX0DER、その他は Amazon SP-API ドキュメントで確認。保存後に同期を実行し、正しい在庫が入ることを確認してください。