API de trabalhos de impressão WMS (impressão na nuvem)
Última atualização 2026-10-13
Enviar trabalhos de impressão na nuvem com ZPL, consultar status, cancelar e repetir.
Enviar um trabalho de impressão na nuvem#
O web do telefone (sem Hub local) grava o ZPL em print_jobs como queued. O Device Hub no PC do armazém busca, imprime localmente na Zebra e devolve o resultado. Sem device_id usa a impressora de etiquetas padrão do armazém.
POST /api/wms/print-jobs
{
"device_id": "<uuid>", // optional; default label printer of the warehouse if omitted
"warehouse_id": "<uuid>", // optional; scope for default-printer lookup
"label_kind": "pallet", // required: e.g. pallet | carton | ucc
"ref_type": "pallet", // optional
"ref_id": "<uuid>", // optional
"copies": 2, // optional, default 1
"zpl_content": "^XA\n^FO40,40^FDHello^FS\n^XZ" // required
}Consultar o status do trabalho#
GET /api/wms/print-jobs/<job-id>
// -> { ok: true, data: {
// id, status: "queued|printing|done|failed|cancelled",
// error, device_id, label_kind, copies, created_at } }
GET /api/wms/print-jobs?status=queued&warehouse_id=<uuid>&page=1&page_size=50
// print-center queue list (page_size default 50, max 200)Ciclo de vida: queued → printing → done, ou → failed (com texto de erro), ou → cancelled. O Hub assume trabalhos atomicamente; um trabalho cancelado nunca é impresso.
Cancelar / repetir#
PATCH /api/wms/print-jobs/<job-id>
{ "action": "cancel" } // only from queued -> cancelled
{ "action": "retry" } // only from failed -> queued (error cleared)
// conditional update: 0 rows affected means the state already changed -> HTTP 409Notas do relé na nuvem: o ZPL passa pela nuvem (Supabase do tenant, protegido por RLS). Trabalhos com mais de 5 minutos são destacados. Saúde dos dispositivos: GET /api/wms/print-devices; online se last_seen_at < 2 min.