供应商订单API v1参考

亚马逊SPAPI

<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处于关闭状态的原因有很多,如订单被供应商拒绝,订单被亚马逊取消或订单被亚马逊完全收到.
Last Updated: 2022/10/17 下午9:17:02