更新商品库存

维护包括美国在内全球所有注册仓库商品的库存信息。

相关URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?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]时，当前值会被忽略
WarehouseLocation 是 String 您仓库所在国家的国际标准3位国家编码。
完整国家代码列表，请通过以下链接下载：International Country Guide
注：含有错误值的提交将会报错
AvailableQuantity 是 integer 卖家指定仓库里的商品数量

Schema: UpdateInventoryRequest.xsd

示例：XML，Request

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

<ItemInventoryInfo>
    <Type>1</Type>
    <Value>A006BSP3</Value>
    <InventoryList>
        <Inventory>
            <WarehouseLocation>USA</WarehouseLocation>
            <AvailableQuantity>107</AvailableQuantity>
        </Inventory>
        <Inventory>
            <WarehouseLocation>AUS</WarehouseLocation>
            <AvailableQuantity>0</AvailableQuantity>
        </Inventory>
    </InventoryList>
</ItemInventoryInfo>

示例：Json，Request

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

{
    "Type": "1",
    "Value": "A006BSP3",
    "InventoryList": {
        "Inventory": [
            {
                "WarehouseLocation": "USA",
                "AvailableQuantity": "107"
            },
            {
                "WarehouseLocation": "AUS",
                "AvailableQuantity": "0"
            }
        ]
    }
}

回复文件主体

属性 格式 描述
SellerID String 您的商家编号
ItemNumber String 新蛋分配的商家编号
SellerPartNumber String 商家商品编号
WarehouseLocation String 您仓库所在国家的国际标准3位国家编码。

完整国家代码列表，请通过以下链接下载：International Country Guide
AvailableQuantity Integer 该仓库当前的有效库存数量

Schema: UpdateInventoryResponse.xsd

示例：XML，Response

<?xml version="1.0" encoding="utf-8"?>
<UpdateInventoryResult>
    <SellerID>A006</SellerID>
    <ItemNumber>9SIA00607Y6476</ItemNumber>
    <SellerPartNumber>A006BSP3</SellerPartNumber>
    <InventoryList>
        <Inventory>
            <WarehouseLocation>USA</WarehouseLocation>
            <AvailableQuantity>107</AvailableQuantity>
        </Inventory>
        <Inventory>
            <WarehouseLocation>AUS</WarehouseLocation>
            <AvailableQuantity>0</AvailableQuantity>
        </Inventory>
    </InventoryList>
</UpdateInventoryResult>

示例：Json，Response

{
    "SellerID": "A006",
    "ItemNumber": "9SIA00607Y6476",
    "SellerPartNumber": "A006BSP3",
    "InventoryList": {
        "Inventory": [
            {
                "WarehouseLocation": "USA",
                "AvailableQuantity": "107"
            },
            {
                "WarehouseLocation": "AUS",
                "AvailableQuantity": "0"
            }
        ]
    }
}

请求失败错误信息

常规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
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

该商品不属于这个商家
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}.
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 小时之后重新处理该商品的价格和库存的更新请求。
CT073 The request for item: { SellerPart#} has been processed with error.Country: [country1,country2] Failed reason: The specified warehouse location has not been setup yet. Please set up your warehouse(s) then submit your request again.

商品{ SellerPart#}的请求已处理但有错误。错误原因：指定的仓库所在地没有被设置。请设置您的仓库然后重新提交请求。

示例：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"
}

更新日期：10/15/2018