Collegare una stampante

L’installazione della stampante può essere eseguita in pochi semplici passaggi. La stampante può essere utilizzata per stampare ricevute, etichette, ordini o anche resoconti dalle diverse applicazioni di Odoo. Inoltre, le azioni della stampante possono essere assegnate come azione su un trigger durante il processo di produzione, o aggiunte a un punto di controllo qualità o a un controllo qualità.

Avvertimento

Il solo metodo per collegare una stampante direttamente a un database Odoo è attraverso l’utilizzo di un sistema IoT. Senza uno di questi, la stampa può avvenire ma verrà gestita dalla stampante stessa che non è il processo consigliato.

Connessione

I sistemi IoT supportano stampanti collegate via USB, connessione di rete o Bluetooth. Le stampanti supportate vengono individuate automaticamente e appaiono nell’elenco Dispositivi dell’app IoT.

La stampante come apparirebbe nell'elenco dispositivi dell'app IoT.

Nota

Le stampanti possono impiegare fino a due minuti per apparire nell’elenco di Dispositivi dell’app IoT.

Cancella la cache della stampante del dispositivo

Dopo aver collegato una stampante per stampare un resoconto, l’impostazione viene salvata nella cache del browser. Ciò significa che un utente può avere diversi dispositivi salvati nella cache per diversi resoconti, in base al dispositivo che utilizza per accedere a Odoo. Ciò significa anche che utenti diversi possono far stampare automaticamente un resoconto da stampanti diverse, in base alle preferenze.

Per scollegare un resoconto da una stampante, apri l’app IoT ‣ Configurazione Deseleziona dispositivi ‣ Ripristina stampanti collegate. Verrà generato un elenco di resoconti collegati a una stampante nel dispositivo attuale. Fai clic sul pulsante Scollega accanto a ogni resoconto per eliminare il collegamento.

Importante

Questo passaggio impedisce solo che il resoconto venga stampato automaticamente dalla stampante elencata dal browser corrente. Il resoconto è ancora collegato al dispositivo, sotto la scheda Resoconti stampante.

Un elenco di resoconti attualmente collegati a una stampante nell'app IoT.

Potenziali problemi

La stampante non viene individuata

Se una stampante non appare nell’elenco dei dispositivi vai sulla pagina principale della box IoT oppire del servizio Windows virtual IoT, fai clic su Mostra nella sezione Dispositivi e assicurati che la stampante appaia nell’elenco.

Se la stampante non appare nella pagina principale del sistema IoT, fai clic su Server stampante, poi su Amministrazione e Aggiungi stampante. Se la stampante non è nell’elenco, potrebbe non essere connessa in modo corretto.

La stampante emette un testo casuale

Per la maggior parte delle stampanti, il driver corretto dovrebbe essere rilevato e selezionato automaticamente. Tuttavia, in alcuni casi, il meccanismo di rilevamento automatico potrebbe non essere sufficiente e, se non viene trovato alcun driver, la stampante potrebbe stampare caratteri casuali.

La soluzione consiste nel selezionare manualmente il driver corrispondente. Nella pagina principale del sistema IoT, fai clic su Server stampante, vai su Stampanti e seleziona la stampante nell’elenco. Nel menu a tendina Amministrazione, fai clic su Modifica stampante. Segui gli step e seleziona il make e model.

Modificare la stampante collegata al sistema IoT.

Nota

Le stampanti di ricevute Epson e le stampanti di etichette Zebra non hanno bisogno di un driver per funzionare. Assicurati che non sia selezionato alcun driver per queste stampanti.

La stampante viene individuata ma non riconosciuta correttamente

Se né Odoo né il sistema IoT riconoscono correttamente la stampante, vai su IoT ‣ Dispositivi, fai clic sulla scheda del dispositivo per accedere al modulo e configura il campo Sottotipo selezionando l’opzione appropriata: Stampante ricevuta, Stampante etichetta o Stampante ufficio.

Casi speciali configurazione Epson

La maggior parte delle stampanti Epson supportano la stampa di ricevute nel Punto vendita Odoo utilizzando il comando GS v 0. Tuttavia, le seguenti stampanti Epson non supportano il comando:

  • TM-U220

  • TM-U230

  • TM-P60

  • TMP-P60II

Per aggirare il problema, è possibile configurare la stampante per l’utilizzo del comando ESC *.

Per prima cosa, consulta il sito web Epson per la compatibilità dei comandi GS v 0 ed ESC *.

