概述

直接履行订单的销售伙伴API提供了对直接履行供应商的订单数据的程序化访问.

Version information

版本 : 2021-12-28

Operations

getOrders
getOrder
submitAcknowledgement
<a name="paths">

路径

<a name="getorders">

getOrders

GET /vendor/directFulfillment/orders/2021-12-28/purchaseOrders

Description

返回在您指定的时间范围内创建的采购订单列表.您使用createdAfter和createdBefore参数定义时间范围.您必须使用这两个参数.您可以通过将includeDetails参数设置为false来选择只获得采购订单号.在这种情况下，该操作返回采购订单号列表.然后您可以调用getOrder操作来返回特定订单的细节.

使用计划：

速率(每秒的请求)	突发
10	10

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

Parameters

Type	Name	Description	Schema	Default
*Query	*shipFromPartyId optional	履约仓库的供应商仓库标识.如果没有指定，结果将包含所有仓库的订单.	string	-
*Query	*status optional	只返回符合指定状态的采购订单.如果没有指定，结果将包含符合任何状态的订单.	enum (Status)	-
Query	limit optional	返回的采购订单的数量限制. Minimum : 1 最大 : 100	integer (int64)	-
*Query	*createdAfter required	在此日期和时间之后可用的采购订单将包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
Query	createdBefore required	在此日期和时间之前成为可用的采购订单将被包括在结果中.必须是ISO-8601日期/时间格式.	string (date-time)
*Query	*sortOrder optional	按订单创建日期以升序或降序排序列表.	enum (SortOrder	-
*Query	*nextToken optional	当有更多的订单超过指定的结果大小限制时，用于分页.token值在前一个API调用中返回.	string	-
Query	includeDetails optional	为真时，返回完整的采购订单细节.否则，只返回采购订单号码.	string (boolean)	"true"

Responses

HTTP Code	Description	Schema
200	Success. 头: x-amzn-RateLimit-Limit (string) : 您对这个操作的速率限制(每秒的请求) x-amzn-RequestId (string) : 唯一的请求参考标识符.	OrderList

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

getOrder

GET /vendor/directFulfillment/orders/2021-12-28/purchaseOrders/{purchaseOrderNumber}

Description

返回您指定的purchaseOrderNumber的采购订单信息.

使用计划：

Rate (requests per second)	Burst
10	10

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

Parameters

Type	Name	Description	Schema
Path	purchaseOrderNumber required	您想要的采购订单的订单标识符.格式说明：alpha-数字代码.	string

Responses

HTTP Code	Description	Schema
200	Success. 头: x-amzn-RateLimit-Limit (string) : 你对这个操作的速率限制(每秒的请求) x-amzn-RequestId (string) : 唯一的请求参考标识.	Order

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

submitAcknowledgement

POST /vendor/directFulfillment/orders/2021-12-28/acknowledgements

Description

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

使用计划：

速率(每秒的请求)	突发
10	10

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

Parameters

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

Responses

HTTP Code	Description	Schema
202	Success. 头: x-amzn-RateLimit-Limit (string) : 您对这个操作的速率限制(每秒的请求) x-amzn-RequestId (string) : 唯一的请求参考标识.	TransactionId

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

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

错误响应和模式

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

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

<a name="definitions">:唯一的请求参考标识符

Definitions

<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
采购订单号 必须的	此订单的采购订单号.格式说明：alpha-数字代码.	string
orderDetails optional	Purchase order details.	OrderDetails

<a name="orderdetails">

OrderDetails

一个订单的细节.

Name	Description	Schema
customerOrderNumber required	The customer order number.	string
*orderDate required	下单日期.此字段预计为ISO-8601日期/时间格式，例如：2018-07-16T23:00 00Z/ 2018-07-16T23:00:00-05:00 /2018-07-16T23:00:00-08:00.如果没有指定时区，应假定为UTC.	string (date-time)
orderStatus optional	订单的当前状态.	enum (OrderStatus
装运细节 required	装运所需的装运细节.	ShipmentDetails
taxTotal optional	行货的总税款详情.	TaxItemDetails
sellingParty required	PartyID of vendor code.	PartyIdentification
shipFromParty required	PartyID of vendor's warehouse.	PartyIdentification
shipToParty required	name/Address and tax details of the ship to party.	Address
billToParty required	name/Address and tax details of the bill to party.	PartyIdentification
items required	A 这个采购订单的项目列表.	< OrderItem > 数组

<a name="partyidentification">

PartyIdentification

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

<a name="taxregistrationdetails">

TaxRegistrationDetails

实体的税务登记详情.

Name	Description	Schema
*税务登记类型 可选	实体的税务登记类型.	enum (税务登记类型)
taxRegistrationNumber required	当事人的税务登记号码.例如，VAT ID.	string
税务登记地址 可选的	与税务登记号码相关的地址.	地址
xRegistrationMessages optional	税务登记信息，可用于额外的税务相关细节.	string

<a name="地址">

Address

当事人的地址.

Name	Description	Schema
name required	该地址的个人、企业或机构的名称.	string
attention optional	该地址的人的注意名称.	string
addressLine1 required	地址的第一行.	string
addressLine2 optional	额外的地址信息，如果需要的话.	string
addressLine3 optional	Additional address information, if required.	string
city optional	个人、企业或机构所在的城市.	string
县 可选择	个人、企业或机构所在的县.	string
区 可选择	个人、企业或机构所在的区.	string
stateOrRegion required	个人、企业或机构所在的州或地区.	string
postalCode 可选的	该地址的邮政编码.它由一系列字母或数字或两者组成，有时包括空格或标点符号.	string
countryCode required	两位数的国家代码.以ISO 3166-1 alpha-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
buyerProductIdentifier optional	买方的标准识别号码(ASIN)的一个项目.	string
vendorProductIdentifier optional	供应商选定的物品的产品标识.	string
title optional	项目的标题.	string
orderedQuantity required	Item quantity ordered.	ItemQuantity
scheduledDeliveryShipment optional	Details for the scheduled delivery shipment.	ScheduledDeliveryShipment
giftDetails optional	Gift message and wrapId details.	GiftDetails
netPrice required	Net price (before tax) to vendor with currency details.	Money
taxDetails optional	细列项目的总税务细节.	TaxItemDetails
totalPrice optional	对亚马逊每个(cost).	Money

<a name="money">

Money

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

Name	Description	Schema
currencyCode optional	ISO 4217格式的三位数货币代码.长度为3的字符串.	string
amount optional	一个没有精度损失的十进制数字.当精度损失不可接受时，很有用，如货币.遵循RFC7159的数字表示法.	Decimal

<a name="十进制">

Decimal

一个没有精度损失的十进制数.当精度损失不可接受时很有用，比如货币.遵循RFC7159的数字表示法.

类型：字符串

<a name="transactionid">

TransactionId

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

<a name="errorlist">

ErrorList

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

Name	Schema
errors required	< Error > array

<a name="submitacknowledgementrequest">

SubmitAcknowledgementRequest

submitAcknowledgement操作的请求模式.

Name	Description	Schema
orderAcknowledgements optional	A list of one or more purchase orders.	< OrderAcknowledgementItem> array

<a name="orderacknowledgementitem">

OrderAcknowledgementItem

被确认的单个订单的详细信息.

Name	Description	Schema
采购订单号 必须的	此订单的采购订单号.格式说明：alpha-数字代码.	string
vendorOrderNumber required	此订单的供应商的订单号.	string
确认日期 必须的	订单被确认的日期和时间，以ISO-8601日期/时间格式.为例2018-07-16T23:00:00Z / 2018-07-16T23:00:00-05:00 / 2018-07-16T23:00:00-08:00.	string (date-time)
acknowledgementStatus required	Status of acknowledgement.	AcknowledgementStatus
sellingParty required	PartyID as vendor code.	PartyIdentification
shipFromParty required	PartyID as the vendor's warehouseId.	PartyIdentification
itemAcknowledgements required	Item details including acknowledged quantity.	< OrderItemAcknowledgement> array

<a name="orderitemAcknowledgement">

OrderItemAcknowledgement

Name	Description	Schema
itemSequenceNumber required	Line item sequence number for the item.	string
买方产品标识符 可选的	买方的标准标识号(ASIN)的一个项目.	string
vendorProductIdentifier optional	供应商选定的物品的产品标识.应与采购订单中提供的相同.	string
确认的数量 必须的	用上述确认代码确认的数量细节.	ItemQuantity

<a name="itemquantity">

ItemQuantity

订购数量的详细信息.

Name	Description	Schema
amount optional	Acknowledged quantity.这个值不应该是零.	integer
unitOfMeasure optional	确认数量的计量单位.	enum (UnitOfMeasure)

<a name="taxlineitem">

TaxLineItem

税项列表.

类型 < TaxDetails > 数组

<a name="taxdetails">

TaxDetails

Name	Description	Schema
taxRate optional	A十进制数字，没有精度损失.当精度损失不可接受时很有用，如货币.遵循RFC7159的数字表示.	Decimal
taxAmount required	一个金额，包括货币形式的单位.	Money
应纳税额 可选择	一个金额，包括货币形式的单位.	Money
type optional	Tax type.	enum (Type)

<a name=" acknowledgementstatus">

AcknowledgementStatus

确认的状态.

Name	Description	Schema
code optional	Acknowledgement code是一个独特的两位数的值，表示确认的状态.关于亚马逊支持的确认代码的列表，见Vendor Direct Fulfillment APIs Use Case Guide.	string
description optional	确认代码的原因.	string

<a name="error">

Error

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

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

<a name="shipmentdetails">

ShipmentDetails

货件所需的货件详情.

Name	Description	Schema
isPriorityShipment required	当为真时，这是一个优先货物.	boolean
isScheduledDeliveryShipment optional	当为真时，这个订单是一个预定交货计划的一部分.	boolean
isPslipRequired required	当为真时，需要向客户发送一份装箱单.	boolean
isGift optional	当为真时，该订单包含一个礼物.包括礼物信息和礼物包装信息.	boolean
*shipMethod required	运送订单所使用的运送方式.亚马逊定义的运送方式代码表明了运送载体和运送服务水平.要查看使用中的运送方式的完整列表，包括代码和友好名称，请在供应商中心的'帮助'部分搜索'运送方式'.	string
shipmentDates required	Shipment dates.	ShipmentDates
messageToCustomer required	Message to customer for order status.	string

<a name="shipmentdates">

ShipmentDates

装运日期.

Name	Description	Schema
requiredShipDate required	供应商需要在什么时间之前发货.	string (date-time)
promisedDeliveryDate optional	承诺给亚马逊客户的交付日期.	string (date-time)

<a name="scheduleddeliveryshipment">

ScheduledDeliveryShipment

预定交货装运的日期.

Name	Description	Schema
预定交货服务类型 可选	预定交货服务类型.	string
earliestNominatedDeliveryDate optional	EarliestNominated delivery date for the scheduled delivery.	string (date-time)
latestNominatedDeliveryDate optional	Latest nominated delivery date for the scheduled delivery.	string (date-time)

<a name="giftdetails">

GiftDetails

该物品的礼品细节.

Name	Description	Schema
giftMessage optional	Gift message to be printed in shipment.	string
giftWrapId optional	用于礼品包装的标识符，如果有的话.	string

<a name="taxitemdetails">

TaxItemDetails

该行的总税收细节.

Name	Description	Schema
taxLineItem optional	Tax details.	TaxLineItem

<a name="status">

Status

只返回符合指定状态的采购订单.如果没有指定，结果将包含符合任何状态的订单.

类型 : 枚举

Value	Description
******	新创建的采购订单的状态.
SHIPPED	已经发货的采购订单的状态.
ACCEPTED	被供应商接受的采购订单的状态.
CANCELLED	取消的采购订单的状态.

<a name="orderstatus">

OrderStatus

订单的当前状态.

类型 : 枚举

Value	Description
******	新创建订单的状态.
SHIPPED	已经发货的订单的状态.
ACCEPTED	被供应商接受的订单的状态.
CANCELLED	取消的订单的状态.

<a name="type">

Type

税收类型.

类型 : 枚举

Value	Description
**CONSUMPTION	对商品和服务的消费支出征收的税款.
GST	对为国内消费而销售的大多数商品和服务征收的税款.
MwSt.	Mehrwertsteuer，MwSt，是德语中的价值税-增值税.
PST	A省销售税(PST)是在加拿大许多省份对商品和特殊服务的消费者征收的.
TOTAL	所有适用税种的综合总额.
TVA	Taxe sur la Valeur Ajoutée (TVA)是法语中的增值税.
VAT	Value-added tax.

<a name="unitofmeasure">

UnitOfMeasure

确认数量的计量单位.

类型 : 枚举

Value	Description
Each	代表单件的计量单位.

<a name="税务登记类型">

TaxRegistrationType

该实体的税务登记类型.

类型 : 枚举

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

<a name="sortorder">

SortOrder

以升序或降序排序，按订单创建日期排序.

类型 : 枚举

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