确认接收订单 — 订单确认
描述
通过“订单确认”上传数据,您能够确认订单下载是否成功。确认上传数据还允许您提供自己的订单编号和订单商品编号,如果需要的话,可在之后用作相同订单的上传数据的参考。
此外,您可以在以下任意情况下利用该上传数据取消整个订单:
买家要求您取消订单(并且您还没有对订单进行配送)。
您接收到了一个单项商品订单,但您不能够对商品(已残损商品)进行配送。
您无法将订单上传到您的系统里面。
要取消订单,请使用 失败状态代码。
词典
元素 | 描述 |
---|---|
亚马逊订单编号 | 亚马逊为订单提供的唯一编号,能够识别整个订单,无论订单中的单项商品数量是多少 |
卖家订单编号 | 由卖家提供的可选订单编号。亚马逊会将卖家订单编号映射到亚马逊订单编号上,之后您就可以对随后的有关订单的上传数据使用自己的订单编号(卖家订单编号)。第一步是在确认上传数据中建立卖家订单编号。查看基础 XSD 了解定义。 |
状态代码 | 允许您确认订单下载是否成功。状态代码要么是 成功要么是 失败。状态代码为 失败时,可用于与亚马逊交流,表示在将订单集成到您的系统时遇到了问题或者您无法处理订单。您遇到配送方面的问题时不应当用该代码进行交流,例如库存里没有该商品。 发送“失败”的状态代码将会自动取消订单;买家也将不用为商品付账。 |
亚马逊订单商品编码 | 亚马逊为订单内商品提供的唯一编号。如果卖家订单商品编号也被指定,则亚马逊将会对两个编号进行映射,并且对于与订单内商品相关的随后的上传数据,您可以利用自己的商品编号。查看基础 XSD 了解定义。 |
卖家订单商品编号 | 卖家为订单内商品提供的可选编号。如果卖家订单商品编号用亚马逊订单商品编码进行指定,则亚马逊将会对两个编号进行映射,对于与该订单商品相关的随后的上传数据,您可以利用自己的订单商品编号。查看基础 XSD 了解定义。 |
取消原因 | 仅在发送 失败状态代码时使用。查看基础 XSD 了解枚举。 |
XSD
https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/OrderAcknowledgement.xsd
<?xml version="1.0" ?> <!- Revision="$Revision: #7 $" --> <xsd:schema elementFormDefault="qualified"> <xsd:include schemaLocation="amzn-base.xsd" /> <xsd:element name="OrderAcknowledgement"> <xsd:complexType> <xsd:sequence> <xsd:element ref="AmazonOrderID" /> <xsd:element ref="MerchantOrderID" minOccurs="0" /> <xsd:element name="StatusCode"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Success" /> <xsd:enumeration value="Failure" /> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="Item" minOccurs="0" maxOccurs="unbounded"> <xsd:complexType> <xsd:sequence> <xsd:element ref="AmazonOrderItemCode" /> <xsd:element ref="MerchantOrderItemID" minOccurs="0" /> <xsd:element name="CancelReason" minOccurs="0"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="NoInventory" /> <xsd:enumeration value="ShippingAddressUndeliverable" /> <xsd:enumeration value="CustomerExchange" /> <xsd:enumeration value="BuyerCanceled" /> <xsd:enumeration value="GeneralAdjustment" /> <xsd:enumeration value="CarrierCreditDecision" /> <xsd:enumeration value="RiskAssessmentInformationNotValid" /> <xsd:enumeration value="CarrierCoverageFailure" /> <xsd:enumeration value="CustomerReturn" /> <xsd:enumeration value="MerchandiseNotReceived" /> </xsd:restriction> </xsd:simpleType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>
示例
<?xml version="1.0" ?> <AmazonEnvelope noNamespaceSchemaLocation="amzn-envelope.xsd"> <Header> <DocumentVersion>1.01</DocumentVersion> <MerchantIdentifier> M_IDENTIFIER</MerchantIdentifier> </Header> <MessageType>订单确认</MessageType> <Message> <MessageID>1</MessageID> <OrderAcknowledgement> <AmazonOrderID>050-1234567-1234567</AmazonOrderID> <MerchantOrderID>1234567</MerchantOrderID> <StatusCode>成功</StatusCode> <Item> <AmazonOrderItemCode>12345678901234</AmazonOrderItemCode> <MerchantOrderItemID>1234567</MerchantOrderItemID> </Item> </OrderAcknowledgement> </Message> </AmazonEnvelope>
亚马逊官网原文详情:
Acknowledge Receipt of Orders - Order Acknowledgement
Description
The Order Acknowledgment feed allows you to acknowledge your success or failure with downloading an order. The acknowledgment feed also allows you to provide your own order ID and order item IDs, which you can then reference in future feeds for the same order, if desired.
Additionally, you can use this feed to cancel the entire order under one of these circumstances:
The customer asked you to cancel the order (and you have not yet shipped it).
You received a single-item order but you can't ship the item (damaged goods).
You are unable to upload an order into your system.
To cancel the order, use the Failure StatusCode.
Dictionary
Element Description AmazonOrderID Amazon's unique identifier for an order, which identifies the entire order regardless of the number of individual items in the order MerchantOrderID Optional seller-supplied order ID. Amazon will map the MerchantOrderID to the AmazonOrderID, and you can then use your own order ID (MerchantOrderID) for subsequent feeds relating to the order. The first step is to establish the MerchantOrderID in the acknowledgment feed. See the base XSD for the definition. StatusCode Allows you to acknowledge your success or failure with downloading an order. StatusCode can be either Success or Failure. A StatusCode of Failure can be used for communicating to Amazon that you had a problem integrating the order into your system and are unable to process the order. It should not be used for communicating that you had a fulfillment problem, such as not having the item in inventory. Sending status code "Failure" will automatically cancel the order; the customer will not be charged for the item.
AmazonOrderItemCode Amazon's unique identifier for an item in an order. If the MerchantOrderItemID is also specified, Amazon will map the two IDs and you can then use your own item ID for subsequent feeds relating to that item within the order. See the base XSD for the definition. MerchantOrderItemID Optional seller-supplied ID for an item in an order. If the MerchantOrderItemID is specified with the AmazonOrderItemCode, Amazon will map the two IDs and you can then use your own order item ID for subsequent feeds relating to that order item. See the base XSD for the definition. CancelReason Used only when sending a StatusCode of Failure. See the base XSD for enumeration.
XSD
https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/OrderAcknowledgement.xsd
<?xml version="1.0" ?> <!- Revision="$Revision: #7 $" --> <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified"> <xsd:include schemaLocation="amzn-base.xsd" /> <xsd:element name="OrderAcknowledgement"> <xsd:complexType> <xsd:sequence> <xsd:element ref="AmazonOrderID" /> <xsd:element ref="MerchantOrderID" minOccurs="0" /> <xsd:element name="StatusCode"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="Success" /> <xsd:enumeration value="Failure" /> </xsd:restriction> </xsd:simpleType> </xsd:element> <xsd:element name="Item" minOccurs="0" maxOccurs="unbounded"> <xsd:complexType> <xsd:sequence> <xsd:element ref="AmazonOrderItemCode" /> <xsd:element ref="MerchantOrderItemID" minOccurs="0" /> <xsd:element name="CancelReason" minOccurs="0"> <xsd:simpleType> <xsd:restriction base="xsd:string"> <xsd:enumeration value="NoInventory" /> <xsd:enumeration value="ShippingAddressUndeliverable" /> <xsd:enumeration value="CustomerExchange" /> <xsd:enumeration value="BuyerCanceled" /> <xsd:enumeration value="GeneralAdjustment" /> <xsd:enumeration value="CarrierCreditDecision" /> <xsd:enumeration value="RiskAssessmentInformationNotValid" /> <xsd:enumeration value="CarrierCoverageFailure" /> <xsd:enumeration value="CustomerReturn" /> <xsd:enumeration value="MerchandiseNotReceived" /> </xsd:restriction> </xsd:simpleType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:sequence> </xsd:complexType> </xsd:element> </xsd:schema>Example
<?xml version="1.0" ?> <AmazonEnvelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="amzn-envelope.xsd"> <Header> <DocumentVersion>1.01</DocumentVersion> <MerchantIdentifier> M_IDENTIFIER</MerchantIdentifier> </Header> <MessageType>OrderAcknowledgement</MessageType> <Message> <MessageID>1</MessageID> <OrderAcknowledgement> <AmazonOrderID>050-1234567-1234567</AmazonOrderID> <MerchantOrderID>1234567</MerchantOrderID> <StatusCode>Success</StatusCode> <Item> <AmazonOrderItemCode>12345678901234</AmazonOrderItemCode> <MerchantOrderItemID>1234567</MerchantOrderItemID> </Item> </OrderAcknowledgement> </Message> </AmazonEnvelope>
文章来源:亚马逊官方网站