PDF et documents

En plus des tickets, un travail peut contenir un PDF, une image, du texte brut, du HTML, des octets d'imprimante bruts, de l'ESC/POS, du ZPL ou de l'EPL. Précisez type et encoding :

type	encoding habituel	S'imprime sur
pdf	url ou base64	Imprimantes de bureau (A4, Letter) ; imprimantes thermiques (chaque page est rastérisée à la largeur du papier, jusqu'à 50 pages)
image	url ou base64 (PNG, JPEG)	Imprimantes de bureau (telle quelle) ; imprimantes thermiques (raster 1 bit, scale fit ou actual)
text	utf8	Imprimantes thermiques (avec retour à la ligne, converti dans la page de code) ; imprimantes de bureau (sous forme de PDF généré)
html	utf8 ou url	Imprimé via un Chrome, Edge ou Chromium sans interface, converti en PDF. Uniquement sur les agents où un tel navigateur est installé (capacité html).
raw	base64	Toute imprimante : les octets sont envoyés sans modification
escpos	base64	Imprimantes thermiques ; doit commencer par une commande ESC/POS. Les options cut et openDrawer sont ajoutées à la fin.
zpl, epl	utf8 ou base64	Imprimantes d'étiquettes. Voir Modèles d'étiquettes et de tickets.

Avec encoding: "url", data est une URL https:// que l'agent télécharge (60 secondes et 50 Mo au plus). Pour les documents privés, utilisez une URL signée de courte durée.

Exemple

await jp.print({
  printer: { alias: "office" },
  type: "pdf",
  encoding: "url",
  data: "https://files.example.com/invoices/10492.pdf?sig=…",
  options: { copies: 2, duplex: "long", paper: "a4", pageRange: "1-3", color: false },
});

Options des documents

Option	Valeurs
copies	1 ou plus. Les imprimantes de bureau impriment les copies en un seul travail spouleur.
paper	a4, letter, 58mm, 80mm, label-4x6, label-2x1
orientation	portrait, landscape
duplex	none, long, short
color	true ou false
pageRange	par exemple 1-3 ou 1,3,5-7
tray	auto ou un nom de bac connu du pilote
scale	fit ou actual

Comment chaque système imprime les documents

• Windows : via le spouleur Windows, avec l'outil PDF fourni pour les fichiers PDF.
• macOS et Linux : via CUPS.
• Android : les PDF sont rastérisés pour les imprimantes thermiques et intégrées ; les imprimantes de bureau ne sont pas prises en charge.

Vérifiez les capabilities de l'agent (pdf, image, html…) avec agent.info avant de proposer un format. Le SDK navigateur le fait pour vous et lève UNSUPPORTED_FORMAT avant l'envoi.

Les images et les PDF ne sont pas encore pris en charge sur les imprimantes d'étiquettes : envoyez plutôt du ZPL ou de l'EPL.