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:
|
| Value | Yes | String | A string according to inquiry type |
| Condition | No | Integer | Available values:
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. |
| MSRP | No | Decimal | Manufacturer Suggested Retail Price
The manufacturer’s suggested retail price (MSRP) or list price for the item. Allow brand owner to maintain item’s MSRP
|
| 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:
|
| SellingPrice | No | Decimal | The actual selling price |
| EnableFreeShipping | No | Integer | Available values:
|
| Active | No | Integer | Available values:
Null = Ignore this action, no change to current item active/deactivate setting |
| 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:
|
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:
|
| 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:
Note:
|
| SellingPrice | Decimal | The actual selling price |
| EnableFreeShipping | Integer | Available values:
|
| 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:
|
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