CloudPrint akzeptiert druckfertige PDF-Dateien und vier RAW-Druckersprachen. Die Integration gibt die Sprache an, der Agent erkennt die Fähigkeiten des Druckers und die API verhindert unzulässige Routen.
## Passenden Vertrag wählen Verwenden Sie für PDF `document_format=pdf` und lassen Sie `document_raw_language` weg. Für RAW setzen Sie `document_format=raw` und genau einen der Werte `zpl`, `tspl`, `cpcl` oder `escpos`. ZPL, TSPL und CPCL werden meist für Etiketten verwendet, ESC/POS für Belege und Kassendrucker. ## Erkannten Fähigkeiten vertrauen Rufen Sie `GET /api/v1/printers` auf und prüfen Sie `capabilities.language_profiles` zusammen mit `endpoint.raw_passthrough_available`. Leiten Sie die Sprache nicht aus Marke, Modell oder Warteschlangenname ab und lassen Sie sie nicht manuell durch Bedienpersonal zuweisen. ## RAW ausdrücklich senden Übergeben Sie immer `document_format=raw` und die passende `document_raw_language`. CloudPrint gleicht die Sprache mit den gemeldeten Druckerfähigkeiten ab, übersetzt Befehle jedoch nicht zwischen verschiedenen Druckersprachen. ## PDF und RAW trennen Für PDF benötigt die Warteschlange Systemdruck oder eine vom Agent unterstützte Konvertierung. Kennzeichnen Sie PDF-Daten nicht als RAW. Das Dashboard akzeptiert PDF und dieselben ausdrücklich angegebenen RAW-Sprachen wie die API: ZPL, TSPL, CPCL und ESC/POS. ## Echte Geräte testen Testen Sie vor dem Produktivbetrieb jedes verwendete Modell, jeden Treiber oder jede Warteschlange, Sprache, DPI und jedes Medium. Erfassen Sie bei Fehlern `print_job_id`, `X-Request-Id`, Fehlergrund und gemeldete Fähigkeiten, aber keine vertraulichen Dokumentinhalte. ## Nächste Schritte