---
title: "InventoryQuantity"
description: "表示特定位置、特定名称的库存项目的数量"
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-quantity'
  md: 'https://developer.shopline.com/zh-hans-cn/docs/admin-graph-ql-api/inventory/objects/inventory-quantity.md'
---
# InventoryQuantity

表示特定位置、特定名称的库存项目的数量

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

## Type Signature

`InventoryQuantity`

## Fields

* `name`

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

  标识库存数量的名称
  | 库存状态 | 描述 |
  | --- | --- |
  | available | 可售库存，代表商家可以销售的数量，这部分数量尚未安排给任何的订单或者转移 |
  | on_hand | 现货库存，表示商家地点中真实拥有的库存数量。`on_hand` 的数量等于 `available`，`committed`，`unavailable` 这几类的总和 |
  | committed | 承诺库存，表示已经安排但是尚未发货的订单使用的数量，草稿单消耗的库存数量不会计算在内 |
  | unavailable | 不可用库存，代表临时为草稿单或某些应用预留的数量，商家的地点中真实存在这部分数量但是暂时不用于销售 |
  

* `quantity`

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

  指定名称对应的库存数量

* `updatedAt`

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

  最后一次数量更新的日期和时间

## Schema Definition

```graphql
type InventoryQuantity { 
	name: String
	quantity: Int
	updatedAt: Date 
}
```

## Field from

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

  所查询的名称对应的库存数量

## 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)。