更新库存和价格

更新商品库存、价格、物流信息以及商品状态。

注：一旦商品被下架，所有关于该商品的价格和库存的更新请求都将被忽略。当您重新激活您的商品时，您可以再次更新价格和库存。

相关URL

该操作只适用于Neweggbusiness.com和Newegg.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：商家发货
  • 1：新蛋发货
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