更新商品价格

维护包括美国在内的所有已开通国家的商品价格信息、物流信息以及商品状态。

相关URL

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

注：请确保您的请求URL全都是小写（除Seller ID）并且不能包含任何空格或者换行符。

参数

名称 是否必填？ 描述
sellerid 是 您在新蛋商城的商家编号

相关请求信息

HTTP方式 是否需要认证？ 请求格式 回复格式 频率限制
POST 需要 XML,Json XML,Json 10,000 请求/小时

请求文件主体

属性 是否必填？ 格式 描述
Type 是 Integer 有效值：

  • 0: NE Item#（新蛋商品编号）
  • 1: Seller Part#（商家商品编号）
  • 2: UPC Code（UPC编号）
Value 是 String 指定查询类型的字符串
Condition 否 Integer 有效值：

  • 1. New（全新的）（默认）
  • 2. Refurbished（翻新的）
  • 3. Used – Like New（二手-类似新品）
  • 4. Used – Very Good（二手-非常好）
  • 5. Used – Good（二手-好）
  • 6. Used – Acceptable（二手-尚可）

注：当Type是[2-UPC code]时，当前值有效；当Type不是[2-UPC code]时，当前值会被忽略
CountryCode 是 String 您仓库所在国家的国际标准3位国家编码。
完整国家代码列表，请通过以下链接下载：International Country Guide
注：商品价格在提交时必须带有与运送目的地国家代码相匹配的货币代码。带有不正确的国家和货币组合的请求将会报错。
Currency 是 String 用于识别您商品销售目标国家的Selling Price(销售价格)，MSRP(厂商建议零售价)，MAP(最低广告价格)的货币单位。
若为空，则默认值为 USD，
完整货币代码，请通过下方链接下载：International Country Guide
注：商品价格在提交时必须带有与运送目的地国家代码相匹配的货币代码。带有不正确的国家和货币组合的请求将会报错。
Active 否 Integer 有效值：

  • 1: Activate item（上架商品）
  • 0: Deactivate item（下架商品）

Null=忽略此操作，没有更改当前商品的状态设置
MAP 否 Decimal 最低广告价格。

如果商品售价低于设置的最低广告价格，网站会要求客户将该商品加入购物车来查看价格。
CheckoutMAP 否 Integer 当Checkout MAP 标记为“1”并且销售价格低于MAP 价格时， 商品在结账之前将不会显示销售价格。
有效值：

  • 0：False（否）
  • 1：True（是）
SellingPrice 否 Decimal 实际销售价格
EnableFreeShipping 否 Integer 有效值：

  • 0: Default（按照运费计算公式收取运费）
  • 1: Free Shipping（免运费）
LimitQuantity 否 Integer 客户在48小时内可以购买该商品的最大数量。最大值是500。注意以下返值：

  • 0：系统将删除现有值
  • null：无更新

Schema: UpdatePriceRequest.xsd

示例：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>

示例：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"
            }
        ]
    }
}

回复文件主体

属性 格式 描述
SellerID String 您的商家编号
ItemNumber String 新蛋分配的商品编号
SellerPartNumber String 商家自定义的商品编号
CountryCode String 商品将销售到的目标国家。新蛋系统将返回国际标准的3位国家代码值。

完整国家代码列表，请通过以下链接下载：International Country Guide
Currency String 用于识别您商品销售目标国家的Selling Price(销售价格)，MSRP(厂商建议零售价)，MAP(最低广告价 格)的货币单位。新蛋系统将返回国际标准的3位货币代码。

完整货币代码列表，请通过以下链接下载：International Country Guide
Active Integer 有效值：

  • 0: 未激活状态
  • 1: 已激活状态
MAP Decimal 最低广告价格。

如果商品售价低于设置的最低广告价格，网站会要求客户将该商品加入购物车来查看价格。
CheckoutMAP Integer 有效值：

  • 0：False（否）
  • 1：True（是）

注：

  • 如果Checkout MAP标记为True，网站会要求客户将该产品加入购物车并到支付页面才能查看商品售价。MAP值将被忽略。
  • 也就是说，只要Checkout MAP为True，不论实际售价是高于或是低于MAP，顾客始终需要加入商品到购物车并到支付页面才能查看商品售价。
  • 如果 MAP 大于 0.00 并且 CheckoutMAP 为空，默认情况下， CheckoutMAP 将被设为 False
SellingPrice Decimal 实际销售价格
EnableFreeShipping Integer 有效值：

  • 0: Default（按照运费计算公式收取运费）
  • 1: Free Shipping（免运费）
LimitQuantity Integer 客户在48小时内可以购买该商品的最大数量。最大值是500。注意以下返值：

  • 0：系统将删除现有值
  • null：无更新

