订单API v0参考

概述

订单的销售伙伴API帮助您以编程方式检索订单信息.这些API让您在订单同步、订单研究和基于需求的决策支持工具等领域开发快速、灵活、定制的应用程序.

Version information

版本 : v0

Operations

getOrders
getOrder
getOrderBuyerInfo
getOrderAddress
getOrderItems
getOrderItemsBuyerInfo
updateShipmentStatus
getOrderRegulatedInfo
updateVerificationStatus
<a name="paths">

路径

<a name="getorders">

getOrders

GET /orders/v0/orders

Description

返回在指定参数指示的时间范围内创建或更新的订单.你也可以应用一系列的过滤条件来缩小返回的订单列表.如果NextToken存在，它将被用来检索订单而不是其他条件.

使用计划：

速率(每秒的请求)	突发
0.0167	20

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴 API (opens new window).

Parameters

Type	Name	Description	Schema
Query	CreatedAfter optional	A日期用于选择在(或)指定时间后创建的订单.只返回指定时间后的订单.需要CreatedAfter参数或LastUpdatedAfter参数.两者不能为空.日期必须是ISO 8601格式.	string
*Query	*CreatedBefore optional	A日期，用于选择在(或)指定时间之前创建的订单.只返回指定时间之前的订单.日期必须是ISO 8601格式.	string
Query	LastUpdatedAfter optional	A日期，用于选择在(或在)指定时间后最后更新的订单.更新被定义为订单状态的任何变化，包括创建一个新的订单.包括亚马逊和卖家的更新.日期必须是ISO 8601格式.	string
Query	LastUpdatedBefore optional	A日期，用于选择在(或)指定时间之前最后更新的订单.更新被定义为订单状态的任何变化，包括创建一个新的订单.包括亚马逊和卖家的更新.日期必须是ISO 8601格式.	string
Query	OrderStatuses optional	A list of OrderStatus values used to filter the results. Possible values: PendingAvailability (此状态仅适用于pre-订单.订单已经下达，付款尚未被授权，并且商品的发布日期在未来.)；Pending (订单已经下达，但付款尚未被授权)未发货(付款已被授权，订单已准备好发货，但订单中没有任何物品已经发货)；部分发货(订单中的一个或多个，但不是所有物品已经发货)Shipped (订单中的所有商品都已发货); InvoiceUnconfirmed (订单中的所有商品都已发货.卖家尚未向亚马逊确认发票已发货给买家.)Canceled (该订单已被取消); and Unfulfillable (该订单不能被履行. 这种状态只适用于Multi-Channel Fulfillment订单.).	< string > array
Query	MarketplaceIds required	A list of MarketplaceId values. 用于选择在指定市场上的订单. See the Selling Partner API Developer Guide (opens new window) for a complete list of marketplaceId values. Max count : 50	< string > array
Query	FulfillmentChannels optional	A list that indicates an order was fulfilled. Filters the results by fulfillment channel. Possible values: AFN (由亚马逊履行)；MFN (由卖家履行).	< string > array
Query	PaymentMethods optional	A list of payment method values. Used to select orders paid using the specified payment methods. Possible values: COD (货到付款); CVS (便利店付款); Other (除COD或CVS以外的任何付款方式).	< string > array
Query	BuyerEmail optional	买家的电子邮件地址.用于选择包含指定电子邮件地址的订单.	string
*Query	*SellerOrderId optional	由卖方指定的订单标识符.用于只选择符合订单标识符的订单.如果指定SellerOrderId，则不能指定FulfillmentChannels, OrderStatuses, PaymentMethod, LastUpdatedAfter, LastUpdatedBefore, and BuyerEmail.	string
*Query	MaxResultsPerPage optional	A number that indicates the maximum number of orders that can be returned per page. Value must be 1 - 100. Default .	integer
Query	EasyShipShipmentStatuses optional	A list of EasyShipShipmentStatus values. Used to select Easy Ship orders with statuses that match the specified values. If EasyShipShipmentStatus is specified, only Amazon Easy Ship orders are returned.possible values: PendingPickUp (亚马逊还没有从卖家那里取走包裹). LabelCanceled (卖家取消了取货). PickedUp (亚马逊已经从卖家那里取走了包裹). AtOriginFC (该 包裹在原产地履行中心). AtDestinationFC (包裹在目的地履行中心). OutForDelivery (包裹已被送出). Damaged (包裹被承运人损坏被承运人损坏).已交付(包裹已交付给买方).RejectedByBuyer (包裹已被买方拒绝).无法交付(包裹无法交付). ReturnedToSeller (包裹没有交付给买方，被退回给卖方). ReturningToSeller (包裹没有交付给买方，被退回给卖方).	< string > array
Query	NextToken optional	A string token returned in the response of your previous request.	string
Query	AmazonOrderIds optional	A list of AmazonOrderId values.AmazonOrderId是一个Amazon-defined order identifier, in 3-7-7 format. Max count : 50	< string > array
*Query	*ActualFulfillmentSupplySourceId optional	Denotes the recommended sourceId where the order should be fulfilled from .	string
*Query	*IsISPU optional	当为真时，此订单被标记为从商店取货而不是送货.	boolean
Query	StoreChainStoreId optional	商店链的商店标识.链接到一个商店链中的特定商店.	string

