Editor di codice delle ricevute stampate per Shopify POS

Puoi personalizzare le ricevute stampate utilizzando l'editor di codice nel pannello di controllo Shopify. I file che compongono le ricevute contengono Liquid, il linguaggio per modelli di Shopify. Con l'editor di codice puoi creare personalizzazioni più avanzate utilizzando HTML, CSS e Liquid rispetto a quanto consentito dall'editor visuale.

Puoi modificare il modello di ricevuta e i modelli di sezione utilizzati nelle ricevute stampate. I file modello delle Ricevute sono i tipi di ricevute che puoi stampare nel tuo negozio. Le Sezioni sono parti delle ricevute, come l'header o il footer. Le sezioni possono essere riutilizzate da più ricevute.

In questa pagina

Considerazioni sull'utilizzo dell'editor di codice delle ricevute

Prima di utilizzare l'editor di codice delle ricevute, esamina le seguenti considerazioni:

Restrizioni di accesso

Puoi utilizzare l'editor di codice solo dal pannello di controllo Shopify su desktop.
L’editor del codice non è disponibile per le sedi POS in Italia.

Dove si applicano le modifiche

Le modifiche al codice apportate si applicano solo alla sede selezionata.
Le personalizzazioni nell'editor di codice si applicano solo alle sedi POS Pro. Se utilizzi l'editor di codice e hai sedi non POS Pro, puoi usare l'editor visuale per personalizzare l'header e il footer di quelle sedi.
Puoi personalizzare le ricevute stampate che dispongono di un modello nell’editor del codice, come le ricevute di vendita, gli scontrini cortesia, le ricevute dei buoni regalo e le ricevute di resi e cambi.

Linguaggi di programmazione

I file che compongono le ricevute contengono Liquid, il linguaggio per modelli di Shopify. Scopri di più sull'utilizzo di Liquid.
Per modificare i modelli nell'editor di codice per le ricevute, è necessario avere familiarità con HTML, CSS e Liquid. L'assistenza per i temi di Shopify può aiutarti con piccole modifiche che rientrano nell'ambito della Politica di design di Shopify.

Limitazioni di personalizzazione

Non puoi visualizzare in anteprima le ricevute in base alle diverse dimensioni di stampa dall’editor del codice. Per visualizzare un’anteprima in base alle dimensioni della stampante, utilizza l’editor visivo.
Le descrizioni dei prodotti non sono disponibili come variabile nei modelli di ricevuta e non possono essere aggiunte alle ricevute stampate.

Manutenzione dei modelli

Se personalizzi una ricevuta con l’editor del codice della ricevuta, al modello esistente potrebbero mancare nuove proprietà, come selling_plan_name. Per aggiungere le proprietà più recenti disponibili al tuo modello, devi ripristinare il modello di ricevuta alle impostazioni predefinite. Ripristinando i modelli di ricevuta alle impostazioni predefinite, eventuali personalizzazioni apportate verranno rimosse. Prendi nota del tuo codice personalizzato prima di eseguire il ripristino. Dopo aver ripristinato il modello, devi riapplicare manualmente le tue personalizzazioni.

Accedi all’editor del codice

Puoi modificare i modelli utilizzando l'editor di codice. Devi prima passare all'utilizzo dell'editor di codice dall'editor visuale predefinito e puoi tornare in qualsiasi momento all'editor visuale.

I passaggi per passare da un editor all’altro variano leggermente a seconda che tutte le tue sedi POS siano idonee per l’editor del codice o lo siano solo in parte (ad esempio, alcune sedi POS non utilizzano POS Pro o si trovano in Italia o Francia).

Passaggi:

Tutte le sedi POS Pro

Dal pannello di controllo Shopify, vai su Punto vendita > Impostazioni.
Nella sezione Personalizzazione, clicca su Ricevute cartacee per aprire l'editor POS.
Clicca sull’icona nella barra laterale sinistra.
Clicca su Modifica codice.
Nella finestra di dialogo Modifica codice per le ricevute stampate, modifica il codice che desideri cambiare.
Clicca su Salva.
Facoltativo: per continuare a modificare altre pagine di Shopify POS utilizzando l’editor POS, torna indietro nella finestra del browser.

Con sedi Lite o in Italia

Dal pannello di controllo Shopify, vai su Punto vendita > Impostazioni.
Nella sezione Personalizzazione, clicca su Ricevute cartacee per aprire l'editor POS.
Nella pagina Personalizzazione ricevuta, clicca su Editor del codice.

