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. Le stampanti cloud configurate per il negozio vengono visualizzate automaticamente nell'elenco stampanti di ogni dispositivo — non è necessario aggiungerle qui.

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

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

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

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. 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

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

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

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 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

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

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

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

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 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

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

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://<printer-ip>)
• Nelle impostazioni DHCP del router (assegnare un IP riservato all'indirizzo MAC della stampante)

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://<printer-ip> 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

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

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

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

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
• 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