处理多渠道订单
批量创建新蛋以外的多渠道订单。商家可配送来自其他平台的订单,但仅限于由新蛋配送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 | 收货地所在国家
|
| 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