亚马逊官方教程——使用信封架构构建 XML 输入数据

亚马逊观察

2022-03-26

1026

信封用于将所有其他数据与消息级协议数据包装在一起。信封由一个标题、一条或多条消息（每一条消息都包含特定的数据对象）组成。虽然一个信封可以包含多条消息，但是同一信封内的每条消息的类型都必须与由消息类型元素指定的类型相同。

信封架构

描述

词典

XSD

https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd

<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema
elementFormDefault="qualified">
        <xsd:include schemaLocation="amzn-base.xsd"/>
        <xsd:include schemaLocation="amzn-header.xsd"/>
        <xsd:include schemaLocation="FulfillmentCenter.xsd"/>
        <xsd:include schemaLocation="Inventory.xsd"/>
        <xsd:include schemaLocation="OrderAcknowledgment.xsd"/>
        <xsd:include schemaLocation="OrderAdjustment.xsd"/>
        <xsd:include schemaLocation="OrderFulfillment.xsd"/>
        <xsd:include schemaLocation="OrderReport.xsd"/>
        <xsd:include schemaLocation="Override.xsd"/>
        <xsd:include schemaLocation="Price.xsd"/>
        <xsd:include schemaLocation="ProcessingReport.xsd"/>
        <xsd:include schemaLocation="Product.xsd"/>
        <xsd:include schemaLocation="ProductImage.xsd"/>
        <xsd:include schemaLocation="Relationship.xsd"/>
        <xsd:include schemaLocation="SettlementReport.xsd"/>
        <xsd:element name="AmazonEnvelope" />
           <xsd:complexType>
               <xsd:sequence>
                   <xsd:element ref="Header"/>
                   <xsd:element name="MessageType">
                       <xsd:simpleType>
                          <xsd:restriction base="xsd:string">
                              <xsd:enumeration value="FulfillmentCenter"/>
                              <xsd:enumeration value="Inventory"/>
                              <xsd:enumeration value="OrderAcknowledgment"/>
                              <xsd:enumeration value="OrderAdjustment"/>
                              <xsd:enumeration value="OrderFulfillment"/>
                              <xsd:enumeration value="OrderReport"/>
                              <xsd:enumeration value="Override"/>
                              <xsd:enumeration value="Price"/>
                              <xsd:enumeration value="ProcessingReport"/>
                              <xsd:enumeration value="Product"/>
                              <xsd:enumeration value="ProductImage"/>
                              <xsd:enumeration value="Relationship"/>
                              <xsd:enumeration value="SettlementReport"/>
                          </xsd:restriction>
                       </xsd:simpleType>
                   </xsd:element>
                   <xsd:element name="PurgeAndReplace" type="xsd:boolean" minOccurs="0"/>
                   <xsd:element name="EffectiveDate" type="xsd:dateTime" minOccurs="0"/>
                   <xsd:element name="Message" maxOccurs="unbounded" />
                       <xsd:complexType>
                          <xsd:sequence>
                              <xsd:element name="MessageID" type="IDNumber"/>
                              <xsd:element name="OperationType" minOccurs="0">
                                  <xsd:simpleType>
                                      <xsd:restriction base="xsd:string">
                                         <xsd:enumeration value="Update"/>
                                         <xsd:enumeration value="Delete"/>
                                      </xsd:restriction>
                                  </xsd:simpleType>
                              </xsd:element>
                              <xsd:choice>
                                  <xsd:element ref="FulfillmentCenter"/>
                                  <xsd:element ref="Inventory"/>
                                  <xsd:element ref="OrderAcknowledgment"/>
                                  <xsd:element ref="OrderAdjustment"/>
                                  <xsd:element ref="OrderFulfillment"/>
                                  <xsd:element ref="OrderReport"/>
                                  <xsd:element ref="Override"/>
                                  <xsd:element ref="Price"/>
                                  <xsd:element ref="ProcessingReport"/>
                                  <xsd:element ref="Product"/>
                                  <xsd:element ref="ProductImage"/>
                                  <xsd:element ref="Relationship"/>
                                  <xsd:element ref="SettlementReport"/>
                              </xsd:choice>
                          </xsd:sequence>
                       </xsd:complexType>
                   </xsd:sequence>
           </xsd:complexType>
        </xs:schema>

