Update Item Price

Maintaining the price information, shipping, and/or status of items in all eligible countries, including the United States.

Resource URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={sellerid}

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

Resource Information

HTTP Method Authentication? Request Formats Response Formats Rate Limited?
POST Required XML, Json XML, Json 10,000 request per hour

Request Body

Attribute Required? Format Description
Type Yes Integer Available values:

  • 0: NE Item #
  • 1: Seller Part #
  • 2: UPC
Value Yes String A string according to inquiry type
Condition No Integer Available values:

  • 1: New (default)
  • 2: Refurbished
  • 3: Used – Like New
  • 4: Used – Very Good
  • 5: Used – Good
  • 6: Used – Acceptable

Only applies if type = [2-UPC code]. If type does not = [2-UPC code], then this column will be disregarded.

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:

Note: 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. To review the complete list of available values, please download the following:

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

Active No Integer Available values:

  • 1: Activate item
  • 0: Deactivate item

Null = Ignore this action, no change to current item active/deactivate setting

MAP No Decimal Minimum Advertised Price. If the Selling Price is below the defined MAP, website will ask customer to add item to shopping cart to see the item’s price.
CheckoutMAP No Integer When Checkout MAP is marked as “1” AND the selling price is lower than MAP price then the selling price will not be displayed until the checkout process.
Available values:

  • 0: False
  • 1: True
SellingPrice No Decimal The actual selling price
EnableFreeShipping No Integer Available values:

  • 0: Default
  • 1: Free Shipping
LimitQuantity No Integer Limit quantity represents the maximum quantity this item can be purchased by a customer within a 48 hour time period. The maximum value is 500. Note if the value is:

  • 0: System will delete the existing value
  • null: No update

Schema: UpdatePriceRequest.xsd

Example: XML, Request

POST https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/xml
Content-Type: application/xml

<ItemPriceInfo>
    <Type>1</Type>
    <Value>A006BSP3</Value>
    <PriceList>
        <Price>
            <CountryCode>USA</CountryCode>
            <Currency>USD</Currency>
            <Active>0</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>20.92</SellingPrice>
            <EnableFreeShipping>1</EnableFreeShipping>
            <LimitQuantity>2</LimitQuantity>
        </Price>
        <Price>
            <CountryCode>IND</CountryCode>
            <Currency>INR</Currency>
            <Active>1</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>389.92</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <LimitQuantity>2</LimitQuantity>
        </Price>
        <Price>
            <CountryCode>IRL</CountryCode>
            <Currency>EUR</Currency>
            <Active>0</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>19.92</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <LimitQuantity>2</LimitQuantity>
        </Price>
    </PriceList>
</ItemPriceInfo>

Example: Json, Request

POST https://api.newegg.com/marketplace/contentmgmt/item/international/price?sellerid={SellerID}
Authorization: 720ddc067f4d115bd544aff46bc75634
SecretKey: 21EC2020-3AEA-1069-A2DD-08002B30309D
Accept: application/json
Content-Type: application/json

{
    "Type": "1",
    "Value": "A006BSP3",
    "PriceList": {
        "Price": [
            {
                "CountryCode": "USA",
                "Currency": "USD",
                "Active": "0",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "20.92",
                "EnableFreeShipping": "1",
                "LimitQuantity": "2"
            },
            {
                "CountryCode": "IND",
                "Currency": "INR",
                "Active": "1",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "389.92",
                "EnableFreeShipping": "0",
                "LimitQuantity": "2"
            },
            {
                "CountryCode": "IRL",
                "Currency": "EUR",
                "Active": "0",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "19.92",
                "EnableFreeShipping": "0",
                "LimitQuantity": "2"
            }
        ]
    }
}

Response Body

Attribute Format Description
SellerID String Your seller ID
ItemNumber String Newegg Item#
SellerPartNumber String Seller Part#
CountryCode String The target country you will be selling your items to. Newegg will return the value in ISO standard 3-digit codes. To review the complete list of available values, please download the following:

Currency String The currency is to identify the Selling Price, MSRP, MAP for the target country you will be selling your items to. Newegg will return the value in ISO standard 3-digit codes. To review the complete list of available values, please download the following:

Active Integer Available values:

  • 0: Inactive
  • 1: Active
MAP Decimal Minimum Advertised Price. If the Selling Price is below the defined MAP, website will ask customer to add item to shopping cart to see the item’s price.
CheckoutMAP integer Available values:

  • 0: False
  • 1: True

Note:

  • If 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. The MAP value will not be considered.
  • If this field is marked as true, it doesn’t matter if the selling price is above or below MAP, the customer will always need to add item to cart and go to checkout to see item’s price.
  • If MAP is greater than 0.00 and CheckoutMAP is left blank, by default CheckoutMAP will equal False.
SellingPrice Decimal The actual selling price
EnableFreeShipping Integer Available values:

  • 0: Default
  • 1: Free Shipping
LimitQuantity Integer Limit quantity represents the maximum quantity this item can be purchased by a customer within a 48 hour time period. The maximum value is 500. Note if the value is:

  • 0: System will delete the existing value
  • null: No update

