← All types
ProductionIn Input object

IssueStockItemInput

A single draw-down of warehouse stock for production.

Fields

Concrete allocation to consume. Null uses unreserved free stock with historical non-idempotent behavior, and is rejected when the requested job already has allocation history on this holding. Anonymous free issues cannot be correlated with earlier consumption and must not be retried as allocated issues. Allocation issues share authority with consumeMaterialLot.

Exact source unit; mandatory for allocated issues. Legacy free issues may omit it and use the holding unit. No conversion is performed.

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

Allocation cumulative consumed counter read before this issue; required with materialLotId. An exact resulting counter pair is a no-op retry.

Allocation cumulative released counter read before this issue; required with materialLotId. Any other stale counter pair rejects the entire request.

TypeID ("wst_01K…") of the warehouse stock record to draw from. Must exist in the tenant.

quantity

Float!Required

Amount to issue, in the stock record's unit. Must be greater than zero and must not exceed the allocation remainder, or free quantity (on-hand minus reserved) for unallocated issues; it is deducted from the on-hand quantity.

jobId

JobIDOptional

Optional target job. For allocated issues it must match the lot's job and the transfer references that MaterialLot. Free issues reference this job directly; null leaves a free issue without a job reference.

notes

StringOptional

Note recorded on the resulting transfer explaining the issue. Null when there is none.

Referenced by (1)
Exact type SDL
"""A single draw-down of warehouse stock for production."""
input IssueStockItemInput {
  """
  Concrete allocation to consume. Null uses unreserved free stock with historical non-idempotent behavior, and is rejected when the requested job already has allocation history on this holding. Anonymous free issues cannot be correlated with earlier consumption and must not be retried as allocated issues. Allocation issues share authority with consumeMaterialLot.
  """
  materialLotId: MaterialLotID
  """
  Exact source unit; mandatory for allocated issues. Legacy free issues may omit it and use the holding unit. No conversion is performed.
  """
  unit: MeasurementUnit
  """
  Allocation cumulative consumed counter read before this issue; required with materialLotId. An exact resulting counter pair is a no-op retry.
  """
  expectedConsumedQuantity: Float
  """
  Allocation cumulative released counter read before this issue; required with materialLotId. Any other stale counter pair rejects the entire request.
  """
  expectedReleasedQuantity: Float
  """
  TypeID ("wst_01K…") of the warehouse stock record to draw from. Must exist in the tenant.
  """
  warehouseStockId: WarehouseStockID!
  """
  Amount to issue, in the stock record's unit. Must be greater than zero and must not exceed the allocation remainder, or free quantity (on-hand minus reserved) for unallocated issues; it is deducted from the on-hand quantity.
  """
  quantity: Float!
  """
  Optional target job. For allocated issues it must match the lot's job and the transfer references that MaterialLot. Free issues reference this job directly; null leaves a free issue without a job reference.
  """
  jobId: JobID
  """
  Note recorded on the resulting transfer explaining the issue. Null when there is none.
  """
  notes: String
}