獲取商品價格

獲取包括美國在內的所有目的地國家的商品價格相關資訊。

相關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]時，當前值會被忽略
  • 如果不填，預設值為全新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