Schema: UpdatePriceResponse.xsd

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<UpdatePriceResult>
    <SellerID>A006</SellerID>
    <ItemNumber>9SIA00607Y6476</ItemNumber>
    <SellerPartNumber>A006BSP3</SellerPartNumber>
    <PriceList>
        <Price>
            <CountryCode>USA</CountryCode>
            <Currency>USD</Currency>
            <Active>0</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>20.92</SellingPrice>
            <EnableFreeShipping>1</EnableFreeShipping>
            <LimitQuantity>2</LimitQuantity>
        </Price>
        <Price>
            <CountryCode>IND</CountryCode>
            <Currency>INR</Currency>
            <Active>1</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>389.92</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <LimitQuantity>2</LimitQuantity>
        </Price>
        <Price>
            <CountryCode>IRL</CountryCode>
            <Currency>EUR</Currency>
            <Active>0</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>19.92</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <LimitQuantity>2</LimitQuantity>
        </Price>
    </PriceList>
</UpdatePriceResult>

Example: Json, Response

{
    "SellerID": "A006",
    "ItemNumber": "9SIA00607Y6476",
    "SellerPartNumber": "A006BSP3",
    "PriceList": {
        "Price": [
            {
                "CountryCode": "USA",
                "Currency": "USD",
                "Active": "0",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "20.92",
                "EnableFreeShipping": "1",
                "LimitQuantity": "2"
            },
            {
                "CountryCode": "IND",
                "Currency": "INR",
                "Active": "1",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "389.92",
                "EnableFreeShipping": "0",
                "LimitQuantity": "2"
            },
            {
                "CountryCode": "IRL",
                "Currency": "EUR",
                "Active": "0",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "19.92",
                "EnableFreeShipping": "0",
                "LimitQuantity": "2"
            }
        ]
    }
}

Request Failure Errors

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

Error Code Description
CT001 Invalid ItemNumber
CT002 Invalid SellerPartNumber
CT003 Invalid UPCCode
CT005 Invalid Action Type. We only support: 0 – NE Item#, 1 – Seller Parts#, 2 – UPC Code
CT004 Item under review, you cannot activate.
CT006 Invalid MSRP. The range should be between 0-99999.99
CT007 Invalid Selling Price. The range should be between 0-99999.99
CT008 Invalid Shipping type. We only support: 0 – default, 1 – free shipping
CT009 Cannot activate item by restricted manufacturer – {0}[({1}){2}].
CT010 Cannot find item with specified item condition.
CT014 SellerItemNumber or SellerPartNumber does not exist
CT015 Item does not belong to this seller
CT016 The item: [SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Shipping. Please note: the inventory or minimum purchase quantity update will NOT be affected.
CT019 The item: [SellerPart#] is locked for an on-going/upcoming promotion. CANNOT update the Selling Price. Please note: the inventory or minimum purchase quantity update will NOT be affected.
CT028 Invalid Active Mark. We only support: 0 – deactivate item, 1 – activate item
CT029 The selling price {selling price} cannot be greater than MSRP {MSRP}.
CT030 MAP price should be decimal with 2 digitals. The range should be between 0-99999.99.
CT031 Invalid CheckoutMAP value. We only support: 0 – False, 1 – True.
CT032 The selling price cannot be 0.
CT043 The item cannot be active because of one of the following reasons:1.Does not exist 2.Breaks the price rule 3.No image
CT044 The item cannot be deactivated because of an on-going/upcoming promotion that is locked by Newegg. Please note: the inventory or minimum purchase quantity update will NOT be affected.
CT045 Item was automatically deactivated due to 7 days out of stock and cannot be reactivated with 0 inventory.
CT050 Item Activation Failed. Strict MAP enforced: ${0} – Selling Price must be greater than or equal to strict MAP. Please contact your account manager for more information.
CT052 This item cannot be activate because of the subcategory had been disabled for your account.
CT053 This item now matches a restricted item and cannot be activated. All other updates will be processed.
CT055 This is a duplicated request for Seller Part #: [seller part #]. This item does not exist in Newegg so we are not able to process your request. We will resume the process of price and inventory update for this item 8 hours after [last failed timestamp].
CT065 Invalid Selling Price. The Selling Price should be greater than the existing 1st tier volume discount unit price: [{0}]
CT067 The item: [SellerPart#] is regulated by a Newegg existing MAP (Minimum Advertised Pricing) setting: MAP = [amount], Checkout MAP = [status]. When MAP amount is great than 0 or Checkout MAP = True, the attempt to change either MAP or Checkout MAP is restricted. All other requests have been processed.
CT071 The Inventory update for item: [SellerPart#] cannot be processed because of the warehouse: [warehouselocation] has not been created.
CT075 Price update failed. Invalid currency code. The currency code received: [code] does not match the specified country: [code].
CT076 Item cannot be activated for specified country: [code]. Please activate the country, then submit your request again.
CT092 The request for item: {Seller Part #} has been processed with error. Error: You have reached the maximum allowance of listing: [limit #] items. To list more, please optimize your listings. To increase the allowance, please upgrade your service. Country(s): [code1, code 2, ….code #]
CT096 FREE SHIPPING is not available for NISP (Newegg International Shipping Program). For free domestic shipping, please update your shipping settings in Seller Portal.
CT097 Item shipping dimensions do not meet the limits of NISP (Newegg International Shipping Program).

Example: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CE003</Code>
        <Message> The 'Type' element is invalid - The value 'a' is invalid according to its
datatype 'Int' - The string 'a' is not a valid Int32 value.</Message>
    </Error>
</Errors>

Example: Json, Response

{
    "Code": "CT002",
    "Message": "Invalid SellerPartNumber"
}

Last updated: August 28, 2020