Usa file personalizzati nel modello di ricevuta

Puoi utilizzare file, come risorse immagine, caricati nel pannello di controllo Shopify per personalizzare le ricevute stampate.

Un file deve essere caricato nel pannello di controllo Shopify prima di poter essere utilizzato in una ricevuta stampata. Scopri di più sul caricamento dei file.

Passaggi:

Dal pannello di controllo Shopify, vai su Contenuti > File.
Accanto al file che desideri includere nel codice della ricevuta stampata, clicca su per copiare il link.
Vai all'editor di codice.
Includi il link della risorsa nel modello.

Ripristina le impostazioni predefinite del modello di ricevuta

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

Passaggi:

Tutte le sedi POS Pro

Dal pannello di controllo Shopify, vai su Punto vendita > Impostazioni.
Nella sezione Personalizzazione, clicca su Ricevute cartacee per aprire l'editor POS.
Clicca su Personalizza ricevute.
Clicca su Modifica codice.
Clicca sul file di codice che desideri ripristinare.
Clicca sull’icona .
Nella finestra di dialogo Ripristina le impostazioni predefinite del file, clicca su Ripristina.

Con sedi Lite o in Italia

Dal pannello di controllo Shopify, vai su Punto vendita > Impostazioni.
Nella sezione Personalizzazione, clicca su Ricevute cartacee per aprire l'editor POS.
Nella pagina Personalizzazione ricevuta, clicca su Editor del codice.
Clicca sul file di codice che desideri ripristinare.
Clicca sull’icona .
Nella finestra di dialogo Ripristina le impostazioni predefinite del file, clicca su Ripristina.

Variabili Liquid disponibili nell’editor del codice delle ricevute

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

I seguenti oggetti di dati sono disponibili per l’editor del codice delle ricevute:

Oggetti ricevuta

Descrizione degli oggetti di dati della ricevuta
Oggetto	Descrizione
shop	Contiene le informazioni sul negozio, come il nome del negozio.
location	Contiene le informazioni sulla sede POS, come l’indirizzo e il numero di telefono.
order	Contiene i dati dell’ordine, incluse le voci, gli sconti, le imposte e le informazioni sulla transazione.
return	Disponibile solo all’interno del modello `return-and-exchange-receipt.liquid` e dei suoi modelli parziali associati. Contiene i dati del reso e del cambio, incluse le voci restituite, le nuove voci, il totale netto e le informazioni sulla 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 che può essere scansionato dall’app POS.

Oggetto ordine

Descrizione dell'oggetto ordine
Proprietà	Descrizione
id	ID dell’ordine.
created_at	La data e l'ora in formato ISO 8601 in cui è stato creato l'ordine.
source_identifier	Un identificatore univoco dell'ordine POS o di terze parti.
change_due	Resto dovuto per l’ordine.
balance_due	Importo dovuto per questo ordine.
name	L’identificatore univoco dell’ordine che appare nella pagina dell’ordine del pannello di controllo Shopify e nella pagina di stato dell'ordine. Ad esempio, “#1001”, “EN1001” o “1001-A”. Questo valore non è univoco tra più negozi.
note	Il contenuto della nota associata all’ordine.
line_items	Un elenco delle voci dell’ordine.
subtotal_price	La somma dei prezzi di tutte le voci al netto degli sconti e prima dei resi. Se `taxesIncluded` è true, il subtotale include anche le imposte.
total_price	Il prezzo totale dell’ordine, prima dei resi. Include imposte e sconti.
total_tip_received	La somma di tutti gli importi delle mance per l’ordine.
discounts	L’importo totale degli sconti.
transactions	Un elenco delle transazioni associate all’ordine.
taxes_included	Indica se le imposte sono incluse nel prezzo del subtotale dell’ordine.
tax_lines	Un elenco di tutte le righe di imposta applicate alle voci dell’ordine, prima dei resi. I prezzi delle righe di imposta rappresentano il prezzo totale per tutte le righe di imposta con la stessa aliquota e lo stesso titolo.
customer	Il cliente che ha effettuato l’ordine.
shipping_address	L’indirizzo di spedizione dell’ordine.
shipping_groups	L’elenco dei gruppi di spedizione dell’ordine. Ogni gruppo contiene le voci che vengono evase insieme.

Oggetto reso

