# 概述
用于直接履行库存更新的销售伙伴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 |