處理多管道訂單
批量創建新蛋以外的多管道訂單。商家可配送來自其他平台的訂單,但僅限於由新蛋配送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