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. ## Siguientes pasos