获取商品价格

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

参数

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

请求文件主体

属性	是否必填？	格式	描述
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

<Value>A006testitem201201021459</Value>

</CountryList>

</ContentQueryCriteria>

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>

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"

]

}

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" ] } }

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"?>

<SellerPartNumber>A006testitem201201021459</SellerPartNumber>

<Price>

</Price>

<Price>

</Price>

<Price>

</Price>

</PriceList>

</PriceResult>

<?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>

<?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"

}

]

}

{ "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" } ] } }

{
    "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"?>

<Error>

<Message>Invalid SellerPartNumber</Message>

</Error>

</Errors>

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

<?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"

}

]

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

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

更新日期：08/28/2020

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

获取商品价格

相关URL

参数

相关请求信息

请求文件主体

回复文件主体

请求失败错误信息