ベンダー出品者出荷在庫API v1ユースケースガイド

Help vendors in the direct fulfillment (DF) program use the Inventory API to manage their direct fulfillment operations.

APIバージョン:v1

出品者出荷在庫APIとは

ベンダーは、出品者出荷在庫APIを使用してAmazonと在庫レベルを交換できます。Amazonは在庫フィードAPIに対応しています。このAPIを使用すると、ベンダーが出品者出荷カタログの在庫フィードをAmazonに送信できます。

以下のオペレーションが含まれています。

オペレーション HTTPメソッド Path 説明
submitInventoryUpdate POST /vendor/directFulfillment/inventory/v1/warehouses/{warehouseId}/items 在庫詳細の一部または全フィードをAmazonに送信します

submitInventoryUpdate

There are two types of inventory feeds that can be submitted using this API. When isFullUpdate is set to true, the feed is a full update. When isFullUpdate is set to false, the feed is a partial update to inventory.

完全更新を選択すると、オペレーションによって特定の倉庫の在庫全体が更新されます。倉庫内のすべての商品に関する情報を送信する必要があります。含まれていない商品については、在庫数量がゼロに更新されます。このオペレーションは、倉庫を完全に同期する場合にのみ使用してください。また、在庫切れの商品の在庫をゼロに更新できない場合にのみ使用してください。すべての商品の在庫を管理できる場合、完全更新を選択することはお勧めしません

部分更新を選択すると、倉庫内の選択した商品の在庫のみが更新されます。これは通常、数時間おきに呼び出して、在庫切れになりそうな商品、または前回の更新以降に在庫切れになった商品を更新します。

注文在庫フィードが正常に送信されたことの確認

Vendors can verify the status of an inventory update using Vendor Central or using the Transaction Status API. For more information about how to use the Transaction Status API, refer to the business use case documentation for the Transaction Status API. Allow the system to take up to 15 minutes to show the original/updated version after submission. If Vendor Central is not showing the correct values for the acknowledgement, open a Contact Us case in Vendor Central.

次の図は、在庫更新を送信するための統合ワークフローを示しています。

The Direct Fulfillment integration workflow for submitting inventory updates.

ビジネスの要件

倉庫ごとに1つの在庫フィードが必要です。複数の倉庫を持っている場合は、各フィードに特定の倉庫の商品を記載して、複数の在庫フィードを送信する必要があります。

完全更新を行うには、倉庫内に在庫があるすべての商品を送信する必要があります。未提出の商品はAmazonでの在庫がゼロに設定され、在庫がない商品については新規注文が発注されません。

部分更新の場合は、在庫数量を更新する必要がある商品のみを記載する必要があります。部分更新に含まれていない商品は変更されません。

isObsoleteリクエストボディのパラメーターを使用して商品ステータスを「obsolete」に設定すると、商品は永続的に入手不可としてマークされます。商品が入荷可能になり、在庫ありに戻った場合は、isObsoleteをfalseに設定して、商品が在庫ありに戻ったとしてマークされるようにします。

If an item is rejected using the order acknowledgement multiple times, then those items will be marked as 'out of stock' and this can impact your fulfillment metrics.

国固有のビジネス要件

国固有の要件はありません。

submitInventoryUpdateリクエスト

To submit inventory updates, call the submitInventoryUpdate operation and pass the following parameter:

パスのパラメーター:

名前 説明 必須
warehouseId 在庫を更新する倉庫のID。

タイプ:文字列

はい

ボディのパラメーター:

名前 説明 必須
inventory リクエストされた倉庫の一部またはすべての商品を更新するために必要な在庫詳細。

Type: InventoryUpdate

はい

リクエストの例:

POST "https://sellingpartnerapi-na.amazon.com/vendor/directFulfillment/inventory/v1/warehouses/ABCD/items" { "inventory": { "sellingParty": { "partyId": "VENDORID" }, "isFullUpdate": false, "items": [ { "buyerProductIdentifier": "ABCD4562", "vendorProductIdentifier": "7Q89K11", "availableQuantity": { "amount": 10, "unitOfMeasure": "Each" }, "isObsolete": false }, { "buyerProductIdentifier": "ABCD4563", "vendorProductIdentifier": "7Q89K12", "availableQuantity": { "amount": 15, "unitOfMeasure": "Each" }, "isObsolete": false }, { "buyerProductIdentifier": "ABCD4564", "vendorProductIdentifier": "7Q89K13", "availableQuantity": { "amount": 20, "unitOfMeasure": "Each" }, "isObsolete": false } ] } }

submitInventoryUpdateレスポンス

成功レスポンスには、以下が含まれます。

名前 説明 必須
transactionId このトランザクションを識別するためのGUID。この値をトランザクションステータスAPIで使用して、このトランザクションのステータスを返すことができます。

タイプ:文字列

いいえ

レスポンスの例:

{ "transactionId": "20190905010908-8a3b6901-ef20-412f-9270-21c021796605" }

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