供应商订单API v1参考

<a name="概览">

概述

零售业采购订单的销售伙伴API提供对供应商订单数据的程序化访问.

Version information

版本 : v1

Operations

getPurchaseOrders
getPurchaseOrder
submitAcknowledgement
getPurchaseOrdersStatus
<a name="paths">

路径

<a name="getpurchaseorders">

getPurchaseOrders

**GET /vendor/orders/v1/purchaseOrders **

Description

返回在您指定的时间范围内创建或更改的采购订单列表.您可以使用createdAfter, createdBefore, changedAfter 和 changedBefore参数来定义时间范围.搜索的日期范围不能超过7天.您可以通过设置includeDetails为false来选择只获得采购订单号码.然后您可以使用getPurchaseOrder操作来接收特定采购订单的细节.

使用计划：

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

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

Parameters

Type	Name	Description	Schema
Query	limit optional	返回记录数的限制.默认值是100条记录. Minimum : 1 最大 : 100	integer (int64)
*Query	*createdAfter optional	在此时间之后可用的采购订单将包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
*Query	*createdBefore optional	在此时间之前可用的采购订单将被包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
*Query	*sortOrder optional	按采购订单创建日期升序或降序排序.	enum (SortOrder
*Query	*nextToken optional	当有更多的采购订单超过指定的结果大小限制时，用于分页.该token值在前一个API调用中返回	string
*Query	*includeDetails optional	当为true时，返回具有完整细节的采购订单.否则，只返回采购订单号码.默认值为true.	string (boolean)
*Query	*changedAfter optional	在这个时间戳之后发生变化的采购订单将被包含在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
Query	changedBefore optional	在这个时间戳之前发生变化的采购订单将被包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
Query	poItemState optional	采购订单项目的当前状态.如果这个值是Cancelled，这个API将返回有一个或多个项目被亚马逊取消的采购订单，更新的项目数量为零.	enum (PoItemState
*Query	*isPOChanged optional	为真时，返回下单后被修改的采购订单.供应商需要拉出修改后的采购订单并履行更新后的采购订单，而不是原来的订单.默认值为假.	string (boolean)
*Query	*purchaseOrderState optional	根据采购订单状态过滤采购订单.	enum (PurchaseOrderState
Query	orderingVendorCode optional	根据指定的订购供应商代码过滤采购订单.此值应与采购订单中的'sellingParty.partyId'相同.如果不包括在过滤器中，将返回用于授权API客户应用的供应商组中存在的所有供应商代码的所有采购订单.	string

Responses

HTTP Code	Description	Schema
200	Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier.	GetPurchaseOrdersResponse
400	Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier.	GetPurchaseOrdersResponse
403	表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrdersResponse
404	指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier.	GetPurchaseOrdersResponse
415	请求的有效载荷是不支持的格式. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersResponse
429	请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersResponse
500	发生了一个意外情况，导致服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrdersResponse
503	服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. _注意 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrdersResponse

更多的错误状态代码、描述和模式，见错误响应和模式. <a name="getpurchase order">

getPurchaseOrder

GET /vendor/orders/v1/purchaseOrders/{purchaseOrderNumber}

Description

根据您指定的purchaseOrderNumber值，返回一个采购订单.

使用计划：

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

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

Parameters

Type	Name	Description	Schema
Path	purchaseOrderNumber required	你想要的订单的采购订单标识符.格式说明8-character alpha-numeric code.	string

Responses

HTTP Code	Description	Schema
200	Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier.	GetPurchaseOrderResponse
400	Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier.	GetPurchaseOrderResponse
403	表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrderResponse
404	指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier.	GetPurchaseOrderResponse
415	请求的有效载荷是不支持的格式. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrderResponse
429	请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrderResponse
500	发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _ 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrderResponse
503	服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. _注意 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识.	GetPurchaseOrderResponse

更多的错误状态代码、描述和模式，见错误响应和模式. <a name="submitacknowledgement">

submitAcknowledgement

POST /vendor/orders/v1/acknowledgements

Description

提交一个或多个采购订单的确认书.

使用计划：

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

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

Parameters

Type	Name	Description	Schema
Body	body required	submitAcknowledgment操作的请求模式.	SubmitAcknowledgementRequest

Responses

HTTP Code	Description	Schema
202	Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier.	SubmitAcknowledgementResponse
400	Request有缺失或无效的参数，无法解析. Headers: x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier.	SubmitAcknowledgementResponse
403	表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	SubmitAcknowledgementResponse
404	指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier.	SubmitAcknowledgementResponse
415	请求的有效载荷是不支持的格式. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	SubmitAcknowledgementResponse
429	请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	SubmitAcknowledgementResponse
500	发生了一个意外情况，使服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	SubmitAcknowledgementResponse
503	服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. _注意 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	SubmitAcknowledgementResponse

其他错误状态代码、描述和模式，见错误响应和模式. <a name="getpurchaseordersstatus">

getPurchaseOrdersStatus

GET /vendor/orders/v1/purchaseOrdersStatus

Description

根据您指定的过滤器返回采购订单状态.搜索的日期范围不得超过7天.您可以使用可用的过滤器返回采购订单状态的列表，或者通过提供采购订单号码返回单个采购订单状态.

使用计划：

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

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

Parameters

Type	Name	Description	Schema
Query	limit optional	返回记录数的限制.默认值是100条记录. Minimum : 1 最大 : 100	integer (int64)
*Query	*sortOrder optional	Sort in ascending or descending order by purchase order creation date.	enum (SortOrder
*Query	*nextToken optional	当采购订单的数量超过指定的结果大小限制时，用于分页.	string
*Query	*createdAfter optional	在此时间戳之后可用的采购订单将被包含在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
*Query	*createdBefore optional	在此时间戳之前可用的采购订单将被包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
*Query	*updatedAfter optional	采购订单的最后一次更新发生在这个时间戳之后，将包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
*Query	*updatedBefore optional	采购订单的最后一次更新发生在这个时间戳之前，将包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time_)
Query	purchaseOrderNumber optional	提供指定采购订单号的采购订单状态.	string
*Query	*purchaseOrderStatus optional	根据指定的采购订单状态过滤采购订单.如果不包括在过滤器中，这将返回所有状态的采购订单.	enum (PurchaseOrderStatus
*Query	*itemConfirmationStatus optional	根据项目确认状态过滤采购订单.如果项目确认状态不包括在过滤器中，则包括所有确认状态的采购订单.	enum (ItemConfirmationStatus)
*Query	*itemReceiveStatus optional	根据采购订单的物品接收状态过滤采购订单.如果物品接收状态不包括在过滤器中，所有接收状态的采购订单都包括在内.	enum (ItemReceiveStatus)
*Query	*orderingVendorCode optional	根据指定的订购供应商代码过滤采购订单.此值应与采购订单中的'sellingParty.partyId'相同.如果不包括在过滤器中，将返回用于授权API客户应用的供应商组中存在的所有供应商代码的采购订单.	string
Query	shipToPartyId optional	通过在这里提供ship to location id来过滤特定买家的Fulfillment Center/warehouse的采购订单.这个值应该与采购订单中的'shipToParty.partyId'相同.如果不包括在过滤器中，这将返回用于供应商组采购订单的所有买家的仓库的采购订单.	string

Responses

HTTP Code	Description	Schema
200	Success. 头: x-amzn-RateLimit-Limit (string) : 您对该操作的速率限制(每秒的请求) . x-amzn-RequestId (string) Unique request reference identifier.	GetPurchaseOrdersStatusResponse
400	Request有缺失或无效的参数，不能被解析. 头信息: x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求)_. x-amzn-RequestId (string) : Unique request reference identifier.	GetPurchaseOrdersStatusResponse
403	表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersStatusResponse
404	指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier.	GetPurchaseOrdersStatusResponse
415	请求的有效载荷是不支持的格式. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersStatusResponse
429	请求的频率超过了允许的范围. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersStatusResponse
500	发生了一个意外情况，导致服务器无法完成请求. 头信息 x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersStatusResponse
503	服务器临时超载或维护. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. _注意 对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string) : 唯一的请求参考标识符.	GetPurchaseOrdersStatusResponse

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

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

错误响应和模式

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

HTTP Code	Description	Schema
401	请求的授权头格式不正确或不包含有效的标记. 头 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)为这个操作. _注意 _对于这个状态代码，速率限制头已被废弃，不再返回. x-amzn-RequestId (string):唯一的请求参考标识符.	GetPurchaseOrderResponse
413	请求的大小超过了最大接受的大小. 头 x-amzn-RateLimit-Limit (string):你的速率限制(每秒的请求)对于这个操作. _注意 _对于这个状态码，速率限制头已经过时，不再返回. x-amzn-RequestId (string):唯一的请求参考标识符.	SubmitAcknowledgementResponse

<a name="definitions">

Definitions

<a name="getpurchaseordersresponse">

GetPurchaseOrdersResponse

getPurchaseOrders操作的响应模式.

Name	Description	Schema
******** 可选	A订单列表.	OrderList
errors optional	A list of error responses returned when a request is unsuccessful.	ErrorList

<a name="getpurchase orderresponse">

GetPurchaseOrderResponse

getPurchaseOrder操作的响应模式.

Name	Description	Schema

|errors
optional|请求不成功时返回的错误响应列表.|ErrorList|

<a name="orderlist">

OrderList

Name	Schema
pagination optional	Pagination
orders optional	< Order > array

<a name="分页">

Pagination

Name	Description	Schema
nextToken optional	A生成的字符串，用来传递信息给你的下一个请求.如果返回NextToken，把NextToken的值传递给下一个请求.如果没有返回NextToken，就没有更多的采购订单项目可以返回.	string

<a name="order">

Order

Name	Description	Schema
采购订单号 必填	此订单的采购订单号.格式说明8-character alpha-numeric code.	string
采购订单状态 必须的	这个字段将包含采购订单的当前状态.	enum (PurchaseOrderState
orderDetails optional	Details of an order.	OrderDetails

<a name="orderdetails">

OrderDetails

一个订单的细节.

Name	Description	Schema
采购订单日期 必须的	采购订单的日期.必须是ISO-8601日期/时间格式.	string (date-time)
purchaseOrderChangedDate optional	采购订单在下单后被亚马逊最后一次更改的日期.该日期将大于'purchaseOrderDate'.这意味着PO数据在该日期被更改，供应商需要履行更新的PO.PO更改可以与物品数量有关.这个字段不会出现在创建后没有变化的订单中.必须是ISO-8601日期/时间格式.	string (date-time)
purchaseOrderStateChangedDate required	当前采购订单状态被改变的日期.当前采购订单状态可以在字段'purchaseOrderState'中找到.必须是ISO-8601日期/时间格式.	string (date-time)
purchaseOrderType optional	Type of purchase order.	enum (PurchaseOrderType)
importDetails optional	如果采购订单是一个进口订单，进口订单的详细信息.	ImportDetails
dealCode optional	如果收件人要求，这个字段将包含一个促销/交易号码.折扣代码行是可选的.它是用来获得订单上物品的价格折扣的.	string
paymentMethod optional	Payment method used.	enum (PaymentMethod)
buyingParty optional	购买方的姓名/地址和税务细节.	PartyIdentification
sellingParty optional	销售方的名称/地址和纳税细节.	PartyIdentification
船方 可选	船方的姓名/地址和税务信息.	PartyIdentification
billToParty optional	name/Address and tax details of the bill to party.	PartyIdentification
shipWindow optional	这表示出货窗口.格式为开始和结束日期，用双连字符分隔(--).例如，2007-03-01T13 00:00Z--2007-03-11T15:30:00Z.	DateTimeInterval
deliveryWindow optional	这表示交付窗口.格式是用双连字符分隔的开始和结束日期(--).例如，2007-03-01T13 00:00Z--2007-03-11T15:30:00Z.	DateTimeInterval
items required	A 这个采购订单的项目列表.	< OrderItem >数组

<a name="importdetails">

ImportDetails

一个进口订单的进口细节.

Name	Description	Schema
methodOfPayment optional	如果收件人要求，包含发货的付款方式.这只适用于进口PO.	enum (MethodOfPayment)
国际商业条款 可选	国际贸易术语(国际商业条款)用于划分买方和卖方之间的交易成本和责任，并反映出 这仅适用于进口采购订单.	enum (国际商业条款
portOfDelivery optional	进口采购订单上的货物必须由供应商交付的港口.只有当internationalCommercialTerms是FOB. maxLength时才应指定64	string
importContainers optional	Types and numbers of container(s) for import purchase orders. Can be a comma-separated list if the shipment has multiple containers. HC signifies a high-capacity container. Free-text field, limited to 64 characters. The format will be a comma-delimited list containing values of the type: $NUMBER_OF_CONTAINERS_OF_THIS_TYPE-$CONTAINER_TYPE. 容器类型的值列表为：40'(40-foot container), 40'HC (40-foot high-capacity container), 45', 45'HC, 30', 30'HC, 20', 20'HC. maxLength 64	字符串
shippingInstructions optional	Special instructions regarding the shipment.此字段用于进口订购单.	string

<a name="datetimeinterval">

DateTimeInterval

根据ISO8601定义一个日期时间间隔.间隔用双连字符分隔(--).

类型 ：字符串

<a name="partyidentification">

PartyIdentification

Name	Description	Schema
partyId required	为当事人分配的标识.例如，仓库代码或供应商代码.更多细节请参考具体当事人.	string
address optional	通过地址识别当事人.	Address
taxInfo optional	当事人的税务登记详细信息.	TaxRegistrationDetails

<a name="taxregistrationdetails">

TaxRegistrationDetails

实体的税务登记详情.

Name	Description	Schema
*税务登记类型 必须的	实体的税务登记类型.	enum (税务登记类型)
税务登记号码 必须的	实体的税务登记号码.例如，增值税ID.	字符串

<a name="地址">

Address

当事人的地址.

Name	Description	Schema
name required	该地址的个人、企业或机构的名称.	string
addressLine1 required	地址的第一行.	string
addressLine2 optional	额外的地址信息，如果需要的话.	string
addressLine3 optional	Additional address information, if required.	string
city optional	个人、企业或机构所在的城市.	string
县 可选择	个人、企业或机构所在的县.	string
区 可选择	个人、企业或机构所在的区.	string
州或地区 可选择	个人、企业或机构所在的州或地区.	string
postalCode optional	该地址的邮政编码.它由一系列字母或数字或两者组成，有时包括空格或标点符号.	string
countryCode required	两位数的国家代码.以ISO 3166-1 alpha-2格式. maxLength : 2	string
phone optional	位于该地址的个人、企业或机构的电话号码.	string

<a name="orderitem">

OrderItem

Name	Description	Schema
itemSequenceNumber required	Numbering of the item on the purchase order. 第一个项目将是1，第二个是2，以此类推.	string
amazonProductIdentifier optional	Amazon Standard Identification Number(ASIN)的物品.	string
vendorProductIdentifier optional	供应商选择的物品的产品标识.	string
orderedQuantity required	Item quantity ordered.	ItemQuantity
isBackOrderAllowed required	为真时，我们将接受这个项目的延期订单确认.	boolean
netCost optional	对亚马逊的价格每(cost).	Money
listPrice optional	亚马逊每个人的价格(list).	Money

<a name="money">

Money

一笔钱，包括货币形式的单位.

Name	Description	Schema
currencyCode optional	ISO 4217格式的三位数货币代码.长度为3的字符串. maxLength : 3	string
amount optional	一个没有精度损失的十进制数字.当精度损失不可接受时很有用，如货币.遵循RFC7159的数字表示法. Pattern : ^-?(0\|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$.	Decimal

<a name="decimal">

Decimal

一个没有精度损失的十进制数.当精度损失不可接受时，非常有用，比如货币.遵循RFC7159的数字表示法.
模式^-?(0|([1-9]\d*))(\.\d+)?([eE][+-]?\d+)?$.

类型：字符串

<a name="submitacknowledgementresponse">

SubmitAcknowledgementResponse

submitAcknowledgement操作的响应模式

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

<a name="transactionid">

TransactionId

Name	Description	Schema
transactionId optional	GUID由亚马逊分配来识别此交易.此值可用于交易状态API，以返回此交易的状态.	string

<a name="errorlist">

ErrorList

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

类型 < Error > 数组

<a name="submitacknowledgementrequest">

SubmitAcknowledgementRequest

submitAcknowledgment操作的请求模式.

Name	Schema
acknowledgements optional	< OrderAcknowledgement > array

<a name="orderacknowledgement">

OrderAcknowledgement

Name	Description	Schema
采购订单号 必填	采购订单号.格式说明8-character alpha-numeric code.	string
sellingParty required	收货方的姓名、地址和税务信息.	PartyIdentification
确认日期 必须的	采购订单被确认的日期和时间，以ISO-8601日期/时间格式.	string (date-time)
items required	A 被确认的项目列表，以及相关的细节.	< OrderAcknowledgementItem> array

<a name="orderacknowledgementitem">

OrderAcknowledgementItem

被确认的项目的详细信息.

Name	Description	Schema
itemSequenceNumber optional	Line item sequence number for the item.	string
amazonProductIdentifier optional	亚马逊的标准识别码(ASIN)的物品.	string
vendorProductIdentifier optional	供应商选择的商品标识.应与采购订单中发送的相同.	string
orderedQuantity required	这个项目的订购数量.	ItemQuantity
netCost optional	亚马逊的成本，应该与发票上的成本一致.这是一个必填字段.如果这个字段留空，文件将在亚马逊系统中被拒绝.价格信息不应该是零或负数.表示净单位价格.	Money
*listPrice optional	the list price.只有当供应商销售的书籍有清单价格时才需要这个.	Money
discountMultiplier optional	如果供应商销售有清单价格的书籍，应该应用到价格上的折扣乘数.这是一个乘数系数，用于得出最终的折扣价格.如果给予10%的折扣，则乘数为.90_是一个系数
itemAcknowledgements required	这是用来表示确认的数量.	< OrderItemAcknowledgement > array

<a name="orderitemAcknowledgement">

OrderItemAcknowledgement

Name	Description	Schema
acknowledgementCode required	This indicates the acknowledgement code.	enum (AcknowledgementCode)
确认的数量 必须的	用上述确认代码确认的数量细节.	ItemQuantity
scheduledShipDate optional	每行项目的估计发货日期.必须是ISO-8601日期/时间格式.	string (date-time)
scheduledDeliveryDate optional	Estimated delivery date per line item. Must be in ISO-8601 date/time format.	string (date-time)
rejectionReason optional	表示拒绝的原因.	enum (RejectionReason

<a name="itemquantity">

ItemQuantity

订购数量的详细信息.

Name	Description	Schema
amount optional	Acknowledged quantity.这个值不应该是零.	integer
单元测量 可选	确认数量的测量单位.	enum (单元测量)
单位尺寸 可选	箱子尺寸，在我们使用箱子订购的情况下.	整数

<a name="getpurchaseordersstatusresponse">

GetPurchaseOrdersStatusResponse

getPurchaseOrdersStatus操作的响应模式.

Name	Description	Schema
****** 可选	采购订单清单的当前状态.	OrderListStatus
errors optional	A list of error responses returned when a request is unsuccessful.	ErrorList

<a name="orderliststatus">

OrderListStatus

Name	Schema
pagination optional	Pagination
ordersStatus optional	< OrderStatus > array

<a name="orderstatus">

OrderStatus

一个采购订单的当前状态.

Name	Description	Schema
采购订单号 必填	此订单的买方采购订单号.格式说明8-character alpha-numeric code.	string
采购订单状态 必须的	买方对这个订单的采购订单状态.	enum (采购订单状态)
采购订单日期 必须的	采购订单的下达日期.必须是ISO-8601日期/时间格式.	string (date-time)
lastUpdatedDate optional	采购订单最后更新的日期.必须是ISO-8601日期/时间格式.	string (date-time)
销售方 必须的	销售方的名称/地址和税务细节.	PartyIdentification
shipToParty required	name/Address and tax details of the ship to party.	PartyIdentification
itemStatus required	Detailed order status.	ItemStatus

<a name="itemstatus">

ItemStatus

项目订单状态的详细描述.

类型 < OrderItemStatus > 数组

<a name="orderitemstatus">

OrderItemStatus

Name	Description	Schema
itemSequenceNumber required	Numbering of the item on the purchase order. 第一个项目将是1，第二个是2，以此类推.	string
buyerProductIdentifier optional	Buyer's Standard Identification Number(ASIN)的一个项目.	string
vendorProductIdentifier optional	供应商选定的物品的产品标识.	string
netCost optional	亚马逊的每项净成本(cost).	Money
listPrice optional	亚马逊每个人的清单价格(list).	Money
orderedQuantity optional	Ordered quantity information.	orderedQuantity
acknowledgementStatus optional	Acknowledgement status information.	acknowledgementStatus
receivingStatus optional	Item receive status at the buyer's warehouse.	receivingStatus

<a name="orderitemstatus-orderedquantity"> 定购数量

Name	Description	Schema
orderedQuantity optional	Item quantity ordered.	ItemQuantity
订购的数量细节 可选	订购的项目数量细节.	< OrderedQuantityDetails >数组

<a name="orderitemstatus-acknowledgementstatus"> 确认的状态

Name	Description	Schema
确认状态 可选	确认项目的状态.	enum (确认状态)
acceptedQuantity optional	Item quantities accepted by vendor to be shipped.	ItemQuantity
拒绝的数量 可选	被供应商拒绝的项目数量.	ItemQuantity
确认状态细节 可选	物品数量确认细节.	< AcknowledgementStatusDetails >数组

<a name="orderitemstatus-receivingstatus"> receivingStatus

Name	Description	Schema
receiveStatus optional	行项目的接收状态.	enum (ReceiveStatus)
receivedQuantity optional	到目前为止，买家收到的总物品数量.	ItemQuantity
lastReceiveDate optional	最近一次在买方仓库收到物品的日期.必须是ISO-8601日期/时间格式.	string (date-time)

<a name="orderedquantitydetails">

OrderedQuantityDetails

订购的物品数量详情

Name	Description	Schema
updatedDate optional	行货数量被买方更新的日期.必须是ISO-8601日期/时间格式.	string (date-time)
orderedQuantity optional	Item quantity ordered.	ItemQuantity
cancelledQuantity optional	Item quantity ordered.	ItemQuantity

<a name=" acknowledgementstatusdetails">

AcknowledgementStatusDetails

订购物品数量的详情

Name	Description	Schema
确认日期 可选	行项目被供应商确认的日期.必须是ISO-8601日期/时间格式.	string (date-time)
acceptedQuantity optional	供应商接受发货的项目数量.	ItemQuantity
rejectedQuantity optional	Item quantity rejected by vendor.	ItemQuantity

<a name="error">

Error

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

Name	Description	Schema
code required	一个错误代码，用于识别所发生的错误类型.	string
message required	一个描述错误情况的信息.	string
details optional	可以帮助呼叫者理解或解决这个问题的额外细节.	string

<a name="methodofpayment">

MethodOfPayment

如果收件人要求，包含发货的付款方式.这只适用于进口订单.

类型 : 枚举

Value	Description
由买方支付	买方支付运费.
CollectOnDelivery	买方支付交货时的运费.
由买方和卖方定义	按照买方和卖方之间的协议支付运费.
FOBPortOfCall	卖方支付运输费用，包括装载和运输.
PrepaidBySeller	Seller prepays for shipping.
由卖方支付	卖方支付运费.

<a name="confirmationstatus">

ConfirmationStatus

行货的确认状态.

类型 : 枚举

Value	Description
ACCEPTED	供应商接受订单的状态.
PARTIALLY_ACCEPTED	被供应商部分接受的订单的状态.
REJECTED	被供应商拒绝的订单的状态.
UNCONFIRMED	供应商尚未确认的订单的状态.

<a name="itemreceivestatus">

ItemReceiveStatus

根据采购订单的物品接收状态，过滤采购订单.如果物品接收状态不包括在过滤器中，所有接收状态的采购订单都包括在内.

类型 : 枚举

Value	Description
NOT_RECEIVED	提供一个至少有一件商品未被买方收到的订单列表.
PARTIALLY_RECEIVED	提供一个至少有一件商品未被买方收到的订单列表.
RECEIVED	提供一个订单的列表，其中至少有一件物品被买方完全收到.

<a name="unitofmeasure">

UnitOfMeasure

确认数量的计量单位.

类型 : 枚举

Value	Description
箱	将单个物品包装成一个箱子.
Eaches	Individual items.

<a name=" acknowledgementcode">

AcknowledgementCode

这表示确认代码.

类型 : 枚举

Value	Description
接受	供应商接受履行订单项目(s).
退货	供应商为履行原始订单而下了一个退货订单，并提供了一个预定发货日期或预定交货日期，这个日期与采购订单中提供的预期发货日期或预期交货日期不同.
Rejected	供应商拒绝履行订单项目(s).

<a name="poitemstate">

PoItemState

采购订单项目的当前状态. 如果这个值是Cancelled，这个API将返回有一个或多个项目被亚马逊取消的采购订单，更新的项目数量为零.

类型 : 枚举

Value	Description
Cancelled	被供应商取消的订单项目的状态.

<a name="itemconfirmationstatus">

ItemConfirmationStatus

根据项目确认状态过滤采购订单.如果项目确认状态不包括在过滤器中，所有确认状态的采购订单都包括在内.

类型 : 枚举

Value	Description
ACCEPTED	提供一个至少有一个项目被供应商完全接受的订单列表.
PARTIALLY_ACCEPTED	提供一个订单列表，其中至少有一个项目被供应商部分接受.
REJECTED	提供一个至少有一个项目被供应商拒绝的订单列表.
UNCONFIRMED	提供一个至少有一个项目尚未被供应商确认的订单列表.

<a name="Internationalcommercialterms">

InternationalCommercialTerms

国际贸易术语(国际商业条款)用于划分买方和卖方之间的交易成本和责任，并反映出最先进的运输方式.这只适用于进口采购订单.

类型 : 枚举

Value	Description
ExWorks	将最大的义务放在买方身上，将最小的义务放在卖方身上.卖方在其场所提供货物.买方负责运输货物的所有费用，并承担将货物带到最终目的地的所有风险.
自由承运人	卖方将清关出口的货物交给承运人处理(由买方指定).买方支付所有额外的运输费用，当货物被交给承运人时，风险也随之转移.
免费上船	仅海上运输.卖方必须在指定的港口靠船交货，并办理出口手续.买方支付所有额外的运输费用，并在货物靠船时转移风险.
自由靠船	只在海上运输.卖方必须将货物装上船，清关出口.买方支付所有额外的运输费用，货物装上船后风险转移.
CarriagePaidTo	卖方支付运输到指定的目的港的费用，但风险在将货物交给第一个承运人时转移给买方.买方支付所有目的地费用.
CostAndFreight	仅限海运.卖方支付到指定目的港的运输费用，但货物装船后风险转移给买方.买方支付所有目的地费用.
运费和保险费付给	卖方支付到指定的目的港的运输和保险费，但在将货物交给第一个承运人后，风险转移给买方.买方支付所有的目的地费用.
CostInsuranceAndFreight	仅限海运.卖方支付到指定目的港的运输费和保险费，但货物装船后风险转移到买方.买方支付所有目的地费用.
DeliveredAtTerminal	卖方支付运输至目的地码头的费用，以及货物在码头卸下时的风险.买方支付进口清关、关税和交付费用.
DeliveredAtPlace	卖方支付到指定目的地的运输费用，并在货物准备好供买方卸货时转移风险.买方支付进口清关、关税和交付费用.
交付关税	卖方负责将货物交付到买方国家的指定地点，并支付将货物运到目的地的所有费用，包括进口关税和税款.本条款规定卖方承担最大义务，买方承担最小义务.

<a name="taxregistrationtype">

TaxRegistrationType

该实体的税务登记类型.

类型 : 枚举

Value	Description
VAT	Value-added tax.
GST	商品和服务税.

<a name="receiveestatus">

ReceiveStatus

该行的接收状态.

类型 : 枚举

Value	Description
NOT_RECEIVED	买方没有收到任何物品.
PARTIALLY_RECEIVED	-
已收到	接收完毕.买方已收到所有确认的物品.

<a name="sortorder">

SortOrder

按采购订单创建日期升序或降序排序.

类型 : 枚举

Value	Description
*ASC	按采购订单创建日期升序排序.
DESC	按采购订单创建日期降序排序.

<a name="rejectionreason">

RejectionReason

表示拒绝的原因.

类型 : 枚举

Value	Description
暂时不可用	项目目前不可用.
InvalidProductIdentifier	无法用所提供的标识符找到该项目.
ObsoleteProduct	Item is no longer sold.

<a name="purchaseordertype">

PurchaseOrderType

采购订单的类型.

类型 : 枚举

Value	Description
RegularOrder	定期采购订单是一种为具有特定数量和单价的细列商品一次性采购和付款的下单方法.
代销订单	代销采购订单是与供应商达成的协议，允许接收产品，但库存仍属于供应商，直到产品被使用.
新产品介绍	一种介绍新产品的采购订单.
RushOrder	Rush订单是购买货物，需要在某个比标准到货日期早得多的日期前处理并交货.

<a name="paymentmethod">

PaymentMethod

使用的支付方式.

类型 : 枚举

Value	Description
发票	发票付款是由企业提交的，用于支付从供应商处购买的产品和服务.
寄售	一个零售商品商作为收货人提供的货物的寄售人.寄售人在销售后向收货人付款，并保留一定比例的收益
信用卡	使用信用卡付款.
预付	付款是预付的.

<a name="purchaseorderstatus">

PurchaseOrderStatus

类型 : 枚举

<a id="purchaseorderstatus-subgroup-1">用于定义(s)OrderStatus 这个订单的买方采购订单的状态.

Value	Description
OPEN	买方尚未收到采购订单中的所有物品.
CLOSED	买方已经收到采购订单中的所有物品.

<a id="purchasestatus-subgroup-2">用于操作(s)getPurchaseOrdersStatus 根据指定的采购订单状态过滤采购订单.如果不包括在过滤器中，这将返回所有状态的采购订单.

Value	Description
OPEN	买方尚未收到采购订单中的所有物品.
CLOSED	买方已经收到采购订单中的所有物品.

<a name="purchaseorderstate">

PurchaseOrderState

类型 : 枚举

<a id="purchaseorderstate-subgroup-1">用于操作(s)getPurchaseOrders 根据采购订单的状态来过滤采购订单.

Value	Description
新	新创建的订单的状态.
Acknowledged	被供应商确认的订单的状态.
关闭	已完成的订单的状态.

<a id="purchaseorderstate-subgroup-2">用于定义(s)Order 这个字段将包含采购订单的当前状态.

Value	Description
新	采购订单是新创建的，需要得到供应商的确认.
Acknowledged	该采购订单已被供应商确认.
Closed	该采购订单已经关闭，不需要供应商采取进一步的行动.PO处于关闭状态的原因有很多，如订单被供应商拒绝，订单被亚马逊取消或订单被亚马逊完全收到.