Descrizione dell’oggetto reso
Proprietà	Descrizione
name	L’identificatore univoco del reso che appare nella pagina dell’ordine del pannello di controllo Shopify e nella pagina di stato dell'ordine. Ad esempio, “#1000-R1”. Questo valore non è univoco tra più negozi.
created_at	La data e l’ora di creazione del reso in formato ISO 8601.
is_unverified	Un valore booleano che indica se il reso è stato creato come Reso non verificato.
is_exchange	Un valore booleano che indica se il reso include un cambio. Sono inclusi i rimborsi effettuati su un buono regalo.
exchange_type	Il tipo di cambio, se il reso include un cambio. I valori possibili sono `LIKE_FOR_LIKE`, `NET_REFUNDABLE` e `NET_PAYABLE`.
return_discount	L’importo totale degli sconti sull’ordine che sono stati rimborsati.
return_subtotal	La somma dei prezzi di tutte le voci di reso prima degli sconti. Se `taxesIncluded` è true, il subtotale include anche le imposte.
return_total	L’importo totale del rimborso possibile. Include imposte, sconti, spedizione e mance. Potrebbe non corrispondere all’importo effettivo rimborsato.
exchange_subtotal	La somma dei prezzi di tutte le nuove voci del cambio prima degli sconti. Se `taxesIncluded` è true, il subtotale include anche le imposte.
exchange_total	L’importo totale di tutte le nuove voci del cambio. Include imposte e sconti.
total_cash_rounding_adjustment	La rettifica di arrotondamento contante applicata al reso o al cambio.
total_adjusted_amount	L’importo totale per il reso o il cambio, rettificato in base all’arrotondamento contante.
net_total	L’importo totale effettivo pagato o rimborsato per il reso o il cambio e prima dell’arrotondamento contante.
return_line_items	Le voci restituite.
exchange_line_items	Le nuove voci nel cambio.
return_tax_lines	Le righe di imposta per le voci restituite.
exchange_tax_lines	Le righe di imposta per le nuove voci del cambio.
shipping_refund_amount	L’importo della spedizione rimborsato.
tip_refund_amount	L’importo della mancia rimborsato.
transactions	Le transazioni associate al reso o al cambio.

Oggetto gruppo di spedizione

Descrizione dell’oggetto gruppo di spedizione
Proprietà	Descrizione
destination	Destinazione dei prodotti in spedizione.
products	Un elenco dei prodotti in spedizione.

Oggetto voce

Descrizione dell’oggetto voce
Proprietà	Descrizione
id	L’ID della voce.
name	Il titolo del prodotto, a cui può essere aggiunto il titolo della variante (se applicabile).
variant_title	Il titolo della variante al momento della creazione dell’ordine.
price	Il prezzo unitario della voce al momento della creazione dell’ordine. Questo valore non include gli sconti.
is_gift_card	Indica se la voce rappresenta l’acquisto di un buono regalo.
discount	Lo sconto totale assegnato alla voce dalle applicazioni di sconto, compresi gli sconti assegnati alle quantità rimborsate e rimosse.
total_price	Il totale per questa voce.
selling_plan_name	Il nome del piano di abbonamento assegnato alla voce.
tax_rates	Le righe di imposta per questa voce.
custom_attributes	Un elenco di attributi che rappresentano funzionalità personalizzate o richieste speciali.
variant_title	Il titolo della variante.
variant_id	L’ID della variante.
variant_metafields	Un elenco di campi personalizzati che un merchant ha associato alla variante.
staff_member_description	Membro dello staff attribuito alla voce.
product_metafields	Un elenco di campi personalizzati che un merchant ha associato al prodotto.

Oggetto voce di reso

Include tutto ciò che è presente nell'oggetto voce più le seguenti proprietà:

Descrizione dell’oggetto voce
Proprietà	Descrizione
return_reason	Il motivo del reso per la voce.
return_reason_note	Una nota facoltativa da aggiungere al motivo del reso.

Filtri Liquid disponibili nell’editor di codice della ricevuta

Puoi utilizzare i filtri Liquid per apportare modifiche alle informazioni nei modelli di ricevuta. Ad esempio, puoi modificare la formattazione della valuta o l’uso delle maiuscole per un testo specifico, come un codice imposta.

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

Nell’esempio seguente, il filtro modifica il codice imposta da minuscolo a maiuscolo.

{{ tax_line.title | upcase }}

