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