← All types
Ob Object

JobMaterialReservationState

Material demand for a job — tracks required vs reserved warehouse stock

Fields

Unique identifier

jobId

JobID!Non-null

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)
CLICK

A billing counter rather than a physical measure: one metered page charged under a cost-per-click press or copier contract.

CM

Centimetres — metric length, a hundredth of a metre.

FT

Feet — imperial length, twelve inches.

G

Grams — metric mass, for light items stocked by weight.

IMPRESSION

A 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.

IN

Inches — imperial length, the unit paper sizes are quoted in outside metric markets.

KG

Kilograms — metric mass, the usual unit for reel and other bulk substrate stock.

LB

Pounds — imperial mass, roughly 0.45 kg.

M

Metres — metric length, the usual unit for material bought by the running metre such as a reel or a roll of laminate.

MM

Millimetres — metric length, a thousandth of a metre, and the granularity trim sizes and other sheet dimensions are normally given in.

OZ

Ounces — imperial mass, a sixteenth of a pound.

PC

Pieces: a plain count of discrete items, carrying no dimension at all. The unit stock and transfer quantities fall back to when none is given.

PT

Points — the typographic length unit of one seventy-second of an inch, used for type sizes and rule weights rather than for stock quantities.

REPEAT

One 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.

SHEET

A 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

notes

StringNullable

Internal notes

Reservation lifecycle status

Possible values (5)
PENDING

Demand recorded, no stock reserved yet

RESERVED

Fully reserved from warehouse stock

PARTIALLY_RESERVED

Partially fulfilled — some stock reserved

CONSUMED

Stock has been pulled for production

CANCELLED

Reservation 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!
}