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.

Perché una stampante che effettua polling?

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

WCPOS Cloud Print — il relay

Quando configuri una stampante con polling (Star CloudPRNT o Epson Server Direct Print), il poll URL che WCPOS ti fornisce punta a cloudprint.wcpos.com, non al tuo sito. Si tratta di WCPOS Cloud Print, un relay gratuito gestito da WCPOS che si colloca tra la tua stampante e il tuo negozio.

Perché esiste. Le stampanti per ricevute eseguono un firmware ridotto e aggiornato di rado. Molte non riescono a completare una connessione sicura verso un negozio su hosting moderno: versioni TLS più recenti, autorità di certificazione più recenti o un CDN/firewall davanti al sito (Cloudflare è un colpevole frequente) rifiuteranno la stampante — o ne verranno rifiutati. Il sintomo è una stampante bloccata su Waiting per sempre, anche se ogni impostazione è corretta. Il relay offre alle stampanti una connessione che anche il firmware più datato riesce sempre a negoziare, e inoltra il loro traffico al tuo negozio.

Come funziona:

• Il tuo sito si collega al relay automaticamente la prima volta che apri le impostazioni Cloud Print — non c'è nulla da abilitare o configurare.
• La stampante effettua il polling su cloudprint.wcpos.com; il relay inoltra la richiesta al tuo negozio e restituisce la risposta del tuo negozio. I lavori di stampa passano attraverso il relay: non vi vengono mai memorizzati.
• Il relay assorbe la maggior parte del polling a vuoto, così una stampante inattiva costa al tuo sito circa una richiesta al minuto anziché una ogni pochi secondi.
• Se il tuo sito non riesce a collegarsi al relay (per esempio un sito di sviluppo locale che il relay non può raggiungere), WCPOS ripiega automaticamente sugli URL diretti al sito.

Preferisci una connessione diretta?

La schermata di configurazione di ogni stampante ha una sezione Advanced che mostra l'URL diretto al sito. Usala se sai che il tuo hosting è compatibile con le stampanti, o se preferisci non instradare i lavori attraverso il relay. Gli sviluppatori possono disattivare il relay per l'intero sito con una sola riga:

add_filter( 'woocommerce_pos_cloud_print_relay_enabled', '__return_false' );

Cosa può vedere il relay. Collegarsi condivide l'URL del tuo sito con wcpos.com, e i lavori di stampa — il contenuto delle ricevute, che include i dettagli dell'ordine — transitano dal relay lungo il percorso verso la stampante. Nulla viene conservato. Tutti i dettagli sono nell'informativa sulla privacy.

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)

1

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.

2

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.

3

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

1

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.

2

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.

3

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.

4

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.

1

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

2

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.

3

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.

4

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.

La compatibilità dei modelli è importante

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)

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

La coda di stampa

Ogni lavoro destinato a una stampante cloud resta in una coda sul tuo sito finché la stampante non lo ritira (stampanti con polling) o il provider non ne conferma la consegna. WP Admin > POS > Settings > Cloud Print mostra la coda sotto le tue stampanti:

• Filtra per stampante o per stato — Waiting, Printing, Printed, Failed, Cancelled — con conteggi in tempo reale.
• Ogni riga mostra da quanto tempo la ricevuta è in attesa e rimanda all'ordine WooCommerce che stampa.
• Annulla i lavori in attesa uno alla volta, in blocco, oppure per un'intera stampante in una sola operazione. Riprova rimette in coda un lavoro fallito.

Se una stampante ha lavori in attesa ma non ne ritira nessuno da più di qualche minuto, un banner di avviso indica il nome della stampante, quante ricevute sono in arretrato e da quanto tempo, e propone Annulla tutto: un arretrato non può mai accumularsi in silenzio mentre una stampante è scollegata.

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.
• Se hai inserito l'URL diretto al sito (dalla sezione Advanced) e la stampante continua a non connettersi, passa all'URL standard cloudprint.wcpos.com: molte stampanti non riescono a negoziare una connessione sicura con l'hosting moderno, ed è esattamente ciò che il relay risolve.

Perché l'URL della mia stampante punta a cloudprint.wcpos.com?

Si tratta di WCPOS Cloud Print, il relay gratuito che offre alle stampanti una connessione che il loro firmware riesce sempre a negoziare e che inoltra i loro lavori di stampa al tuo negozio. È attivo automaticamente, i lavori non vi vengono mai memorizzati e l'URL diretto al sito è sempre disponibile nella sezione Advanced della stampante, se lo preferisci.

Ho configurato la stampante prima che il relay esistesse: devo cambiare qualcosa?

No — gli URL già salvati nella configurazione di una stampante continuano a funzionare. Se però quella stampante è bloccata su Waiting, il suo firmware è probabilmente tra quelli che non riescono a connettersi direttamente al tuo hosting: apri Setup & token sulla scheda della stampante, rigenera il token e inserisci il nuovo URL cloudprint.wcpos.com e il token nella configurazione della stampante.

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.

Documentazione correlata

Configurazione della stampanteCollega una stampante sullo stesso dispositivo o sulla stessa rete

ModelliIl sistema di modelli per le ricevute

Modelli termiciCrea layout ESC/POS per stampanti Star ed Epson