主页文档代码示例API 参考公告模型发行说明常见问题GitHub视频
开发者中心API 状态支持
文档
开发者中心API 状态支持

供应商直接配送库存 API v1 用例指南

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

API 版本:v1

什么是直接配送库存 API?

供应商可以使用直接配送库存 API 与亚马逊交换库存水平。我们支持库存上传数据 API,它允许供应商向亚马逊发送直接配送目录的库存上传数据。

包括以下操作:

操作 HTTP 方法 Path 描述
submitInventoryUpdate POST /vendor/directFulfillment/inventory/v1/warehouses/{warehouseId}/items 向亚马逊提交库存详情的部分或全部上传数据。

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.

业务需求

每个库房都需要一个库存上传数据。如果供应商有多个库房,则需要提交多个库存上传数据,每个上传数据都包含给定库房的商品。

要获得全面更新,应提交库房中所有有货的商品。任何未提交的商品在亚马逊上的库存情况都将设置为零,并且不会为这些不可售商品发放新订单。

对于部分更新,应仅包括那些必须更新库存数量的商品。不在部分更新中的其余商品将保持不变。

当使用 isObsolete 请求正文参数将商品的状态设置为“过时”时,该项目会被标记为永久不可用。如果该商品变为可售并且有货,则必须将 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 要更新库存的库房的标识符。

类型:字符串

有帮助

主体参数:

名称 描述 必填项
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" }

此页面对您有帮助吗?