← All types
Ob Object

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_PRODUCT

Durable operation output identity. Actual stock receipts remain gated pending the material receipt service.

SUBSTRATE

Substrate / paper / media.

COMPONENT

A component used in production.

FINISHED_GOODS

Finished goods.

TOOL

Tooling.

INK

Ink.

CONSUMABLE

Generic consumable.

Catalogue or OperationProduct identifier of allocated input

quantity

Float!Non-null

Total allocated quantity; finite and positive, measured in unit

Shared unit for allocated, consumed, released and remaining quantities; no implicit conversion

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

Target operation, if allocation is for work; no synthetic item is required

Optional target partition belonging to operationId

jobId

JobIDNullable

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