Appearance
WarehouseStockState
Type: Object
A warehouse stock record tracking inventory at a location
Fields
| Name | Type | Args | Description | Deprecated |
|---|---|---|---|---|
| availableQuantity | Float! | Quantity free to reserve or issue: quantity minus reservedQuantity. Derived, not stored. | ||
| batchNumber | String | Supplier or production batch this stock belongs to. Null when the stock is not batch-tracked. | ||
| createdAt | String! | ISO8601 timestamp the stock record was created. | ||
| expiryDate | ISO8601 | ISO8601 date after which this stock should not be consumed. Null when the item does not expire. Advisory — nothing blocks issuing expired stock. | ||
| id | WarehouseStockID! | The stock record's id, as a TypeID (e.g. "wst_01K…"). | ||
| lastCountedAt | ISO8601 | ISO8601 timestamp of the last physical stock count that set quantity. Null if the record has never been counted, only transacted. | ||
| locationId | WarehouseLocationID! | Warehouse location holding this stock, as a TypeID (e.g. "wlc_01K…"). A stockable item held in two locations is two records, not one. | ||
| notes | String | Free-text operator notes on this stock record. | ||
| quantity | Float! | Total quantity on hand at this location, in unit. Never negative. Includes stock that is reserved but not yet issued. | ||
| reservedQuantity | Float! | Quantity committed to jobs but not yet issued. Never negative, and never more than quantity — reserved stock is still physically on hand. | ||
| stockable | Stockable! | The catalog entity this row stocks, moves, reserves or consumes, resolved from the row's stockable type and id. Members of the Stockable union are contributed by the active vertical (PrintVertical contributes SubstrateState); with no vertical loaded the union holds only the platform fallback. Rows the vertical cannot resolve — an unmodelled kind such as ink or tooling, or a partner-supplied id with no local record — surface as a StockableMarker carrying the original type, id, external id and label. Never null. | ||
| unit | MeasurementUnit! | Unit quantity is measured in. Defaults to PC (pieces). | ||
| updatedAt | String! | ISO8601 timestamp the stock record was last modified. |