マルチロケーション在庫統合ガイド

複数のロケーションのインベントリをAPIやオペレーションと統合して、ロケーションレベルのデータを顧客に提供します。

出品者は複数のロケーションの在庫を使用して、データおよびフルフィルメント機能に関するロケーションレベルのデータをAmazonに提供できます。このロケーションレベルのデータを販売者の出荷元ロケーションデータと組み合わせることで、購入者が確認できる正確な情報が生成されます。複数のロケーションに在庫があると、出品者のスピードと信頼性が向上し、サービスにかかるコストが下がるため、出品商品が顧客にとってより魅力的なものになり、MFN(最恵国待遇)の売り上げが促進され、出品者の利益が増加します。このガイドでは、複数店舗の在庫をうまく統合するために必須となるAPIと運用について、出品パートナーにアドバイスします。

🚧

現在、次の条件に当てはまる出品者様は、複数店舗在庫をご利用いただけません。

  • FBA 在庫を使用する
  • セラーセントラルで在庫を管理

前提条件

出品用アカウントには、マルチロケーション在庫の使用に必要な権限が必要です。アカウントにマルチロケーション在庫権限がない場合は、以下からアクセスをリクエストできます。 マルチロケーション在庫登録フォーム。15 営業日以内にアカウントの準備が整ったことを示す確認メールが届きます。

必要な権限を取得すると、Amazonはデフォルトの場所を供給元として追加します。テンプレートを使用して追加のロケーションを作成し、配送設定オートメーション (SSA) で許可されている場合、これらのロケーションも供給元として追加されます。

出品用アカウントの設定を完了するには:

  1. サプライソースAPIまたはセラーセントラルUIを使用して、新しいサプライソースを作成するか、既存のサプライソースを更新します。
  2. API を使用して場所固有のインベントリを提供します。
  3. SSA で許可されている既存のテンプレートを作成または特定します。
  4. 手順3で作成または特定した配送テンプレートを、在庫を追加したSKUに割り当てます。ロケーションごとにこれを行います。
  5. を設定 DEFAULT インベントリチャネルへ 0
  6. を追加してください セリング・パートナー・インサイトの役割 開発者プロフィールへ。

マルチロケーションの在庫統合に必須の API

販売パートナーは以下を統合する必要があります サプライソース API、ザ・ リスティングアイテム API、そして フィード API マルチロケーションのインベントリを使用する。

セラーセントラルでSSAが許可する複数ロケーションの在庫配送テンプレートを作成

SSAで許可されている複数ロケーションの在庫配送テンプレートを作成する方法については、を参照してください。 配送設定の自動化

サプライソース API の統合

Supply Sources APIでマルチロケーション在庫プログラムを使用する方法については、以下を参照してください。 サプライソース API ユースケースガイド

出品商品APIの統合

出品者はListings Items APIを使用して、供給元で利用可能な在庫数を置き換えることができます。出品商品APIは以下を受け付けます。 PATCH 既存のリストの 1 つまたは複数の個別の属性を更新および削除するオペレーション (例: price そして quantity

🚧

注意

を設定する必要があります DEFAULT チャネルトー 0。の設定に失敗 DEFAULT チャネルトー 0 結果として、2 つの出品商品が表示されます。1 つは複数の店舗の在庫出品で、もう 1 つは複数の店舗にまたがる在庫商品です。この問題は出品者の購入可能性には影響しませんが、複数拠点以外の在庫出品では、在庫と配送スケジュールが不正確になる場合があります。

複数店舗の在庫を使用して在庫を更新する

を使う PATCH エンドポイントでの操作 /listings/2021-08-01/items/{sellerId}/{sku}?marketplaceIds={marketplaceIds}&issueLocale={issueLocale}そして、次のパラメータを渡します。

パスのパラメーター

パラメーター説明必須
sellerId販売パートナー識別子 (MCID) やベンダーコードなどの販売パートナー識別子。はい
sku出品者IDに固有の出品商品のSKU識別子。はい
marketplaceIdsリクエストのマーケットプレイスIDのコンマ区切りリスト。はい
issueLocale理由テキストのローカリゼーション用のロケール。指定しない場合は、最初のマーケットプレイスのデフォルト言語コードが使用されます。例:en_USfr_CAfr_FR。指定されたロケールでローカリゼーションが利用できない場合、ローカライズされたメッセージのデフォルトは en_USとなります。いいえ

ヘッダーパラメーター

名前Value
Acceptsapplication/json
Content-Typeapplication/json
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "StoreID1234567", "quantity": 10 } ] } ] }

❗️

警告

設定する必要があります Product Type そして Path 次のとおり:

  • Product TypePRODUCT
  • Path/attributes/fulfillment_availability

これらの値を設定しないと、次のような結果になる可能性があります。

  • エラーまたは警告応答

  • 無視されたり、Amazon システムの意図した部分に届かなかったりする可能性のあるデータ。これにより、関連する出品情報の更新や在庫状況に影響が及ぶ可能性があります。

  • デフォルト設定によるデータの上書きやマーケットプレイス固有の操作の問題など、予期しないAPIの動作

