MaterialLot
Allocated input and partial-use contract. WarehouseStock owns balances; a resolved lot attributes one reservation's claim to one holding. Unresolved lots claim no stock.
Fields
Stable allocation identifier
Kind of allocated input material
Possible values (7)
OPERATION_PRODUCTDurable operation output identity. Actual stock receipts remain gated pending the material receipt service.
SUBSTRATESubstrate / paper / media.
COMPONENTA component used in production.
FINISHED_GOODSFinished goods.
TOOLTooling.
INKInk.
CONSUMABLEGeneric consumable.
Catalogue or OperationProduct identifier of allocated input
Total allocated quantity; finite and positive, measured in unit
Shared unit for allocated, consumed, released and remaining quantities; no implicit conversion
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).
Target operation, if allocation is for work; no synthetic item is required
Optional target partition belonging to operationId
Target job, or validated parent context for operation/component; not source ownership
Target component within jobId, when specified
Exact source holding committed by reserveJobMaterials; null for unresolved input requirements
Existing reservation summary for this concrete holding allocation; no second commitment is counted
Cumulative final use, already deducted from holding on-hand and reserved quantities
Cumulative released commitment; decreases holding and header reserved quantities without changing on-hand. Reopens demand for a later reserve action.
quantity minus consumedQuantity minus releasedQuantity, counted once
When the allocation was defined
The material catalogue entity or durable operation output this row references, resolved from the row's stockable type and id. Members of the Stockable union are provided by core for OperationProduct and by the active vertical for catalog entities; OperationProduct resolves without a vertical. 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.
Referenced by (3)
Exact type SDL
"""
Allocated input and partial-use contract. WarehouseStock owns balances; a resolved lot attributes one reservation's claim to one holding. Unresolved lots claim no stock.
"""
type MaterialLot {
"""Stable allocation identifier"""
id: MaterialLotID!
"""Kind of allocated input material"""
stockableType: StockableType!
"""Catalogue or OperationProduct identifier of allocated input"""
stockableId: String!
"""Total allocated quantity; finite and positive, measured in unit"""
quantity: Float!
"""
Shared unit for allocated, consumed, released and remaining quantities; no implicit conversion
"""
unit: MeasurementUnit!
"""
Target operation, if allocation is for work; no synthetic item is required
"""
operationId: OperationID
"""Optional target partition belonging to operationId"""
operationItemId: OperationItemID
"""
Target job, or validated parent context for operation/component; not source ownership
"""
jobId: JobID
"""Target component within jobId, when specified"""
componentId: ComponentID
"""
Exact source holding committed by reserveJobMaterials; null for unresolved input requirements
"""
warehouseStockId: WarehouseStockID
"""
Existing reservation summary for this concrete holding allocation; no second commitment is counted
"""
reservationId: JobMaterialReservationID
"""
Cumulative final use, already deducted from holding on-hand and reserved quantities
"""
consumedQuantity: Float!
"""
Cumulative released commitment; decreases holding and header reserved quantities without changing on-hand. Reopens demand for a later reserve action.
"""
releasedQuantity: Float!
"""quantity minus consumedQuantity minus releasedQuantity, counted once"""
remainingQuantity: Float!
"""When the allocation was defined"""
createdAt: ISO8601!
"""
The material catalogue entity or durable operation output this row references, resolved from the row's stockable type and id. Members of the `Stockable` union are provided by core for OperationProduct and by the active vertical for catalog entities; OperationProduct resolves without a vertical. 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.
"""
stockable: Stockable!
}