How to submit a Job

Understanding the job structure

Our Job API was written "bespoke first". This means it has been designed for submitting both basic and complex print jobs.

A Job is made up of a series of components that we call a JobComponent. This is where the specifics of the Job is defined, such as the size, the stock and any finishings.

The JobComponent is made up of the following structure:

  • reference: Your reference for the Job; this can be your Job or Order Item ID
  • product: The unique identifier (UUID) of the selected print product
  • quantity: The number of copies or units
  • options: An array that can hold additional options or features related to the entire print job, such as binding for multipage products
  • components: An array representing the different components or parts of the print job
    • label: One of general|cover|pages depending on single or multipage
    • size: The size of the Job
    • material: The stock to be used for the Job
    • options: An array of finishing items, such as lamination, perforation
    • range_start and range_end: The page count for Job
    • artwork: Details related to the artwork or design of the component.
      • files: An array containing the artwork files used for the Component
        • file: The remote URL where the artwork is accessible
        • finishing_item: The finishing for which the artwork belongs to
        • label: A label or identifier for the artwork component, usually "ink"

Each JobComponent must have an artwork PDF assigned to it which must be accessible for the API to download. See Supplying artwork for more information.

Example Jobs

Business Cards: 7bea462b-f281-415e-92a8-6c62c5df21d4

Business Card Single Sided
{
  "reference": "MY-FIRST-JOB",
  "product": "7bea462b-f281-415e-92a8-6c62c5df21d4",
  "quantity": 10,
  "options": [],
  "components": [
    {
      "label": "general",
      "size": "size-85mm-x-55mm",
      "material": "material-recycled-silk-standard-350gsm",
      "options": [
        {
          "finishing_item": "finishing-orientation-landscape"
        },
        {
          "finishing_item": "finishing-ink-single"
        }
      ],
      "range_start": 1,
      "range_end": 1,
      "artwork": {
        "files": [
          {
            "file": {
              "mime_type": "application/pdf",
              "source": "https://assets.printeddirect.com/artwork/85x55_L_SS.pdf"
            },
            "finishing_item": "finishing-ink-single",
            "label": "ink"
          }
        ]
      }
    }
  ]
}
Business Card Double Sided
{  
  "reference": "MY-FIRST-JOB",
  "product": "7bea462b-f281-415e-92a8-6c62c5df21d4",
  "quantity": 10,
  "options": [],
  "components": [
    {
      "label": "general",
      "size": "size-85mm-x-55mm",
      "material": "material-recycled-silk-standard-350gsm",
      "options": [
        {
          "finishing_item": "finishing-orientation-landscape"
        },
        {
          "finishing_item": "finishing-ink-double"
        }
      ],
      "range_start": 1,
      "range_end": 2,
      "artwork": {
        "files": [
          {
            "file": {
              "mime_type": "application/pdf",
              "source": "https://assets.printeddirect.com/artwork/85x55_L_SS.pdf"
            },
            "finishing_item": "finishing-ink-double",
            "label": "ink"
          }
        ]
      }
    }
  ]
}
Table of Contents