PDF und RAW-Druckersprachen
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.