{ "sku": "SKUID1234567", "status": "ACCEPTED", "submissionId": "f1dc2914-75dd-11ea-bc55-0242ac130003", "issues": [] }
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "ISPU01", "quantity": 10 }, { "fulfillment_channel_code": "ISPU02", "quantity": 10 } ] } ] }
{ "header": { "sellerId": "{merchantId}", "version": "2.0", "issueLocale": "en_US" }, "messages": [ { "messageId": 1, "sku": "My-SKU-01", "operationType": "PATCH", "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "ISPU01", "quantity": 10 }, { "fulfillment_channel_code": "ISPU02", "quantity": 10 } ] } ] }, { "messageId": 2, "sku": "My-SKU-02", "operationType": "PATCH", "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillment_channel_code": "ISPU01", "quantity": 10 }, { "fulfillment_channel_code": "ISPU02", "quantity": 10 } ] } ] } ] }

出品商品APIを使用して在庫を表示する

出品者はListings Items APIを使用して、供給元で入手可能な在庫数を確認できます。を呼び出します。 getListingsItem リスト項目の詳細を返すオペレーション。

を使う GET エンドポイントでの操作 /listings/2021-08-01/items/{sellerId}/{sku}?marketplaceIds={marketplaceIds}&issueLocale={issueLocale} &includedData=issues,attributes,summaries,offers,fulfillmentAvailability そして、以下のパラメーターを渡します。

パスのパラメーター

名前説明必須
sellerId販売パートナー識別子 (MCID) やベンダーコードなどの販売パートナー識別子。はい
sku出品商品に固有のSKU識別子 sellerIdはい

クエリーパラメーター

名前説明必須
marketplaceIdsリクエストのマーケットプレイスIDのコンマ区切りリスト。はい
issueLocale理由テキストのローカリゼーション用のロケール。指定しない場合は、最初のマーケットプレイスのデフォルト言語コードが使用されます。例:en_USfr_CAfr_FR。指定されたロケールでローカリゼーションが利用できない場合、ローカライズされたメッセージのデフォルトは en_USとなります。オプション
includedDataリクエストのマーケットプレイスIDのコンマ区切りリスト。

タイプ:配列 (CSV)
いいえ

成功時のレスポンスには、 Fulfillment Availability サプライソース ID を返す配列属性 (fulfillmentChannelCode) と残りの在庫数 (quantity)。

個々のSKUに在庫を割り当てる

  1. を使用してください GET デフォルトロケーションの個々の SKU の数量を調べるオペレーション。この例では以下を使用しています。 ssnm001 SKU (数量が 3 単一電源で。
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{ "sku": "ssnm001", "fulfillmentAvailability": [ { "fulfillmentChannelCode": "DEFAULT", "quantity": 3 } ] }
  1. を使う PATCH 操作と設定 fulfillmentChannelCodeDEFAULT そして quantity0
PATCH: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{ "productType": "PRODUCT", "patches": [ { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 5 }, { "fulfillmentchannelCode": "DEFAULT", "quantity": 0 } ] } ] }
{ "sku": "ssnm001", "status": "ACCEPTED", "submissionId": "680b16163093417da2edfd77a7edc38f", "issues": [] }
  1. を使用してください getListingsItem 変更を送信して詳細を取得する操作 fulfillmentAvailability
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm001?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{ "sku": "ssnm001", "fulfilmentAvailability": [ { "fulfillmentchannelCode": "DEFAULT", "quantity": 9 }, { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 5 } ] }

応答により、SKU が次のとおりであることが確認されます。 ssnm001 そして、その在庫は2つの供給元から統合されています。 Store A そして Store B

セラーセントラルで数量が更新されていることを確認します。

  1. 1) セラーセントラルのアカウントにログインします。
  2. 左上隅にあるハンバーガーメニューを選択します。
  3. 選択 Inventory そして選択してください Manage All Inventory
  4. SKU番号と関連する供給元を確認してください。

注文履行フィードを通じて、販売パートナーが使用している供給元IDを取得します

ザの 注文処理フィード 購入者に請求し、出品用アカウントに入金し、注文が発送されたことを購入者に通知するよう Amazon に指示します。

このフィードは、販売パートナーが使用するサプライソースIDを提供します。この情報を取得するには、注文履行フィードを使用する必要があります。 XML スキーマ

注文処理フィードで複数の注文を確認する

を使用して注文または注文グループを確認するには POST_ORDER_FULFILLMENT_DATA フィードタイプ。必ず含めてください CarrierCodeShippingMethod、および ShipperTrackingNumber XML スキーマ内。を統合できます POST_ORDER_FULFILLMENT_DATA 出品者が出荷した注文を確認するためのフィードタイプ。

XML のサンプル

<?xml version="1.0" encoding="utf-8"?> <AmazonEnvelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <Header> <DocumentVersion>1.01</DocumentVersion> <MerchantIdentifier>MerchantID</MerchantIdentifier> </Header> <MessageType>OrderFulfillment</MessageType> <Message> <MessageID>1</MessageID> <OrderFulfillment> <AmazonOrderID>7XX-XXXXXXX-XXXXXXX</AmazonOrderID> <FulfillmentDate>2023-01-01T01:01:01+00:00</FulfillmentDate> <FulfillmentData> <CarrierCode>USPS</CarrierCode> <ShippingMethod>USPS First Class Mail</ShippingMethod> <ShipperTrackingNumber>1234567891011121314</ShipperTrackingNumber> </FulfillmentData> </OrderFulfillment> </Message> </AmazonEnvelope>

セラーセントラルのUIには、新しい配送業者が定期的に追加されます。もし CarrierCode 使用したい配送業者の金額が、にマッピングされていません amzn-base XSD ファイル、使って CarrierCode の値 Other に配送業者の名前を入力してください CarrierName フィールド。この方法を使用する場合、Amazon は荷物の配送の更新情報を追跡できませんのでご注意ください。

必要な情報を含む XML を作成したら、以下を使用できます。 POST_ORDER_FULFILLMENT_DATA 注文が発送されたことを購入者に通知するよう Amazon に求めるフィードタイプ。

一括更新を行う

フィード API は一括更新を行うことができます。それぞれに複数のフルフィルメント更新が含まれる 2 つの SKU を含むフィードの例については、以下を参照してください。 リスティングフィード API

複数のSKUに在庫を割り当てる

  1. 2つのSKUを含むフィード文書を作成し、両方を2つの供給元に割り当てます。この例では以下を使用しています。 ssnm001 そして ssnm002 SKU。
POST: {{baseUrl}}/feeds/2021-06-30/documents
{ "contentType": "application/json; charset=UTF-8" }
{ "feedDocumentId": "amzn1.tortuga.4.na.116e0ef0-ae4e-4430-9c13-249cd489c9a.T20RL98XXLBHV9", "url": "https://tortuga-prod-na.s3-external-1.amazonaws.com/&2FNinetyDays/amzn1.tortuga.4.na.116e0ef0-ae4e-4430-9c13-249cd48f9c9a.T20RL98XXLBHV9?X" }
  1. すべてのSKUに1つのJSONをアップロードし、各供給元の在庫レベルを調整します。
PUT: {{FeedUrl}} { "header": { "sellerId": "A1PP0FEH11RW77", "version": "2.0" }, "messages": [ { "messageId": 1, "sku": "ssnm002", "operationType": "PATCH", "patches": { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 7 }, { "fulfillmentchannelCode": "DEFAULT", "quantity": 0 } ] } }, { "messageId": 2, "sku": "ssnm001", "operationType": "PATCH", "patches": { "op": "replace", "path": "/attributes/fulfillment_availability", "value": [ { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 5 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 8 }, { "fulfillmentchannelCode": "DEFAULT", "quantity": 0 } ] } } ] }
  1. フィードを作成します。
