---
title: "InventoryItem"
description: "代表可运送给客户的货物。它保存有关商品的基本信息，包括 SKU 以及是否被跟踪"
doc_type: graphql
doc_category: adminGraphQL
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item.md'
---
# InventoryItem

代表可运送给客户的货物。它保存有关商品的基本信息，包括 SKU 以及是否被跟踪

- **API Version:** v20270301
- **API Type:** Admin
- **API Protocol:** GraphQL
- **Operation Type:** Object

## Type Signature

`InventoryItem`

## Fields

* `countryCodeOfOrigin`

  [CountryCode](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common-objects/enums/country-code.md)

  根据 ISO 3166-1 alpha-2 标准表示的产品来源国/地区编码

* `createdAt`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/date.md)

  创建库存项目的日期和时间

* `harmonizedSystemCode`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  商品的统一系统代码

* `id`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  库存项目的ID

* `inventoryLevel`

  [InventoryLevel](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-level.md)

  指定地点的库存商品数量

* `inventoryLevels`

  [InventoryLevelConnection](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-level-connection.md)

  每个位置可存放库存数量的列表

* `requiredShipping`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  指示库存项目是否需要运输

* `sku`

  [String](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/string.md)

  该库存项目的 SKU 标识码，区分大小写的字符串

* `tracked`

  [Boolean](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/boolean.md)

  是否启用对该商品库存的跟踪

* `updatedAt`

  [Date](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/date.md)

  该库存项目上次修改的日期及时间

* `variantId`

  [ID](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/common/scalars/id.md)

  拥有此库存项目的变体ID

## Schema Definition

```graphql
type InventoryItem { 
	countryCodeOfOrigin: CountryCode
	createdAt: Date
	harmonizedSystemCode: String
	id: ID
	inventoryLevel(locationId,ID!): InventoryLevel
	inventoryLevels(first,Int,last,Int,before,String,after,String,reverse,Boolean): InventoryLevelConnection
	requiredShipping: Boolean
	sku: String
	tracked: Boolean
	updatedAt: Date
	variantId: ID 
}
```

## Field from

* [InventoryItemConnection](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item-connection.md).nodes

  InventoryItemEdge 中包含的节点列表

* [InventoryItemEdge](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item-edge.md).node

  InventoryItem 的节点

* [InventoryItemUpdatePayload](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-item-update-payload.md).inventoryItem

  已更新的库存对象。

* [InventoryLevel](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-level.md).item

  与库存水平相关的库存对象

* [ProductVariant](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/products-and-collections/objects/product-variant.md).inventoryItem

  产品库存项目，用于查询库存信息

* [Query](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/queries/inventory-item.md).inventoryItem

  按ID返回库存对象

* [InventoryBulkToggleActivationPayload](https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-bulk-toggle-activation-payload.md).inventoryItem

  已更新的库存对象。

## Error Handling

关于更多通用错误码说明，参考：[状态码和错误码](https://developer.shopline.com/zh-hans-cn/docs/apps/api-instructions-for-use/graph-ql-admin-api/overview.md#status-and-error-codes)。