Configurazione stampante

Le impostazioni della stampante si trovano nel POS in Impostazioni > Stampante. Ogni dispositivo gestisce la propria configurazione della stampante — le stampanti sono memorizzate localmente e non sincronizzate tra i dispositivi.

Stampare 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 che si desidera condividere tra tutti i dispositivi — vedere Stampa cloud.

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 (HTTP)
App desktop	Qualsiasi stampante per scontrini di rete	Rete (TCP raw)
App iOS	Epson e Star	Rete, Bluetooth
App Android	Epson e Star	Rete, Bluetooth, USB

Perché solo Epson e Star sul web?

I browser web non possono aprire connessioni TCP dirette. Le stampanti per scontrini Epson e Star includono un server web integrato che accetta lavori di stampa tramite HTTP — questo è l'unico modo per inviare comandi ESC/POS da un browser. L'app desktop non ha questa limitazione perché può connettersi direttamente tramite TCP.

Nelle app mobile, la stampa tramite Bluetooth e USB avviene attraverso gli SDK ufficiali di Epson e Star, quindi anche queste connessioni richiedono una stampante Epson o Star. Le stampanti generiche funzionano solo tramite rete.

Aggiungere una stampante

1

Aprire le impostazioni stampante

Andare in Impostazioni > Stampante nel POS. Se non è ancora configurata alcuna stampante, verrà visualizzata una schermata vuota con un pulsante Aggiungi stampante. Ogni stampante ha un Nome stampante — una semplice etichetta, compilata automaticamente come "Receipt Printer" (poi "Receipt Printer 2" e così via) — che è possibile modificare con qualsiasi nome utile a distinguere le stampanti.

2

Scegliere la modalità di connessione della stampante

Questo è il passaggio che varia in base alla piattaforma:

• App web — scegliere il Produttore: Epson o Star. Questa è la prima scelta sul web, perché i browser possono raggiungere solo i server web integrati di questi due marchi.
• App desktop — le stampanti si collegano tramite la rete; non è necessario selezionare nient'altro.
• App mobile — scegliere un Tipo di connessione: Rete, Bluetooth o USB (USB è disponibile solo su Android). I campi sottostanti cambiano in base alla scelta effettuata.

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. Una volta completato il rilevamento, viene visualizzata l'etichetta "Detected: Epson" o "Detected: Star". Nell'app web viene mostrato anche l'URL esatto dell'endpoint a cui si connetterà.

Stampanti Bluetooth o USB (dispositivi mobili) — selezionare la stampante dall'elenco dei dispositivi rilevati. La selezione di un dispositivo 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 fornisce risultati corretti, è possibile regolare tutti i parametri nelle Impostazioni avanzate.

4

Salvare e testare

Fare clic su Salva. WCPOS esegue prima una stampa di prova e salva la stampante solo se ha esito positivo.

La stampa di prova è un breve test diagnostico: un righello a colonne numerate, 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, dimensionamento e taglio siano configurati correttamente, non solo che la stampante sia raggiungibile.

Se il test fallisce, viene visualizzato l'errore insieme all'opzione Salva senza testare per salvare comunque il profilo.

Tipi di connessione (app mobili)

Nelle app iOS e Android, una stampante può connettersi in tre modi. Selezionare il Tipo di connessione nella parte superiore del modulo Aggiungi stampante: i campi di connessione si aggiornano di conseguenza.

Rete

La stampante è sulla stessa rete Wi-Fi del dispositivo. Inserisci il suo indirizzo IP — vedi Trovare l'indirizzo IP della stampante. Le stampanti di rete possono essere Epson, Star o generiche.

Bluetooth

La stampante è abbinata al dispositivo tramite Bluetooth. Tocca Cerca stampanti e scegli la tua dall'elenco — il nome e il produttore vengono compilati automaticamente. La stampa Bluetooth utilizza gli SDK nativi di Epson e Star, quindi la stampante deve essere un modello Epson o Star.

USB (solo Android)

La stampante è collegata tramite cavo USB. Tocca Aggiorna e selezionala dall'elenco dei dispositivi collegati. Come per il Bluetooth, la stampa USB richiede una stampante Epson o Star. iOS non supporta le periferiche USB generiche, quindi questa opzione è disponibile solo su Android.

nota

