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