Responses

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

<a name="getorder">

getOrder

GET /orders/v0/orders/{orderId}

Description

返回您指定的订单.

使用计划：

Rate (requests per second)	Burst
0.0167	20

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴 API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	An Amazon-defined order identifier, in 3-7-7 format.	string

Responses

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

<a name="getorderbuyerinfo">

getOrderBuyerInfo

GET /orders/v0/orders/{orderId}/buyerInfo

Description

返回您指定的订单的买方信息.

使用计划：

Rate (requests per second)	Burst
0.0167	20

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴 API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	一个orderId是亚马逊-定义的订单标识符，以3-7-7格式.	string

Responses

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

<a name="get orderaddress">

getOrderAddress

GET /orders/v0/orders/{orderId}/address

Description

返回您指定的订单的运输地址.

使用计划：

Rate (requests per second)	Burst
0.0167	20

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴 API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	一个orderId是亚马逊-定义的订单标识符，以3-7-7格式.	string

Responses

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

<a name="getorderitems">

getOrderItems

GET /orders/v0/orders/{orderId}/orderItems

Description

返回您指定的订单的详细订单信息.如果提供NextToken，它将被用来检索下一页的订单项目.

注意__当一个订单处于挂起状态(订单已经下达，但付款尚未授权)，getOrderItems操作不会返回有关价格、税金、运费.当订单离开待定状态(这发生在付款已被授权)并进入未发货、部分发货或已发货状态后，getOrderItems操作会返回订单中的订单项目的价格、税收、运费、礼品状态和促销活动等信息.

使用计划：

速率(每秒的请求)	突发
0.5	30

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
Query	NextToken optional	A string token returned in your previous request.	string

Responses

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

<a name="getorderitemsbuyerinfo">

getOrderItemsBuyerInfo

GET /orders/v0/orders/{orderId}/orderItems/buyerInfo

Description

返回您指定的订单项目的买方信息.

使用计划：

Rate (requests per second)	Burst
0.5	30

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
Query	NextToken optional	A string token returned in your previous request.	string

Responses

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

<a name=" updateshipmentstatus">

updateShipmentStatus

POST /orders/v0/orders/{orderId}/shipment

Description

更新您指定的订单的装运状态.

使用计划：

速率(每秒的请求)	突发
5	15

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
Body	payload required	updateShipmentStatus操作的请求主体.	UpdateShipmentStatusRequest

Responses

HTTP Code	Description	Schema
204	Success. 头: x-amzn-RateLimit-Limit (string) : 您的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) : 唯一的请求参考标识.	No Content
400	请求有缺失或无效的参数，无法解析. 头文件 : x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier.	UpdateShipmentStatusErrorResponse
403	表示禁止访问该资源.可能的原因包括拒绝访问、未经授权、过期令牌或无效签名. 头 : x-amzn-RequestId (string) : Unique request reference identifier.	UpdateShipmentStatusErrorResponse
404	指定的资源不存在. 头: x-amzn-RateLimit-Limit (string) : 你的速率限制(每秒的请求)为这个操作. x-amzn-RequestId (string) Unique request reference identifier.	UpdateShipmentStatusErrorResponse
413	请求的大小超过了最大接受的大小. 头: x-amzn-RequestId (string) : Unique request reference identifier.	UpdateShipmentStatusErrorResponse
415	请求的有效载荷是不支持的格式. 头: x-amzn-RequestId (string) : Unique request reference identifier.	UpdateShipmentStatusErrorResponse
429	请求的频率超过允许的范围. 头: x-amzn-RequestId (string) : Unique request reference identifier.	UpdateShipmentStatusErrorResponse
500	发生了一个意想不到的情况，使服务器无法完成该请求. 头信息: x-amzn-RequestId (string) : Unique request reference identifier.	UpdateShipmentStatusErrorResponse
503	服务器临时超载或维护. 头: x-amzn-RequestId (string) : Unique request reference identifier.	UpdateShipmentStatusErrorResponse

<a name="get orderregulatedinfo">

getOrderRegulatedInfo

GET /orders/v0/orders/{orderId}/regulatedInfo

Description

返回您指定的订单的监管信息.

使用计划：

Rate (requests per second)	Burst
0.5	30

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	一个orderId是亚马逊-定义的订单标识符，以3-7-7格式.	string

Responses

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

<a name="updateverificationstatus">

updateVerificationStatus

PATCH /orders/v0/orders/{orderId}/regulatedInfo

Description

更新(批准或拒绝)包含受监管产品的订单的验证状态.

使用计划：

速率(每秒的请求)	突发
0.5	30

响应头 "x-amzn-RateLimit-Limit "返回应用于请求操作的使用计划速率限制（如果有的话）. 上表显示了该操作的默认速率和突发值. 业务需求需要更高的吞吐量的销售伙伴可能会看到比这里显示的更高的速率和突发值. 更多信息，请参阅使用计划和速率限制在销售伙伴API (opens new window).