L'impostazione Porta si applica solo alle stampanti di rete — è nascosta per le connessioni Bluetooth e USB.

Impostazioni avanzate

Espandi Impostazioni avanzate per regolare la configurazione della stampante. La maggior parte di queste viene compilata automaticamente una volta noto il produttore.

Impostazione	Opzioni	Descrizione
Produttore	Epson, Star, Generico	Produttore della stampante. Nell'app web, il produttore è la scelta principale in cima al modulo (solo Epson o Star) anziché un'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. Solo per connessione di rete — nascosta per Bluetooth e USB.
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 possono stare su una riga. Impostare in base alla carta e alla stampante in uso — la maggior parte delle stampanti da 80mm supporta 42 caratteri per riga, alcune ne supportano 48.
Scontrino raster completo	Off / On	Stampa l'intero scontrino come immagine anziché come testo — vedere Scontrino raster completo di seguito.

Opzioni stampante

Queste opzioni si trovano in fondo al modulo Aggiungi stampante:

Opzione	Descrizione
Taglio automatico carta	Taglia automaticamente la carta dopo ogni scontrino
Apertura automatica cassetto	Invia un comando di apertura al cassetto portadenaro collegato dopo la stampa
Imposta come predefinita	Imposta questa come stampante predefinita — utilizzata per qualsiasi scontrino non indirizzato a una stampante specifica

Stai cercando "stampa automatica dopo il checkout"?

La stampa automatica dello scontrino al completamento di una vendita è un'impostazione del carrello, non della stampante — attivare Stampa automatica scontrino nelle impostazioni del carrello POS. La stampante utilizzata è determinata dalla stampante predefinita e dall'eventuale instradamento per modello.

Instradamento di stampa

Se si utilizzano più modelli — ad esempio una ricevuta termica e una fattura A4 — l'instradamento di stampa decide a quale stampante inviare ciascun modello. L'instradamento si compone di tre livelli, verificati in questo ordine:

1. Override per singolo lavoro. Nella schermata della ricevuta, un menu a discesa della stampante si trova accanto al selettore dei modelli. Selezionare una stampante qui sovrascrive tutte le impostazioni per quel singolo lavoro di stampa. Cambiare modello riporta l'impostazione ad Auto.
2. Override dalle impostazioni. Andare su Impostazioni → Instradamento stampa per assegnare una stampante specifica a ciascun modello. Ad esempio, instradare la ricevuta termica alla stampante di rete Epson e la fattura HTML alla finestra di stampa di sistema. Reimpostare un modello su Auto per rimuovere l'override.
3. Corrispondenza automatica. Quando non è impostato alcun override, WCPOS effettua la corrispondenza automaticamente:
   • I modelli termici vengono instradati alle stampanti termiche la cui larghezza dei caratteri corrisponde. Un modello termico da 58mm predilige stampanti a 32 colonne; un modello da 80mm predilige stampanti a 42 o 48 colonne.
   • I modelli HTML vengono instradati alla finestra di stampa di sistema.
   • Se più stampanti corrispondono, viene utilizzata la stampante predefinita.

Se si invia manualmente un modello a una stampante incompatibile — ad esempio un modello termico alla finestra di sistema — nella schermata della ricevuta appare un avviso di incompatibilità color ambra. La stampa viene comunque eseguita, ma il risultato potrebbe non essere reso correttamente.

Gli override di instradamento sono memorizzati 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 viene visualizzata solo dopo aver aggiunto almeno una stampante. Senza stampanti configurate, ogni modello utilizza implicitamente la finestra di dialogo di stampa di sistema.

Rasterizzazione completa dello scontrino

Per impostazione predefinita, WCPOS invia gli scontrini alle stampanti termiche come testo — veloce, compatto e nitido, utilizzando i font integrati della stampante. Il problema: i font delle stampanti termiche coprono solo un set limitato di caratteri. Le scritture per cui la stampante non dispone di un font — molti alfabeti non latini, testo da destra a sinistra, alcuni simboli — possono risultare come quadrati vuoti o caratteri illeggibili.

La rasterizzazione completa dello scontrino risolve questo problema. Quando è attiva, WCPOS renderizza l'intero scontrino come immagine e invia quell'immagine alla stampante, così la stampa corrisponde esattamente a ciò che appare sullo schermo — in qualsiasi lingua o scrittura.

