ProductionReportState

Type: Object

Production observation. May be partner-sourced, manual, or system-generated; binding refs are optional.

Fields

Name	Type	Args	Description	Deprecated
actualPrintingDurationSeconds	Float		Engaged production time in seconds — machine actually running. Distinct from the endedAt - startedAt wall clock, which can include pauses.
areaPrinted	Area		Total area printed.
averageSpeed	Speed		Mean production rate over the run, as a value plus its speed unit. Null when the source reported no speed.
bindingMethod	ProductionReportBindingMethod		How the binding refs were established (ingested / manual / auto). Null while the report is still unbound.
boundAt	ISO8601		When the report was bound to canonical entities (ISO8601).
capabilityCode	CapabilityCode		The kind of operation this report describes (e.g. printing, cutting). Determines which operationData paths are meaningful. Optional — partner reports may omit it, and it can be inferred from the bound operation later.
componentId	ComponentID		Binding ref: TypeID of the Component this report was produced for (cmp_…). Null until the report is bound.
consumption	[ProductionReportConsumptionState!]!		Consumption rows attached to this report (ink, substrate, …). Requires productionReport:read.
countUnit	MetricUnit		Unit that goodCount and totalPlanned are counted in (e.g. sheets, metres). CUSTOM means the real unit name is in customCountUnit.
createdAt	String!		When the report row was written (ISO8601). This is ingestion time, not production time — use startedAt for when the run actually happened.
customCountUnit	String		Vertical-specific count unit name, meaningful only when countUnit is CUSTOM. Null otherwise.
endedAt	ISO8601		When the reported run finished (ISO8601). Null for a run that is still open or for a source that reported no timing.
errorCode	String		Machine- or partner-defined error code raised during the run. Null for a run that reported no error.
errorMessage	String		Human-readable description of the error named by errorCode. Null when no error occurred.
errorSeverity	ProgressErrorSeverity		How serious the reported error was. Null when no error occurred.
externalRefs	[ExternalRef!]		Binding-grade external references from the source system, used by the binding mutation to resolve this report against canonical entities. Null when the source supplied none.
goodCount	Float		Saleable output produced by this run, expressed in countUnit. Waste is deliberately not broken out separately for partner-sourced data.
groupingKeys	[Dictionary!]!		Partner-internal grouping keys as a JSON object (key → value strings).
id	ProductionReportID!		TypeID of the production report (prr_…). Stable for the lifetime of the row.
integrationInstanceId	IntegrationInstanceID		Source integration that produced the report.
isUnbound	Boolean!		True iff no binding refs are set.
jobId	JobID		Binding ref: TypeID of the Job this report was produced for (job_…). Null until the report is bound; only the binding mutation may set it.
lengthPrinted	Length		Length of the print run, with unit provenance preserved.
metadata	JSON		Freeform integration metadata. Native JSON — numbers stay numbers, nested structures preserved verbatim.
name	String		Display name.
operationData	JSON		Capability-keyed flat path map. Native JSON object with JSON-Pointer-style keys; numeric values are emitted as JSON numbers.
operationId	OperationID		Binding ref: TypeID of the Operation the report describes (opr_…). Null until the report is bound.
operationItemId	OperationItemID		Binding ref: TypeID of the OperationItem the report describes (opi_…). Null until the report is bound.
operatorIdentifier	String		Free-form operator identifier from the source system, when no user maps to it.
printColorPolicy	String		Color matching policy. Read from operationData["/colorPolicy"].
printDirection	String		Bidirectional/unidirectional. Read from operationData["/direction"].
printDpiHorizontal	Int		Horizontal print resolution (DPI). Read from operationData["/dpi/horizontal"].
printDpiVertical	Int		Vertical print resolution (DPI). Read from operationData["/dpi/vertical"].
printMode	String		Print mode (vendor-specific string). Read from operationData["/mode"].
printPasses	Int		Number of print passes. Read from operationData["/passes"].
printSaveInkMethod	String		Ink-save method. Read from operationData["/saveInkMethod"].
printSpeedMode	String		Speed mode (vendor-specific string). Read from operationData["/speedMode"].
runKind	RunKind		Whether this report describes real production output or a non-production run (setup, proof, calibration, test). Null means unspecified — treated as PRODUCTION by downstream filters.
startedAt	ISO8601		When the reported run began (ISO8601). Null when the source system reported counts without timing.
substrateId	SubstrateID		FK to the typed Substrate catalog entry, when one was matched.
substrateLength	Length		Substrate roll/sheet length.
substrateName	String		Substrate display name as reported by the source.
substrateThickness	Length		Substrate caliper / thickness.
substrateType	String		Substrate type / material as reported by the source.
substrateWeight	PaperWeight		Substrate basis weight.
substrateWidth	Length		Substrate roll/sheet width.
totalPlanned	Float		Quantity the run was planned to produce, in countUnit — the denominator for completion against goodCount. Null when the source reported no plan.
updatedAt	String!		When the row last changed (ISO8601). Payload columns are immutable after first write, so this only moves when the binding refs are set.
userId	UserID		User associated with this report (typically the operator on duty).
widthPrinted	Length		Width of the print run, with unit provenance preserved.
workCenterId	WorkCenterID		Binding ref: TypeID of the WorkCenter (machine/cell) the output came from (wcr_…). Null until the report is bound.

Relationships

• Area
• Length
• PaperWeight
• Speed