Vendor Direct Fulfillment Inventory API v1 reference

亚马逊SPAPI

# 概述

用于直接履行库存更新的销售伙伴API提供了对直接履行供应商的库存更新的程序化访问.

# Version information

版本 : v1

# Operations

submitInventoryUpdate
<a name="paths">

# 路径

<a name="submitinventoryupdate">

# submitInventoryUpdate

**POST /vendor/directFulfillment/inventory/v1/warehouses/{warehouseId}/items **

# Description

为指定仓库提交部分或全部库存项目的库存更新.

使用计划:

计划类型 速率(每秒的请求) 突发
Default 10 10
销售伙伴具体 变量 变量

x-amzn-RateLimit-Limit响应头返回应用于请求操作的使用计划费率限制.一些销售伙伴的费率限制将不同于上表所示的默认费率和爆裂.更多信息,请参阅销售伙伴API文档中的 "使用计划和费率限制".

# Parameters

Type Name Description Schema
Body body
required
submitInventoryUpdate操作的请求体. SubmitInventoryUpdateRequest
Path warehouseId
required
要更新库存的仓库的标识符. string

# Responses

HTTP Code Description Schema
202 Success.
:
x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求)
x-amzn-RequestId (string) : Unique request reference identifier.
SubmitInventoryUpdateResponse

错误状态代码、描述和模式,见错误响应和模式.

<a name="error-responses-and-schemas">

# 错误响应和模式

该表包含HTTP状态代码和错误响应的相关信息.

HTTP Code Description Schema
400 Request有缺失或无效的参数,无法解析.
Headers
x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) Unique request reference identifier.
SubmitInventoryUpdateResponse
403 表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名.
**头信息
x-amzn-RequestId (string):Unique request reference identifier.
SubmitInventoryUpdateResponse
404 指定的资源不存在.

x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)为这个操作.
x-amzn-RequestId (string) Unique request reference identifier.
SubmitInventoryUpdateResponse
413 请求的大小超过了最大接受的大小.

x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考标识符.
SubmitInventoryUpdateResponse
415 请求的有效载荷是不支持的格式.

x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考标识符.
SubmitInventoryUpdateResponse
429 请求的频率超过了允许的范围.

x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考标识符.
SubmitInventoryUpdateResponse
500 发生了一个意外情况,使服务器无法完成请求.
头信息
x-amzn-RateLimit-Limit (string):您的速率限制(每秒的请求)对于这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考标识符.
SubmitInventoryUpdateResponse
503 服务器临时超载或维护.

x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作.
_注意 _对于这个状态代码,速率限制头已经过时,不再返回.
x-amzn-RequestId (string):唯一的请求参考标识.
SubmitInventoryUpdateResponse

<a name="definitions">

# Definitions

<a name="submitinventoryupdaterequest">

# SubmitInventoryUpdateRequest

提交库存更新操作的请求主体.

Name Description Schema
inventory
optional
Inventory details required to update some or all items for requested warehouse. InventoryUpdate

<a name="inventoryupdate">

# InventoryUpdate

Name Description Schema
sellingParty
required
销售方或供应商的ID. PartyIdentification
isFullUpdate
required
为真时,这个请求包含一个完整的反馈.否则,这个请求包含一个部分反馈.当发送一个完整的反馈时,你必须发送仓库中所有物品的信息.任何不在完整反馈中的物品都被更新为不可用.当发送一个部分反馈时,只包括需要更新库存的物品.其他物品的状态将保持不变. boolean
items
required
A list of inventory items with updated details, including quantity available. < ItemDetails> array

<a name="itemdetails">

# ItemDetails

更新一个物品的库存细节.

Name Description Schema
buyerProductIdentifier
optional
买方选择的物品的产品标识.应提交buyerProductIdentifier或vendorProductIdentifier. string
vendorProductIdentifier
optional
供应商选择的项目的产品标识.应提交buyerProductIdentifier或vendorProductIdentifier. string
availableQuantity
required
仓库中可用的物品总量. ItemQuantity
isObsolete
optional
为真时,该物品永久不可用. boolean

<a name="partyidentification">

# PartyIdentification

Name Description Schema
partyId
required
为当事人分配的标识. string

<a name="itemquantity">

# ItemQuantity

项目数量的详情.

Name Description Schema
amount
optional
特定项目的可用单位数量. integer
unitOfMeasure
required
可用数量的计量单位. string

<a name="submitinventoryupdateresponse">

# SubmitInventoryUpdateResponse

submitInventoryUpdate操作的响应模式.

Name Description Schema
payload
optional
submitInventoryUpdate操作的响应有效载荷. TransactionReference
errors
optional
A list of error responses returned when a request is unsuccessful. ErrorList

<a name="transactionreference">

# TransactionReference

Name Description Schema
transactionId
optional
GUID来识别这个交易.这个值可以和交易状态API一起使用来返回这个交易的状态. string

<a name="errorlist">

# ErrorList

当请求不成功时返回的错误响应列表.

类型 < Error > 数组

<a name="error">

# Error

当请求不成功时返回的错误响应.

Name Description Schema
code
required
一个错误代码,用于识别所发生的错误类型. string
message
required
一个描述错误情况的信息. string
details
optional
可以帮助呼叫者理解或解决这个问题的额外细节. string
Last Updated: 2022/10/17 下午9:17:02