OnePrint

Documentación: Obtener ZPL de un Trabajo

Volver a la documentación
GET /api/print-jobs/{id}/zpl

Descripción

Este endpoint devuelve el código ZPL de un trabajo de impresión específico para enviarlo a una impresora Zebra. Opcionalmente, puede actualizar el estado del trabajo al mismo tiempo, lo que es útil para sistemas de impresión que necesitan marcar el trabajo como "en proceso" o "completado" al obtener el ZPL.

Parámetros de ruta

NombreTipoDescripción
idstring (UUID)ID del trabajo de impresión del que se quiere obtener el ZPL

Parámetros de consulta

NombreTipoDescripción
update_statusstring (enum)Actualiza el estado del trabajo después de obtener el ZPL. Valores posibles: 'printing', 'completed'
Ejemplo: /api/print-jobs/123e4567-e89b-12d3-a456-426614174000/zpl?update_status=printing

Encabezados de respuesta

NombreValorDescripción
Content-Typetext/plainIndica que el contenido es texto plano (código ZPL)
Content-Dispositionattachment; filename="print-job-{id}.zpl"Sugiere al navegador que descargue el contenido como un archivo

Respuesta

El endpoint devuelve el código ZPL como texto plano. Ejemplo:

^XA
^FO50,50^A0N,50,50^FDProducto XYZ^FS
^FO50,120^A0N,30,30^FDCódigo: PRD-123^FS
^FO50,170^A0N,30,30^FDNúmero: 001001^FS
^XZ

Códigos de estado

CódigoDescripción
200Código ZPL obtenido exitosamente
401No autorizado - Token inválido o expirado
404Trabajo de impresión no encontrado o no tiene ZPL
500Error interno del servidor