供应商直接配送库存 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.
下图显示了提交库存更新的集成工作流程。
业务需求
每个库房都需要一个库存上传数据。如果供应商有多个库房,则需要提交多个库存上传数据,每个上传数据都包含给定库房的商品。
要获得全面更新,应提交库房中所有有货的商品。任何未提交的商品在亚马逊上的库存情况都将设置为零,并且不会为这些不可售商品发放新订单。
对于部分更新,应仅包括那些必须更新库存数量的商品。不在部分更新中的其余商品将保持不变。
当使用 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:
|
有帮助 |
请求示例:
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"
}
Updated 8 months ago