处理多渠道订单

批量创建新蛋以外的多渠道订单。商家可配送来自其他平台的订单,但仅限于由新蛋配送SBN的商品。

相关URL

Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Newegg.ca: https://api.newegg.com/marketplace/can/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}

注:请确保您的请求URL全都是小写(除Seller ID)并且不能包含任何空格或者换行符。

参数

名称 是否必填? 描述
sellerid 您在新蛋商城的商家编号
RequestType 值:MULTICHANNEL_ORDER_DATA

相关请求信息

HTTP方式 是否需要认证? 请求格式 回复格式 频率限制
POST 需要 XML,Json XML,Json 1000 请求/小时

请求文件主体

属性 是否必填? 格式 描述
DocumentVersion Decimal 固定值:1.0
MessageType String 固定值:MultiChannelOrderCreation
OrderDate String 顾客下订单的时间
SalesChannel String 由商家标识,用来确认销售渠道

可帮助区分订单编号相同但来自不同销售渠道的订单

SellerOrderID String 商家分配的订单编号/ 标识符
ShippingMethod String 订单运送方式
可接受值:
Standard Shipping (5-7 business days)
Expedited Shipping (3-5 business days)
Two-Day Shipping
One-Day Shipping
只适用于Newegg.ca的额外值:
CAN Ground (2-7 business days)
CAN Express (2-5 business days)
ShipToFirstName String 收货人的名
ShipToLastName String 收货人的姓
ShipToCompany String 收货人公司
ShipToAddressLine1 String 收货地址1
注:新蛋配送SBN服务要求提供有效的街道地址。
我们不送货到邮政信箱。
ShipToAddressLine2 String 收货地址2
注:新蛋配送SBN服务要求提供有效的街道地址。
我们不送货到邮政信箱。
ShipToCity String 收货地所在城市
ShipToState String 收货地所在州
ShipToPostalCode String 收货地邮编
ShipToCountry String 收货地所在国家

  • USA:Newegg.com国家编码
  • CAN:Newegg.ca国家编码
ShipToPhoneNumber String 收货人电话
SignatureOptions String 选项:

  • 常规:物流商将在交货时获取收件人签名
  • 没有值则表示交付时不需要签名
SellerPartNumber String 商家自定义的商品编号
NeweggItemNumber String 新蛋分配的该商品编号
Quantity Integer 订单中该商品的总数量

Schema: MultiChannelOrder.xsd

示例:XML,Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=MULTICHANNEL_ORDER_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>MultiChannelOrderCreation</MessageType>
    <Message>
        <MultiChannelOrder>
            <Order>
                <OrderDate>05/30/2013</OrderDate>
                <SalesChannel>3rd channel</SalesChannel>
                <SellerOrderID>2153930</SellerOrderID>
                <ShippingMethod>Expedited Shipping (3-5 business days)</ShippingMethod>
                <ShipToFirstName>Carol</ShipToFirstName>
                <ShipToLastName>Chaste</ShipToLastName>
                <ShipToCompany/>
                <ShipToAddressLine1>248 River Trace Ct</ShipToAddressLine1>
                <ShipToAddressLine2/>
                <ShipToCity>McDonough</ShipToCity>
                <ShipToState>GA</ShipToState>
                <ShipToPostalCode>30253</ShipToPostalCode>
                <ShipToCountry>USA</ShipToCountry>
                <ShipToPhoneNumber>770-898-1921</ShipToPhoneNumber>
                <SignatureOptions>Regular</SignatureOptions>
                <ItemList>
                    <Item>
                        <SellerPartNumber>PTV3000-100NAS</SellerPartNumber>
                        <NeweggItemNumber/>
                        <Quantity>10</Quantity>
                    </Item>
                    <Item>
                        <SellerPartNumber>CTB-212312S</SellerPartNumber>
                        <NeweggItemNumber/>
                        <Quantity>20</Quantity>
                    </Item>
                </ItemList>
            </Order>
        </MultiChannelOrder>
    </Message>
</NeweggEnvelope>

