Price Update Feed

Batch update items price information, shipping, and/or activation for targeted country.

Note: If not enable to ship to different countries, default country is USA.  To enable different countries to ship, you may manage at Newegg Seller Portal > Manage Account > Shipping Settings, please refer to our Newegg Global Program for more details.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/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: PRICE_DATA

Resource Information

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

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

Request Body

Attribute Required? Format Description
DocumentVersion Yes Decimal Fixed value: 2.0
MessageType Yes String Fixed value: Price
SellerPartNumber Yes String A seller-defined unique identifier for an item.

An alphanumeric string, max 40 characters including space.

Note: Once an item is created, this information cannot be updated.

NeweggItemNumber No String Newegg’s unique identifier for an item
CountryCode Yes String The target country you will be selling your items to. Only the ISO standard 3-digit codes are accepted.  To review the complete list of available values, please download
the following: International Country GuideNote: Item price must be submitted with the correct currency code based on ship-to destination country code. Submissions with incorrect combinations will error-out.
Currency Yes String The currency is to identify the Selling Price, MSRP, MAP for the target country you will be selling your items to. Only the ISO standard 3-digit codes are accepted. The default value will be USD if left blank. To review the complete list of available values, please download the following: International Country Guide

Note: Correct currency code must be submitted based on ship-to destination country code. Submissions with incorrect combinations will error-out.

MSRP No Decimal The manufacturer’s suggested retail price (MSRP) or list price for item.

Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs.

If you want to remove MSRP, input “0.00” or  “0”.

If null, no change to current setting.

MAP No Decimal Dictates the “minimum advertised price” for item.

Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs.

If the Selling Price is below the defined MAP, the website will ask customer to add item to shopping cart to see the item’s price.

If you want to remove MAP, input “0.00” or “0”.

If null, no change to current setting.

CheckoutMAP No String Regardless the Selling Price and the value inputted in MAP field, if the Checkout MAP is marked as “True”, then the website will ask customer to add item to shopping cart AND go to checkout page to see the item’s price.

Available values: “True” or “False”

SellingPrice Yes Decimal The actual price at which the item is offered for sale.

Format: 10 digits allowed to the left of the decimal point and 2 digits to the right of the decimal point. Please do not use commas or dollar signs.

Shipping Yes String The shipping charge setting for item.

Available values: “Default” or “Free”

Shipping charge for “Default” setting is determined by seller’s shipping rate setting at Newegg Seller Portal > Manage Account > Shipping Settings.

ActivationMark No String Available values:

True: Activate item, the product will be listed for sale at Newegg website.
False: Deactivate item, the product will be hidden/offline, not for sale at Newegg website.

If Null, system will do nothing, no change to current item active/deactivate status.

Note: If Newegg Seller account status is “Inactive”, all items will be offline.  To have option to “Active” item, the account status should be “Active”.  Please contact  datafeeds@newegg.com for details.

Schema: PriceUpdate.xsd

Example: XML, Request

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

<?xml version="1.0" encoding="UTF-8"?>
<NeweggEnvelope xsi:noNamespaceSchemaLocation="NeweggEnvelop.xsd"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <Header>
        <DocumentVersion>2.0</DocumentVersion>
        <!--The identifier for the very of current feed; assigned by Newegg-->
    </Header>
    <MessageType>Price</MessageType>
    <Message>
        <Price>
            <Item>
                <SellerPartNumber>a006-test-001</SellerPartNumber>
                <!--A seller-defined unique identifier for an item. An alphanumeric string, max 40 characters including space-->
                <NeweggItemNumber>9SIAWE50008504</NeweggItemNumber>
                <!--Newegg’s unique identifier for an item-->
                <CountryCode>USA</CountryCode>
                <Currency>USD</Currency>
                <!--The form of money for all price related elements. -->
                <MSRP>100.00</MSRP>
                <!--Manufacturer's suggested retail price for the product. -->
                <MAP>9.99</MAP>
                <CheckoutMAP>True</CheckoutMAP>
                <SellingPrice>100.00</SellingPrice>
                <Shipping>default</Shipping>
                <!--The shipping charge setting for this item. -->
                <ActivationMark>True</ActivationMark>
                <!--The ActivationMark's default setting is True on all uploaded products because all products must be activated to be visible on Newegg websites. -->
            </Item>
        </Price>
    </Message>
</NeweggEnvelope>

Example: Json, Request

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

{
    "NeweggEnvelope": {
        "-xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance",
        "-xsi:noNamespaceSchemaLocation": "NeweggEnvelop.xsd",
        "Header": {
            "DocumentVersion": "2.0"
        },
        "MessageType": "Price",
        "Message": {
            "Price": {
                "Item": {
                    "SellerPartNumber": "a006-test-001",
                    "NeweggItemNumber": "9SIAWE50008504",
                    "CountryCode": "USA",
                    "Currency": "USD",
                    "MSRP": "100.00",
                    "MAP": "9.99",
                    "CheckoutMAP": "True",
                    "SellingPrice": "100.00",
                    "Shipping": "default",
                    "ActivationMark": "True"
                }
            }
        }
    }
}

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