获取商品价格

获取包括美国在内的所有目的地国家的商品价格相关信息。

相关URL

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

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

参数

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

相关请求信息

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

请求文件主体

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

  • 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]时，当前值会被忽略
  • 如果不填，默认值为1: New全新
CountryCode 否 String 您仓库所在国家的国际标准3位国家编码。
完整国家代码列表，请通过以下链接下载：International Country Guide
如果不填，则默认为所有

Schema: GetPriceRequest.xsd

示例：XML，Request

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

<ContentQueryCriteria>
    <Type>1</Type>
    <Value>A006testitem201201021459</Value>
    <CountryList>
        <CountryCode>USA</CountryCode>
        <CountryCode>AUS</CountryCode>
    </CountryList>
</ContentQueryCriteria>

示例：Json，Request

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

{
    "Type": "1",
    "Value": "A006testitem201201021459",
    "CountryList": {
        "CountryCode": [
            "USA",
            "AUS"
        ]
    }
}

回复文件主体

属性 格式 描述
SellerID String 您的商家编号
ItemNumber String 新蛋分配的商品编号
SellerPartNumber String 商家自定义的商品编号
CountryCode String 您仓库所在国家的国际标准3位国家编码。

完整国家代码列表，请通过以下链接下载：International Country Guide
Currency Integer 用于识别您商品销售目标国家的Selling Price(销售价格)，MSRP(厂商建议零售价)，MAP(最低广告价 格)的货币单位。若为空，则默认值为 USD。

完整国家代码列表，请通过以下链接下载：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（免运费）
OnPromotion Integer，separated by comma 有效值：

  • 0: No active Promotion（无促销）
  • 1: Active promotion with Price Lock（锁定价格的有效促销）
  • 2: Active Promotion with Promotion Code（有优惠券的有效促销）
  • 3: Active promotion with Auto Add To Cart（买赠活动的有效促销）
  • 4: Active Promotion with Combo（捆绑式组合促销）
  • 5: Active Promotion with Volume Discount（批量折扣促销）
LimitQuantity Integer 客户在48小时内可以购买该商品的最大数量。最大值是500。注意以下返值：
0：系统将删除现有值
null：无更新

Schema: GetPriceResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<PriceResult>
    <SellerID>A006</SellerID>
    <ItemNumber>9SIA0060884598</ItemNumber>
    <SellerPartNumber>A006testitem201201021459</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>
            <OnPromotion>1,5</OnPromotion>
            <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>
            <OnPromotion>1,5</OnPromotion>
            <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>
            <OnPromotion/>
            <LimitQuantity>2</LimitQuantity>
        </Price>
    </PriceList>
</PriceResult>

示例：Json，Response

{
    "SellerID": "A006",
    "ItemNumber": "9SIA0060884598",
    "SellerPartNumber": "A006testitem201201021459",
    "PriceList": {
        "Price": [
            {
                "CountryCode": "USA",
                "Currency": "USD",
                "Active": "0",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "20.92",
                "EnableFreeShipping": "1",
                "OnPromotion": "1,5",
                "LimitQuantity": "2"
            },
            {
                "CountryCode": "IND",
                "Currency": "INR",
                "Active": "1",
                "MAP": "25.99",
                "CheckoutMAP": "0",
                "SellingPrice": "389.92",
                "EnableFreeShipping": "0",
                "OnPromotion": "1,5",
                "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 Code
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
CT010 Cannot find item with specified item condition.

找不到指定condition的商品
CT026 Can’t find this item in the system, please create first

系统中找不到该商品，请先创建

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<Errors>
    <Error>
        <Code>CT002</Code>
        <Message>Invalid SellerPartNumber</Message>
    </Error>
</Errors>

示例：Json，Response

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

更新日期：08/28/2020