批量追蹤商品庫存

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

相關URL

Newegg.com: https://api.newegg.com/marketplace/contentmgmt/item/international/inventorylist?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編號)
如果不填,預設值為Seller Part#
Value String Array 多個指定值的字串,最大長度為100
WarehouseList String Array 您倉庫所在國家的國際標準3位元國家編碼。
完整國家代碼清單,請通過以下連結下載:International Country Guide
如果不填,則默認為所有

Schema: GetInventoryListRequest.xsd

示例:XML, Request

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

<ContentQueryCriteria>
  <Type>1</Type>
  <Values>
    <Key>A006-TestItem-001</Key>
    <Key>A006-TestItem-002</Key>
    <Key>A006-TestItem-003</Key>
  </Values>
  <WarehouseList>
    <WarehouseLocation>USA</WarehouseLocation>
    <WarehouseLocation>AUS</WarehouseLocation>
  </WarehouseList>
</ContentQueryCriteria>

示例:Json, Request

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

{
  "Type": "1",
  "Values": ["A006-TestItem-001","A006-TestItem-002","A006-TestItem-003"],
  "WarehouseList": ["USA","AUS"]
}

回覆文件主體

屬性 格式 描述
SellerID String 您的商家編號
TotalCount Integer 庫存數量盤點
SellerPartNumber String Seller part#,賣家自訂的商品唯一識別碼
ItemNumber String 以9SI開頭的新蛋商品編號
WarehouseLocation String 您倉庫所在國家的國際標準3位元國家編碼;
完整國家代碼清單,請通過以下連結下載:International Country Guide
FulfillmentOption String 有效值:
0: ShipBySeller(商家配送)
1: ShipByNewegg(新蛋配送)
Condition Integer 有效值:
1.New(全新)
2.Refurbished(翻新)
3.Used – Like New(二手 – 類似新品)
4.Used – Very Good(二手 – 非常好)
5.Used – Good(二手 – 好)
6.Used – Acceptable(二手 – 尚可)
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 該新蛋倉庫當前的有效庫存數量
註:只有當商品目前存放在新蛋倉庫時才會返回該資訊。
預設值:0

Schema: GetInventoryListResponse.xsd

示例: XML, Response

<NeweggAPIResponse
  xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
  xmlns:xsd=http://www.w3.org/2001/XMLSchema>
  <IsSuccess>true</IsSuccess>
  <OperationType>GetInventoryList</OperationType>
  <SellerID>A006</SellerID>
  <ResponseDate>2022-04-20T23:46:41.7786361-07:00</ResponseDate>
  <ResponseBody>
    <ItemList>
      <InventoryResult>
        <ItemNumber>9SIA00603V5190</ItemNumber>
        <SellerPartNumber>A006-TestItem-001</SellerPartNumber>
        <Condition>1</Condition>
        <InventoryAllocation>
          <Inventory>
            <WarehouseLocation>USA</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>10</AvailableQuantity>
          </Inventory>
          <Inventory>
            <WarehouseLocation>AUS</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>0</AvailableQuantity>
          </Inventory>
        </InventoryAllocation>
      </InventoryResult>
      <InventoryResult>
        <ItemNumber>9SIA00603V5191</ItemNumber>
        <SellerPartNumber>A006-TestItem-002</SellerPartNumber>
        <Condition>1</Condition>
        <InventoryAllocation>
          <Inventory>
            <WarehouseLocation>USA</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>5</AvailableQuantity>
          </Inventory>
          <Inventory>
            <WarehouseLocation>AUS</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>10</AvailableQuantity>
          </Inventory>
        </InventoryAllocation>
      </InventoryResult>
      <InventoryResult>
        <ItemNumber>9SIA00603V5192</ItemNumber>
        <SellerPartNumber>A006-TestItem-003</SellerPartNumber>
        <Condition>1</Condition>
        <InventoryAllocation>
          <Inventory>
            <WarehouseLocation>AUS</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>15</AvailableQuantity>
          </Inventory>
          <Inventory>
            <WarehouseLocation>KOR</WarehouseLocation>
            <FulfillmentOption>0</FulfillmentOption>
            <AvailableQuantity>20</AvailableQuantity>
          </Inventory>
        </InventoryAllocation>
      </InventoryResult>
    </ItemList>
    <TotalCount>3</TotalCount>
  </ResponseBody>
</NeweggAPIResponse>

示例: Json, Response

{
  "ResponseBody": {
    "ItemList": [
      {
        "ItemNumber": "9SIA00603V5190",
        "SellerPartNumber": "A006-TestItem-001",
        "Condition": 1,
        "InventoryAllocation": [
          {
            "WarehouseLocation": "USA",
            "FulfillmentOption": "0",
            "AvailableQuantity": 10
          },
          {
            "WarehouseLocation": "AUS",
            "FulfillmentOption": "0",
            "AvailableQuantity": 0
          }
        ]
      },
      {
        "ItemNumber": "9SIA00603V5191",
        "SellerPartNumber": "A006-TestItem-002",
        "Condition": 1,
        "InventoryAllocation": [
          {
            "WarehouseLocation": "USA",
            "FulfillmentOption": "0",
            "AvailableQuantity": 5
          },
          {
            "WarehouseLocation": "AUS",
            "FulfillmentOption": "0",
            "AvailableQuantity": 10
          }
        ]
      },
      {
        "ItemNumber": "9SIA00603V5192",
        "SellerPartNumber": "A006-TestItem-003",
        "Condition": 1,
        "InventoryAllocation": [
          {
            "WarehouseLocation": "USA",
            "FulfillmentOption": "0",
            "AvailableQuantity": 15
          },
          {
            "WarehouseLocation": "AUS",
            "FulfillmentOption": "0",
            "AvailableQuantity": 20
          }
        ]
      }
    ],
    "TotalCount": 3
  },
  "IsSuccess": true,
  "OperationType": "GetInventoryList",
  "SellerID": "A006",
  "ResponseDate": "2022-04-20T23:46:41.7786361-07:00"
}

請求失敗錯誤資訊

常規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"
    }
]

更新日期: 03/09/2022