订单API v0参考

亚马逊SPAPI

# 概述

订单的销售伙伴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 联盟一站式商店.所购买的商品在欧盟境内待运.
    Last Updated: 2022/10/17 下午9:17:02