Si attiva per ogni stampante in Impostazioni avanzate. Da sapere:

• È più lenta. Un'immagine è molto più grande di una riga di testo, quindi lo scontrino richiede più tempo per l'invio e la stampa.
• Da usare solo quando necessario. Se gli scontrini vengono stampati correttamente come testo, lasciare l'opzione disattivata.
• Si applica alle stampanti termiche con qualsiasi tipo di connessione (rete, Bluetooth, USB). Non si applica alla finestra di dialogo di stampa di sistema, che stampa già da un rendering a pagina intera.

Rilevamento delle stampanti

Nelle app mobile, il modulo Aggiungi stampante elenca le stampanti nelle vicinanze per le connessioni Bluetooth (iOS e Android) e USB (solo Android) — toccare Cerca stampanti o Aggiorna e selezionare la propria dall'elenco. Il nome e il produttore vengono compilati automaticamente.

Per le stampanti di rete su qualsiasi piattaforma, inserire direttamente l'indirizzo IP — vedere Trovare l'indirizzo IP della stampante di seguito. L'app web non dispone del rilevamento di rete (i browser non possono eseguire la scansione delle reti), quindi 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: tenere premuto il pulsante di avanzamento carta durante l'accensione
• Star: tenere 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 scontrini dovrebbero utilizzare un indirizzo IP statico per evitare che l'indirizzo cambi al riavvio della stampante. È possibile configurarlo in due modi:

• Nell'interfaccia web integrata della stampante (solitamente 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)
• 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 sua configurazione. Accedere all'interfaccia web della stampante all'indirizzo http://<printer-ip> per verificare e abilitare le impostazioni ePOS.

Nelle app mobili, le stampanti Epson possono connettersi anche tramite Bluetooth o USB attraverso l'SDK nativo di Epson — non è necessario un indirizzo IP né un 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:

• HTTPS o HTTP
• Endpoint: /StarWebPRNT/SendMessage

Nelle app mobile, le stampanti Star possono connettersi anche tramite Bluetooth o USB attraverso l'SDK nativo di Star.

Stampanti generiche

L'app desktop supporta qualsiasi stampante di scontrini di rete tramite TCP raw. Inserire l'indirizzo IP e la porta della stampante (di solito 9100). Funziona con la maggior parte delle stampanti termiche indipendentemente dal produttore, purché accettino comandi ESC/POS.

Nelle app mobile, le stampanti generiche sono supportate, ma solo per connessioni di rete, non tramite Bluetooth o USB (che richiedono una stampante Epson o Star). L'app web non supporta le stampanti generiche.

Cassetti portadenaro

I cassetti portadenaro collegati a una stampante di scontrini possono essere attivati automaticamente dopo ogni vendita:

1. Abilitare Apertura automatica cassetto portadenaro nelle opzioni della stampante
2. Il POS invia un comando ESC/POS di apertura cassetto 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 connessa alla stessa rete del dispositivo
• Per le stampanti di rete: verificare che l'indirizzo IP sia corretto (stampare una pagina di test)
• 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 in uso (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 o Star Line Mode
• Assicurarsi che l'impostazione Larghezza testo stampante sia corretta
• Se lo scontrino utilizza un alfabeto non latino o una lingua con scrittura da destra a sinistra, attivare Scontrino raster completo nelle Impostazioni avanzate: lo scontrino verrà stampato come immagine, garantendo la corretta visualizzazione di qualsiasi lingua

Il cassetto portadenaro non si apre

• Verificare che l'opzione Apertura automatica cassetto portadenaro sia attivata nelle opzioni della stampante
• Verificare che il cassetto sia collegato alla porta DK della stampante (non a un'alimentazione separata)
• Non tutte le stampanti supportano il comando di apertura del cassetto — consultare la documentazione della stampante

Impossibile connettersi dall'app web

• L'app web può connettersi solo a stampanti Epson e Star dotate di server web integrato
• Le stampanti generiche e USB non sono supportate sul web — utilizzare l'app desktop o mobile
• Se il sito utilizza HTTPS ma la stampante comunica solo tramite HTTP, il browser potrebbe bloccare la connessione come contenuto misto

La stampante Bluetooth non si connette (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