# 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?[​](#what-is-cloud-printing "Collegamento diretto a 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](/it/hardware/printers.md) 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[​](#providers "Collegamento diretto a 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[​](#setup "Collegamento diretto a 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)[​](#setup-polling "Collegamento diretto a 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[​](#setup-printnode "Collegamento diretto a 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[​](#setup-star-online "Collegamento diretto a 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[​](#auto-print "Collegamento diretto a 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](/it/receipts/thermal-templates.md) per creare layout termici. ## Stampanti per negozio (Pro)[​](#per-store-printers "Collegamento diretto a Stampanti per negozio (Pro)") Funzionalità Pro L'instradamento della stampa per negozio richiede [WCPOS Pro](/it/getting-started/pro-license.md) e una configurazione [multi-negozio](/it/stores/.md). 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[​](#manual "Collegamento diretto a 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[​](#status "Collegamento diretto a 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[​](#troubleshooting "Collegamento diretto a 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](/it/receipts/thermal-templates.md), oppure usa una stampante **PrintNode** — PrintNode renderizza in PDF, quindi può stampare qualsiasi modello. ## Documentazione correlata[​](#related-documentation "Collegamento diretto a Documentazione correlata") [Configurazione della stampanteCollega una stampante sullo stesso dispositivo o sulla stessa rete](/it/hardware/printers.md) [ModelliIl sistema di modelli per le ricevute](/it/receipts/.md) [Modelli termiciCrea layout ESC/POS per stampanti Star ed Epson](/it/receipts/thermal-templates.md)