批量追蹤商品庫存
批量追蹤商品預設發貨倉庫的有效庫存資訊。
相關URL
該操作只適用於Neweggbusiness.com和Newegg.ca平台。
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventorylist?sellerid={SellerID}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/inventorylist?sellerid={SellerID}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventorylist?sellerid={SellerID}
Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/inventorylist?sellerid={SellerID}
Neweggbusiness.com: https://api.newegg.com/marketplace/b2b/contentmgmt/item/inventorylist?sellerid={SellerID} Newegg.ca: https://api.newegg.com/marketplace/can/contentmgmt/item/inventorylist?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編號) 如果不填,預設值為Seller Part# |
Value | 是 | String Array | 多個指定值的字串,最大長度為100 |
Schema: GetItemInventoryListRequest.xsd
示例:XML, Request
POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/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>
</ContentQueryCriteria>
POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/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>
</ContentQueryCriteria>
POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/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> </ContentQueryCriteria>
示例:Json, Request
POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/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"]
}
POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/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"]
}
POST https://api.newegg.com/marketplace/b2b/contentmgmt/item/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"] }
回覆文件主體
屬性 | 格式 | 描述 |
SellerID | String | 您的商家編碼 |
TotalCount | Integer | 庫存數量盤點 |
SellerPartNumber | String | Seller part#,賣家自訂的商品唯一識別碼 |
ItemNumber | String | 以9SI開頭的新蛋商品編號 |
FulfillmentOption | String | 有效值: 0: 商家配送 1: 新蛋配送 |
AvailableQuantity | Integer | 可用庫存總數 |
Active | Integer | 啟動狀態 0: 未啟動狀態 1: 已啟動狀態 |
WarehouseCode | String | 表明庫存在新蛋哪個倉庫中 有效值: 適用於Neweggbusiness.com的有效值:
適用於Newegg.ca的有效值:
註:只有當產品為新蛋配送時才會返回該資訊 |
Quantity | Integer | 該新蛋倉庫當前的有效庫存數量 註:只有當商品目前存放在新蛋倉庫時才會返回該資訊。 預設值:0 |
Schema: GetItemInventoryListResponse.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>
<FulfillmentOption>0</FulfillmentOption>
<Active>1</Active>
<AvailableQuantity>10</AvailableQuantity>
</InventoryResult>
<InventoryResult>
<ItemNumber>9SIA00603V5191</ItemNumber>
<SellerPartNumber>A006-TestItem-002</SellerPartNumber>
<FulfillmentOption>1</FulfillmentOption>
<Active>1</Active>
<AvailableQuantity>15</AvailableQuantity>
<WarehouseAllocation>
<Warehouse>
<WarehouseCode>07</WarehouseCode>
<Quantity>12</Quantity>
</Warehouse>
<Warehouse>
<WarehouseCode>08</WarehouseCode>
<Quantity>3</Quantity>
</Warehouse>
</WarehouseAllocation>
</InventoryResult>
<InventoryResult>
<ItemNumber>9SIA00603V5192</ItemNumber>
<SellerPartNumber>A006-TestItem-003</SellerPartNumber>
<FulfillmentOption>0</FulfillmentOption>
<Active>1</Active>
<AvailableQuantity>8</AvailableQuantity>
</InventoryResult>
</ItemList>
<TotalCount>3</TotalCount>
</ResponseBody>
</NeweggAPIResponse>
<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>
<FulfillmentOption>0</FulfillmentOption>
<Active>1</Active>
<AvailableQuantity>10</AvailableQuantity>
</InventoryResult>
<InventoryResult>
<ItemNumber>9SIA00603V5191</ItemNumber>
<SellerPartNumber>A006-TestItem-002</SellerPartNumber>
<FulfillmentOption>1</FulfillmentOption>
<Active>1</Active>
<AvailableQuantity>15</AvailableQuantity>
<WarehouseAllocation>
<Warehouse>
<WarehouseCode>07</WarehouseCode>
<Quantity>12</Quantity>
</Warehouse>
<Warehouse>
<WarehouseCode>08</WarehouseCode>
<Quantity>3</Quantity>
</Warehouse>
</WarehouseAllocation>
</InventoryResult>
<InventoryResult>
<ItemNumber>9SIA00603V5192</ItemNumber>
<SellerPartNumber>A006-TestItem-003</SellerPartNumber>
<FulfillmentOption>0</FulfillmentOption>
<Active>1</Active>
<AvailableQuantity>8</AvailableQuantity>
</InventoryResult>
</ItemList>
<TotalCount>3</TotalCount>
</ResponseBody>
</NeweggAPIResponse>
<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> <FulfillmentOption>0</FulfillmentOption> <Active>1</Active> <AvailableQuantity>10</AvailableQuantity> </InventoryResult> <InventoryResult> <ItemNumber>9SIA00603V5191</ItemNumber> <SellerPartNumber>A006-TestItem-002</SellerPartNumber> <FulfillmentOption>1</FulfillmentOption> <Active>1</Active> <AvailableQuantity>15</AvailableQuantity> <WarehouseAllocation> <Warehouse> <WarehouseCode>07</WarehouseCode> <Quantity>12</Quantity> </Warehouse> <Warehouse> <WarehouseCode>08</WarehouseCode> <Quantity>3</Quantity> </Warehouse> </WarehouseAllocation> </InventoryResult> <InventoryResult> <ItemNumber>9SIA00603V5192</ItemNumber> <SellerPartNumber>A006-TestItem-003</SellerPartNumber> <FulfillmentOption>0</FulfillmentOption> <Active>1</Active> <AvailableQuantity>8</AvailableQuantity> </InventoryResult> </ItemList> <TotalCount>3</TotalCount> </ResponseBody> </NeweggAPIResponse>
示例: Json, Response
{
"ResponseBody": {
"ItemList": [
{
"ItemNumber": "9SIA00603V5190",
"SellerPartNumber": "A006-TestItem-001",
"FulfillmentOption": "0",
"Active": "1",
"AvailableQuantity": 10
},
{
"ItemNumber": "9SIA00603V5191",
"SellerPartNumber": "A006-TestItem-002",
"FulfillmentOption": "1",
"Active": "1",
"AvailableQuantity": 15,
"WarehouseAllocation": [
{
"WarehouseCode": "07",
"Quantity": 12
},
{
"WarehouseCode": "08",
"Quantity": 3
}
]
},
{
"ItemNumber": "9SIA00603V5192",
"SellerPartNumber": "A006-TestItem-003",
"FulfillmentOption": "0",
"Active": "1",
"AvailableQuantity": 8
}
],
"TotalCount": 3
},
"IsSuccess": true,
"OperationType": "GetInventoryList",
"SellerID": "A006",
"ResponseDate": "2022-04-20T23:46:41.7786361-07:00"
}
{
"ResponseBody": {
"ItemList": [
{
"ItemNumber": "9SIA00603V5190",
"SellerPartNumber": "A006-TestItem-001",
"FulfillmentOption": "0",
"Active": "1",
"AvailableQuantity": 10
},
{
"ItemNumber": "9SIA00603V5191",
"SellerPartNumber": "A006-TestItem-002",
"FulfillmentOption": "1",
"Active": "1",
"AvailableQuantity": 15,
"WarehouseAllocation": [
{
"WarehouseCode": "07",
"Quantity": 12
},
{
"WarehouseCode": "08",
"Quantity": 3
}
]
},
{
"ItemNumber": "9SIA00603V5192",
"SellerPartNumber": "A006-TestItem-003",
"FulfillmentOption": "0",
"Active": "1",
"AvailableQuantity": 8
}
],
"TotalCount": 3
},
"IsSuccess": true,
"OperationType": "GetInventoryList",
"SellerID": "A006",
"ResponseDate": "2022-04-20T23:46:41.7786361-07:00"
}
{ "ResponseBody": { "ItemList": [ { "ItemNumber": "9SIA00603V5190", "SellerPartNumber": "A006-TestItem-001", "FulfillmentOption": "0", "Active": "1", "AvailableQuantity": 10 }, { "ItemNumber": "9SIA00603V5191", "SellerPartNumber": "A006-TestItem-002", "FulfillmentOption": "1", "Active": "1", "AvailableQuantity": 15, "WarehouseAllocation": [ { "WarehouseCode": "07", "Quantity": 12 }, { "WarehouseCode": "08", "Quantity": 3 } ] }, { "ItemNumber": "9SIA00603V5192", "SellerPartNumber": "A006-TestItem-003", "FulfillmentOption": "0", "Active": "1", "AvailableQuantity": 8 } ], "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>
<?xml version="1.0" encoding="utf-8"?>
<Errors>
<Error>
<Code>CT002</Code>
<Message>Invalid SellerPartNumber</Message>
</Error>
</Errors>
<?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"
}
]
[
{
"Code": "CT002",
"Message": "Invalid SellerPartNumber"
}
]
[ { "Code": "CT002", "Message": "Invalid SellerPartNumber" } ]
更新日期:03/09/2022