JobState
A print production order for one or more components. Jobs move through a defined lifecycle (draft → confirmed → in progress → complete), carry quantity and due date, and group the components, operations, and milestones needed to produce and deliver the finished product.
Fields
Unique identifier
Job name
Ordered quantity
Due date (ISO8601)
Job status
Possible values (12)
DRAFTJob created but not yet confirmed
RFQAwaiting cost estimation
CONFIRMEDOrder confirmed, ready for production
PREPRESSArtwork preparation and plate-making
PRESSCurrently printing
POSTPRESSFinishing operations (binding, cutting, etc.)
PACKINGPacking for shipment
SHIPPEDDispatched to customer
COMPLETEDDelivered and closed
WAITINGOn hold pending external action
CANCELLEDJob cancelled
EXCEPTIONRequires attention due to error
Internal job number
External URL for the calling integration, or the primary identity for unscoped callers.
All linked external identities, including identities belonging to other integrations.
Integration instance that originally created this record, when known.
IaC stack that originally created this record, when known.
External system ID
Job description
Maximum deliverable quantity
Billing customer ID
Delivery customer ID
Linked estimate ID
Product template ID used to instantiate this job
Product template version used to instantiate this job
Job group this job belongs to
Scheduling priority (higher = more urgent, default 0)
Scheduled start time (ISO8601)
Scheduled end time (ISO8601)
Actual start time (ISO8601)
Actual end time (ISO8601)
Creation timestamp (ISO8601)
Last update timestamp (ISO8601)
Components of this job. Requires component:list permission.
Operations of this job. Requires operation:list permission.
All milestones of this job, including ones scoped to specific components. Requires milestone:list permission.
Billing customer. Requires customer:read permission.
Delivery customer. Requires customer:read permission.
Linked estimate. Requires estimate:read permission.
Optional explicit versioned assembly graph stored on this job. Inferred relationships are never persisted here. Replace through replaceJobAssembly.
Monotonic graph edit revision, initially zero. Supply it as expectedRevision when replacing the graph; ordinary job edits do not increment it.
Binding/finishing type
Possible values (7)
SADDLE_STITCHEDSaddle stitched binding
PERFECT_BOUNDPerfect bound
WIRE_BOUNDWire-O bound
CASE_BOUNDCase/hardcover bound
FLATWORKFlat sheets
FOLDEDFolded products
OTHEROther binding type
Commercial product type
Possible values (13)
BANNERBanner
BROCHUREBrochure
BUSINESS_CARDBusiness card
CATALOGCatalog
COMPLIMENT_SLIPCompliment slip
ENVELOPEEnvelope
HARDCOVER_BOOKHardcover book
LABELLabel
LETTERHEADLetterhead
MAGAZINEMagazine
POSTCARDPostcard
SOFTCOVER_BOOKSoftcover book
OTHEROther product type
Referenced by (20)
- AcceptEstimatePayload.jobs
- AddJobToJobGroupPayload.job
- ComponentGroupState.job
- ComponentState.job
- CreateJobsFromOrderPayload.jobs
- CreateOrderGraphPayload.jobs
- InstantiateProductTemplatePayload.job
- InvoiceLineState.job
- JobCostingSummaryPayload.job
- JobEdge.node
- JobGroupState.jobs
- MilestoneState.job
- OperationState.job
- OrderLifecyclePayload.jobs
- OrderLineState.job
- ProductionBoardJob.job
- Query.getJob
- Query.getJobBy
- RemoveJobFromJobGroupPayload.job
- UpsertJobPayload.job
Exact type SDL
"""
A print production order for one or more components. Jobs move through a defined lifecycle (draft → confirmed → in progress → complete), carry quantity and due date, and group the components, operations, and milestones needed to produce and deliver the finished product.
"""
type JobState {
"""Unique identifier"""
id: JobID!
"""Job name"""
name: String!
"""Ordered quantity"""
quantity: Int!
"""Due date (ISO8601)"""
dueAt: ISO8601
"""Job status"""
status: JobStatus!
"""Internal job number"""
jobNumber: String
"""
External URL for the calling integration, or the primary identity for unscoped callers.
"""
externalUrl: String @iac_computed
"""
All linked external identities, including identities belonging to other integrations.
"""
externalIdentities: [RecordExternalIdentity!]! @iac_computed
"""Integration instance that originally created this record, when known."""
createdByIntegrationId: IntegrationInstanceID @iac_computed @iac_ref(resource: "integration_instance")
"""IaC stack that originally created this record, when known."""
createdByStackId: IaCStackID @iac_computed
"""External system ID"""
externalId: String
"""Job description"""
description: String
"""Maximum deliverable quantity"""
maxDeliverableQuantity: Int
"""Job tags"""
tags: [String!]
"""Billing customer ID"""
billingCustomerId: CustomerID
"""Delivery customer ID"""
deliveryCustomerId: CustomerID
"""Linked estimate ID"""
estimateId: EstimateID
"""Product template ID used to instantiate this job"""
sourceTemplateId: String
"""Product template version used to instantiate this job"""
sourceTemplateVersion: Int
"""Job group this job belongs to"""
jobGroupId: JobGroupID
"""Scheduling priority (higher = more urgent, default 0)"""
priority: Int!
"""Scheduled start time (ISO8601)"""
scheduledStartAt: ISO8601
"""Scheduled end time (ISO8601)"""
scheduledEndAt: ISO8601
"""Actual start time (ISO8601)"""
actualStartAt: ISO8601
"""Actual end time (ISO8601)"""
actualEndAt: ISO8601
"""Creation timestamp (ISO8601)"""
createdAt: ISO8601!
"""Last update timestamp (ISO8601)"""
updatedAt: ISO8601!
"""Components of this job. Requires component:list permission."""
components: [ComponentState!]!
"""Operations of this job. Requires operation:list permission."""
operations: [OperationState!]!
"""
All milestones of this job, including ones scoped to specific components. Requires milestone:list permission.
"""
milestones: [MilestoneState!]!
"""Billing customer. Requires customer:read permission."""
billingCustomer: CustomerState
"""Delivery customer. Requires customer:read permission."""
deliveryCustomer: CustomerState
"""Linked estimate. Requires estimate:read permission."""
estimate: EstimateState
"""
Optional explicit versioned assembly graph stored on this job. Inferred relationships are never persisted here. Replace through replaceJobAssembly.
"""
assemblyGraph: AssemblyGraph
"""
Monotonic graph edit revision, initially zero. Supply it as expectedRevision when replacing the graph; ordinary job edits do not increment it.
"""
assemblyGraphRevision: Int!
"""Binding/finishing type"""
productionKind: ProductionKind
"""Commercial product type"""
commercialKind: CommercialKind
}