Stampa cloud
La stampa cloud consente a WCPOS di inviare le ricevute a una stampante non collegata direttamente al dispositivo che esegue la cassa. Configurala una sola volta in WP Admin e i tuoi ordini verranno stampati su una stampante della cucina, una stampante del back-office o una stampante in un'altra stanza — senza che ogni dispositivo debba rilevare e accoppiarsi con l'hardware.
Cos'è la stampa cloud?
Con la stampa locale, il dispositivo che esegue il POS comunica direttamente con la stampante tramite USB, Bluetooth o la rete locale. Questa è la scelta giusta quando la stampante si trova accanto alla cassa — vedi Configurazione della stampante per collegare stampanti USB, Bluetooth e di rete sullo stesso dispositivo.
La stampa cloud è per tutto il resto: una stampante in una posizione diversa, su una rete diversa, oppure una che vuoi condividere tra tutti i dispositivi senza configurarla su ciascuno. Esistono due modelli di consegna:
- Stampanti che effettuano polling. La stampante contatta WCPOS tramite Internet secondo una pianificazione, chiede "hai qualcosa per me?" e scarica eventuali lavori in attesa. WCPOS non si connette mai alla stampante — è sempre la stampante ad avviare la comunicazione. È così che funzionano Star CloudPRNT ed Epson Server Direct Print.
- Provider di relay ospitati. WCPOS invia il lavoro di stampa a un servizio ospitato, che lo recapita alla stampante. È così che funzionano Star Online e PrintNode. Star Online recapita alle stampanti Star CloudPRNT registrate nel tuo account stario.online; PrintNode recapita tramite il suo client desktop a quasi tutte le stampanti su cui quel computer può già stampare.
Una stampante che effettua polling non ha bisogno di una porta aperta, di un IP statico o di modifiche al firewall — effettua sempre e solo richieste in uscita. Questo la rende ideale per una stampante in una sede remota o dietro un router che non controlli. Lo svantaggio è un breve ritardo: la stampante stampa solo quando arriva il polling successivo.
Scelta di un provider
Scegli il provider che corrisponde al tuo hardware.
Star CloudPRNT
Per stampanti termiche Star con firmware CloudPRNT. La stampante effettua il polling su WCPOS e scarica i lavori. Le ricevute vengono renderizzate nei comandi nativi della stampante. Richiede un modello termico.
Star Online
Per stampanti Star registrate in un account stario.online. WCPOS invia Star Document Markup al servizio ospitato di Star e la stampante lo raccoglie da Star Online. Richiede un modello termico.
Epson Server Direct Print
Per stampanti Epson ePOS che supportano Server Direct Print. La stampante effettua il polling su WCPOS e scarica i lavori come ePOS-Print XML. Richiede un modello termico.
PrintNode
Funziona con praticamente qualsiasi stampante su cui il tuo computer può stampare, su qualsiasi sistema operativo, tramite il client desktop PrintNode. WCPOS invia un PDF, quindi puoi usare qualsiasi modello — incluse fatture HTML a pagina intera.
| Provider | Hardware | Come scorrono i lavori | Modelli |
|---|---|---|---|
| Star CloudPRNT | Stampante termica Star con firmware CloudPRNT | La stampante effettua il polling su WCPOS | Solo termici |
| Star Online | Stampante Star registrata in stario.online | WCPOS invia Star Document Markup a Star Online | Solo termici |
| Epson Server Direct Print | Stampante Epson ePOS con Server Direct Print | La stampante effettua il polling su WCPOS | Solo termici |
| PrintNode | Qualsiasi stampante collegata al sistema operativo + client PrintNode | WCPOS invia un PDF a PrintNode | Qualsiasi modello |
Configurazione di una stampante cloud
Le stampanti cloud vengono configurate una sola volta in WP Admin e condivise tra tutti i dispositivi — a differenza delle stampanti locali, che sono memorizzate per ogni dispositivo.
Vai su WP Admin > POS > Settings > Cloud Print e clicca su Add printer. Assegnale un nome (ad esempio "Cucina" o "Back office"). WCPOS deriva automaticamente un ID stampante stabile dalla stampante — non cambia mai, quindi è sicuro farvi riferimento dalla configurazione del firmware di una stampante.
Dopo che la stampante esiste, configura il lato provider.
Star o Epson (stampanti con polling)
Aggiungi la stampante in WCPOS
In WP Admin > POS > Settings > Cloud Print, aggiungi una stampante e scegli Star CloudPRNT o Epson Server Direct Print come provider. WCPOS genera un poll URL e un token monouso per quella stampante.
Copia il poll URL e il token
Copia il poll URL e il token generati. Il token viene mostrato solo una volta — se lo perdi, rigenerane uno nuovo dalla scheda della stampante e aggiorna la stampante con il nuovo valore.
Inseriscili nella configurazione della stampante
Apri la pagina di configurazione della stampante — le impostazioni CloudPRNT per Star o le impostazioni Server Direct Print per Epson — e incolla il poll URL e il token. Imposta l'intervallo di polling se la stampante lo richiede (qualche secondo è tipico). Salva e riavvia la stampante se necessario.
Entro un ciclo di polling la stampante si registra e il suo stato in WCPOS passa da Waiting a Connected.
PrintNode
Installa il client desktop PrintNode
Su un computer che può già stampare sulla tua stampante di destinazione, installa il client PrintNode e accedi. Il client deve rimanere in esecuzione e online affinché i lavori vengano stampati.
Ottieni una chiave API PrintNode
Nel tuo account PrintNode, crea una chiave API. È questo che consente a WCPOS di inviare lavori al tuo account PrintNode.
Inserisci la chiave API in WCPOS
Aggiungi una stampante in WP Admin > POS > Settings > Cloud Print, scegli PrintNode come provider e incolla la chiave API. WCPOS la utilizza per recuperare l'elenco delle stampanti registrate nel tuo account PrintNode.
Seleziona la stampante
Scegli la stampante di destinazione dall'elenco delle stampanti segnalate dal client PrintNode, quindi salva. WCPOS invierà i lavori per questa stampante a PrintNode e il client li stamperà.
Star Online
Usa Star Online quando la tua stampante Star è già registrata in un account stario.online e vuoi che il servizio ospitato di Star gestisca la consegna.
Ottieni l'URL CloudPRNT
In stario.online, apri Device Groups e copia il CloudPRNT URL del gruppo. Dovrebbe avere un aspetto simile a https://device.stario.online/cloudprnt/... o https://eu-device.stario.online/cloudprnt/....
Crea una chiave API con i permessi
In stario.online, crea una chiave API per WCPOS. La chiave deve avere il permesso di elencare i dispositivi e di stampare su di essi. Come minimo, abilita:
- EnumDevices — necessario quando WCPOS recupera l'elenco dei dispositivi
- ViewDevice — utilizzato per i controlli dello stato del dispositivo
- PrintToDevice — necessario per inviare i lavori di stampa
- ViewDeviceGroups — consigliato per la ricerca del gruppo e la diagnostica
Una chiave API può esistere e tuttavia fallire se questi permessi non sono abilitati.
Inserisci l'URL e la chiave API in WCPOS
Aggiungi una stampante in WP Admin > POS > Settings > Cloud Print, scegli Star Online come provider, quindi incolla il CloudPRNT URL e la chiave API. Clicca su Fetch my devices.
Seleziona il dispositivo Star
Scegli la stampante dall'elenco dei dispositivi e salva. WCPOS memorizza la chiave API lato server e utilizza l'identificatore di accesso del dispositivo selezionato quando invia i lavori a Star Online.
Regole di stampa automatica
Le regole di stampa automatica decidono cosa viene stampato e dove, in automatico — scritte come frasi semplici. Una regola è ambito × stampante × modello, ad esempio:
Stampa ogni ordine su Cucina usando Ticket Cucina.
Quando un ordine corrispondente viene completato, WCPOS renderizza il modello scelto lato server nel formato richiesto dalla stampante e lo accoda — non c'è nulla che il cassiere debba fare.
Le stampanti Star ed Epson possono usare solo modelli termici, perché il lavoro deve essere renderizzato nel linguaggio di comando nativo della stampante (Star Document Markup o ESC/POS per Star, ePOS-Print per Epson). PrintNode può usare qualsiasi modello — termico o HTML a pagina intera — perché il lavoro viene renderizzato in un PDF. Se un modello non appare come opzione per una stampante, è perché la stampante non può renderizzare quel formato. Vedi Modelli termici per creare layout termici.
Stampanti per negozio (Pro)
L'instradamento della stampa per negozio richiede WCPOS Pro e una configurazione multi-negozio.
Per impostazione predefinita, le regole di stampa automatica sono globali — ogni negozio le condivide. Con Pro, puoi assegnare a un singolo negozio le proprie regole di stampa cloud, in modo che i suoi ordini vengano stampati sulle sue stampanti (un ticket della cucina in una sede non dovrebbe stamparsi in un'altra).
Modifica un negozio in POS → Stores, apri la sua sezione Cloud Printing e clicca Add rule. Ogni regola è:
- ID stampante — l'ID stabile della stampante cloud a cui inviare
- Ambito — Solo ordini POS (predefinito), Solo ordini online o Ogni ordine
- Formato — StarPRNT (predefinito), ESC/POS, Epson ePOS-Print o HTML
Quando un ordine appartiene a un negozio che ha le proprie regole, WCPOS lo instrada alle stampanti di quel negozio. Se un negozio non ha regole proprie, ricorre alle regole globali di stampa automatica — quindi devi configurare solo i negozi che differiscono.
Stampa manuale
Non devi aspettare una regola di stampa automatica. Dalla schermata di checkout / ricevuta, un cassiere può inviare una ricevuta a una stampante cloud su richiesta — comodo per le ristampe o per instradare un ticket occasionale a una stampante specifica.
Il modo in cui viene prodotta la ricevuta dipende dalla stampante:
- Star CloudPRNT — la ricevuta viene renderizzata sul dispositivo e consegnata alla stampante tramite CloudPRNT.
- Star Online, Epson e PrintNode — la ricevuta viene renderizzata sul server a partire dall'ordine e dal modello selezionati, quindi recapitata alla stampante o al relay ospitato.
Stampa di prova e stato della connessione
Ogni scheda della stampante ha un pulsante Test print che invia una breve diagnostica, in modo da poter confermare che la stampante sia raggiungibile e che il formato sia corretto prima di affidarvi gli ordini reali.
La scheda mostra anche uno stato in tempo reale:
| Provider | Stato | Significato |
|---|---|---|
| Star CloudPRNT / Epson | Waiting | La stampante non si è ancora registrata — WCPOS è in attesa del suo primo polling. |
| Star CloudPRNT / Epson | Connected | La stampante ha effettuato di recente il polling su WCPOS e sta raccogliendo i lavori. |
| Star Online | Online | Star Online segnala che il dispositivo selezionato è disponibile. |
| Star Online | Offline | Star Online segnala che il dispositivo selezionato non è disponibile. |
| Star Online | Unknown | WCPOS non è riuscito a confermare lo stato del dispositivo da Star Online. |
| PrintNode | Online | Il servizio PrintNode segnala che il client e la stampante sono disponibili. |
| PrintNode | Offline | PrintNode segnala che il client o la stampante non sono disponibili. |
Risoluzione dei problemi
Stampante bloccata su Waiting
Una stampante con polling che non esce mai da Waiting non ha mai raggiunto con successo WCPOS. Controlla:
- Che il poll URL e il token nel firmware della stampante corrispondano esattamente a quanto generato da WCPOS. Un solo carattere errato significa che ogni polling viene rifiutato — rigenera il token in WCPOS e reinseriscilo se hai dubbi.
- Che la stampante possa effettivamente raggiungere il tuo sito tramite Internet (DNS corretto, nessun firewall che blocchi l'HTTPS in uscita, certificato SSL valido sul tuo negozio).
- Che il polling sia abilitato nella configurazione CloudPRNT / Server Direct Print della stampante, con un intervallo sensato. Riavvia la stampante dopo aver modificato le impostazioni.
Star Online dice che la chiave API non è autorizzata o è vietata
Star Online separa l'autenticazione dai permessi:
- 401 / autenticazione fallita significa che la chiave API stessa non è stata accettata. Controlla che la chiave sia stata copiata correttamente, non sia stata revocata e appartenga all'account/regione Star Online previsto.
- 403 / vietato significa che la chiave API è stata accettata ma non è autorizzata per l'azione richiesta. Modifica la chiave in stario.online e abilita i permessi richiesti, in particolare EnumDevices per Fetch my devices e PrintToDevice per la stampa.
Se Fetch my devices ha successo ma non appare alcuna stampante, controlla la pagina Device Groups di stario.online. Il gruppo deve contenere almeno un dispositivo connesso e il CloudPRNT URL in WCPOS deve puntare a quello stesso gruppo.
Il lavoro PrintNode non viene mai stampato
Il lavoro ha raggiunto PrintNode ma non è uscito dalla stampante. Controlla:
- Che il client desktop PrintNode sia in esecuzione e online sul computer collegato alla stampante. Se il computer è in sospensione o il client è chiuso, non viene stampato nulla.
- Di aver selezionato la stampante corretta in WCPOS — il nome deve corrispondere alla stampante segnalata dal client.
- Che la chiave API sia valida e non sia stata revocata. Reinseriscila se PrintNode mostra la stampante come Offline.
Il mio modello non è selezionabile per una stampante Star o Epson
Solo i modelli termici funzionano sulle stampanti cloud Star ed Epson, perché la ricevuta deve essere renderizzata in comandi ESC/POS o ePOS-Print. I modelli HTML e a pagina intera non possono essere espressi in quei formati, quindi sono nascosti per queste stampanti.
Scegli un modello termico, oppure usa una stampante PrintNode — PrintNode renderizza in PDF, quindi può stampare qualsiasi modello.