Parameters

Type	Name	Description	Schema
Path	orderId required	一个orderId是一个亚马逊-定义的订单标识符，以3-7-7格式.	string
Body	payload required	Request to update verification status of an order containing regulated products.	UpdateVerificationStatusRequest

Responses

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

<a name="definitions">

Definitions

<a name=" updateshipmentstatusrequest">

UpdateShipmentStatusRequest

updateShipmentStatus操作的请求主体.

Name	Description	Schema
marketplaceId required	The unobfuscated marketplace identifier.	MarketplaceId

|orderItems
optional|对于部分货件状态的更新，需要更新的订单项目和数量列表.|OrderItems|

<a name="updateverificationstatusrequest">

UpdateVerificationStatusRequest

请求更新包含受管制产品的订单的验证状态.

Name	Description	Schema
regulatedOrderVerificationStatus required	The updated values of the VerificationStatus field.	UpdateVerificationStatusRequestBody

<a name="updateverificationstatusrequestbody">

UpdateVerificationStatusRequestBody

验证状态字段的更新值.

Name	Description	Schema
status required	订单的新验证状态.	VerificationStatus
externalReviewerId required	订单的监管信息审查员的标识符.	string
rejectionReasonId optional	用于拒绝订单监管信息的拒绝原因的唯一标识符.只有在新状态为拒绝时才需要.	string

<a name="marketplaceid">

MarketplaceId

未被混淆的市场识别码.

类型：字符串

<a name="shipmentstatus">

ShipmentStatus

要应用的货件状态.

类型 : 枚举

Value	Description
ReadyForPickup	Ready for pickup.
PickedUp	Picked up.
RefusedPickup	Refused pickup.

<a name="orderitems">

OrderItems

对于部分发货状态的更新，需要更新的订单项目和数量列表.

类型 : < OrderItems > array

<a name="orderitems-inline"> 订单项目

Name	Description	Schema
orderItemId optional	订单项目的唯一标识符.	string
quantity optional	用于更新货物状态的数量.	integer

<a name=" updateshipmentstatuserrorresponse">

UpdateShipmentStatusErrorResponse

UpdateShipmentStatus操作的错误响应模式.

Name	Description	Schema
errors optional	在UpdateShipmentStatus操作中发生了一个或多个意外的错误.	ErrorList

<a name="updateverificationstatuserrorresponse">

UpdateVerificationStatusErrorResponse

UpdateVerificationStatus操作的错误响应模式.

Name	Description	Schema
errors optional	在UpdateVerificationStatus操作中发生了一个或多个意外的错误.	ErrorList

<a name="getordersresponse">

GetOrdersResponse

getOrders操作的响应模式.

Name	Description	Schema
payload optional	getOrders操作的有效载荷.	OrdersList
errors optional	在 getOrders 操作中发生了一个或多个意外的错误.	ErrorList

<a name="getorderresponse">

GetOrderResponse

getOrder操作的响应模式.

Name	Description	Schema
payload optional	getOrder操作的有效载荷.	Order
errors optional	在 getOrder 操作中发生一个或多个意外的错误.	ErrorList

<a name="getorderbuyer inforesponse">

GetOrderBuyerInfoResponse

getOrderBuyerInfo操作的响应模式.

Name	Description	Schema
payload optional	getOrderBuyerInfo操作的有效载荷.	OrderBuyerInfo
errors optional	在 getOrderBuyerInfo 操作中发生了一个或多个意外的错误.	ErrorList

<a name="getorderregulated inforesponse">

GetOrderRegulatedInfoResponse

getOrderRegulatedInfo操作的响应模式.

Name	Description	Schema
payload optional	getOrderRegulatedInfo操作的有效载荷.	OrderRegulatedInfo
errors optional	在 getOrderRegulatedInfo 操作中发生了一个或多个意外的错误.	ErrorList

<a name="getorderaddressresponse">

GetOrderAddressResponse

getOrderAddress操作的响应模式.

Name	Description	Schema
payload optional	getOrderAddress操作的有效载荷.	OrderAddress
errors optional	在 getOrderAddress 操作中发生了一个或多个意外的错误.	ErrorList

<a name="getorderitemsresponse">

GetOrderItemsResponse

getOrderItems操作的响应模式.

Name	Description	Schema
payload optional	getOrderItems操作的有效载荷.	OrderItemsList
errors optional	在 getOrderItems 操作中发生了一个或多个意外的错误.	ErrorList

<a name="getorderitemsbuyer inforesponse">

GetOrderItemsBuyerInfoResponse

getOrderItemsBuyerInfo操作的响应模式.

Name	Description	Schema
payload optional	getOrderItemsBuyerInfo操作的有效载荷.	OrderItemsBuyerInfoList
errors optional	在 getOrderItemsBuyerInfo 操作中发生了一个或多个意外的错误.	ErrorList

<a name="orderslist">

OrdersList

一个订单的列表，连同附加信息，以便进行后续的API调用.

