更新商品價格

維護包括美國在內的所有已開通國家的商品價格資訊、物流資訊以及商品狀態。

相關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