ProductionReportState

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