Nel blocco di codice di esempio, product è l’oggetto, title è la sua proprietà e upcase è il filtro applicato. Il filtro upcase cambia il valore di tax_line.title in maiuscolo. Ad esempio, se tax_line.title ha un valore di Hst, il filtro upcase lo modificherà in HST.

Consulta la sezione Filtri della documentazione di riferimento di Liquid per i temi di Shopify per maggiori dettagli su come utilizzare i filtri Liquid.

I seguenti filtri sono disponibili nell'editor del codice della ricevuta:

Descrizione dei filtri per le 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, come `<>`, `'` e `&`, e li converte in sequenze di escape.
barcode	Genera un codice a barre 1D in formato SVG.
qrcode	Genera un codice a barre 2D in formato SVG.

Esempio di personalizzazione del codice del modello di ricevuta stampata

Puoi usare Liquid per aggiungere messaggi condizionali. Questa funzionalità è simile al salvataggio per una singola sede con l'editor visuale. Ad esempio, la tua attività è iniziata con una singola sede e ora ne hai diverse nuove. Desideri evidenziare il tuo negozio originale sulle ricevute stampate.

Puoi aggiungere un messaggio personalizzato al modello header.liquid nella cartella Sezioni dell’editor del codice e utilizzare Liquid per mostrare il messaggio solo per la tua sede principale.

Il seguente codice controlla il nome della sede, in questo caso la tua sede originale chiamata “Home”, e mostra il messaggio «Benvenuto nel nostro negozio originale, aperto nel 1972.» se la sede corrisponde al nome. Le ricevute stampate dalle altre sedi mostrano invece il messaggio «Benvenuto nel nostro negozio.».

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Anteprima delle modifiche al codice nell'editor

Puoi visualizzare in anteprima le modifiche alle ricevute stampate nell’editor di codice POS nel pannello di controllo Shopify.

A seconda del file Liquid selezionato, la finestra di anteprima evidenzia il design o la sezione della ricevuta interessata dal file. Per impostazione predefinita, la finestra di anteprima mostra il contenuto del tuo ordine POS più recente. Puoi selezionare un ordine specifico da utilizzare come contenuto della ricevuta nella finestra di anteprima per tutti i file Liquid, ad eccezione del file gift-card.liquid, che mostra solo le diverse sedi come opzioni di anteprima selezionabili.

Passaggi:

Tutte le sedi POS Pro

Dal pannello di controllo Shopify, vai su Punto vendita > Impostazioni.
Nella sezione Personalizzazione, clicca su Ricevute cartacee per aprire l'editor POS.
Clicca su Personalizza ricevute.
Clicca su Modifica codice.
Clicca sul file di codice di cui desideri visualizzare l'anteprima. La ricevuta verrà visualizzata nella finestra dell'editor più a destra.
Facoltativo: per selezionare un ordine specifico da utilizzare come contenuto della ricevuta nella finestra di anteprima, esegui le seguenti azioni:
1. Clicca sull'icona .
2. Le vendite effettuate dal canale POS da tutte le sedi vengono visualizzate nella finestra di dialogo Scegli l'ordine da visualizzare in anteprima. Seleziona un ordine dall'elenco o cerca ordini e sedi specifici utilizzando la barra di ricerca.
3. Clicca su Conferma.
Facoltativo: se visualizzi in anteprima il file gift-card.liquid, clicca sull'icona e seleziona la sede di cui desideri visualizzare l'anteprima del modello.

Con sedi Lite o in Italia

Dal pannello di controllo Shopify, vai su Punto vendita > Impostazioni.
Nella sezione Personalizzazione, clicca su Ricevute cartacee per aprire l'editor POS.
Nella pagina Personalizzazione ricevuta, clicca su Editor del codice.
Clicca sul file di codice di cui desideri visualizzare l'anteprima. La ricevuta verrà visualizzata nella finestra dell'editor più a destra.
Facoltativo: per selezionare un ordine specifico da utilizzare come contenuto della ricevuta nella finestra di anteprima, esegui le seguenti azioni:
1. Clicca sull'icona .
2. Le vendite effettuate dal canale POS da tutte le sedi vengono visualizzate nella finestra di dialogo Scegli l'ordine da visualizzare in anteprima. Seleziona un ordine dall'elenco o cerca ordini e sedi specifici utilizzando la barra di ricerca.
3. Clicca su Conferma.
Facoltativo: se visualizzi in anteprima il file gift-card.liquid, clicca sull'icona e seleziona la sede di cui desideri visualizzare l'anteprima del modello.