Multi Channel Order Feed

Batch create multi-channel orders that are not placed on Newegg.com.  Seller’s may fulfill orders from other channels, if and only If the items is fulfilled by SBN (Shipped by Newegg).

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

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

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json Max. 100 requests per min per client

Note: Maximum Size of Request 10,000 records per file. Limit 30,000 records per hour.

Request Body

Attribute Required? Format Description
DocumentVersion Yes Decimal Fixed value: 1.0
MessageType Yes String Fixed value: MultiChannelOrderCreation
OrderDate Yes String The date when the order was placed.
SalesChannel Yes String A label assigned by the seller to identify the sales channel.

This helps to distinguish orders with identical Order ID but from different sales
channels.

SellerOrderID Yes String An identifier for the order, assigned by the seller.
ShippingMethod Yes String Order’s shipping method

Accepted values:

Standard Shipping (5-7 business days)
Expedited Shipping (3-5 business days)
Two-Day Shipping
One-Day Shipping

Additional values for Newegg.ca only:

CAN Ground (2-7 business days)
CAN Express (2-5 business days)

ShipToFirstName Yes String Ship to recipient’s First Name
ShipToLastName Yes String Ship to recipient’s Last Name
ShipToCompany No String Ship to company name
ShipToAddressLine1 Yes String Ship to address line 1

Note: SBN (Shipped by Newegg) service will only accept shipments to a valid street address. We do not deliver to P.O. Box.

ShipToAddressLine2 No String Ship to address line 2

Note: SBN (Shipped by Newegg) service will only accept shipments to a valid
street address. We do not deliver to P.O. Box.

ShipToCity Yes String Ship to City
ShipToState Yes String Ship to State
ShipToPostalCode Yes String Ship to Zip code
ShipToCountry No String Ship to Country

Newegg.com is only limited to United States. If left blank will default to USA

Newegg.ca is only limited to Canada. If left blank will default to Canada

ShipToPhoneNumber Yes String Ship to Person’s phone number
SellerPartNumber Yes String The seller part # that was assigned to this item
NeweggItemNumber No String The Newegg Item # for this item
Quantity Yes Integer The number of units for the particular item in the order

Schema:

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

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

{
    "-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
    "Header": {
        "DocumentVersion": "1.0"
    },
    "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",
                "ItemList": {
                    "Item": [
                        {
                            "SellerPartNumber": "PTV3000-100NAS",
                            "Quantity": "10"
                        },
                        {
                            "SellerPartNumber": "CTB-212312S",
                            "Quantity": "20"
                        }
                    ]
                }
            }
        }
    }
}

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: MULTICHANNEL_ORDER_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>MULTICHANNEL_ORDER_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": "MULTICHANNEL_ORDER_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