Sezione dedicata ai template per stampanti termiche in linguaggio ZPL
In questa sezione:
- Inizialmente sono presenti solo modelli standard
- I template standard possono essere duplicati
- Il duplicato diventa personalizzabile
Il modello di stampa ZPL si configura nella sezione Configurazione → Modelli di stampa.
Puoi creare modelli diversi per ogni tipo di documento (es. DDT, fattura, ordine).
Quando stampi, il programma utilizza automaticamente il modello associato al documento.
Se non esiste un modello specifico, verrà utilizzato quello predefinito.
Dati azienda
Dati cliente
Dati documento
Totali
– `#TOTIVA#`
– `#TOTDOCUMENTO#`
Righe articoli
Per personalizzare la stampa delle righe articoli (una riga per ogni prodotto) devi inserire nel modello il blocco seguente:
#CORPO_TEMPLATE_START#
#CORPO_CONFIG base=900 step=30 maxDescription=28#
^FO20,{{y}}^FD{{codiceArticolo}}^FS
^FO200,{{y}}^FD{{descrizione}}^FS
^FO450,{{y}}^FD{{prezzo}}^FS
^FO550,{{y}}^FD{{quantita}}^FS
^FO630,{{y}}^FD{{sconto1}}^FS
^FO690,{{y}}^FD{{imponibile}}^FS
^FO780,{{y}}^FD{{iva}}^FS
{{extraLines}}
#CORPO_TEMPLATE_END#
Il programma ripeterà automaticamente questo blocco per ogni articolo del documento.
Assicurati che nel modello principale sia presente il campo #CORPO# nel punto in cui vuoi stampare le righe.
1) Configurazione opzionale del blocco `#CORPO_CONFIG`
Parametri disponibili:
– `base` (default 900): coordinata Y di partenza
– `step` (default 30): altezza tra una riga e la successiva
– `maxDescription` (default 28): lunghezza massima della descrizione (taglio)
2) Token disponibili nel template riga
Testo/valori:
– `{{codiceArticolo}}`
– `{{descrizione}}`
– `{{descrizioneCompleta}}`
– `{{quantita}}`
– `{{prezzo}}`
– `{{sconto1}}`
– `{{sconto2}}`
– `{{imponibile}}`
– `{{iva}}`
– `{{aliquota}}`
Posizionamento:
– `{{y}}` (coordinata Y calcolata)
Extra righe (omaggi/lotto):
– `{{extraLines}}`
– `{{omaggioExtra}}`
– `{{lottoExtra}}`
– `{{omaggioTipo}}`
3) Gestione extra righe (omaggio e lotto)
Se una riga ha:
– **omaggio**: viene aggiunta una riga descrittiva
– **personalizzati.string_pers1**: viene aggiunta una riga con lotto e scadenza
Alcuni articoli possono stampare automaticamente informazioni aggiuntive (es. lotto o omaggio).
Se inserisci {{extraLines}} nel template puoi scegliere tu dove stamparle.
il sistema aggiunge automaticamente le righe extra sotto la riga principale.
Se invece le inserisci nel template, il sistema **non** le duplica.
4) Prezzi e DDT
Se `tipoDocumento` contiene `”ddt”`, i campi prezzo/sconto/imponibile/iva vengono mascherati con `***` o `*`.
5) Esempio minimo di corpo personalizzato
#CORPO_TEMPLATE_START#
^FO20,{{y}}^FD{{codiceArticolo}}^FS
^FO200,{{y}}^FD{{descrizione}}^FS
^FO550,{{y}}^FD{{quantita}}^FS
{{extraLines}}
#CORPO_TEMPLATE_END#
Controlli da verificare prima della stampa
Il modello ZPL è salvato
La stampante è configurata come ZPL
Il documento contiene almeno due articoli
Controllare il posizionamento `{{y}}`