Printago API
POST
/v1/orders/print
Reconcile print jobs with orders
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"
]
}