Order Ship Notice Feed

Batch ship orders that is placed on Newegg that seller’s will be responsible to fulfill.

This request will allow seller’s to update shipment of one or all items in an order. When the order has been completely fulfilled (i.e. all the item(s) in order shipped), the order process is completed.

Please review the following example and the possible shipment options you can assign for each feed:
Order XYZ has item A (5 units) and item B (1 unit)

  • Single package contains 5 units of item A and 1 unit of item B with one tracking number.
  • Single package contains either 5 units of item A or 1 unit of item B with one tracking number.
  • Mutile packages: one package contains 5 units of item A with one tracking number. The other package contains 1
    unit of item B with another tracking number.
  • Multiple package: one package contains 2 units of item A with one tracking number. Another package contains 3
    units of item A with another tracking number. The other package contains 1 unit of item B with another tracking
    number.
  • Multiple package, 1 package contains 2 units of item A with one tracking number. The other package contains 3
    units of item A and 1 unit of item B with another tracking number.
  • You cannot submit a request for partial shipment as following: Single package contains 2 units of item A with
    one tracking number.

Resource 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}

Note: Please make sure your request URL is all in lower case (except for Seller ID) and cannot contain any blank spaces or line breaks.

Parameters

Name Required? Description
sellerid Yes Your seller ID on Newegg Marketplace
RequestType Yes Value: ORDER_SHIP_NOTICE_DATA

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json 1000 request per minute

Request Body

Attribute Required? Format Description
DocumentVersion Yes Decimal Fixed value: 1.0
MessageType Yes String Fixed value: ShipNotice
OrderNumber Yes String Newegg’s unique identifier for an order
SellerPartNumber Yes String A seller-defined unique identifier for an item
NeweggItemNumber No String Newegg’s unique identifier for an item
ShippedQuantity Yes Integer Number of units the item was shipped
ActualShippingCarrier Yes String The shipping carrier of this package when seller ships the package.  For Newegg.com, Neweggbusiness.com and  Newegg.ca acceptable values refer to Newegg Integrated Carrier List.
ActualShippingMethod Yes String The shipping method of this package when seller  ships the package.

Example: UPS Ground

TrackingNumber Yes String The tracking number of this package.

Schema: ShipNotice.xsd

Example: 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>

Example: 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"
                }
            }
        }
    }
}

Response Body

Attribute Format Description
IsSuccess String Get feed status operation:

True: Successful
False: Not successful

OperationType String Fixed value: SubmitFeedResponse
SellerID String Your seller ID
RequestType String Value: ORDER_SHIP_NOTICE_DATA
RequestDate String The date when the feed was submitted. (Pacific Standard Time)
RequestStatus String The status of the feed submission:

SUBMITTED

Memo String Additional Information

Schema: SubmitFeedResponse.xsd

Example: 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>

Example: 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"
}

Request Failure Errors

For common HTTP error responses, please refer to Failed Response Error Code List.

Error Code Description
DF003 The MaxCount (maximum request records) CANNOT be over 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.

Example: 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>

Example: Json, Response

[
    {
        "Code": "DF003",
        "Message": "The MaxCount (maximum request records) CANNOT be over 30000"
    }
]

Last updated: October 15, 2018