Name	Description	Schema
Orders required	A list of orders.	OrderList
NextToken optional	当存在并且不为空时，在下一个请求中传递这个字符串令牌以返回下一个响应页面.	string
LastUpdatedBefore optional	用于选择在指定时间之前(或)最后更新的订单的日期.更新被定义为订单状态的任何变化，包括新订单的创建.包括亚马逊和卖家的更新.所有日期必须是ISO8601格式.	string
CreatedBefore optional	A日期用于选择在(或在)指定时间之前创建的订单.只返回指定时间之前的订单.日期必须是ISO 8601格式.	string

<a name="orderlist">

OrderList

一个订单的列表.

类型< Order >数组

<a name="order">

Order

订单信息.

Name	Description	Schema
AmazonOrderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
SellerOrderId optional	A seller-defined order identifier.	string
PurchaseDate required	创建订单的日期.	string
LastUpdateDate required	订单最后被更新的日期. 注意对于2009年之前最后一次更新的订单，LastUpdateDate的返回日期是不正确的-04-01.	string
OrderStatus required	当前的订单状态.	enum (OrderStatus)
FulfillmentChannel optional	订单是由亚马逊(AFN)还是由卖家(MFN).	enum (FulfillmentChannel
SalesChannel optional	订单中第一个商品的销售渠道.	string
*OrderChannel optional	订单中第一个商品的订购渠道.	string
*ShipServiceLevel optional	该订单的发货服务水平.	string
*OrderTotal optional	此订单的总费用.	Money
运送的物品数量 可选择	运送的物品数量.	整数
NumberOfItemsUnshipped optional	The number of items unshipped.	integer
PaymentExecutionDetail optional	关于货到付款(COD)订单的子-支付方式的信息. _注意对于使用一种sub-payment方法支付的COD订单，将返回一个PaymentExecutionDetailItem对象，PaymentExecutionDetailItem/PaymentMethod = COD.对于使用多种sub-payment方法支付的COD订单，将返回两个或多个PaymentExecutionDetailItem对象.	PaymentExecutionDetailItemList
PaymentMethod optional	订单的支付方式.此属性仅限于货到付款(COD)和便利店(CVS)支付方式.除非你需要PaymentExecutionDetailItem对象提供的特定COD支付信息我们建议使用PaymentMethodDetails属性来获取支付方式信息.	enum (PaymentMethod
PaymentMethodDetails optional	A list of payment methods for the order.	PaymentMethodDetailItemList
MarketplaceId optional	下订单的市场的标识符.	string
*货物服务级别类别 可选	订单的货物服务级别类别. 可能的值Expedited, FreeEconomy, NextDay, SameDay, SecondDay, Scheduled, Standard.	string
EasyShipShipmentStatus optional	亚马逊易发货订单的状态.此属性只包含在亚马逊易发货订单中. 可能的值PendingPickUp, LabelCanceled, PickedUp, OutForDelivery, Damaged, Delivered, RejectedByBuyer, Undeliverable, ReturnedToSeller, ReturningToSeller.	string
CbaDisplayableShippingLabel optional	Custom ship label for Checkout by Amazon (CBA).	string
OrderType optional	订单的类型.	enum (OrderType
EarliestShipDate optional	您承诺发货的时间段的开始.以ISO8601日期时间格式.仅对卖方-已完成的订单返回. _注意__对于2013年2月1日之前的订单，EarliestShipDate可能不会被返回.	string
LatestShipDate optional	您承诺发货的时间段结束.以ISO8601日期时间格式.仅对卖家-已完成的订单返回. __注意对于2013年2月1日之前的订单，LatestShipDate可能不会被返回.	string
EarliestDeliveryDate optional	您承诺履行订单的时间段的开始.以ISO 8601日期时间格式.仅对卖方-履行的订单返回.	string
LatestDeliveryDate optional	您承诺履行订单的时间段结束.以ISO 8601日期时间格式.仅对没有PendingAvailability、Pending或Canceled状态的卖方-fulfilled订单返回
IsBusinessOrder optional	为真时，该订单为Amazon Business订单.Amazon Business订单是指买方为经过验证的商业买家的订单.	boolean
IsPrime optional	为真时，该订单为卖家-fulfilled Amazon Prime订单.	boolean
IsPremiumOrder optional	当为真时，该订单有一个Premium Shipping Service Level Agreement.关于Premium Shipping订单的更多信息，请参见您所在市场的Seller Central Help中的 "Premium Shipping Options".	boolean
IsGlobalExpressEnabled optional	为真时，该订单为GlobalExpress订单.	boolean
ReplacedOrderId optional	被替换的订单的订单ID值.仅在IsReplacementOrder = true时返回.	string
IsReplacementOrder optional	为真时，这是一个替换的订单.	boolean
PromiseResponseDueDate optional	表示卖方必须回复买方的估计发货日期.仅对Sourcing on Demand订单返回.	string
IsEstimatedShipDateSet optional	为真时，订单的预计发货日期被设置.仅对按需采购订单返回.	boolean
IsSoldByAB optional	当为真时，此订单中的商品是由Amazon Business EU SARL购买并重新-销售的(ABEU).通过购买并立即重新-销售您的商品，ABEU成为记录中的卖家，使您的库存可以销售给那些不会从第三方卖家购买的客户.	boolean
IsIBA optional	为真时，此订单中的商品由Amazon Business EU SARL购买和再-销售(ABEU).通过购买和即时再-销售您的商品，ABEU成为记录中的卖家，使您的库存可以销售给那些不会从第三方卖家购买的顾客.	boolean
DefaultShipFromLocationAddress optional	推荐给卖家的发货地点.它在结账时计算.卖家可以选择从这个地点发货，也可以不选择.	Address
BuyerInvoicePreference optional	the buyer's invoicing preference. Available only in the TR marketplace.	enum (BuyerInvoicePreference)
BuyerTaxInformation optional	包含商业发票的税务信息.	[BuyerTaxInformation](#buyertaxin information)
FulfillmentInstruction optional	包含关于履行的说明，如应该从哪里履行.	FulfillmentInstruction
IsISPU optional	为真时，该订单被标记为从商店取货而不是送货.	boolean
IsAccessPointOrder optional	当为真时，此订单被标记为送到一个接入点.接入点由客户选择.接入点包括Amazon Hub Lockers, Amazon Hub Counters, 和由运营商运营的提货点.	boolean
MarketplaceTaxInfo optional	Tax information about the marketplace.	MarketplaceTaxInfo
SellerDisplayName optional	在市场上注册的卖方的友好名称.	string
ShippingAddress optional	订单的运输地址.	Address
BuyerInfo optional	Buyer information.	BuyerInfo
AutomatedShippingSettings optional	包含有关自动发货设置程序的信息，如订单的发货设置是否自动生成，以及这些设置是什么.	AutomatedShippingSettings
HasRegulatedItems optional	订单是否包含受管制的物品，这些物品可能需要额外的审批步骤才能完成.	boolean

<a name="orderbuyerinfo">

OrderBuyerInfo

一个订单的买方信息.

Name	Description	Schema
AmazonOrderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
BuyerEmail optional	买家的匿名电子邮件地址.	string
*BuyerName optional	买家的名字.	string
*BuyerCounty optional	买方的县.	string
BuyerTaxInfo optional	关于买方的税收信息.	BuyerTaxInfo
采购订单号 可选	买方在结账时输入的采购订单(PO)号码.仅对买方在结账时输入PO号码的订单返回.	string

<a name="orderregulatedinfo">

OrderRegulatedInfo

订单的监管信息以及它的验证状态.

Name	Description	Schema
AmazonOrderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
监管信息 必须的	购买时收集的监管信息，用于验证订单.	监管信息
RequiresDosageLabel required	为真时，该订单要求在发货时附上剂量信息标签.	boolean
RegulatedOrderVerificationStatus required	The order's verification status.	RegulatedOrderVerificationStatus

<a name="regulatedorderverificationstatus">

RegulatedOrderVerificationStatus

订单的验证状态，以及相关的批准或拒绝元数据.

Name	Description	Schema
Status required	订单的验证状态.	VerificationStatus
RequiresMerchantAction required	为真时，订单中提供的受监管信息需要商家审查.	boolean
ValidRejectionReasons required	一个有效的拒绝理由列表，可以用来拒绝订单中的受监管信息.	< RejectionReason > array
RejectionReason optional	拒绝订单的监管信息的原因.如果订单没有被拒绝就不存在.	RejectionReason
ReviewDate optional	订单被审核的日期.以ISO8601日期时间格式.	string
ExternalReviewerId optional	该订单的监管信息审查员的标识符.	string

<a name="rejectionreason">

RejectionReason

拒绝订单的监管信息的原因.如果订单没有被拒绝就不存在.

Name	Description	Schema
RejectionReasonId required	拒绝原因的唯一标识符.	string
RejectionReasonDescription required	这个拒绝原因的描述.	string

<a name="verificationstatus">

VerificationStatus

订单的验证状态.

类型 : 枚举

Value	Description
Pending	该订单正在等待批准.注意，根据RequiresMerchantAction属性确定，可能需要由商家以外的人批准.
Approved	该订单的监管信息已被审查和批准.
拒绝	该订单的监管信息已被审查并拒绝.
过期	审查该订单的监管信息的时间已经过期.
Cancelled	该订单被购买者取消了.

<a name="regulatedinformation">

RegulatedInformation

在购买过程中收集的被监管的信息，用于验证订单.

Name	Description	Schema
Fields required	A list of regulated information fields as collected from regulatory form.	< RegulatedInformationField> array

<a name="regulatedinformationfield">

RegulatedInformationField

一个从监管表格中收集的字段.

Name	Description	Schema
FieldId required	字段的唯一标识符.	string
FieldLabel required	字段的名称.	string
FieldType required	字段的类型.	enum (FieldType
FieldValue required	监管表格中收集的字段内容.注意，FileAttachment类型的字段将包含一个URL，可以在这里下载附件.	string

<a name="orderaddress">

OrderAddress

该订单的运输地址.

Name	Description	Schema
AmazonOrderId required	An Amazon-defined order identifier, in 3-7-7 format.	string
ShippingAddress optional	订单的运输地址.	Address

<a name="地址">

Address

该订单的运输地址.

Name	Description	Schema
Name required	The name.	string
AddressLine1 可选的	街道地址.	string
AddressLine2 optional	额外的街道地址信息，如果需要的话.	string
AddressLine3 optional	额外的街道地址信息，如果需要的话.	string
City optional	The city	string
County optional	The county.	string
District optional	The district.	string
州或地区 可选择	州或地区.	string
Municipality optional	The municipality.	string
邮政编码 可选择	邮政编码.	string
CountryCode optional	国家代码.两个字符的国家代码，采用ISO 3166-1 alpha-2格式.	string
Phone optional	电话号码.不返回给Fulfillment by Amazon (FBA)订单.	string
AddressType optional	发货地址的地址类型.	enum (AddressType)

<a name="money">

Money

订单的货币价值.

Name	Description	Schema
CurrencyCode optional	三位数的货币代码.以ISO 4217格式.	string
金额 可选择	货币金额.	string

<a name="paymentmethoddetailitemlist">

PaymentMethodDetailItemList

一个支付方式细节项目的列表.

类型 < string > 数组

<a name="paymentexecutiondetailitemlist">

PaymentExecutionDetailItemList

一个付款执行细节项目的列表.

类型: < PaymentExecutionDetailItem > 数组

<a name="paymentexecutiondetailitem">

PaymentExecutionDetailItem

关于用于支付COD订单的子-支付方式的信息.

Name	Description	Schema
付款 要求	订单的货币价值.	Money
付款方式 required	A sub-payment method for a COD order. possible values: COD - Cash On Delivery. GC - Gift Card. PointsAccount - Amazon Points.	string

<a name="buyertaxinfo">

BuyerTaxInfo

关于买方的税务信息.

Name	Description	Schema
公司法律名称 可选	公司的法律名称.	字符串
TaxingRegion optional	征税的国家或地区.	string
TaxClassifications optional	适用于该订单的税收分类列表.	< TaxClassification > 数组

<a name="marketplacetaxinfo">

MarketplaceTaxInfo

关于市场的税务信息.

Name	Description	Schema
TaxClassifications optional	适用于订单的税收分类列表.	< TaxClassification>数组

<a name="taxclassification">

TaxClassification

该订单的税收分类.

Name	Description	Schema
名称 可选	税收的类型.	字符串
*值 可选择	买方的税务识别码.	string

<a name="orderitemslist">

OrderItemsList

订单项目列表，以及订单ID.

Name	Description	Schema
OrderItems required	A list of order items.	OrderItemList
NextToken optional	当存在且不为空时，在下一个请求中传递这个字符串令牌以返回下一个响应页面.	string
AmazonOrderId required	An Amazon-defined order identifier, in 3-7-7 format.	string

<a name="orderitemlist">

OrderItemList

一个订单项目的列表.

类型< OrderItem > 数组

<a name="orderitem">

OrderItem

一个单一的订单项目.

Name	Description	Schema
ASIN 必须的	亚马逊标准识别码(ASIN)的物品.	字符串
SellerSKU optional	该商品的卖家库存单位(SKU).	string
OrderItemId required	An Amazon-defined order item identifier.	string
Title optional	物品的名称.	string
QuantityOrdered required	订单中的物品数量.	integer
*发运数量 可选	发运的物品数量.	integer
ProductInfo optional	Product information for the item.	ProductInfoDetail
PointsGranted optional	购买商品时获得的亚马逊积分的数量和价值.	PointsGrantedDetail
ItemPrice optional	订单物品的销售价格.注意，一个订单物品是一个物品和一个数量.这意味着ItemPrice的值等于物品的销售价格乘以订单数量.注意，ItemPrice不包括ShippingPrice和GiftWrapPrice.	Money
ShippingPrice optional	项目的运输价格.	Money
ItemTax optional	物品价格的税收.	Money
ShippingTax optional	运输价格的税收.	Money
运费折扣 可选择	运费的折扣.	Money
运费折扣税 可选择	运费折扣税.	Money
PromotionDiscount optional	报价中所有促销折扣的总额.	Money
促销折扣税 可选择	该优惠中所有促销折扣总额的税金.	Money
PromotionIds optional	在创建促销活动时由卖方提供的促销标识符的列表.	PromotionIdList
CODFee optional	COD服务的收费.	Money
CODFeeDiscount optional	COD费用的折扣.	Money
IsGift optional	为真时，该物品是一个礼物.	boolean
ConditionNote optional	卖家描述的物品状况.	string
ConditionId optional	物品的状况. 可能的值新的, 二手的, 收藏的, 翻新的, 预购的, 俱乐部.	string
ConditionSubtypeId optional	物品的次级条件. 可能的值新的, 新鲜的, 非常好的, 好的, 可接受的, 差的, 俱乐部, OEM, 保修, 翻新保修, 翻新的, 开箱的, 任何, 其他.	string
ScheduledDeliveryStartDate optional	订单目的地时区的预定交货窗口的开始日期.以ISO8601日期时间格式.	string
ScheduledDeliveryEndDate optional	订单目的地时区的预定交货窗口的结束日期.以ISO 8601日期时间格式.	string
PriceDesignation optional	表示销售价格是仅适用于Amazon Business订单的特殊价格.关于Amazon Business卖家计划的更多信息，请参阅Amazon Business网站 (opens new window). 可能的值BusinessPrice -只对Amazon Business订单提供的特殊价格.	string
TaxCollection optional	Information about withheld taxes.	TaxCollection
SerialNumberRequired optional	为真时，此商品的产品类型有一个序列号. 仅对亚马逊易发货的订单返回.	boolean
IsTransparency optional	为真时，需要透明代码.	boolean
IossNumber optional	市场的IOSS号码.卖家从欧盟以外的地方运往欧盟(EU)，当亚马逊收取了销售的增值税后，必须向他们的运营商提供这个IOSS号码.	string
StoreChainStoreId optional	商店链的商店标识.链接到商店链中的一个特定商店.	string
DeemedResellerCategory optional	认定经销商的类别.这适用于不在欧盟的销售伙伴，用来帮助他们满足欧盟和英国的增值税认定经销商税法.	enum (DeemedResellerCategory)
BuyerInfo optional	A single item's buyer information.	ItemBuyerInfo
BuyerRequestedCancel optional	关于买方是否要求取消的信息.	BuyerRequestedCancel

<a name="orderitemsbuyerinfolist">

OrderItemsBuyerInfoList

单个订单项目的买方信息列表，订单编号为.

Name	Description	Schema
OrderItems required	A single order item's buyer information list.	OrderItemBuyerInfoList
NextToken optional	当存在且不为空时，在下一个请求中传递此字符串令牌以返回下一个响应页面.	string
AmazonOrderId required	An Amazon-defined order identifier, in 3-7-7 format.	string

<a name="orderitembuyerinfolist">

OrderItemBuyerInfoList

单个订单项目的买方信息列表.

类型: < OrderItemBuyerInfo > 数组

<a name="orderitembuyerinfo">

OrderItemBuyerInfo

单个订单项目的买方信息.

Name	Description	Schema
OrderItemId required	An Amazon-defined order item identifier.	string
BuyerCustomizedInfo 可选的	来自亚马逊定制计划的定制订单的买家信息.	BuyerCustomizedInfoDetail
GiftWrapPrice optional	物品的礼品包装价格.	Money
GiftWrapTax optional	礼品包装价格的税收.	Money
GiftMessageText optional	由买家提供的礼物信息.	string
GiftWrapLevel optional	由买方指定的礼品包装级别.	string

<a name="pointsgranteddetail">

PointsGrantedDetail

购买商品时提供的亚马逊积分的数量，以及它们的货币价值.

Name	Description	Schema
PointsNumber optional	购买商品时获得的亚马逊积分数量.	integer
PointsMonetaryValue optional	授予的亚马逊积分的货币价值.	Money

<a name="productinfodetail">

ProductInfoDetail

产品信息的数量.

Name	Description	Schema
NumberOfItems optional	包含在ASIN中的项目总数.	integer

<a name="promotionidlist">

PromotionIdList

卖家在创建促销活动时提供的促销标识符的列表.

类型 < string > 数组

<a name="buyercustomizedinfodetail">

BuyerCustomizedInfoDetail

来自亚马逊定制计划的定制订单的买家信息.

Name	Description	Schema
CustomizedURL optional	包含亚马逊自定义数据的zip文件的位置.	string

<a name="taxcollection">

TaxCollection

关于预扣税款的信息.

Name	Description	Schema
模型 可选	应用于项目的征税模型.	enum (Model
ResponsibleParty optional	负责扣留税款并汇给税务机关的一方.	enum (ResponsibleParty)

<a name="buyertaxinformation">

BuyerTaxInformation

包含商业发票的税务信息.仅在TR市场上可用.

Name	Description	Schema
买方法律公司名称 可选	企业买方的公司法律名称.	string
BuyerBusinessAddress optional	Business buyer's address.	string
*买家税务登记ID optional	商业买家的税务登记ID.	string
*买方税务局 可选择	企业买方税务局.	string

<a name="fulfillmentinstruction">

FulfillmentInstruction

包含关于履行的指示，如应该从哪里履行.|名称|的指示

Name	Description	Schema
FulfillmentSupplySourceId optional	表示推荐的源码，订单应从那里完成.	string

<a name="buyerinfo">

BuyerInfo

买家信息.

Name	Description	Schema
BuyerEmail optional	买方的匿名电子邮件地址.	string
BuyerName optional	买家的名字.	string
*BuyerCounty optional	买方的县.	string
BuyerTaxInfo optional	关于买方的税收信息.	BuyerTaxInfo
PurchaseOrderNumber optional	买方在结账时输入的采购订单(PO)号码.仅对买方在结账时输入PO号码的订单返回.	string

<a name="itembuyerinfo">

ItemBuyerInfo

单个物品的买家信息.

Name	Description	Schema
BuyerCustomizedInfo optional	Buyer Information for custom orders from Amazon Custom program.	BuyerCustomizedInfoDetail
GiftWrapPrice optional	物品的礼品包装价格.	Money
GiftWrapTax optional	礼品包装价格的税收.	Money
GiftMessageText optional	由买方提供的礼品信息.	string
GiftWrapLevel optional	由买方指定的礼品包装级别.	string

<a name="automatedshippingsettings">

AutomatedShippingSettings

包含有关运送设置自动化程序的信息，例如，订单的运送设置是否自动生成，以及这些设置是什么.

Name	Description	Schema
HasAutomatedShippingSettings optional	为真时，该订单具有由亚马逊生成的自动运输设置.该订单可被识别为SSA订单.	boolean
AutomatedCarrier optional	Auto-为SSA订单生成的载体.	string
AutomatedShipMethod optional	Auto-generated ship method for SSA orders.	string

<a name="buyerrequestedcancel">

BuyerRequestedCancel

关于买方是否要求取消的信息.

Name	Description	Schema
IsBuyerRequestedCancel optional	为真时，买方已要求取消.	boolean
BuyerCancelReason optional	买方要求取消的原因.	string

<a name="errorlist">

ErrorList

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

类型 < Error > 数组

<a name="error">

Error

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

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

<a name="buyerinvoicepreference">

BuyerInvoicePreference

买方的开票偏好.仅在TR市场上可用.

类型 : 枚举

Value	Description
INDIVIDUAL	买方应获得一张个人发票.
BUSINESS	买方应开具商业发票.税务信息见BuyerTaxInformation结构.

<a name="orderstatus">

OrderStatus

当前的订单状态.

类型 : 枚举

Value	Description
Pending	订单已经下达，但付款尚未被授权.订单尚未准备好发货.注意，对于订单类型=标准的订单，初始订单状态为Pending.对于订单类型=预购的订单，初始订单状态为PendingAvailability，当付款授权过程开始时，订单转入Pending状态.
Unshipped	付款已被授权，订单已准备好发货，但订单中没有物品被发货.
部分已发货	订单中的一个或多个(但不是全部)项目已经发货.
已发运	订单中的所有物品都已发运.
取消	该订单已被取消.
无法履行	该订单无法履行.该状态只适用于亚马逊-未在亚马逊零售网站上完成的订单.
InvoiceUnconfirmed	订单中的所有商品都已发货.卖家尚未向亚马逊确认发票已发货给买家.
PendingAvailability	此状态仅适用于pre-订单.订单已经下达，付款尚未授权，且商品的发售日期在未来.订单尚未准备好发货.

<a name="ordertype">

OrderType

订单的类型.

类型 : 枚举

Value	Description
标准订单	包含销售伙伴目前有库存的物品的订单.
LongLeadTimeOrder	一个包含有较长交货期的商品的订单.
**Preorder	一个包含发布日期在未来的商品的订单.
BackOrder	一个包含已经在市场上发布但目前没有库存的商品的订单，将在未来提供.
SourcingOnDemandOrder	A Sourcing On Demand订单.

<a name="model">

Model

适用于该物品的征税模式.

类型 : 枚举

Value	Description
MarketplaceFacilitator	税款由亚马逊代表卖家扣留并汇给税务机关.

<a name="paymentmethod">

PaymentMethod

订单的支付方式. 此属性仅限于货到付款(COD)和便利店(CVS)支付方式. 除非你需要PaymentExecutionDetailItem对象提供的特定COD支付信息，否则我们建议使用PaymentMethodDetails属性来获取支付方式信息.

类型 : 枚举

Value	Description
COD	货到付款.
CVS	Convenience store.
其他	除货到付款和CVS以外的付款方式.

<a name="addresstype">

AddressType

发货地址的地址类型.

类型 : 枚举

Value	Description
住宅	发货地址是住宅地址.
商业	收货地址是一个商业地址.

<a name="responsibleparty">

ResponsibleParty

负责扣留税款并汇给税务机关的一方.

类型 : 枚举

Value	Description
亚马逊服务有限公司.	亚马逊服务有限公司.

<a name="fulfillmentchannel">

FulfillmentChannel

该订单是由亚马逊(AFN)还是由卖家(MFN).完成的

类型 : 枚举

Value	Description
MFN	由卖方履行.
AFN	由亚马逊履行.

<a name="fieldtype">

FieldType

字段的类型.

类型 : 枚举

Value	Description
文本	这个字段是一个从监管表格中收集的反应的文本表示.
文件附件	这个字段包含从监管表格中收集的附件的链接.

<a name="deemedresellercategory">

DeemedResellerCategory

认定经销商的类别. 这适用于不在欧盟的销售伙伴，用来帮助他们满足欧盟和英国的增值税认定经销商税法.

类型 : 枚举

Value	Description
IOSS	Import one stop shop.所购买的物品没有被扣留在欧盟境内待运.
UOSS	联盟一站式商店.所购买的商品在欧盟境内待运.