訂單發貨通知

批量操作由商家配送的新蛋訂單。
商家使用該請求可以對一個訂單中的一個或所有商品的配送資訊進行更改。當訂單中所有商品都已發貨,該訂單處理才會完成。

請參考以下示例,並為每個文件指定可能的配送選項:
訂單XYZ有5個商品A,一個商品B

  • 一個包裹,包含5個商品A和一個商品B,且使用一個運送單號
  • 一個包裹,包含5個商品A或一個商品B,且使用一個運送單號
  • 多個包裹:一個包裹包含5個商品A, 使用一個運送單號;另一個包裹包含1個商品B,使用一個運送單號
  • 多個包裹:一個包裹包含2個商品A, 使用一個運送單號;一個包裹包含3個商品A,使用一個運單號;另一個包裹包含1個商品B,使用一個運送單號
  • 多個包裹:一個包裹包含2個商品A,使用一個運送單號;一個包裹包含3個商品A和1個商品B,使用一個運送單號
  • 不能像這樣提交部分運送的請求:僅有一個包裹只包含2個商品A,使用一個運送單號

相關URL

Newegg.com: https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype={RequestType}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/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 值:ORDER_SHIP_NOTICE_DATA

相關請求資訊

HTTP方式 是否需要認證? 請求格式 回覆格式 頻率限制
POST 需要 XML,Json XML,Json 1000 請求/分鐘

請求文件主體

屬性 是否必填? 格式 描述
DocumentVersion Decimal 固定值:1.0
MessageType String 固定值:ShipNotice
OrderNumber String 新蛋制訂給每個訂單唯一的訂單編號
SellerPartNumber String 商家自訂的商品編號。
NeweggItemNumber String 新蛋制訂給每個商品的唯一識別碼
ShippedQuantity Integer 已運送商品的數量
ActualShippingCarrier String 商家發貨時,運送該包裹的物流公司。

有效值,請參考新蛋已對接物流服務商列表

ActualShippingMethod String 賣家發貨該包裹時的發貨方式。

如:UPS Ground

TrackingNumber String 該包裹的物流追蹤單號。

Schema: ShipNotice.xsd

示例:XML, Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ORDER_SHIP_NOTICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/xml
Accept: application/xml

<NeweggEnvelope>
    <Header>
        <DocumentVersion>1.0</DocumentVersion>
    </Header>
    <MessageType>ShipNotice</MessageType>
    <Message>
        <ShipNotice>
            <Package>
                <OrderNumber>11006035</OrderNumber>
                <ItemInformation>
                    <Item>
                        <SellerPartNumber>data_MP_329_00976</SellerPartNumber>
                        <NeweggItemNumber>9SIAWES000CY64</NeweggItemNumber>
                        <ShippedQuantity>1</ShippedQuantity>
                    </Item>
                    <Item>
                        <SellerPartNumber>data_MP_329_00975</SellerPartNumber>
                        <NeweggItemNumber>9SIAWES000CY58</NeweggItemNumber>
                        <ShippedQuantity>2</ShippedQuantity>
                    </Item>
                    <Item>
                        <SellerPartNumber>data_MP_329_00974</SellerPartNumber>
                        <NeweggItemNumber>9SIAWES000CY53</NeweggItemNumber>
                        <ShippedQuantity>1</ShippedQuantity>
                    </Item>
                    <Item>
                        <SellerPartNumber>data_MP_32900973</SellerPartNumber>
                        <NeweggItemNumber>9SIAWES000CY49</NeweggItemNumber>
                        <ShippedQuantity>1</ShippedQuantity>
                    </Item>
                    <Item>
                        <SellerPartNumber>data_MP_32900972</SellerPartNumber>
                        <NeweggItemNumber>9SIAWES000CY45</NeweggItemNumber>
                        <ShippedQuantity>2</ShippedQuantity>
                    </Item>
                </ItemInformation>
                <ActualShippingCarrier>UPS</ActualShippingCarrier>
                <ActualShippingMethod>UPS Ground</ActualShippingMethod>
                <TrackingNumber>20110922002</TrackingNumber>
            </Package>
        </ShipNotice>
    </Message>
</NeweggEnvelope>

示例:Json, Request

POST https://api.newegg.com/marketplace/datafeedmgmt/feeds/submitfeed?sellerid={sellerid}&requesttype=ORDER_SHIP_NOTICE_DATA
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Content-Type: application/json
Accept: application/json

{
    "NeweggEnvelope": {
        "Header": {
            "DocumentVersion": "1.0"
        },
        "MessageType": "ShipNotice",
        "Message": {
            "ShipNotice": {
                "Package": {
                    "OrderNumber": "11006035",
                    "ItemInformation": {
                        "Item": [
                            {
                                "SellerPartNumber": "data_MP_329_00976",
                                "NeweggItemNumber": "9SIAWES000CY64",
                                "ShippedQuantity": "1"
                            },
                            {
                                "SellerPartNumber": "data_MP_329_00975",
                                "NeweggItemNumber": "9SIAWES000CY58",
                                "ShippedQuantity": "2"
                            },
                            {
                                "SellerPartNumber": "data_MP_329_00974",
                                "NeweggItemNumber": "9SIAWES000CY53",
                                "ShippedQuantity": "1"
                            },
                            {
                                "SellerPartNumber": "data_MP_32900973",
                                "NeweggItemNumber": "9SIAWES000CY49",
                                "ShippedQuantity": "1"
                            },
                            {
                                "SellerPartNumber": "data_MP_32900972",
                                "NeweggItemNumber": "9SIAWES000CY45",
                                "ShippedQuantity": "2"
                            }
                        ]
                    },
                    "ActualShippingCarrier": "UPS",
                    "ActualShippingMethod": "UPS Ground",
                    "TrackingNumber": "20110922002"
                }
            }
        }
    }
}

回覆文件主體

屬性 格式 描述
IsSuccess String 獲取文件狀態操作:
True:成功
False:失敗
OperationType String 固定值:SubmitFeedResponse
SellerID String 商家編號
RequestType String 值:ORDER_SHIP_NOTICE_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>ORDER_SHIP_NOTICE_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": "ORDER_SHIP_NOTICE_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"
    }
]

更新日期:10/15/2018