Se la stampante non è compatiile con GS v 0 ma supporta ESC *, configura il sistema IoT per utilizzare il comando come segue:

  1. Accedi alla pagina principale della box IoT oppure della Windows virtual IoT.

  2. fai clic sul pulsante Server stampante e poi fai clic su Amministrazione sulla pagina CUPS.

  3. fai clic su Aggiungi stampante nella sezione Stampanti, seleziona la stampante e fai clic su Continua.

    Suggerimento

    Se il nome della stampante non è ancora certom segui questi step;

    1. prendi nota delle stampanti elencate nella pagina CUPS;

    2. Spegni la stampante e ricarica la pagina:

    3. confronta con il primo elenco per vedere quale stampante è scomparsa;

    4. Riaccendi la stampante e ricarica la pagina;

    5. Controlla di nuovo l’elenco per vedere se appare la stampante;

    6. la stampante scomparsa che riappare nell’elenco delle stampanti è il nome della stampante in questione. Può avere il nome Sconosciuta nella sezione Stampanti locali.

  4. Nella pagina Aggiungi stampante, specifica il Nome della stampante utilizzando la seguente convenzione: <printer_name>__IMC_<param_1>_<param_2>_..._<param_n>__, dove:

    • printer_name è il nome della stampante. Può contenere qualsiasi carattere eccetto _, /, # o ` ` (carattere spazio).

    • IMC: ovvero Image Mode Column nome semplificato per ESC *).

    • param_1: parametro specifico:

      • SCALE<X>: scala dell’immagine (con lo stesso rapporto di aspetto). X dovrebbe essere un intero che descrive la percentuale della scala da utilizzare. Ad esempio, 100 è la dimensione originale, 50 corrisponde alla metà e 200 al doppio.

      • LDV: Low Density Vertical (verrà impostata su High Density Vertical se non specificato).

      • LDH: Low Density Horizontal (verrà impostata su High Density Horizontal se non specificato).

      Nota

      • Potrebbe essere necessario configurare i parametri relativi alla densità in un modo particolare in base al modello di stampante.

      • Consulta la documentazione `ESC * di Epson per capire se la stampante richiede la configurazione dei parametri.

    Example

    Di seguito alcuni esempi di nomi formattati in modo giusto e sbagliato.

    Formattazione nome giusta:

    • EPSONTMm30II__IMC__

    • EPSON_TM_U220__IMC_LDV_LDH_SCALE80__

    Formattazione nome errata (non impedirà la stampa ma il risultato potrebbe non essere quello desiderato):

    • EPSON TMm 30II: il nome non può contenere spazi

    • EPSONTMm30II: il nome è corretto ma non utilizzerà ESC *

    • EPSONTMm30II__IMC: il nome manca della fine __

    • EPSONTMm30II__IMC_XDV__: il parametro XDV non corrisponde a nessuno dei parametri esistenti

    • EPSONTMm30II__IMC_SCALE__: il parametro SCALE manca il valore della scala

  5. Una volta che il nome della stampante è stato definito utilizzando la convenzione di denominazione appropriata, fai clic su Continua.

  6. in seguito, configura il valore Make impostandolo su Raw e per il valore Model scegli Raw Queue (en);

  7. fai clic su Aggiungi stampante. Se tutto è stato fatto correttamente, la pagina dovrebbe reindirizzare alla pagina Banner;

  8. aspetta alcuni minuti per far sì che il sistema individui la stampante e si sincronizzi con il server Odoo;

  9. accedi alle impostazioni del POS e seleziona il tuo POS oppure fai clic sul pulsante a forma di ellissi verticale () di una scheda e clicca su Modifica. Scorri in basso fino alla sezione Dispositivi collegati, attiva la Box IoT e seleziona la stampante nel campo Stampante ricevuta. Fai clic su Salva.

Nota

Se la stampante è stata configurata in modo errato (ad esempio, continua a stampare testo a caso o la ricevuta stampata è troppo grande o troppo piccola), non è possibile modificarla tramite il nome della stampante in CUPS. Occorre invece configurare una nuova stampante da zero con i parametri modificati, seguendo i passi precedenti.

Di seguito è riportato un esempio del processo di risoluzione dei problemi per un modello di stampante TM-U220B utilizzando il comando ESC *. La ricevuta illustrata di seguito è un esempio di ricevuta che viene stampata correttamente grazie alla formattazione corretta (in teoria):

Immagine di una ricevuta formattata correttamente da un database demo.

La stampa immediata di questa ricevuta senza una formattazione adeguata non funzionerà, poiché il modello di stampante TM-U220B non supporta il comando GS v 0. Verranno stampati caratteri casuali:

Carta stampante con caratteri casuali.

Per configurare in modo appropriato la formattazione per il modello stampante Epson TM-U220B segui questi step:

  1. Dopo aver consultato il sito web Epson per la compatibilità con i comandi GS v 0 ed ESC *, la stampante TM-U220B non è compatibile con il comando GS v 0 ma supporta ESC *.

    Valutazione compatibilità Epson dal sito web Epson.
  2. Quando aggiungi la stampante, il sistema CUPS mostra l’elenco di stampanti disponibili:

    Menu amministrazione, selezione aggiunta stampante.

    In questo caso, la stampante è collegata tramite USB quindi non sarà parte delle Stampanti di rete scoperte. Al contrario, farà parte della selezione Sconosciuta nella sezione Stampanti locali. Scollegando il cavo USB della stampante dal sistema IoT e ricaricando la pagina, la stampante Sconosciuta scomparirà. Ricollegandola, la stampante riappare, quindi si può dire che si tratta della stampante in questione.

  3. Per la convenzione di denominazione, dato che la stampante deve stampare utilizzando il comando ESC *, è imperativo aggiungere __IMC.

    Specifiche Epson TM-U220 sul sito web del produttore.

    Per questo particolare modello, TM-U220, m deve essere pari a 0 o 1. Facendo riferimento alla tabella Descrizione sul sito web Epson’s ESC *, i valori m potrebbero essere 0, 1, 32 o 33. Quindi, nel caso della stampante, il valore m *non* può essere 32 o 33 (altrimenti verranno stampati caratteri casuali).

    La tabella include i valori numerici 32 e 33, entrambi appaiono se il Numero di bit per dati verticali è impostato su 24 ovvero è un High Vertical Density. Nel caso della configurazione della Epson TM-U220, il valore Low Vertical Density dovrà essere forzato perché questo modello di stampante non supporta il High Vertical Density per il comando ESC *.

    Per aggiungere un Low Vertical Density, aggiungi il parametro LDV alla convenzione di denominazione.

    Aggiungi un *Low Vertical Density*, (parametro `LDV`) alla convenzione di denominazione.
  4. Fai clic su Continua per procedere. In seguito, configura il valore Make impostandolo su Raw e per il valore Model scegli Raw Queue (en).

    Specifiche Epson TM-U220 sul sito web dei produttori.

    Tuttavia, quando provi a stampare con la convenzione di denominazione EpsonTMU220B__IMC_LDV__, la ricevuta viene stampata ma è troppo grande e fuori dai margini. Per risolvere il problema, aggiungi una nuova stampante (e convenzione di denominazione) con il parametro SCALE<X> per adattarlo alla dimensione della ricevuta.

    Ecco alcuni esempi:

    Convenzione di denominazione stampante

    EpsonTMU220B__IMC_LDV__

    EpsonTMU220B__IMC_LDV_SCALE75__

    EpsonTMU220B__IMC_LDV_LDH__

    EpsonTMU220B__IMC_LDV_LDH_SCALE35__

    Formato esempio ricevuta. Formato ricevuta che usa la convenzione: EpsonTMU220B__IMC_LDV__. Formato ricevuta che usa la convenzione: EpsonTMU220B__IMC_LDV_SCALE75__. Receipt format using naming convention: EpsonTMU220B__IMC_LDV_SCALE75__. Formato ricevuta che usa la convenzione: EpsonTMU220B__IMC_LDV_LDH_SCALE35__.

Problema di stampa DYMO LabelWriter

La stampante DYMO LabelWriter presenta un problema noto nella stampa con i sistemi IoT. Il server CUPS OpenPrinting installa la stampante utilizzando i driver Local RAW Printer. Per poter stampare qualsiasi cosa, è necessario impostare la corretta Marca e modello, in modo che venga fatto riferimento al driver corretto quando si utilizza il dispositivo.

Inoltre, è necessario aggiungere una nuova stampante per ridurre il ritardo di stampa che si verifica dopo l’aggiornamento del driver.

Importante

The DYMO LabelWriter 450 DUO printer is the recommended DYMO printer for use with Odoo and IoT systems. This device combines two printers: a label printer and a tape printer. When configuring the following processes, it is essential to select the correct model (either DYMO LabelWriter 450 DUO Label (en) or DYMO LabelWriter 450 DUO Tape (en)). For consistency, the following processes outline configuration steps for the DYMO LabelWriter 450 DUO Label (en) model. Adjust the model selections as needed.

DYMO LabelWriter non stampa

If the DYMO LabelWriter fails to print, install a new driver:

  1. Access the IoT system’s homepage and click Printer server to open the OpenPrinting CUPS console.

  2. Click Printers in the top menu, then click the printer in the list.

  3. Select Maintenance in the first dropdown menu.

  4. Select Modify Printer in the second dropdown menu.

    Modify the make and model of the DYMO LabelWriter. Maintenance and Modify dropdown menus highlighted.
  5. Select the specific network connection/printer on which the modification should be made and click Continue.

  6. On the next page, click Continue, then select DYMO from the Make dropdown list.

  7. Click on Continue and set the Model to DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used).

  8. Click Modify Printer to set the new driver; a confirmation page appears.

  9. Click Printers in the top menu; all printers installed on the OpenPrinting CUPS server appear, including the newly updated DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used).

  10. Click the newly updated printer, then click the Maintenance dropdown menu and select Print Test Page to print a test label. The test label is printed after a few seconds if the driver update was successful.

To reduce this delay, add a new printer using the steps below.

Ritardo stampa DYMO LabelWriter

Suggerimento

If the DYMO LabelWriter 450 DUO printer is not printing at all, or is not recognized (i.e., it has a RAW driver type), then update the drivers on the device.

To resolve the delay issue after modifying the driver, reinstall the printer:

  1. Access the IoT system’s homepage and click Printer server to open the OpenPrinting CUPS console.

  2. Click Administration in the top menu, then click Add a Printer.

  3. On the next page, in the Local Printers section, select DYMO LabelWriter 450 DUO Label (DYMO LabelWriter 450 DUO Label) (or whichever DYMO printer model is being used) pre-installed printer. Click Continue.

    Add a printer screen on OpenPrinting CUPS with DYMO LabelWriter 450 DUO Label highlighted.
  4. On the following screen, update the Name to something easily identifiable, as the original printer will remain in the list. Then, click Continue.

    Pagina rinomina stampante nel flusso 'Aggiungi stampante' con il campo nome evidenziato.
  5. Set the Model field to DYMO LabelWriter 450 DUO Label (en) (or whichever DYMO printer model is being used), then click Add Printer to complete the installation.

    Schermata scelta modello nella console OpenPrinting CUPS con campi modello e aggiungi stampante evidenziati.
  6. Click Printers in the top menu and click the newly installed printer DYMO LabelWriter 450 DUO Label (or whichever DYMO printer model is being used) from in the list.

    Pagina della stampante con evidenziata la stampante appena installata.
  7. Click the Maintenance dropdown list and select Print Test Page to print a test label. The test label should print out immediately, or after one or two seconds.

La stampante Zebra non stampa nulla

Zebra printers are quite sensitive to the format of the printed Zebra Programming Language (ZPL) code. If nothing comes out of the printer or blank labels are printed, try changing the format of the report sent to the printer. To do so, activate the developer mode, go to Settings ‣ Technical ‣ User Interface ‣ Views, and search for the corresponding template.

Barcode scanner issues

I caratteri letti dal lettore di codici a barre non corrispondono al codice a barre

By default, most barcode scanners are configured in the US QWERTY format. If the barcode scanner uses a different layout, go to IoT ‣ Devices and click the barcode device’s card. Then, select the correct language in the Keyboard Layout field.

Nota

The Keyboard Layout is language-specific, with available options varying based on the device and the language of the database (e.g., English (UK), English (US), etc.).

Non accade nulla al momento della scansione di un codice a barre

Make sure the correct device is selected in the Point of Sale settings (when applicable) and the barcode is configured to send an ENTER character (keycode 28) at the end of every barcode.

Il lettore di codici a barre viene rilevato come tastiera

Importante

Some barcode scanners are identified as USB keyboards rather than barcode scanners and are not recognized by IoT systems.

To change the device type manually, go to IoT ‣ Devices and click the barcode device’s card. Then, enable Is scanner.

The barcode scanner processes barcode characters individually

When accessing the mobile version of Odoo from a mobile device or tablet paired with a barcode scanner via the IoT system, the scanner might interpret each character in a barcode as a separate scan. To resolve this, go to IoT ‣ Devices and click the barcode device’s card. Then, select the correct language in the Keyboard Layout field.

Nota

The Keyboard Layout is language-specific, with available options varying based on the device and the language of the database (e.g., English (UK), English (US), etc.).