批量獲取商品價格

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

相關URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/international/Pricelist?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編號)
如果不填,預設值為Seller Part#
Value String Array 多個指定值的字串
CountryCode String Array 您倉庫所在國家的國際標準3位元國家編碼。
完整國家代碼清單,請通過以下連結下載:International Country Guide
如果不填,則默認為所有

Schema: GetPriceListRequest.xsd

示例:XML, Request

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

<ContentQueryCriteria>
  <Type>1</Type>
  <Values>
    <Key>A006TestItem2022050601</Key>
    <Key>A006TestItem2022050602</Key>
    <Key>A006TestItem2022050603</Key>
  </Values>
  <CountryList>
    <CountryCode>USA</CountryCode>
    <CountryCode>CHN</CountryCode>
  </CountryList>
</ContentQueryCriteria>

示例:Json, Request

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

{
  "Type": "1",
  "Values": ["A006TestItem2022050601","A006TestItem2022050602","A006TestItem2022050603"],
  "CountryList": ["USA","CHN"]
}

回覆文件主體

屬性 格式 描述
SellerID String 您的商家編號
TotalCount Integer 商品價格數量
SellerPartNumber String Seller part#,賣家自訂的商品唯一識別碼
ItemNumber String 以9SI開頭的新蛋商品編號
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

 

有效值:
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(批量折扣促銷)
ShipByNewegg Integer 有效值:
0:商家配送
1:新蛋配送
LimitQuantity Integer 客戶在48小時內可以購買該商品的最大數量。最大值是500。註意以下返值:
0:系統將刪除現有值
null: 無更新

Schema: GetPriceListResponse.xsd

示例: XML, Response

<NeweggAPIResponse
  xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
  xmlns:xsd=http://www.w3.org/2001/XMLSchema>
  <IsSuccess>true</IsSuccess>
  <OperationType>GetPriceList</OperationType>
  <SellerID>A006</SellerID>
  <ResponseDate>2022-04-20T23:46:41.7786361-07:00</ResponseDate>
  <ResponseBody>
    <ItemList>
      <PriceResult>
        <ItemNumber>9SIA00603V5190</ItemNumber>
        <SellerPartNumber>A006-TestItem-001</SellerPartNumber>
        <PriceList>
          <Price>
            <CountryCode>USA</CountryCode>
            <Currency>USD</Currency>
            <Active>1</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>80.00</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <OnPromotion>0</OnPromotion>
            <ShipByNewegg>0</ShipByNewegg>
            <LimitQuantity xsi:nil="true" />
          </Price>
          <Price>
            <CountryCode>CHN</CountryCode>
            <Currency>USD</Currency>
            <Active>0</Active>
            <MAP>25.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>80.00</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <OnPromotion>0</OnPromotion>
            <ShipByNewegg>0</ShipByNewegg>
            <LimitQuantity xsi:nil="true" />
          </Price>
        </PriceList>
      </PriceResult>
      <PriceResult>
        <ItemNumber>9SIA00603V5191</ItemNumber>
        <SellerPartNumber>A006-TestItem-002</SellerPartNumber>
        <PriceList>
          <Price>
            <CountryCode>USA</CountryCode>
            <Currency>USD</Currency>
            <Active>1</Active>
            <MAP>50.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>100.00</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <OnPromotion>0</OnPromotion>
            <ShipByNewegg>0</ShipByNewegg>
            <LimitQuantity>20</LimitQuantity>
          </Price>
          <Price>
            <CountryCode>CHN</CountryCode>
            <Currency>USD</Currency>
            <Active>0</Active>
            <MAP>50.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>100.00</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <OnPromotion>0</OnPromotion>
            <ShipByNewegg>0</ShipByNewegg>
            <LimitQuantity>20</LimitQuantity>
          </Price>
        </PriceList>
      </PriceResult>
      <PriceResult>
        <ItemNumber>9SIA00603V5192</ItemNumber>
        <SellerPartNumber>A006-TestItem-003</SellerPartNumber>
        <PriceList>
          <Price>
            <CountryCode>USA</CountryCode>
            <Currency>USD</Currency>
            <Active>1</Active>
            <MAP>75.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>120.00</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <OnPromotion>0</OnPromotion>
            <ShipByNewegg>0</ShipByNewegg>
            <LimitQuantity xsi:nil="true" />
          </Price>
          <Price>
            <CountryCode>CHN</CountryCode>
            <Currency>USD</Currency>
            <Active>0</Active>
            <MAP>75.99</MAP>
            <CheckoutMAP>0</CheckoutMAP>
            <SellingPrice>120.00</SellingPrice>
            <EnableFreeShipping>0</EnableFreeShipping>
            <OnPromotion>0</OnPromotion>
            <ShipByNewegg>0</ShipByNewegg>
            <LimitQuantity xsi:nil="true" />
          </Price>
        </PriceList>
      </PriceResult>
    </ItemList>
    <TotalCount>3</TotalCount>
  </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
  "ResponseBody": {
    "ItemList": [
      {
        "ItemNumber": "9SIA00603V5190",
        "SellerPartNumber": "A006-TestItem-001",
        "PriceList": [
          {
            "CountryCode": "USA",
            "Currency": "USD",
            "Active": 1,
            "MAP": 25.99,
            "CheckoutMAP": 0,
            "SellingPrice": 80,
            "EnableFreeShipping": 0,
            "OnPromotion": "0",
            "ShipByNewegg": 0
          },
          {
            "CountryCode": "CHN",
            "Currency": "USD",
            "Active": 0,
            "MAP": 25.99,
            "CheckoutMAP": 0,
            "SellingPrice": 80,
            "EnableFreeShipping": 0,
            "OnPromotion": "0",
            "ShipByNewegg": 0
          }
        ]
      },
      {
        "ItemNumber": "9SIA00603V5191",
        "SellerPartNumber": "A006-TestItem-002",
        "PriceList": [
          {
            "CountryCode": "USA",
            "Currency": "USD",
            "Active": 1,
            "MAP": 50.99,
            "CheckoutMAP": 0,
            "SellingPrice": 100,
            "EnableFreeShipping": 0,
            "OnPromotion": "0",
            "ShipByNewegg": 0,
            "LimitQuantity": 20
          },
          {
            "CountryCode": "CHN",
            "Currency": "USD",
            "Active": 0,
            "MAP": 50.99,
            "CheckoutMAP": 0,
            "SellingPrice": 100,
            "EnableFreeShipping": 0,
            "OnPromotion": "0",
            "ShipByNewegg": 0,
            "LimitQuantity": 20
          }
        ]
      },
      {
        "ItemNumber": "9SIA00603V5192",
        "SellerPartNumber": "A006-TestItem-003",
        "PriceList": [
          {
            "CountryCode": "USA",
            "Currency": "USD",
            "Active": 1,
            "MAP": 75.99,
            "CheckoutMAP": 0,
            "SellingPrice": 120,
            "EnableFreeShipping": 0,
            "OnPromotion": "0",
            "ShipByNewegg": 0
          },
          {
            "CountryCode": "CHN",
            "Currency": "USD",
            "Active": 0,
            "MAP": 75.99,
            "CheckoutMAP": 0,
            "SellingPrice": 120,
            "EnableFreeShipping": 0,
            "OnPromotion": "0",
            "ShipByNewegg": 0
          }
        ]
      }
    ],
    "TotalCount": 3
  },
  "IsSuccess": true,
  "OperationType": "GetPriceList",
  "SellerID": "A006",
  "ResponseDate": "2022-04-20T23:46:41.7786361-07:00"
}

請求失敗錯誤資訊

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

更新日期:03/09/2022