Schema: UpdatePriceResponse.xsd

示例：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>

示例：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"
            }
        ]
    }
}

请求失败错误信息

常规HTTP错误回复，请参考回复失败错误代码列表。

错误代码 描述
CT001 Invalid ItemNumber

无效的商品编号
CT002 Invalid SellerPartNumber

无效的 Seller Part #
CT003 Invalid UPCCode

无效UPC 编码
CT005 Invalid Action Type. We only support: 0 – NE Item#, 1 – Seller Parts#, 2 – UPC Code

无效的 Action 类型。我们只支持：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

无效的 MSRP。价格区间为 0 至 99999.99
CT007 Invalid Selling Price. The range should be between 0-99999.99

无效 Selling Price。价格区间为 0 至 99999.99
CT008 Invalid Shipping type. We only support: 0 – default, 1 – free shipping

无效的 Shipping type。我们只支持 0 – default, 1 – free shipping
CT009 Cannot activate item by restricted manufacturer – {0}[({1}){2}].

无法激活商品，制造厂商受限- {0}[({1}){2}].
CT010 Cannot find item with specified item condition.

找不到指定 condition 的商品
CT014 SellerItemNumber or SellerPartNumber does not exist

SellerItemNumber 或 SellerPartNumber 不存在
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.

该商品因促销被新蛋锁定，不能更改 Shipping(运送方式)。请注意：库存数量或最小订购数量不会被影响。
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

无效的 ActiveMark(激活标志)，我们只支持：0 – deactivate item(商品下架), 1 – activate item(商品激活)
CT029 The selling price {selling price} cannot be greater than MSRP {MSRP}.

实际售价{ selling price }不能高于厂家建议零售价{ MSRP }
CT030 MAP price should be decimal with 2 digitals. The range should be between 0-99999.99.

MAP 价格应带有 2 位小数，价格区间为 0-99999.99
CT031 Invalid CheckoutMAP value. We only support: 0 – False, 1 – True.

无效的 CheckoutMAP 值。我们只支持：0 – False, 1 -True
CT032 The selling price cannot be 0.

实际售价不能为 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

由于下列原因该商品不能被激活：1.商品不存在 2.违反价格规定 3.没有图片
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.

商品因为 7 天 0 库存而被自动下架，库存仍为 0 无法被重新激活。
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.

商品激活失败。Strict MAP：${0} – Selling Price 必须大于或等于 Strict MAP。 详细信息请联系您的账户经理。
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].

此请求为 Seller Part #: [seller part #]的重复请求。此商品不存在于 Newegg，因此我们无法处理您的请求。 我们将会在[上一次失败的时间]的 8 小时之后重新处理该商品的价格和库存的更新请求。
CT065 Invalid Selling Price. The Selling Price should be greater than the existing 1st tier volume discount unit price: [{0}]

无效的销售价格。销售价格应该大于已设置的第一级总量折扣单价(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.

商品[Seller Part #]由新蛋已存在的 MAP(最小广告价格)设置所控制，MAP=[amount], Checkout MAP = [status]。当 MAP 总额大于 0 或 Checkout MAP=True 时，试图更改 MAP 或 CheckoutMAP 的操作都会被限 制。所有其他请求都已被处理。
CT071 The Inventory update for item: [SellerPart#] cannot be processed because of the warehouse: [warehouselocation] has not been created.

商品:[Seller Part #]的库存更新不能被处理因为仓库(warehouse)[warehouse]未被创建
CT075 Price update failed. Invalid currency code. The currency code received: [code] does not match the specified country: [code].

价格更新失败。无效的货币代码。接受的货币代码[code]不匹配指定的国家:[code]
CT076 Item cannot be activated for specified country: [code]. Please activate the country, then submit your request again.

无法激活指定国家:[code]的商品。请先激活国家再重新提交请求。
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 #]

商品{Seller Part #}的请求已经处理但有错误。您的账户当前所能创建的商品个数已达上限。为了能刊登更 多商品，请优化您的商品列表。如需增加可允许的最大限制，请升级您的服务。
CT096 FREE SHIPPING is not available for NISP (Newegg International Shipping Program). For free domestic shipping, please update your shipping settings in Seller Portal.

Free Shipping（免运费）不适用于 NISP(新蛋国际运输项目)。如需设置美国国内运送免运费，请在 Seller Portal 更新 Shipping Settings（配送设置）
CT097 Item shipping dimensions do not meet the limits of NISP (Newegg International Shipping Program).

商品运输尺寸没有达到 NISP 的运输要求(新蛋国际运输项目)。

示例：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>

示例：Json，Response

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

更新日期：08/28/2020