追蹤商品庫存

追蹤商品在全球所有已登記的倉庫，包括美國倉的有效庫存資訊。

相關URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/international/inventory?sellerid={sellerid}

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

參數

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

相關請求資訊

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

請求文件主體

屬性 是否必填？ 格式 描述
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]時，當前值會被忽略
  • 如果不填，預設值為全新New
Type 是 Integer 可用屬性：

  • 0: NE Item#（新蛋商品編號）
  • 1: Seller Part#（商家商品編號）
  • 2: UPC Code（UPC編號）
Value 是 String 根據指定類型的字串
WarehouseLocation 否 String 您倉庫所在國家的國際標準3位元國家編碼。
完整國家代碼清單，請通過以下連結下載：International Country Guide
如果不填，則默認為所有

Schema: GetInventoryRequest.xsd

示例：XML, Request

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

<ContentQueryCriteria>
    <Type>1</Type>
    <Value>A006testitem201201021459</Value>
    <WarehouseList>
        <WarehouseLocation>USA</WarehouseLocation>
        <WarehouseLocation>AUS</WarehouseLocation>
    </WarehouseList>
</ContentQueryCriteria>

示例：Json, Request

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

{
    "Type": "1",
    "Value": "A006testitem201201021459",
    "WarehouseList": {
        "WarehouseLocation": [
            "USA",
            "AUS"
        ]
    }
}

回覆文件主體

屬性 格式 描述
SellerID String 您的商家編號
ItemNumber String 新蛋分配的商品編號
SellerPartNumber String Seller part# 商家商品編號
WarehouseLocation String 您倉庫所在國家的國際標準3位元國家編碼；
完整國家代碼清單，請通過以下連結下載：International Country Guide
FulfillmentOption String 有效值：

  • 0: ShipBySeller（商家配送)
  • 1: ShipByNewegg（新蛋配送）
AvailableQuantity Integer 該倉庫當前的有效庫存數量
WarehouseCode String 表明庫存在新蛋哪個倉庫中。
有效值：

  • 06: Tennessee Bulk Warehouse（田納西大型倉庫）
  • 07: California Small Warehouse（加利福尼亞小型倉庫）
  • 08: California Bulk Item Warehouse（加利福尼亞大型倉庫）
  • 10: New Jersey Bulk Warehouse（新澤西大型倉庫）
  • 12: Tennessee Small Warehouse（田納西大型倉庫）
  • 14: New Jersey Small Warehouse（新澤西小型倉庫）

註：只有當商品目前存放在新蛋倉庫時才會返回該資訊。
Quantity Integer 該新蛋倉庫當前的有效庫存數量
註：只有當商品目前存放在新蛋倉庫時才會返回該資訊。

Schema: GetInventoryResponse.xsd

示例: XML, Response

<?xml version="1.0" encoding="utf-8"?>
<InventoryResult>
    <SellerID>A006</SellerID>
    <ItemNumber>9SIA0060884598</ItemNumber>
    <SellerPartNumber>A006testitem201201021459</SellerPartNumber>
    <InventoryAllocation>
        <Inventory>
            <WarehouseLocation>USA</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>107</AvailableQuantity>
        </Inventory>
        <Inventory>
            <WarehouseLocation>USA</WarehouseLocation>
            <FulfillmentOption>1</FulfillmentOption>
            <AvailableQuantity>40</AvailableQuantity>
            <WarehouseAllocation>
                <Warehouse>
                    <WarehouseCode>07</WarehouseCode>
                    <Quantity>3</Quantity>
                </Warehouse>
                <Warehouse>
                    <WarehouseCode>12</WarehouseCode>
                    <Quantity>37</Quantity>
                </Warehouse>
            </WarehouseAllocation>
        </Inventory>
        <Inventory>
            <WarehouseLocation>AUS</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>0</AvailableQuantity>
        </Inventory>
    </InventoryAllocation>
</InventoryResult>

示例: Json, Response

{
    "SellerID": "A006",
    "ItemNumber": "9SIA0060884598",
    "SellerPartNumber": "A006testitem201201021459",
    "InventoryAllocation": {
        "Inventory": [
            {
                "WarehouseLocation": "USA",
                "FulfillmentOption": "0",
                "AvailableQuantity": "107"
            },
            {
                "WarehouseLocation": "USA",
                "FulfillmentOption": "1",
                "AvailableQuantity": "40",
                "WarehouseAllocation": {
                    "Warehouse": [
                        {
                            "WarehouseCode": "07",
                            "Quantity": "3"
                        },
                        {
                            "WarehouseCode": "12",
                            "Quantity": "37"
                        }
                    ]
                }
            },
            {
                "WarehouseLocation": "AUS",
                "FulfillmentOption": "0",
                "AvailableQuantity": "0"
            }
        ]
    }
}

請求失敗錯誤資訊

常規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 No data found
找不到數據。

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

更新日期： 10/15/2018