示例:Json,Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=MultiChannel_Order_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
  "NeweggEnvelope": {
    "MessageType": "MultiChannelOrderCreation",
    "Message": {
      "MultiChannelOrder": {
        "Order": {
          "OrderDate": "05/30/2013",
          "SalesChannel": "3rd channel",
          "SellerOrderID": "2153930",
          "ShippingMethod": "Expedited Shipping (3-5 business days)",
          "ShipToFirstName": "Carol",
          "ShipToLastName": "Chaste",
          "ShipToAddressLine1": "248 River Trace Ct",
          "ShipToCity": "McDonough",
          "ShipToState": "GA",
          "ShipToPostalCode": "30253",
          "ShipToCountry": "USA",
          "ShipToPhoneNumber": "770-898-1921",
          "SignatureOptions": "Regular",
          "ItemList": {
            "Item": [
              {
                "SellerPartNumber": "PTV3000-100NAS",
                "Quantity": "10"
              },
              {
                "SellerPartNumber": "CTB-212312S",
                "Quantity": "20"
              }
            ]
          }
        }
      }
    }
  }
}

回复文件主体

属性 格式 描述
IsSuccess String 获取文件状态操作:
True: 成功
False: 失败
OperationType String 固定值:SubmitFeedResponse
SellerID String 商家编号
RequestType String 值:MULTICHANNEL_ORDER_DATA
RequestDate String 文件提交的时间(太平洋标准时间)
RequestStatus String 文件提交的状态:
SUBMITTED 已提交
Memo String 附加信息

Schema: SubmitFeedResponse.xsd

示例:XML,Response

<?xml version="1.0" encoding="utf-8"?>
<NeweggAPIResponse>
    <IsSuccess>true</IsSuccess>
    <OperationType>SubmitFeedResponse</OperationType>
    <SellerID>A006</SellerID>
    <ResponseBody>
        <ResponseList>
            <ResponseInfo>
                <RequestId>2291326430</RequestId>
                <RequestType>MULTICHANNEL_ORDER_DATA</RequestType>
                <RequestDate>2/16/2012 12:29:19</RequestDate>
                <RequestStatus>SUBMITTED</RequestStatus>
            </ResponseInfo>
        </ResponseList>
    </ResponseBody>
    <Memo />
</NeweggAPIResponse>

示例:Json,Response

{
    "IsSuccess": true,
    "OperationType": "SubmitFeedResponse",
    "ResponseBody": {
        "ResponseList": [
            {
                "RequestDate": "2/22/2012 17:24:35",
                "RequestId": "2PQCX3CMQ82MK",
                "RequestStatus": "SUBMITTED",
                "RequestType": "MULTICHANNEL_ORDER_DATA"
            }
        ]
    },
    "SellerID": "A006"
}

请求失败错误信息

常规HTTP错误回复,请参考回复失败错误代码列表

错误代码 描述
DF003 The MaxCount (maximum request records) CANNOT be over 30000.

最大请求数记录不能超过30000

DF004 Unfortunately, we are unable to process your request at this time. We apologize for the inconvenience. Please try again later.

很抱歉,目前我们无法处理您的请求。请您稍后再试。

DF011 Your data feed request will not be processed during the scheduled data feed processing restriction from [{begin timestamp: hh:mm:ss, MM/DD/YYYY}] to [{end timestamp: hh:mm:ss, MM/DD/YYYY}]). Please contact datafeeds@newegg.com if you have any question or concern. Thank you for your patience.

在已定的数据文件处理限制期内,从[{begin timestamp: hh:mm:ss, MM/DD/YYYY}] 到 [{end timestamp: hh:mm:ss, MM/DD/YYYY}],您的数据请求将无法被处理。如您有任何问题或者疑问,请联系datafeeds@newegg.com。 感谢您的耐心等待。

示例:XML,Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>DF003</Code>
        <Message>The MaxCount (maximum request records) CANNOT be over 30000</Message>
    </Error>
</Errors>

示例:Json,Response

[
    {
        "Code": "DF003",
        "Message": "The MaxCount (maximum request records) CANNOT be over 30000"
    }
]

更新日期:01/08/2020