Saltar al contenido

Imprimir etiquetas y códigos de barras por API

Tu aplicación prepara la etiqueta terminada. CloudPrint comprueba que el formato pueda llegar a la impresora elegida, crea el trabajo y permite seguir el resultado.

Prepara la etiqueta final

Genera el texto, el código y el diseño en el ecommerce, ERP, WMS o sistema de inventario. CloudPrint no diseña la etiqueta ni modifica sus datos.

Elige PDF o RAW

Usa PDF para una etiqueta ya compuesta como página. Para impresión térmica directa, envía document_format=raw y declara document_raw_language como zpl, tspl o cpcl.

Comprueba las capacidades

Consulta GET /api/v1/printers y verifica capabilities.language_profiles junto con endpoint.raw_passthrough_available. No deduzcas el lenguaje por la marca o por el nombre de la cola.

Ajusta el soporte físico

Haz coincidir el diseño con el ancho, el alto y el DPI reales. Calibra el sensor, la oscuridad y la velocidad, e intenta leer muestras impresas con el escáner antes de poner el proceso en producción.

Evita duplicados

Guarda printer_id, crea el trabajo con un Idempotency-Key estable y conserva print_job_id. Un reintento por timeout mantiene la clave; una reimpresión deliberada utiliza una nueva.

Siguientes pasos

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