マルチロケーション在庫統合ガイド
複数のロケーションのインベントリをAPIやオペレーションと統合して、ロケーションレベルのデータを顧客に提供します。
出品者は複数のロケーションの在庫を使用して、データおよびフルフィルメント機能に関するロケーションレベルのデータをAmazonに提供できます。このロケーションレベルのデータを販売者の出荷元ロケーションデータと組み合わせることで、購入者が確認できる正確な情報が生成されます。複数のロケーションに在庫があると、出品者のスピードと信頼性が向上し、サービスにかかるコストが下がるため、出品商品が顧客にとってより魅力的なものになり、MFN(最恵国待遇)の売り上げが促進され、出品者の利益が増加します。このガイドでは、複数店舗の在庫をうまく統合するために必須となるAPIと運用について、出品パートナーにアドバイスします。
現在、次の条件に当てはまる出品者様は、複数店舗在庫をご利用いただけません。
- FBA 在庫を使用する
- セラーセントラルで在庫を管理
前提条件
出品用アカウントには、マルチロケーション在庫の使用に必要な権限が必要です。アカウントにマルチロケーション在庫権限がない場合は、以下からアクセスをリクエストできます。 マルチロケーション在庫登録フォーム。15 営業日以内にアカウントの準備が整ったことを示す確認メールが届きます。
必要な権限を取得すると、Amazonはデフォルトの場所を供給元として追加します。テンプレートを使用して追加のロケーションを作成し、配送設定オートメーション (SSA) で許可されている場合、これらのロケーションも供給元として追加されます。
出品用アカウントの設定を完了するには:
- サプライソースAPIまたはセラーセントラルUIを使用して、新しいサプライソースを作成するか、既存のサプライソースを更新します。
- API を使用して場所固有のインベントリを提供します。
- SSA で許可されている既存のテンプレートを作成または特定します。
- 手順3で作成または特定した配送テンプレートを、在庫を追加したSKUに割り当てます。ロケーションごとにこれを行います。
- を設定
DEFAULT
インベントリチャネルへ0
。 - を追加してください セリング・パートナー・インサイトの役割 開発者プロフィールへ。
マルチロケーションの在庫統合に必須の 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_US 、fr_CA 、fr_FR 。指定されたロケールでローカリゼーションが利用できない場合、ローカライズされたメッセージのデフォルトは en_US となります。 | いいえ |
ヘッダーパラメーター
名前 | Value |
---|---|
Accepts | application/json |
Content-Type | application/json |
{
"productType": "PRODUCT",
"patches": [
{
"op": "replace",
"path": "/attributes/fulfillment_availability",
"value": [
{
"fulfillment_channel_code": "StoreID1234567",
"quantity": 10
}
]
}
]
}
警告
設定する必要があります
Product Type
そしてPath
次のとおり:
Product Type
:PRODUCT
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_US 、fr_CA 、fr_FR 。指定されたロケールでローカリゼーションが利用できない場合、ローカライズされたメッセージのデフォルトは en_US となります。 | オプション |
includedData | リクエストのマーケットプレイスIDのコンマ区切りリスト。 タイプ:配列 (CSV) | いいえ |
成功時のレスポンスには、 Fulfillment Availability
サプライソース ID を返す配列属性 (fulfillmentChannelCode
) と残りの在庫数 (quantity
)。
個々のSKUに在庫を割り当てる
- を使用してください
GET
デフォルトロケーションの個々の SKU の数量を調べるオペレーション。この例では以下を使用しています。ssnm001
SKU (数量が3
単一電源で。
GET: {{baseUrl}}/listings/2021-08-01/items/{{sellerid}}/ssnm001?marketplacelds={{Marketplaceld}}
{
"sku": "ssnm001",
"fulfillmentAvailability": [
{
"fulfillmentChannelCode": "DEFAULT",
"quantity": 3
}
]
}
- を使う
PATCH
操作と設定fulfillmentChannelCode
にDEFAULT
そしてquantity
に0
。
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": []
}
- を使用してください
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) セラーセントラルのアカウントにログインします。
- 左上隅にあるハンバーガーメニューを選択します。
- 選択 Inventory そして選択してください Manage All Inventory。
- SKU番号と関連する供給元を確認してください。
注文履行フィードを通じて、販売パートナーが使用している供給元IDを取得します
ザの 注文処理フィード 購入者に請求し、出品用アカウントに入金し、注文が発送されたことを購入者に通知するよう Amazon に指示します。
このフィードは、販売パートナーが使用するサプライソースIDを提供します。この情報を取得するには、注文履行フィードを使用する必要があります。 XML スキーマ。
注文処理フィードで複数の注文を確認する
を使用して注文または注文グループを確認するには POST_ORDER_FULFILLMENT_DATA
フィードタイプ。必ず含めてください CarrierCode
、 ShippingMethod
、および ShipperTrackingNumber
XML スキーマ内。を統合できます POST_ORDER_FULFILLMENT_DATA
出品者が出荷した注文を確認するためのフィードタイプ。
XML のサンプル
<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に在庫を割り当てる
- 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"
}
- すべての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
}
]
}
}
]
}
- フィードを作成します。
POST: {{baseUrl}}/feeds/2021-06-30/feeds
var jsonData=JSON.parse(responseBody);
postman.setEnvironmentVariable("feedId", jsonData. feedId);
{
"feedId": "50037019429"
}
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"
}
- 両方の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) セラーセントラルのアカウントにログインします。
- 左上隅にあるハンバーガーメニューを選択して展開します。
- 選択 Inventory そして選択してください Manage All Inventory。
- SKU番号と関連する供給元を確認してください。
トラブルシューティング
認証エラーが発生した場合は、を参照してください。 認証エラー。
Updated 27 days ago