處理多管道訂單

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

  • Newegg.com僅限於美國
  • 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