更新庫存和價格

更新商品庫存、價格、物流資訊以及商品狀態。

註:一旦商品被下架,所有關於該商品的價格和庫存的更新請求都將被忽略。當您重新啟動您的商品時,您可以再次更新價格和庫存。

相關URL

該操作只適用於Neweggbusiness.comNewegg.ca平台。

Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventoryandprice?sellerid={sellerid}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/inventoryandprice?sellerid={sellerid}

註:請確保您的請求URL全都是小寫(除Seller ID)並且不能包含任何空格或者分行符號。

參數

名稱 是否必填? 描述
sellerid 您在新蛋商城的商家編號

相關請求資訊

HTTP方式 是否需要認證? 請求格式 回覆格式 頻率限制
PUT 需要 XML,Json XML,Json 10,000 請求/小時

請求文件主體

屬性 是否必填? 格式 描述
Type Integer 有效值:

  • 0: NE Item#(新蛋商品編號)
  • 1: Seller Part#(商家商品編號)
  • 2: UPC Code(UPC編號)
Value String 指定查詢類型的字串
Inventory Integer 可用庫存數量
您無法更新使用SBN(新蛋配送)商品的庫存資訊。
註:一旦商品被下架,所有關於該商品價格和庫存的更新請求都將被忽略。當您重新啟動您的商品時,您可以再次更新價格和庫存。
MAP Decimal 最低廣告價格。
如果商品售價低於設置的最低廣告價格,網站會要求客戶將該商品加入購物車來查看價格。
如果您想要刪除MAP, 請在該欄位裡輸入“0.00”或者“0”。
如果為空,則不更改當前設置。
CheckoutMAP Integer 當Checkout MAP 標記為“1”並且銷售價格低於MAP 價格時,商品在結帳之前將不會顯示銷售價格。
有效值:

  • 0:False(否)
  • 1:True(是)
SellingPrice Decimal 實際銷售價格
實際銷售價格不能大於MSRP
EnableFreeShipping Integer 有效值:

  • 0:Default(按照運費計算公式收取運費)
  • 1:Free Shipping(免運費)
Active Integer 有效值:

  • 1:Activate item(啟動商品)
  • 0:Deactivate item(下架商品)

Null=忽略此操作,沒有更改當前商品的狀態設置

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]時,當前值會被忽略

FulfillmentOption Integer 有效值:

  • 0:Ship Seller 商家發貨
  • 1:Ship by Newegg 新蛋發貨
LimitQuantity Integer 客戶在48小時內可以購買該商品的最大數量。最大值是500。註以下返值:

  • 0:系統將刪除現有值
  • null:無更新

Schema: UpdateInventoryandPriceRequest.xsd

示例:XML, Request

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

<ItemInventoryAndPriceInfo>
    <Type>1</Type>
    <Value>A006BSP3</Value>
    <Inventory>20</Inventory>
    <MAP>230</MAP>
    <CheckoutMAP>0</CheckoutMAP>
    <SellingPrice>200</SellingPrice>
    <EnableFreeShipping>1</EnableFreeShipping>
    <Active>0</Active>
    <FulfillmentOption>1</FulfillmentOption>
    <LimitQuantity>1</LimitQuantity>
</ItemInventoryAndPriceInfo>

示例:Json, Request

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

{
    "Type": "1",
    "Value": "A006BSP3",
    "Inventory": "20",
    "MAP": "230",
    "CheckoutMAP": "0",
    "SellingPrice": "200",
    "EnableFreeShipping": "1",
    "Active": "0",
    "FulfillmentOption": "1",
    "LimitQuantity": "1"
}

回覆文件主體

屬性 格式 描述
Result Integer 用於確定當前的服務請求是否成功。有效值:

  • 0:失敗
  • 1:成功
SellerID String 您的商家編號
ItemNumber String 新蛋分配的商品編號
SellerPartNumber String 商家自訂的商品編號
FulfillmentOption Integer 有效值:

  • 0:商家配送(Ship by Seller)
  • 1:新蛋配送(Ship by Newegg)
Active Integer 有效值:

  • 0:未啟動狀態
  • 1:已啟動狀態
AvailableQuantity Integer 有效庫存總數
當某個商品轉為使用新蛋配送SBN,則該商品在系統中的庫存數變為0,直到新蛋倉庫接收到新的貨物
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 LimitQuantity 客戶在48小時內可以購買該商品的最大數量。最大值是500。註以下返值:

  • 0:系統將刪除現有值
  • null:無更新

Schema: UpdateInventoryandPriceResponse.xsd

示例:XML, Response

<?xml version="1.0" encoding="utf-8"?>
<UpdateInventoryAndPriceResult>
    <SellerID>V006</SellerID>
    <ItemNumber>9SIA00607Y6476</ItemNumber>
    <SellerPartNumber>A006BSP3</SellerPartNumber>
    <FulfillmentOption>0</FulfillmentOption>
    <Active>0</Active>
    <Result>1</Result>
    <AvailableQuantity>20</AvailableQuantity>
    <MAP>230</MAP>
    <CheckoutMAP>0</CheckoutMAP>
    <SellingPrice>250</SellingPrice>
    <EnableFreeShipping>1</EnableFreeShipping>
    <LimitQuantity>1</LimitQuantity>
</UpdateInventoryAndPriceResult>

示例:Json, Response

{
  "UpdateInventoryAndPriceResult": {
    "SellerID": "V006",
    "ItemNumber": "9SIA00607Y6476",
    "SellerPartNumber": "A006BSP3",
    "FulfillmentOption": "0",
    "Active": "0",
    "Result": "1",
    "AvailableQuantity": "20",
    "MAP": "230",
    "CheckoutMAP": "0",
    "SellingPrice": "250",
    "EnableFreeShipping": "1",
    "LimitQuantity": "1"
  }
}

請求失敗錯誤資訊

常規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.

該商品因促銷被新蛋鎖定,不能更改價格。

請註:庫存數量或最小訂購數量不會被影響

CT022 This item is Shipping by Newegg. Can NOT update inventory

該商品為新蛋配送。無法更新庫存。

CT023 Inventory value must be between 0 and 999999

庫存數量詞範圍為0-999999

CT025 This item is an approved promotion and its minimum inventory cannot be lower than {0}

該商品為促銷商品,其最小庫存不能低於{0}

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 無法被重新啟動。

CT047 Cannot convert Seller Part # [SellerPart#] to [the original request value of either ship by seller/ship by Newegg] because of scheduled/ongoing promotion(s). Please close promotion(s) first then submit your request again

由於已安排/正在進行的促銷,不能將seller part#[SellerPart#]轉為[ship by seller/ship by Newegg的原始請求值]。請先關閉促銷,然後再提交請求。

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。 詳細資訊請聯繫你的帳戶經理。

CT051 The update submitted for seller part #:{SellerPart#} cannot be processed because the item is currently deactivated.

為seller part#:{SellerPart#}提交的更新請求不能被執行,因為該產品已下架。

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 小時之後重新處理該商品的價格和庫存的更新請求。

CT056 Request has been processed. Warning:The item:[{seller part#}] is a Subscribe & Save item but currently either deactivated or out of stock. Any order with existing subscription will NOT be processed.

此請求已處理。警告:商品[{seller part#}]時訂閱商品,但當前未啟動或者缺貨。任何現有訂閱的訂單都不會被處理

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

示例: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