订单发货通知

批量操作由商家配送的新蛋订单。
商家使用该请求可以对一个订单中的一个或所有商品的配送信息进行更改。当订单中所有商品都已发货，该订单处理才会完成。

请参考以下示例，并为每个文件指定可能的配送选项：
订单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