JobMaterialReservationState
Material demand for a job — tracks required vs reserved warehouse stock
Fields
Unique identifier
Job this reservation belongs to
The material being reserved, resolved from (stockableType, stockableId) to the concrete catalog entity by the active vertical; falls back to a StockableMarker when the vertical cannot resolve it.
Total quantity needed
Outstanding stock commitment, excluding consumed and released quantities. Includes any pre-existing unattributed claims.
Cumulative final consumption through attributed MaterialLots; zero for pre-existing reservations until attributed use
requiredQuantity minus reservedQuantity minus consumedQuantity; release reopens this demand
Concrete holding allocations in stable ID order; requires warehouseStock:read. Use their IDs and counters for consumeMaterialLot, releaseMaterialLot or allocated issues. Pre-existing unattributed commitments have no invented lots.
Unit of measure
Possible values (15)
CLICKA billing counter rather than a physical measure: one metered page charged under a cost-per-click press or copier contract.
CMCentimetres — metric length, a hundredth of a metre.
FTFeet — imperial length, twelve inches.
GGrams — metric mass, for light items stocked by weight.
IMPRESSIONA production counter rather than a physical measure: one pass of one sheet through a press. Distinct from SHEET, since a sheet printed on both sides can cost two impressions.
INInches — imperial length, the unit paper sizes are quoted in outside metric markets.
KGKilograms — metric mass, the usual unit for reel and other bulk substrate stock.
LBPounds — imperial mass, roughly 0.45 kg.
MMetres — metric length, the usual unit for material bought by the running metre such as a reel or a roll of laminate.
MMMillimetres — metric length, a thousandth of a metre, and the granularity trim sizes and other sheet dimensions are normally given in.
OZOunces — imperial mass, a sixteenth of a pound.
PCPieces: a plain count of discrete items, carrying no dimension at all. The unit stock and transfer quantities fall back to when none is given.
PTPoints — the typographic length unit of one seventy-second of an inch, used for type sizes and rule weights rather than for stock quantities.
REPEATOne printed repeat of a web: a cut-off in web offset, a repeat in flexo and labels. What a roll press counts when it produces signatures.
SHEETA count of substrate sheets, the usual unit for sheet-fed stock. Counts the physical sheets held or moved, not the press passes over them (see IMPRESSION).
Preferred warehouse location for picking
Internal notes
Reservation lifecycle status
Possible values (5)
PENDINGDemand recorded, no stock reserved yet
RESERVEDFully reserved from warehouse stock
PARTIALLY_RESERVEDPartially fulfilled — some stock reserved
CONSUMEDStock has been pulled for production
CANCELLEDReservation cancelled
Creation timestamp (ISO8601)
Last update timestamp (ISO8601)
Referenced by (4)
Exact type SDL
"""
Material demand for a job — tracks required vs reserved warehouse stock
"""
type JobMaterialReservationState {
"""Unique identifier"""
id: JobMaterialReservationID!
"""Job this reservation belongs to"""
jobId: JobID!
"""
The material being reserved, resolved from (stockableType, stockableId) to the concrete catalog entity by the active vertical; falls back to a StockableMarker when the vertical cannot resolve it.
"""
stockable: Stockable!
"""Total quantity needed"""
requiredQuantity: Float!
"""
Outstanding stock commitment, excluding consumed and released quantities. Includes any pre-existing unattributed claims.
"""
reservedQuantity: Float!
"""
Cumulative final consumption through attributed MaterialLots; zero for pre-existing reservations until attributed use
"""
consumedQuantity: Float!
"""
requiredQuantity minus reservedQuantity minus consumedQuantity; release reopens this demand
"""
availableToReserve: Float!
"""
Concrete holding allocations in stable ID order; requires warehouseStock:read. Use their IDs and counters for consumeMaterialLot, releaseMaterialLot or allocated issues. Pre-existing unattributed commitments have no invented lots.
"""
materialLots: [MaterialLot!]!
"""Unit of measure"""
unit: MeasurementUnit!
"""Preferred warehouse location for picking"""
preferredLocationId: WarehouseLocationID
"""Internal notes"""
notes: String
"""Reservation lifecycle status"""
status: MaterialReservationStatus!
"""Creation timestamp (ISO8601)"""
createdAt: String!
"""Last update timestamp (ISO8601)"""
updatedAt: String!
}