# Personalizza la tua ricevuta Per cambiare l'aspetto della ricevuta sono disponibili tre opzioni. Scegli quella più semplice che soddisfa le tue esigenze — la maggior parte dei negozi non ha bisogno di andare oltre la prima. ## Tre modi per personalizzare[​](#three-ways-to-customise "Collegamento diretto a Tre modi per personalizzare") #### 1. Scegli un modello diverso Usa uno dei modelli predefiniti nella galleria. **Nessun codice necessario.** Ideale per: un layout diverso, nascondere i prezzi, una fattura A4, uno scontrino per la cucina. #### 2. Chiedi all'IA di modificarlo Incolla il modello in ChatGPT o Claude e descrivi cosa desideri. **Non servono competenze di programmazione** — basta descriverlo a parole. Ideale per: piccole modifiche come testi, colori o spostamento di elementi. #### 3. Modifica manualmente L'editor integrato nell'app consente di modificare il modello direttamente. Ideale per: controllo preciso o per chi conosce già l'HTML. Tutte e tre partono dallo stesso punto: **WP Admin → POS → Modelli**. La pagina è divisa in due parti — **I tuoi modelli** in alto (quelli attualmente in uso) e la **Galleria modelli** sotto (la libreria di modelli predefiniti). ## Opzione 1 — Scegliere un modello diverso[​](#option-1-pick-a-different-template "Collegamento diretto a Opzione 1 — Scegliere un modello diverso") Questo è il metodo più semplice e copre la maggior parte delle esigenze. 1 #### Aprire la galleria dei modelli In WP Admin andare su **POS → Modelli**. Scorrere oltre *I tuoi modelli* fino alla sezione **Galleria modelli** — è la libreria di modelli iniziali. 2 #### Sfogliare e visualizzare l'anteprima Filtrare per **categoria** (Scontrino, Fattura, Scontrino regalo, Comanda cucina, Preventivo / Ordine d'acquisto), **formato** (HTML per la stampa da browser, ESC/POS per stampanti termiche) o **direzione** (Da sinistra a destra o Da destra a sinistra). Fare clic sulla miniatura di una scheda — o sul collegamento **Anteprima** nel piè di pagina — per aprire un'anteprima dal vivo con i dati reali del negozio. 3 #### Utilizzarlo Fare clic su **Usa modello** sulla scheda. WCPOS crea una copia modificabile e la aggiunge a **I tuoi modelli** in cima alla pagina. Attivare l'interruttore **Attivo** sulla riga per iniziare a utilizzarlo sugli scontrini; trascinare la maniglia della riga per riordinare. È possibile avere più modelli attivi contemporaneamente — il cassiere sceglie quello desiderato al momento della vendita. Usa modello non sostituisce mai nulla Facendo clic su **Usa modello** viene sempre creata una nuova copia. Il modello originale della galleria rimane invariato, quindi è possibile tornare e scegliere un punto di partenza diverso in qualsiasi momento. Se più modelli di scontrino sono attivi, la schermata dello scontrino mostra un menu a discesa che consente al cassiere di passare dall'uno all'altro al volo. ### I modelli inclusi[​](#the-bundled-templates "Collegamento diretto a I modelli inclusi") | Modello | Formato | A cosa serve | | ----------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------- | | **Scontrino standard** | HTML | Predefinito — logo, articoli, totali, pagamento. Adatto alla maggior parte dei negozi | | **Scontrino standard (RTL)** | HTML | Come lo standard, speculare per arabo / ebraico / persiano / urdu | | **Minimale / Moderno** | HTML | Stesse informazioni dello standard, in meno spazio verticale | | **Scontrino dettagliato** | HTML | Fattura fiscale completa — colonna SKU, prezzo unitario, dettaglio imposta per aliquota, indirizzi | | **Scontrino regalo** | HTML | Solo articoli — prezzi nascosti. Include messaggio regalo e politica di reso | | **Fattura** | HTML | Fattura a pagina intera A4/Letter. Aggiunge un pannello "Come pagare" per gli ordini non saldati | | **Documento di trasporto** | HTML | Documento per il magazzino — articoli + quantità, indirizzo di spedizione, nessun prezzo | | **Preventivo** | HTML | Documento pre-vendita con prezzi e condizioni — nessuna sezione di pagamento | | **Scontrino stretto** | HTML | Scontrino a spaziatura fissa per carta stretta o stampanti termiche compatibili HTML | | **Scontrino termico semplice (58 mm)** | Termico | Layout termico pulito da 58 mm | | **Scontrino termico semplice (80mm)** | Termico | Layout termico pulito da 80 mm — il più comune | | **Scontrino termico semplice 80mm (RTL)** | Termico | Versione RTL per 80 mm. Richiede una stampante con codepage arabo | | **Scontrino termico dettagliato (58mm / 80mm)** | Termico | Aggiunge dettaglio imposte, indirizzi, rimborsi, pagamenti, condizioni, codice a barre | | **Comanda cucina** | Termico | Solo articoli, carattere grande, senza prezzi — per le postazioni di preparazione | La maggior parte dei modelli inclusi **si adatta automaticamente alle impostazioni fiscali del negozio**: i negozi con prezzi IVA inclusa mostrano i prezzi lordi e una riga "IVA inclusa"; i negozi con prezzi IVA esclusa mostrano i prezzi netti con l'imposta aggiunta come riga separata. La famiglia **Dettagliato** mostra sempre un riepilogo fiscale completo indipendentemente dall'impostazione. ### Modelli fattura e documento di trasporto di WP Overnight[​](#wp-overnight-invoice-and-packing-slip-templates "Collegamento diretto a Modelli fattura e documento di trasporto di WP Overnight") Se il sito utilizza anche [PDF Invoices & Packing Slips for WooCommerce](https://wordpress.org/plugins/woocommerce-pdf-invoices-packing-slips/) di WP Overnight, WCPOS aggiunge automaticamente due modelli extra a **I tuoi modelli**: | Modello | Formato | A cosa serve | | ----------------------------------------- | ------------------------ | ------------------------------------------------------------------------------- | | **Fattura (WP Overnight)** | HTML generato dal server | Utilizza il documento fattura configurato in WP Overnight per l'ordine POS | | **Documento di trasporto (WP Overnight)** | HTML generato dal server | Utilizza il documento di trasporto configurato in WP Overnight per l'ordine POS | Questi modelli non copiano i layout di fattura o documento di trasporto integrati in WCPOS. Richiedono a WP Overnight di generare il documento per l'ordine POS, così i numeri di fattura esistenti, il branding, i campi legali/fiscali e le personalizzazioni dei modelli WP Overnight restano coerenti tra ordini online e ordini in negozio. Vengono visualizzati solo quando il plugin WP Overnight è attivo. L'output si apre come HTML nella schermata di stampa di WCPOS anziché come download PDF separato. Poiché il documento viene generato dal server, il POS necessita di una connessione al sito per stampare questi modelli; per la stampa offline, utilizzare i modelli HTML o termici integrati. ## Assegnazioni per negozio[​](#per-store-assignments "Collegamento diretto a Assegnazioni per negozio") Se si dispone di più di un [negozio](/it/stores/.md) (Pro), ogni negozio può avere una **propria selezione e ordinamento dei modelli**, separata dalle impostazioni predefinite del sito. Il bar in fondo alla strada può utilizzare un piccolo scontrino termico con un logo e un indirizzo diversi; il magazzino può usare una distinta di imballaggio; il negozio principale può mantenere lo scontrino standard — il tutto dalla stessa galleria di modelli. Configurare dalla pagina **WP Admin → POS → Negozi**, quindi aprire il negozio da configurare. La pagina **Modifica negozio** contiene una sezione **Modelli di scontrino** con un'opzione *"Modelli di scontrino specifici per negozio"*: * **Disattivato** *(predefinito)* — il negozio eredita l'elenco dei modelli del sito dalla pagina principale **POS → Modelli**. * **Attivato** — il negozio ottiene una propria selezione e ordinamento dei modelli, separata dalle impostazioni predefinite del sito. Il riordinamento tramite trascinamento funziona allo stesso modo. La stessa pagina Modifica negozio è anche dove si trova l'**intestazione** di ciascun negozio (logo, indirizzo, dettagli di contatto e il blocco *Messaggi dello scontrino* — Formula di chiusura, Politica di reso, Piè di pagina). I modelli integrati attingono da questi campi specifici per negozio, quindi un singolo modello "Scontrino standard" può riportare un branding diverso in sedi diverse. Quando un cassiere accede a un negozio, nel menu a discesa degli scontrini vengono visualizzati solo i modelli attivi di quel negozio. A livello di sito vs per negozio La pagina **Modelli** in WP Admin imposta le impostazioni predefinite per l'intero sito. La sovrascrittura per negozio consente a un singolo modello (ad es. uno Scontrino standard) di riportare un branding diverso in sedi diverse, oppure a una sede di utilizzare un layout che le altre non usano. Se tutti i negozi necessitano degli stessi modelli, è sufficiente lasciare vuote le assegnazioni per negozio e verranno applicate le impostazioni predefinite del sito. ## Opzione 2 — Chiedere all'IA di modificarlo[​](#option-2-ask-ai-to-tweak-it "Collegamento diretto a Opzione 2 — Chiedere all'IA di modificarlo") Se la galleria è quasi perfetta ma non del tutto, un assistente AI può modificarla in pochi minuti — senza bisogno di conoscere l'HTML. 1 #### Copiare il template Aprire il template da cui si desidera partire in **WP Admin → POS → Template**, fare clic nell'editor e selezionare tutto il testo sul lato sinistro (Ctrl/Cmd + A). Copiarlo. 2 #### Incollare in ChatGPT o Claude Aprire [ChatGPT](https://chat.openai.com) o [Claude](https://claude.ai). Incollare il template, quindi descrivere le modifiche desiderate in linguaggio naturale: 3 #### Descrivere le modifiche Indicare all'AI esattamente cosa si desidera. Esempi efficaci: * *"Ingrandisci il nome del negozio e centralo."* * *"Aggiungi un messaggio di ringraziamento in corsivo in fondo."* * *"Nascondi il nome del cliente. Aggiungi il numero di telefono sotto il numero dell'ordine."* * *"Sostituisci il codice a barre con un codice QR che rimanda alla pagina dei resi."* * *"Aggiungi lo slogan 'A conduzione familiare dal 1987' sotto il nome del negozio."* L'IA restituirà un modello modificato. 4 #### Incollalo di nuovo Copiare la risposta dell'IA. Nell'editor di modelli di WCPOS, selezionare tutto (Ctrl/Cmd + A), incollare la nuova versione e fare clic su **Aggiorna**. L'anteprima a destra si aggiorna per mostrare il risultato. Se non sembra corretto, chiedere all'IA di correggerlo descrivendo cosa non va. Buona pratica Ogni clic su **Usa modello** nella galleria crea una nuova copia modificabile, quindi l'originale rimane al sicuro. Durante la sperimentazione è possibile utilizzare lo stesso modello dalla galleria più volte: rinominare le copie *(Ricevuta v1, Ricevuta v2)* e passare dall'una all'altra fino a trovare la versione desiderata. E le variabili? Le parti come `{{store.name}}` e `{{order.number}}` sono **segnaposto** per i dati reali. L'IA li comprende automaticamente, non è necessario conoscerli nel dettaglio. Per consultare tutti i segnaposto disponibili, vedere la [Guida ai dati della ricevuta](/it/receipts/receipt-data.md). ## Opzione 3 — Modifica manuale[​](#option-3-edit-it-by-hand "Collegamento diretto a Opzione 3 — Modifica manuale") Chi ha familiarità con l'HTML (o collabora con uno sviluppatore) può modificare il modello direttamente nell'editor integrato nell'app. L'editor offre anteprima in tempo reale, evidenziazione della sintassi, un selettore di campi con ricerca, annulla/ripristina e trova e sostituisci. Scegliere il motore di template: * **[Modelli HTML](/it/receipts/html-templates.md)** — Segnaposto in stile Mustache `{{variable}}`. Rendering lato client, funziona offline. **Consigliato per la maggior parte dei negozi.** * **[Modelli termici](/it/receipts/thermal-templates.md)** — XML per stampanti termiche ESC/POS. Lo stesso modello produce sia l'anteprima a schermo sia l'output della stampante. * **[Riferimento dati scontrino](/it/receipts/receipt-data.md)** — Tutti i segnaposto utilizzabili, raggruppati per sezione. Modelli PHP legacy Se in passato si sovrascriveva lo scontrino con un file PHP nel tema (`yourtheme/woocommerce-pos/receipt.php`), questa modalità continua a funzionare. Ora è etichettata come **Modello PHP legacy** nella galleria e si affianca ai nuovi motori logicless e termici. Anche l'integrazione WP Overnight utilizza il percorso di rendering lato server perché l'API di documenti di terze parti genera l'HTML sul server. Per le nuove personalizzazioni è consigliabile utilizzare la galleria o l'editor integrato nell'app: funzionano offline, offrono un'anteprima in tempo reale e non richiedono un round-trip verso il server. ## Personalizzazioni comuni[​](#common-customisations "Collegamento diretto a Personalizzazioni comuni") Risposte rapide alle domande più frequenti. Come posso aggiungere il logo del mio negozio? I loghi provengono dalle impostazioni del negozio, non dal modello stesso. Andare su **WP Admin → POS → Impostazioni → Negozi**, modificare il negozio e caricare un logo. Tutti i modelli inclusi che mostrano un logo lo utilizzeranno automaticamente. Per modificare la *posizione* del logo all'interno del modello, modificare il modello e spostare il blocco `{{#store.logo}}{{/store.logo}}` nella posizione desiderata. Come posso modificare il testo a piè di pagina (ad es. 'Grazie per il tuo acquisto!')? Due opzioni: 1. **Più semplice** — impostare una volta per tutte le ricevute in **WP Admin → POS → Impostazioni → Negozi → Dettagli negozio → Piè di pagina ricevuta / nota personale**. I modelli inclusi lo utilizzano automaticamente; se non viene impostato alcun piè di pagina, viene utilizzato un messaggio predefinito come *"Grazie per il tuo acquisto!"*. 2. **In un singolo modello** — modificare il modello e sostituire direttamente il testo del piè di pagina. Cercare `{{store.personal_notes}}` o la riga di ringraziamento. Come posso aggiungere uno slogan sotto il nome del negozio? Modificare il modello e aggiungere una riga sotto `{{store.name}}`: ```
Family-owned since 1987
``` In un modello termico: ``` Family-owned since 1987 ``` Come posso nascondere i prezzi (per una ricevuta regalo)? Fare clic su **Usa modello** sulla scheda **Ricevuta regalo** nella galleria — nasconde tutti i prezzi e i totali mostrando comunque gli articoli, lo SKU, gli attributi e il messaggio regalo. Non è necessaria alcuna modifica. Se si preferisce creare una ricevuta senza prezzi, copiare un modello qualsiasi ed eliminare i blocchi `{{...total...}}`, `{{...price...}}` e `{{#totals}}...{{/totals}}`. Come posso sostituire il codice a barre con un codice QR? Trovare l' `` elemento nel modello e modificare l' `type` attributo: ``` {{order.number}} {{order.number}} https://example.com/returns?order={{order.number}} ``` La stessa `` sintassi funziona sia nei modelli HTML che in quelli termici. Altri tipi supportati includono `ean13`, `ean8`, `upca`, `pdf417` e [tutto ciò che bwip-js supporta](https://github.com/metafloor/bwip-js/wiki/Supported-Barcode-Types). Come posso inviare un modello diverso a una stampante specifica? Nell'app POS, vai su **Impostazioni → Instradamento stampa**. Vedrai ciascuno dei modelli attivi con un menu a discesa per la stampante accanto. Seleziona la stampante desiderata oppure lascia l'impostazione su **Auto**. * **Auto** abbina automaticamente i modelli alle stampanti — i modelli termici vengono inviati alle stampanti termiche, i modelli HTML vengono inviati alla finestra di dialogo di stampa del sistema. * Una **stampante specifica** sovrascrive l'impostazione Auto e invia sempre quel modello alla stampante selezionata. * Al momento della stampa, il cassiere può sovrascrivere entrambe le impostazioni precedenti tramite il menu a discesa della stampante nella schermata dello scontrino. L'instradamento è memorizzato per dispositivo, quindi ogni iPad o computer può avere la propria configurazione. La ricevuta mostra ancora la vecchia versione dopo la modifica Fai clic sul pulsante **Aggiorna** di WordPress nella schermata di modifica del modello. L'editor non salva automaticamente — le modifiche vengono salvate solo quando fai clic su Aggiorna. Per i **modelli PHP legacy**, l'anteprima nell'editor mostra l'*ultima versione salvata*, non il testo in fase di digitazione. Salva prima, quindi aggiorna l'anteprima. L'anteprima è vuota o mostra 'Nessun ordine POS trovato' Questo accade solo con i **template PHP Legacy**, che necessitano di un ordine reale per generare l'anteprima. Elabora un singolo ordine POS — anche una vendita di prova da $0 — e l'anteprima inizierà a funzionare. I template Logicless (HTML) e termici dispongono sempre di dati di esempio su cui ripiegare, quindi l'anteprima funziona correttamente anche su un negozio appena creato. Ho fatto confusione — come posso ricominciare da capo? Tre reti di sicurezza: 1. L'editor dispone della funzione **Annulla** (Ctrl/Cmd + Z) per le modifiche effettuate durante la sessione. 2. Ogni salvataggio crea una **revisione** WordPress — apri **Revisioni** nella schermata di modifica per confrontare e ripristinare qualsiasi versione precedente. 3. Se sei partito da un template della galleria, fai clic su **Elimina** sulla tua copia in *I tuoi template*, quindi fai di nuovo clic su **Usa template** sulla stessa scheda della galleria. Otterrai una copia nuova e intatta. ## Quando chiedere assistenza[​](#when-to-ask-for-help "Collegamento diretto a Quando chiedere assistenza") * L'editor dei template non si carica oppure i salvataggi non vengono mantenuti. * La ricevuta viene stampata correttamente su un dispositivo ma non su un altro. * È necessario un layout fiscale/legale per un paese specifico (Italia, Brasile, Spagna, ecc.) — questi vengono solitamente gestiti da [WCPOS Pro](/it/getting-started/pro-license.md) o da un'integrazione specifica per il paese. * Si sta tentando di fare qualcosa di personalizzato e l'IA non riesce a ottenere il risultato corretto. Apri un [ticket di supporto](https://wcpos.com/support) e incolla il template su cui stai lavorando — questo ci fornisce tutto il necessario per aiutarti.