Editor di codice per le ricevute stampate

Puoi personalizzare le tue ricevute stampate utilizzando l'editor di codice nel pannello di controllo di Shopify. Con l'editor di codice, puoi creare personalizzazioni più avanzate rispetto all'editor visuale utilizzando HTML, CSS e Liquid.

Puoi modificare il modello delle ricevute e i modelli delle sezioni utilizzati sulle ricevute stampate. I file modello Ricevute rappresentano i tipi di ricevute che puoi stampare nel tuo negozio. Le sezioni sono le parti che compongono la ricevuta, come header o footer. Le sezioni possono essere riutilizzate con più ricevute.

Considerazioni sull'utilizzo dell'editor di codice delle ricevute

Prima di utilizzare l'editor di codice per le ricevute, prendi in considerazione quanto segue:

  • Puoi utilizzare l'editor di codice solo dal pannello di controllo di Shopify su desktop.
  • Le modifiche apportate al codice si applicano a tutte le sedi POS Pro. Tuttavia, puoi aggiungere delle condizioni per mostrare le personalizzazioni per sedi specifiche. Maggiori informazioni sull'utilizzo dei tag di flusso di controllo con Liquid.
  • Quando passi all'editor di codice, non è possibile apportare personalizzazioni al modello di ricevuta dall'app di Shopify POS. Puoi comunque modificare le Opzioni di stampa dall'app di Shopify POS dalle sedi con il piano di abbonamento POS Pro.
  • Le personalizzazioni apportate nell'editor di codice si applicano solo alle sedi con abbonamento a POS Pro. Se utilizzi l'editor di codice e hai sedi POS Lite, puoi utilizzare l'editor visuale per personalizzare header e footer per le sedi Lite.
  • Nei file che costituiscono le ricevute viene usato Liquid, il linguaggio dei modelli di Shopify. Maggiori informazioni sull'utilizzo di Liquid.
  • Per creare o modificare modelli nell'editor di codice delle ricevute, devi avere dimestichezza con HTML, CSS e Liquid. Il servizio di assistenza per i temi di Shopify può aiutarti a effettuare modifiche limitate nell'ambito della Design Policy di Shopify.
  • Alcuni tipi di ricevute stampate non possono essere personalizzate.
  • L'editor di codice non è disponibile in nessuna delle sedi in Italia.

Considerazioni sull'incompatibilità per i tipi di ricevuta

Alcuni tipi di ricevute stampate non possono essere personalizzati nell'editor di codice per ricevute. I tipi di ricevuta che non dispongono di un modello nell'editor di codice non sono compatibili con la personalizzazione.

Puoi personalizzare i seguenti tipi di ricevute stampate:

  • ricevute di vendita
  • ricevute di buono regalo
  • ricevute di scontrini cortesia

Non puoi personalizzare le seguenti ricevute:

  • ricevute per il reso
  • ricevute cambio

Inoltre, tutti i tipi di ricevuta per le sedi in Italia non sono idonei per la personalizzazione.

Accesso all'editor di codice

Puoi modificare i modelli utilizzando l'editor di codice.

Passaggi:

  1. Dal pannello di controllo Shopify vai a Impostazioni > App e canali di vendita.

  2. Dalla pagina App e canali di vendita clicca su Point of sale.

  3. Clicca su Apri canale di vendita.

  4. Clicca su Impostazioni > Personalizzazione ricevuta.

  5. Clicca su Personalizza ricevute.

  6. Clicca su ... > Modifica codice.

  7. Nella finestra di dialogo Modifica codice clicca su Modifica codice.

Utilizzo di file personalizzati nei modelli di ricevuta

Puoi utilizzare i file che carichi per personalizzare le ricevute. Se hai immagini personalizzate che desideri stampare sulle ricevute, puoi caricarle dal pannello di controllo di Shopify e poi utilizzarle sulle ricevute personalizzate. Maggiori informazioni sul caricamento dei file.

Passaggi:

  1. Dal pannello di controllo Shopify vai a Impostazioni > App e canali di vendita.

  2. Dalla pagina App e canali di vendita clicca su Point of sale.

  3. Clicca su Apri canale di vendita.

  4. Clicca su Impostazioni > Personalizzazione ricevuta.

  5. Clicca su Personalizza ricevute.

  6. Clicca su Pagina di contenuto.

  7. Copia il link accanto al file che desideri utilizzare nel modello di ricevuta.

  8. Includi il link nel modello.

