Printago API
POST /v1/orders/print

Reconcile print jobs with orders

Requires: order.print

Request Body

Reconciliation parameters including SKUs, orders, printer tags, and priority

ReconcileJobsRequest
consolidationoptional
object
Build-time plate consolidation (issue #437): when printing quantity N of a part, pack the copies onto as few plates as possible and emit one merged plate per full plate instead of N separate jobs. Reuses the merge core, so a consolidated plate is an ordinary merged parent (unmergeable back into its copies). All layout fields default to the store's PlateMergingSettings / the account's smallest bed when omitted.
bedSizeoptional
object
{x,y,z} mm build volume of the target plate.
xrequired
number
yrequired
number
zrequired
number
enabledrequired
boolean
Off by default. When true, this build's copies are consolidated.
partSpacingMmoptional
number
Per-build override of the store's part spacing (mm).
plateMarginMmoptional
number
Per-build override of the store's plate edge margin (mm).
orderIdsoptional
string[]
positionoptional
any
printerTagsoptional
Record<string, string>
Make all properties in T optional
priorityoptional
any
skuIdsrequired
string[]

Example Request

application/json
{
  "skuIds": [
    "string"
  ],
  "orderIds": [
    "string"
  ],
  "printerTags": {},
  "consolidation": {
    "enabled": true,
    "partSpacingMm": 1,
    "plateMarginMm": 1,
    "bedSize": {
      "x": 1,
      "y": 1,
      "z": 1
    }
  }
}

Response Schema

ReconcileJobsResponse
errorsrequired
string[]

Example Response

201 OK — application/json
{
  "errors": [
    "string"
  ]
}