POST: {{baseUrl}}/feeds/2021-06-30/feeds
var jsonData=JSON.parse(responseBody); postman.setEnvironmentVariable("feedId", jsonData. feedId);
{ "feedId": "50037019429" }
  1. GET フィード文書。
GET: {{baseUrl}}/feeds/2021-06-30/feeds/:feedId
{ "createdTime": "2023-03-12T21:23:02+00:00", "processingStatus": "DONE ", "marketplaceIds": ["ATVPDKIKX0DER"], "feedId": "50037019429", "feedType": "JSON_LISTINGS_FEED", "createdTime": "2023-03-12T21:23:02+00:00", "processingStartTime": "2023-03-12T21:23:02+00:00", "resultFeedDocumentId": "amzn1.tortuga.4.na.55£45d82-9068-4386-bbdd-9d0b7330c2e1.T3HAQ94M1R94U6" }
  1. 両方のSKUの数量を確認してください。
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm001?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{ "sku": "ssnm001", "fulfillmentAvailability": [ { "fulfillmentchannelCode": "DEFAULT", "quantity": 15 }, { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 5 } ] }
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerId}}/ssnm002?marketplacelds={{Marketplaceld}}&includedData=fulfillmentAvailability
{ "sku": "ssnm002", "fulfillmentAvailability": [ { "fulfillmentchannelCode": "DEFAULT", "quantity": 17 }, { "fulfillmentchannelCode": "353e4e48-6301-4d50-990e-43a86e8787a3", "quantity": 10 }, { "fulfillmentchannelCode": "8e07a0c9-ab0a-4108-9f16-83dc3496bee0", "quantity": 7 } ] }
  1. セラーセントラルで在庫数量が更新されていることを確認するには:

    1. 1) セラーセントラルのアカウントにログインします。
    2. 左上隅にあるハンバーガーメニューを選択して展開します。
    3. 選択 Inventory そして選択してください Manage All Inventory
    4. SKU番号と関連する供給元を確認してください。

トラブルシューティング

認証エラーが発生した場合は、を参照してください。 認証エラー


このページは役に立ちましたか?