Ripristino del modello di ricevuta alla versione predefinita

Puoi ripristinare la versione predefinita di un modello di ricevuta utilizzando l'editor di codice.

Passaggi:

  1. Dal pannello di controllo Shopify vai a Impostazioni > App e canali di vendita.

  2. Dalla pagina App e canali di vendita clicca su Point of sale.

  3. Clicca su Apri canale di vendita.

  4. Clicca su Impostazioni > Personalizzazione ricevuta.

  5. Clicca sul modello che desideri ripristinare.

  6. Clicca sull'icona di ripristino.

  7. Nella modale Ripristina il file alle impostazioni predefinite, clicca su Reimposta per confermare.

Variabili Liquid disponibili nell'editor di codice della ricevuta

Puoi utilizzare Liquid per personalizzare il modello della ricevuta stampata e i tipi di ricevuta.

Nell'editor di codice delle ricevute sono disponibili i seguenti oggetti dati:

Descrizione degli oggetti dati della ricevuta
OggettiDescrizione
shop
Contiene le informazioni del negozio, ad esempio il nome del negozio.
location
Contiene le informazioni del negozio fisico, ad esempio l'indirizzo e il numero di telefono.
order
Contiene i dati dell'ordine, comprese le voci, gli sconti, le imposte e i dati della transazione.
gift_card
Disponibile solo all'interno del modello gift_card.liquid. Contiene i dati del buono regalo, inclusi il saldo, il codice alfanumerico e il contenuto di un codice QR scansionabile dall'app POS.

Filtri Liquid disponibili nell'editor di codice della ricevuta

Puoi utilizzare i filtri Liquid per apportare rettifiche alle informazioni riportate nei modelli di ricevuta. Ad esempio, puoi modificare la formattazione della valuta o le maiuscole di un testo specifico, ad esempio un codice imposta.

Per applicare un filtro, aggiungi un carattere di detrazione| e poi il filtro all'interno del blocco di codice Liquid tra le doppie parentesi graffe {{ }}. I filtri possono essere applicati solo a blocchi di codice Liquid.

Nell'esempio seguente, il filtro trasforma le lettere del codice imposta da minuscole in maiuscole.

{{ tax_line.title | upcase }}

Nel blocco di codice di esempio, product è l'oggetto, title è la proprietà e upcase è il filtro applicato. Il filtro upcase rende maiuscole le lettere del valore di tax_line.title. Ad esempio, se tax_line.title ha un valore Hst, il filtro upcase modificherà il valore in HST.

Consulta la sezione filtri del riferimento Liquid dei temi Shopify per dettagli su come utilizzare i filtri Liquid.

Nell'editor di codice delle ricevute sono disponibili i seguenti filtri:

Descrizione dei filtri delle ricevute
ProprietàDescrizione
t
Traduce le etichette predefinite nella lingua assegnata alla tua sede.
money
Formatta il prezzo nella valuta della tua sede.
escape
Esegue l'escape dei caratteri speciali in HTML, ad esempio <>, ' e &, e converte i caratteri in sequenza di escape.
barcode
Genera un codice a barre 1D SVG.
qrcode
Genera un codice a barre 2D SVG.

Esempio di personalizzazione del codice di un modello di ricevuta stampata

Puoi utilizzare Liquid per aggiungere messaggi condizionali. Questa funzionalità è simile al salvataggio in un'unica sede con l'editor visuale. Ad esempio, la tua attività commerciale è iniziata con un'unica sede e ora hai diverse nuove sedi. Vuoi mettere in evidenza il negozio originale sulle ricevute stampate.

Puoi aggiungere un messaggio personalizzato al modello header.liquid nella cartella Sezioni dell'editor di codice e utilizzare Liquid per mostrare il messaggio solo per la sede del flagship store.

Il seguente codice controlla il nome della sede (in questo caso la sede originale chiamata "Home") e riporta il messaggio "Welcome to our original store, opened in 1972" (Benvenuti al nostro primo negozio, aperto nel 1972), se la sede corrisponde al nome. Le ricevute stampate dalle altre sedi invece riportano il messaggio "Welcome to our store" (Ti diamo il benvenuto nel nostro negozio). .

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}
Non trovi le risposte che stai cercando? Siamo qui per aiutarti.