Appearance
JobState
Type: Object
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
| Name | Type | Args | Description | Deprecated |
|---|---|---|---|---|
| actualEndAt | ISO8601 | Actual end time (ISO8601) | ||
| actualStartAt | ISO8601 | Actual start time (ISO8601) | ||
| billingCustomer | CustomerState | Billing customer. Requires customer:read permission. | ||
| billingCustomerId | CustomerID | Billing customer ID | ||
| commercialKind | CommercialKind | Commercial product type | ||
| components | [ComponentState!]! | Components of this job. Requires component:list permission. | ||
| createdAt | ISO8601! | Creation timestamp (ISO8601) | ||
| deliveryCustomer | CustomerState | Delivery customer. Requires customer:read permission. | ||
| deliveryCustomerId | CustomerID | Delivery customer ID | ||
| description | String | Job description | ||
| dueAt | ISO8601 | Due date (ISO8601) | ||
| estimate | EstimateState | Linked estimate. Requires estimate:read permission. | ||
| estimateId | EstimateID | Linked estimate ID | ||
| externalId | String | External system ID | ||
| id | JobID! | Unique identifier | ||
| jobGroupId | JobGroupID | Job group this job belongs to | ||
| jobNumber | String | Internal job number | ||
| maxDeliverableQuantity | Int | Maximum deliverable quantity | ||
| milestones | [MilestoneState!]! | All milestones of this job, including ones scoped to specific components. Requires milestone:list permission. | ||
| name | String! | Job name | ||
| operations | [OperationState!]! | Operations of this job. Requires operation:list permission. | ||
| priority | Int! | Scheduling priority (higher = more urgent, default 0) | ||
| productionKind | ProductionKind | Binding/finishing type | ||
| quantity | Int! | Ordered quantity | ||
| scheduledEndAt | ISO8601 | Scheduled end time (ISO8601) | ||
| scheduledStartAt | ISO8601 | Scheduled start time (ISO8601) | ||
| sourceTemplateId | String | Product template ID used to instantiate this job | ||
| sourceTemplateVersion | Int | Product template version used to instantiate this job | ||
| status | JobStatus! | Job status | ||
| tags | [String!] | Job tags | ||
| updatedAt | ISO8601! | Last update timestamp (ISO8601) |