← All types
Sales & CRMOb Object

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

id

JobID!Non-null

Unique identifier

name

String!Non-null

Job name

quantity

Int!Non-null

Ordered quantity

dueAt

ISO8601Nullable

Due date (ISO8601)

Job status

Possible values (12)
DRAFT

Job created but not yet confirmed

RFQ

Awaiting cost estimation

CONFIRMED

Order confirmed, ready for production

PREPRESS

Artwork preparation and plate-making

PRESS

Currently printing

POSTPRESS

Finishing operations (binding, cutting, etc.)

PACKING

Packing for shipment

SHIPPED

Dispatched to customer

COMPLETED

Delivered and closed

WAITING

On hold pending external action

CANCELLED

Job cancelled

EXCEPTION

Requires 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

tags

[String!]Nullable

Job tags

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

priority

Int!Non-null

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_STITCHED

Saddle stitched binding

PERFECT_BOUND

Perfect bound

WIRE_BOUND

Wire-O bound

CASE_BOUND

Case/hardcover bound

FLATWORK

Flat sheets

FOLDED

Folded products

OTHER

Other binding type

Commercial product type

Possible values (13)
BANNER

Banner

BROCHURE

Brochure

BUSINESS_CARD

Business card

CATALOG

Catalog

COMPLIMENT_SLIP

Compliment slip

ENVELOPE

Envelope

HARDCOVER_BOOK

Hardcover book

LABEL

Label

LETTERHEAD

Letterhead

MAGAZINE

Magazine

POSTCARD

Postcard

SOFTCOVER_BOOK

Softcover book

OTHER

Other product type

Referenced by (20)
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
}