库存物品
库存物品表示可用于运送给客户的实物。它包含有关实物的重要信息,包括其SKU以及是否跟踪其库存。
产品变体与库存项目之间存在1:1的关系。每个产品变型都包括其相关库存项目的ID。您可以使用库存项目ID来查询InventoryLevel资源以检索库存信息。
结合使用InventoryItem资源,InventoryLevel和Location资源来管理多个位置的商店库存。
您可以使用InventoryItem做什么
Shopify API使您可以使用InventoryItem资源执行以下操作。这些常规操作的更详细的版本可能可用:
- GET /admin/api/2021-01/inventory_items.json?ids=808950810,39072856,457924702检索库存项目列表
- GET /admin/api/2021-01/inventory_items/{inventory_item_id}.json通过ID检索单个库存物料
- PUT /admin/api/2021-01/inventory_items/{inventory_item_id}.json更新现有库存项目
InventoryItem属性
成本 | plain "cost": "25.00" 库存物料的单位成本。 |
---|---|
country_code_of_origin | plain "country_code_of_origin": "FR" 库存物料所在国家/地区的两位数代码。 |
country_harmonized_system_codes | plain "country_harmonized_system_codes": [ { "harmonized_system_code": "1234561111", "country_code": "CA" }, { "harmonized_system_code": "1234562222", "country_code": "US" } ] 该项目的一组特定于国家/地区的协调系统(HS)代码。用于确定将库存物品运送到某些国家/地区时的关税。 |
created_at 只读 | plain "created_at": "2012-08-24T14:01:47-04:00" 创建库存物料 的日期和时间(ISO 8601格式)。 |
harmonized_system_code | plain "harmonized_system_code": 123456 库存物料 的通用协调系统(HS)代码。如果特定国家/地区的HS代码不可用,则使用此代码。 |
ID 只读 | plain "id": 450789469 库存物料的ID。 |
province_code_of_origin | plain "province_code_of_origin": "QC" 产生库存物料的省的两位数字代码。仅在库存商品的运输提供商为加拿大邮政时使用。 |
ku | plain "sku": "IPOD2008PINK" 库存物料的唯一SKU(库存单位)。 |
已追踪 | plain "tracked": true 是否跟踪库存项目。如果为true,则Shopify会跟踪库存数量更改。 |
Updated_at 只读 | plain "updated_at": "2012-08-24T14:01:47-04:00" 上次修改库存项目 的日期和时间(ISO 8601格式)。 |
require_shipping | plain "requires_shipping": true 下订单包含库存商品时,客户是否需要提供送货地址。 |
终点
得到/admin/api/2021-01/inventory_items.json?ids=808950810,39072856,457924702 检索库存项目列表。注意:从2019-10版本开始,此端点通过使用响应标头中提供的链接来实现分页。发送<font style="background-color:#F4F6F8;">page</font>
参数将返回错误。要了解更多信息,请参阅向分页的REST Admin API端点发出请求。
编号 必需的 | 仅显示用逗号分隔的ID列表指定的清单项目。 (最大: 100 ) |
---|---|
限制 | 要显示的最大结果数。 (默认值: 50 最大: 250 ) |
检索库存清单
GET /admin/api/2021-01/inventory_items.json?ids=808950810,39072856,457924702
得到/admin/api/2021-01/inventory_items/{inventory_item_id}.json 通过ID检索单个库存物料通过ID检索库存物料
GET /admin/api/2021-01/inventory_items/808950810.json
放/admin/api/2021-01/inventory_items/{inventory_item_id}.json 更新现有库存项目更新库存商品的单位成本
PUT /admin/api/2021-01/inventory_items/808950810.json
{
“ inventory_item” : {
“ id” :808950810,
“费用” :“ 25.00”
}
}
更新库存商品的SKU
PUT /admin/api/2021-01/inventory_items/808950810.json
{
“ inventory_item” : {
“ id” :808950810,
“ sku” :“新sku”
}
}