Saltar al contenido

Imprimir etiquetas de envío desde una aplicación

CloudPrint imprime la etiqueta que ya ha generado el transportista, la plataforma de venta o el sistema de envíos. No compra el envío, no elige el servicio y no crea el número de seguimiento; entrega la etiqueta terminada a la impresora local correcta y comunica el resultado.

Crea el envío antes de imprimir

Obtén la etiqueta definitiva mediante la API del transportista o de la plataforma logística. Comprueba que corresponde al pedido y al servicio correctos antes de enviarla a CloudPrint.

Elige PDF o un lenguaje RAW

Usa PDF para una etiqueta compuesta como página. Si recibes comandos de impresora, establece document_format=raw y declara document_raw_language como zpl, tspl o cpcl. La impresora elegida debe anunciar ese lenguaje y admitir el envío directo de datos RAW.

Asigna cada puesto de embalaje

Guarda una printer_id por almacén, puesto o proceso. Muestra al operario un nombre comprensible, pero enruta por el identificador estable. Si la cola no está disponible, solicita una elección explícita en vez de enviar la etiqueta a otra ubicación.

Ajusta el soporte y el código

Haz coincidir el tamaño de página, el ancho, el alto y los DPI con la etiqueta física. Calibra el sensor, la oscuridad y la velocidad, e intenta leer muestras reales con el escáner antes de pasar a producción.

Distingue un reintento de una reimpresión

Construye el Idempotency-Key con el envío, el tipo de etiqueta y la versión de la operación. Un reintento tras un timeout conserva la misma clave; una segunda copia solicitada de forma deliberada usa una nueva y deja registrada la razón.

Siguientes pasos

Guías para integrar CloudPrint, conectar el agente local y operar flujos de impresión.