Envelope Schema
Description
The envelope is used to wrap all other data with message-level protocol data. The envelope consists of a header and one or more messages, each of which contains the specified data object. While an envelope may contain more than one message, each message in the same envelope must be of the same type, as specified by the message type element.
Dictionary
XSD
https://images-na.ssl-images-amazon.com/images/G/01/rainier/help/xsd/release_1_9/amzn-envelope.xsd
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
elementFormDefault="qualified">
        <xsd:include schemaLocation="amzn-base.xsd"/>
        <xsd:include schemaLocation="amzn-header.xsd"/>
        <xsd:include schemaLocation="FulfillmentCenter.xsd"/>
        <xsd:include schemaLocation="Inventory.xsd"/>
        <xsd:include schemaLocation="OrderAcknowledgment.xsd"/>
        <xsd:include schemaLocation="OrderAdjustment.xsd"/>
        <xsd:include schemaLocation="OrderFulfillment.xsd"/>
        <xsd:include schemaLocation="OrderReport.xsd"/>
        <xsd:include schemaLocation="Override.xsd"/>
        <xsd:include schemaLocation="Price.xsd"/>
        <xsd:include schemaLocation="ProcessingReport.xsd"/>
        <xsd:include schemaLocation="Product.xsd"/>
        <xsd:include schemaLocation="ProductImage.xsd"/>
        <xsd:include schemaLocation="Relationship.xsd"/>
        <xsd:include schemaLocation="SettlementReport.xsd"/>
        <xsd:element name="AmazonEnvelope" />
           <xsd:complexType>
               <xsd:sequence>
                   <xsd:element ref="Header"/>
                   <xsd:element name="MessageType">
                       <xsd:simpleType>
                          <xsd:restriction base="xsd:string">
                              <xsd:enumeration value="FulfillmentCenter"/>
                              <xsd:enumeration value="Inventory"/>
                              <xsd:enumeration value="OrderAcknowledgment"/>
                              <xsd:enumeration value="OrderAdjustment"/>
                              <xsd:enumeration value="OrderFulfillment"/>
                              <xsd:enumeration value="OrderReport"/>
                              <xsd:enumeration value="Override"/>
                              <xsd:enumeration value="Price"/>
                              <xsd:enumeration value="ProcessingReport"/>
                              <xsd:enumeration value="Product"/>
                              <xsd:enumeration value="ProductImage"/>
                              <xsd:enumeration value="Relationship"/>
                              <xsd:enumeration value="SettlementReport"/>
                          </xsd:restriction>
                       </xsd:simpleType>
                   </xsd:element>
                   <xsd:element name="PurgeAndReplace" type="xsd:boolean" minOccurs="0"/>
                   <xsd:element name="EffectiveDate" type="xsd:dateTime" minOccurs="0"/>
                   <xsd:element name="Message" maxOccurs="unbounded" />
                       <xsd:complexType>
                          <xsd:sequence>
                              <xsd:element name="MessageID" type="IDNumber"/>
                              <xsd:element name="OperationType" minOccurs="0">
                                  <xsd:simpleType>
                                      <xsd:restriction base="xsd:string">
                                         <xsd:enumeration value="Update"/>
                                         <xsd:enumeration value="Delete"/>
                                      </xsd:restriction>
                                  </xsd:simpleType>
                              </xsd:element>
                              <xsd:choice>
                                  <xsd:element ref="FulfillmentCenter"/>
                                  <xsd:element ref="Inventory"/>
                                  <xsd:element ref="OrderAcknowledgment"/>
                                  <xsd:element ref="OrderAdjustment"/>
                                  <xsd:element ref="OrderFulfillment"/>
                                  <xsd:element ref="OrderReport"/>
                                  <xsd:element ref="Override"/>
                                  <xsd:element ref="Price"/>
                                  <xsd:element ref="ProcessingReport"/>
                                  <xsd:element ref="Product"/>
                                  <xsd:element ref="ProductImage"/>
                                  <xsd:element ref="Relationship"/>
                                  <xsd:element ref="SettlementReport"/>
                              </xsd:choice>
                          </xsd:sequence>
                       </xsd:complexType>
                   </xsd:sequence>
           </xsd:complexType>
        </xs:schema>