PDF y lenguajes de impresora RAW
CloudPrint acepta documentos PDF listos para imprimir y cuatro lenguajes RAW. La integración declara el lenguaje, el agente detecta las capacidades de cada impresora y la API bloquea las rutas incompatibles.
Elige el contrato correcto
Para PDF usa document_format=pdf y omite document_raw_language. Para RAW usa document_format=raw y uno de estos valores exactos: zpl, tspl, cpcl o escpos. ZPL, TSPL y CPCL se usan habitualmente para etiquetas; ESC/POS, para recibos y puntos de venta.
Confía en las capacidades detectadas
Consulta GET /api/v1/printers y comprueba capabilities.language_profiles junto con endpoint.raw_passthrough_available. No deduzcas el lenguaje por la marca, el modelo o el nombre de la cola, ni pidas al operador que lo asigne manualmente.
Envía RAW de forma explícita
Incluye siempre document_format=raw y el document_raw_language correspondiente. CloudPrint valida el lenguaje frente a las capacidades de la impresora, pero no traduce comandos de un lenguaje a otro.
Mantén PDF separado
Una cola PDF necesita impresión del sistema o una conversión compatible en el agente. No marques bytes PDF como RAW. El panel admite PDF y los mismos lenguajes RAW explícitos que la API: ZPL, TSPL, CPCL y ESC/POS.
Prueba el equipo real
Antes de producción, prueba cada modelo, controlador o cola, lenguaje, DPI y soporte físico. Si falla un trabajo, registra print_job_id, X-Request-Id, el motivo y las capacidades anunciadas, pero no el contenido confidencial del documento.