# Configurazione stampante Le impostazioni della stampante si trovano nel POS in **Impostazioni > Stampante**. Ogni dispositivo gestisce la propria configurazione della stampante: le stampanti vengono memorizzate localmente e non sincronizzate tra i dispositivi. Stampa su una stampante non collegata a questo dispositivo? Questa pagina riguarda le stampanti collegate alla cassa tramite USB, Bluetooth o rete locale. Per una stampante in un'altra stanza o sede — o una stampante da condividere tra tutti i dispositivi — consultare [Stampa cloud](/it/receipts/cloud-printing.md). Le stampanti cloud configurate per il negozio vengono visualizzate **automaticamente** nell'elenco stampanti di ogni dispositivo — non è necessario aggiungerle qui. ## Stampanti supportate per piattaforma[​](#supported-printers-by-platform "Collegamento diretto a Stampanti supportate per piattaforma") Il modulo **Aggiungi stampante** si adatta all'app in uso — ogni piattaforma mostra solo le connessioni e le opzioni effettivamente disponibili. | Piattaforma | Stampanti supportate | Connessioni | | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------ | | **App web** | Stampanti Epson e Star con server web integrato (rete); stampanti Epson e Star tramite WebUSB/Web Bluetooth (USB/Bluetooth, solo Chrome/Edge) | Rete (HTTP), USB, Bluetooth | | **App desktop** | Qualsiasi stampante per scontrini di rete | Rete (raw TCP), USB, Bluetooth | | **App iOS** | Epson e Star | Rete, Bluetooth | | **App Android** | Epson e Star | Rete, Bluetooth, USB | Perché solo Epson e Star in rete sul web? I browser web non possono aprire connessioni TCP dirette. Le stampanti per ricevute Epson e Star includono un web server integrato che accetta lavori di stampa tramite HTTP — questo è l'unico modo per inviare comandi ESC/POS a una stampante di *rete* da un browser. L'app desktop non ha questa limitazione perché può connettersi direttamente tramite TCP. Anche la stampa USB e Bluetooth nel browser funziona, ma solo in **Chrome o Microsoft Edge** (utilizzano le API WebUSB e Web Bluetooth) — Safari e Firefox non le supportano. Nelle **app mobili**, la stampa Bluetooth e USB avviene tramite gli SDK ufficiali di Epson e Star, quindi queste connessioni richiedono una stampante Epson o Star. Le stampanti generiche funzionano solo in rete. ## Aggiunta di una stampante[​](#adding-a-printer "Collegamento diretto a Aggiunta di una stampante") 1 #### Aprire le impostazioni stampante Andare in **Impostazioni > Stampante** nel POS. Se non sono ancora configurate stampanti, verrà visualizzato uno stato vuoto con un pulsante **Aggiungi stampante**. Ogni stampante ha un **Nome stampante** — una semplice etichetta, compilata automaticamente come "Stampante ricevute" (poi "Stampante ricevute 2" e così via) — che è possibile modificare a piacere per distinguere le stampanti. 2 #### Scegliere la modalità di connessione della stampante Ogni piattaforma presenta la stessa domanda iniziale — **Tipo di connessione** — e mostra solo le opzioni supportate dalla piattaforma. I campi sottostanti si aggiornano in base alla scelta effettuata. * **App web** — **Rete**, **USB** o **Bluetooth** (USB e Bluetooth richiedono Chrome o Edge). Per una stampante in **Rete** si sceglie poi il **Produttore** — Epson o Star — perché il browser raggiunge la stampante di rete attraverso il server web integrato del marchio. * **App desktop** — **Rete**, **USB** o **Bluetooth**. * **App mobile** — **Rete** o **Bluetooth**, più **USB** su Android (iOS non supporta USB). 3 #### Identificare la stampante **Stampanti di rete** — inserire l'**Indirizzo IP** (ad esempio `192.168.1.100`). WCPOS interroga l'indirizzo per rilevare se si tratta di un dispositivo Epson o Star e compila automaticamente porta, linguaggio di comando e produttore. Al termine del rilevamento viene mostrata un'etichetta "Rilevato: Epson" o "Rilevato: Star". Nell'app web viene inoltre visualizzato l'URL esatto dell'endpoint a cui verrà effettuata la connessione. **Stampanti Bluetooth o USB** (mobile) — selezionare la stampante dall'elenco dei dispositivi rilevati. La selezione compila automaticamente nome e produttore. Toccare **Cerca stampanti** (Bluetooth) o **Aggiorna** (USB) se la stampante non è ancora presente nell'elenco. Se il rilevamento automatico non è del tutto corretto, è possibile regolare ogni impostazione nelle **Impostazioni avanzate**. 4 #### Salva e testa Fare clic su **Salva**. WCPOS invia prima una **stampa di prova** e salva la stampante solo se la prova ha esito positivo. La stampa di prova è un breve test diagnostico: un righello numerato per le colonne, testo centrato in dimensione normale e doppia, una riga con allineamento a sinistra e a destra e un taglio della carta. È progettata per verificare che larghezza della carta, allineamento, dimensioni e taglio siano configurati correttamente, non solo che la stampante sia raggiungibile. La prova non riesce? È comunque possibile salvare Se la prova non riesce, viene mostrato l'errore insieme all'opzione **Salva senza testare** per salvare comunque il profilo. ## Tipi di connessione[​](#connection-types-mobile-apps "Collegamento diretto a Tipi di connessione") Si inizia selezionando il **Tipo di connessione** nella parte superiore del modulo Aggiungi stampante; i campi di connessione si aggiornano di conseguenza. I tipi disponibili dipendono dalla piattaforma (vedere la tabella sopra). ### Rete[​](#network "Collegamento diretto a Rete") La stampante si trova sulla stessa rete Wi-Fi del dispositivo. Nelle app **desktop** e **mobile**, toccare **Scansiona rete** per rilevare automaticamente le stampanti oppure inserire manualmente l'indirizzo IP — vedere [Trovare l'indirizzo IP della stampante](#finding-your-printers-ip-address). L'**app web** supporta solo l'inserimento manuale dell'IP. Nelle app desktop e mobile una stampante di rete può essere Epson, Star o Generica; sul web deve essere **Epson o Star**, e si seleziona il tipo nella connessione di rete. ### Bluetooth[​](#bluetooth "Collegamento diretto a Bluetooth") La stampante è associata al dispositivo tramite Bluetooth. Selezionarla dall'elenco: il nome e il produttore vengono compilati automaticamente. Su **mobile**, la stampa Bluetooth utilizza gli SDK nativi di Epson e Star, pertanto la stampante deve essere un modello **Epson o Star**; sul **web**, il Bluetooth funziona in Chrome o Edge tramite l'API Web Bluetooth. ### USB[​](#usb-android-only "Collegamento diretto a USB") La stampante è collegata tramite cavo USB. Selezionarla dall'elenco dei dispositivi connessi. La connessione USB è disponibile sul **web** (Chrome o Edge, tramite WebUSB), nell'app **desktop** e su **Android**, ma **non su iOS**, che non supporta periferiche USB generiche. Su mobile, la stampa USB richiede una stampante **Epson o Star**. nota L'impostazione **Porta** si applica solo alle stampanti di rete — è nascosta per le connessioni Bluetooth e USB. ## Impostazioni avanzate[​](#advanced-settings "Collegamento diretto a Impostazioni avanzate") Espandere **Impostazioni avanzate** per regolare la configurazione della stampante. La maggior parte di questi campi viene compilata automaticamente una volta riconosciuto il produttore. Queste impostazioni si applicano su tutte le piattaforme: | Impostazione | Opzioni | Descrizione | | ----------------------------- | ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Linguaggio** | ESC/POS, StarPRNT, Star Line Mode | Il protocollo di comando utilizzato dalla stampante. Compilato automaticamente in base al produttore rilevato. | | **Larghezza testo stampante** | 58mm (32 caratteri), 80mm standard (42 caratteri), 80mm largo (48 caratteri) | Quanti caratteri entrano in una riga. Impostare in base alla carta e alla stampante — la maggior parte delle stampanti da 80mm supporta 42 caratteri per riga, alcune 48. | | **Scontrino raster completo** | Off / On | Stampa l'intero scontrino come immagine anziché come testo — vedere [Scontrino raster completo](#full-receipt-raster) di seguito. | Queste due impostazioni si comportano diversamente a seconda della piattaforma e del tipo di connessione: | Impostazione | Opzioni | Dove si applica | | -------------- | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Produttore** | Epson, Star, Generico | Produttore della stampante. Nell'**app web** il produttore si seleziona direttamente nella connessione **Rete** (solo Epson o Star), non come impostazione avanzata. Generico è disponibile per le stampanti di **rete** nelle app desktop e mobile, ma non per le connessioni Bluetooth o USB. | | **Porta** | Compilata automaticamente | Porta di rete della stampante, mostrata accanto all'indirizzo IP. **Solo rete** — nascosta per Bluetooth e USB. Viene compilata automaticamente in base al produttore (e, nell'app web, in base all'utilizzo di HTTP o HTTPS per il POS); modificarla solo se la rete la rimappa. | ## Opzioni stampante[​](#printer-options "Collegamento diretto a Opzioni stampante") Queste opzioni si trovano in fondo al modulo Aggiungi stampante: | Opzione | Descrizione | | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------- | | **Taglio automatico della carta** | Taglia automaticamente la carta dopo ogni scontrino | | **Apertura automatica del cassetto** | Invia un comando di apertura al cassetto portadenaro collegato dopo la stampa | | **Imposta come predefinita** | Rende questa la stampante predefinita, utilizzata per qualsiasi scontrino non indirizzato a una stampante specifica | Cerchi la "stampa automatica dopo il checkout"? La stampa automatica dello scontrino al completamento di una vendita è un'**impostazione del carrello**, non della stampante — attiva **Stampa automatica scontrino** nelle impostazioni del carrello POS. La stampante utilizzata dipende dalla stampante predefinita e dall'eventuale instradamento per modello. ## Instradamento di stampa[​](#print-routing "Collegamento diretto a Instradamento di stampa") Se si utilizzano più modelli — ad esempio uno scontrino termico **e** una fattura A4 — l'instradamento di stampa determina a quale stampante viene inviato ciascun modello. L'instradamento ha tre livelli, verificati nel seguente ordine: 1. **Override per singolo lavoro.** Nella schermata dello scontrino, un menu a tendina per la stampante si trova accanto al selettore del modello. Scegliendo una stampante qui si sovrascrive ogni altra impostazione per quel singolo lavoro di stampa. Cambiando modello si ripristina l'impostazione su **Auto**. 2. **Override nelle impostazioni.** Vai su **Impostazioni → Instradamento di stampa** per assegnare una stampante specifica a ciascun modello. Ad esempio, è possibile indirizzare lo scontrino termico alla stampante di rete Epson e la fattura HTML alla finestra di dialogo di stampa del sistema. Per rimuovere l'override, reimpostare un modello su **Auto**. 3. **Abbinamento automatico.** Quando non è impostata alcuna sostituzione, WCPOS esegue l'abbinamento automaticamente: * **I modelli termici** vengono indirizzati alle stampanti termiche la cui larghezza in caratteri corrisponde. Un modello termico da 58mm preferisce stampanti a 32 colonne; un modello da 80mm preferisce stampanti a 42 o 48 colonne. * **I modelli HTML** vengono indirizzati alla finestra di stampa di sistema. * Se più stampanti corrispondono, prevale quella impostata come **predefinita**. Se si invia manualmente un modello a una stampante non compatibile — ad esempio un modello termico alla finestra di stampa di sistema — nella schermata dello scontrino compare un **avviso di incompatibilità** in ambra. La stampa viene comunque eseguita, ma il risultato potrebbe non essere visualizzato correttamente. Le sostituzioni di instradamento vengono memorizzate **per dispositivo**. Ogni iPad, telefono o computer gestisce il proprio instradamento — non è prevista alcuna sincronizzazione lato server. nota La pagina delle impostazioni di instradamento stampa compare solo dopo aver aggiunto almeno una stampante. Se non è configurata alcuna stampante, tutti i modelli utilizzano implicitamente la finestra di stampa di sistema. Anche le **stampanti cloud** configurate per il proprio negozio vengono considerate: appaiono automaticamente come destinazioni di instradamento, senza necessità di aggiungerle sul dispositivo. ## Rasterizzazione completa dello scontrino[​](#full-receipt-raster "Collegamento diretto a Rasterizzazione completa dello scontrino") Per impostazione predefinita, WCPOS invia gli scontrini alle stampanti termiche come **testo** — rapido, compatto e nitido, utilizzando i font integrati della stampante. Il limite: i font delle stampanti termiche coprono solo un insieme limitato di caratteri. Le scritture per le quali la stampante non dispone di un font — molti alfabeti non latini, testo da destra a sinistra, alcuni simboli — possono risultare come riquadri vuoti o caratteri illeggibili. La **rasterizzazione completa dello scontrino** risolve questo problema. Quando è attivata, WCPOS genera l'intero scontrino come immagine e invia quell'immagine alla stampante, in modo che la stampa corrisponda esattamente a ciò che viene visualizzato sullo schermo — in qualsiasi lingua o scrittura. Attivala per ogni stampante in **Impostazioni avanzate**. Aspetti da considerare: * **È più lenta.** Un'immagine è molto più grande di una riga di testo, quindi lo scontrino richiede più tempo per essere inviato e stampato. * **Utilizzala solo quando necessario.** Se gli scontrini vengono stampati correttamente come testo, lasciala disattivata. * Si applica alle stampanti termiche su qualsiasi connessione (rete, Bluetooth, USB). Non si applica alla finestra di stampa di sistema, che stampa già da un rendering a pagina intera. ## Rilevamento delle stampanti[​](#discovering-printers "Collegamento diretto a Rilevamento delle stampanti") La modalità di ricerca di una stampante dipende dal tipo di connessione: * **Bluetooth e USB** — nelle **app mobile**, tocca **Cerca stampanti** (Bluetooth) o **Aggiorna** (USB) e seleziona la tua dall'elenco; il nome e il produttore vengono compilati automaticamente. Sul **web** (Chrome o Edge), fai clic su **Connetti** e scegli la stampante dalla finestra di selezione dispositivo del browser. * **Rete** — nelle app **desktop** e **mobile**, tocca **Scansiona rete** per trovare automaticamente le stampanti sulla rete locale (il desktop le rileva tramite mDNS/Bonjour; il mobile utilizza gli SDK Epson e Star), quindi seleziona la tua dall'elenco. È possibile anche inserire direttamente l'indirizzo IP — vedi [Trovare l'indirizzo IP della stampante](#finding-your-printers-ip-address) di seguito. I browser non possono eseguire scansioni di rete, quindi l'**app web** utilizza sempre l'inserimento manuale dell'IP. ## Trovare l'indirizzo IP della stampante[​](#finding-your-printers-ip-address "Collegamento diretto a Trovare l'indirizzo IP della stampante") La maggior parte delle stampanti per scontrini può stampare una pagina di autotest che include l'indirizzo IP: * **Epson**: tieni premuto il pulsante di avanzamento carta durante l'accensione * **Star**: tieni premuto il pulsante di avanzamento carta per 5 secondi con la stampante accesa In alternativa, controllare l'elenco dei dispositivi connessi nel router o l'utilità di configurazione della stampante. ### IP statico consigliato[​](#static-ip-recommended "Collegamento diretto a IP statico consigliato") Le stampanti per ricevute dovrebbero utilizzare un **indirizzo IP statico** per evitare che l'indirizzo cambi al riavvio della stampante. Configurarlo in uno dei seguenti modi: * Nell'interfaccia web integrata della stampante (generalmente accessibile all'indirizzo `http://`) * Nelle impostazioni DHCP del router (assegnare un IP riservato all'indirizzo MAC della stampante) ## Stampanti Epson[​](#epson-printers "Collegamento diretto a Stampanti Epson") Le stampanti Epson con supporto ePOS comunicano tramite HTTP. WCPOS invia richieste SOAP/XML al server web integrato della stampante. **Dettagli di connessione:** * Porta `8008` (HTTP) o `8043` (HTTPS) — compilata automaticamente in base al protocollo HTTP o HTTPS utilizzato dal POS * Endpoint: `/cgi-bin/epos/service.cgi` **Modelli verificati:** * Epson TM-T70-i 2 (rete) * Epson TM-m30iii (con middleware Printus) consiglio Assicurarsi che la stampante Epson abbia ePOS abilitato nella configurazione. Accedere all'interfaccia web della stampante all'indirizzo `http://` per verificare e abilitare le impostazioni ePOS. Nelle **app mobile**, le stampanti Epson possono anche connettersi tramite Bluetooth o USB attraverso l'SDK nativo di Epson — non sono necessari indirizzo IP o server web ePOS. ## Stampanti Star[​](#star-printers "Collegamento diretto a Stampanti Star") Le stampanti Star con supporto WebPRNT comunicano tramite HTTP. WCPOS invia i comandi all'endpoint Star WebPRNT. **Dettagli di connessione:** * Porta `80` (HTTP) o `443` (HTTPS) — compilata automaticamente in base al protocollo HTTP o HTTPS utilizzato dal POS * Endpoint: `/StarWebPRNT/SendMessage` Nelle **app mobili**, le stampanti Star possono connettersi anche tramite Bluetooth o USB attraverso l'SDK nativo di Star. ## Stampanti generiche[​](#generic-printers "Collegamento diretto a Stampanti generiche") L'**app desktop** supporta qualsiasi stampante per ricevute di rete tramite TCP raw. Inserire l'indirizzo IP della stampante e la porta (di solito `9100`). Funziona con la maggior parte delle stampanti termiche indipendentemente dal produttore, purché accettino comandi ESC/POS. Nelle **app mobili**, le stampanti generiche sono supportate, ma solo per connessioni di **rete**, non tramite Bluetooth o USB (per queste è necessaria una stampante Epson o Star). L'**app web** non supporta le stampanti generiche. ## Cassetti portadenaro[​](#cash-drawers "Collegamento diretto a Cassetti portadenaro") I cassetti portadenaro collegati a una stampante per ricevute possono essere attivati automaticamente dopo ogni vendita: 1. Abilitare **Apertura automatica cassetto** nelle opzioni della stampante 2. Il POS invia un comando ESC/POS di apertura dopo la stampa nota Il controllo del cassetto portadenaro richiede un profilo stampante termica — la finestra di stampa del browser non può attivare i cassetti portadenaro. ## Risoluzione dei problemi[​](#troubleshooting "Collegamento diretto a Risoluzione dei problemi") Stampante non rilevata durante la configurazione * Verificare che la stampante sia accesa e collegata alla stessa rete del dispositivo * Per le stampanti di rete: nell'app desktop o mobile, provare **Scansione rete** per trovarla automaticamente; in caso contrario verificare che l'indirizzo IP sia corretto (stampare una pagina di autotest) * Per l'app web: verificare che la stampante sia un modello Epson o Star con supporto ePOS/WebPRNT * Per l'app desktop: provare l'opzione produttore Generico con la porta 9100 * Per il Bluetooth: associare prima la stampante nelle impostazioni Bluetooth del dispositivo, quindi toccare **Cerca stampanti** * Per USB (Android): controllare il cavo e approvare la richiesta di autorizzazione USB se visualizzata * Verificare che nessun firewall stia bloccando la connessione Stampante rilevata ma non stampa nulla * Controllare il rotolo di carta: potrebbe essere esaurito o inceppato * Verificare che l'impostazione **Larghezza testo stampante** corrisponda alla carta utilizzata (58mm o 80mm) * Provare a stampare un autotest direttamente dalla stampante per verificarne il funzionamento * Verificare che il linguaggio di comando corrisponda alla stampante (ESC/POS per Epson, StarPRNT o Star Line Mode per Star) Lo scontrino è illeggibile o presenta caratteri errati * L'impostazione del linguaggio di comando potrebbe essere errata — provare a passare da ESC/POS a StarPRNT e Star Line Mode * Assicurarsi che l'impostazione **Larghezza testo stampante** sia corretta * Se lo scontrino è in una scrittura non latina o in una lingua con direzione da destra a sinistra, attivare **Rasterizzazione completa scontrino** nelle Impostazioni avanzate — lo scontrino viene stampato come immagine in modo che qualsiasi lingua venga visualizzata correttamente Il cassetto portadenaro non si apre * Verificare che **Apertura automatica cassetto** sia abilitata nelle opzioni della stampante * Verificare che il cassetto sia collegato alla porta DK della stampante (non a una fonte di alimentazione separata) * Non tutte le stampanti supportano il comando di apertura cassetto — consultare la documentazione della stampante Impossibile connettersi dall'app web * Tramite **rete**, l'app web raggiunge solo stampanti Epson e Star (attraverso i loro server web integrati) — le stampanti raw-network generiche non sono supportate nel browser; utilizzare l'app desktop o mobile, oppure una [stampante cloud](/it/receipts/cloud-printing.md) * Le stampanti **USB e Bluetooth** funzionano sul web, ma solo in **Chrome o Microsoft Edge** (Safari e Firefox non supportano le API WebUSB / Web Bluetooth) * Se il sito utilizza HTTPS ma la stampante supporta solo HTTP, il browser potrebbe bloccare la connessione come contenuto misto — la stampante deve utilizzare lo stesso protocollo HTTP/HTTPS del POS La stampante Bluetooth non si connette (dispositivo mobile) * Associare la stampante nelle impostazioni Bluetooth di sistema del dispositivo prima di aggiungerla in WCPOS * La stampa Bluetooth supporta solo stampanti Epson e Star — le stampanti Bluetooth generiche non sono supportate * Se la stampante non compare nell'elenco, toccare **Cerca stampanti** di nuovo e assicurarsi che sia accesa e nel raggio d'azione