Riferimento variabili di notifica
Le notifiche inviate dal tuo negozio vengono visualizzate utilizzando Liquid. Liquid è il linguaggio di programmazione di Shopify semplice e facile da utilizzare. Si tratta dello stesso linguaggio di programmazione con cui sono costruiti i temi del Theme Store.
Per modificare le notifiche che vengono inviate dal tuo negozio, puoi realizzare delle personalizzazioni di base ai modelli di email per le notifiche.
Per ottenere assistenza riguardo alle modifiche più avanzate o per apportare modifiche ai modelli per le notifiche personalizzati, puoi contattare la community sui nostri forum oppure rivolgerti a un Esperto Shopify perché si occupi delle tue personalizzazioni.
Ecco un elenco di modelli di notifica Liquid che puoi personalizzare dal pannello di controllo Shopify:
- Check-out abbandonato
- Contatta il cliente
- Invito di creazione account cliente
- Benvenuto di creazione account cliente
- Ripristino password dell'account cliente
- Fattura per proposta d'ordine
- Richiesta di evasione
- Buono regalo creato
- Nuovo ordine
- Nuovo ordine (mobile)
- Fattura ordine
- Ordine cancellato
- Conferma dell'ordine
- Ricevuta POS e mobile
- Rimborso dell'ordine
- Conferma di spedizione
- Aggiornamento di spedizione
Tutti i modelli nel pannello di controllo Shopify hanno accesso alle proprietà dell'ordine corrispondente.
Proprietà ordine
Molte proprietà di un ordine sono disponibili direttamente utilizzando Liquid nei modelli email e negli script aggiuntivi.
Le proprietà di un ordine sono disponibili nei seguenti modelli email:
- Conferma dell'ordine
- Nuovo ordine
- Nuovo ordine (mobile)
- Fattura ordine
- Conferma di spedizione
- Aggiornamento di spedizione
- Script aggiuntivi
- Richiesta di evasione
| Proprietà | Descrizione |
|---|---|
id |
Un ID dell'ordine univoco nel sistema, per uso interno. Utilizza l'esempio seguente per generare un link all'ordine nella sezione del pannello di controllo del tuo negozio. Ad esempio, nel modello di email Nuovo ordine puoi aggiungere il codice seguente: <a href="{{ shop.url }}/admin/orders/{{ id }}">Visualizza ordine</a>
|
| L'email associata all'ordine. | |
name |
Normalmente è formato dal simbolo del cancelletto seguito da Esempio: #1004 |
order_name |
Lo stesso del nome. |
order_number |
Numero univoco del negozio per l'ordine, senza il simbolo del cancelletto # come prefisso o qualsiasi altro prefisso o suffisso aggiunto all'ID ordine dal proprietario del negozio nelle preferenze del negozio. Esempio: 1004 |
created_at |
La data e l'ora in cui il cliente ha creato l'ordine. La formattazione può essere effettuata utilizzando il filtro della data. Esempio: 2009-05-30T17:43:51+02:00 |
payment_terms |
I termini di pagamento specificano la data di scadenza del pagamento di un ordine. Scopri come aggiungere termini di pagamento alle fatture per gli ordini. Per maggiori informazioni, consulta il riferimento Liquid payment_terms. |
| tags | Restituisce una serie di tutti i tag dell'ordine. I tag vengono elencati in ordine alfabetico. Consulta la nostra documentazione di riferimento su Liquid per ulteriori dettagli. |
| transactions | Restituisce una serie di transazioni dell'ordine. |
tax_price |
Le imposte complessive di tutti gli articoli nell'ordine. |
tax_lines |
Le imposte suddivise per tipo di tassazione: |
tax_line.title |
Il nome dell'imposta. Esempi: QST o IVA |
tax_line.price |
L'importo. |
tax_line.rate |
L'aliquota. Sarà equivalente a 0,175 se è pari al 17,5%. |
tax_line.rate_percentage |
L'aliquota fiscale in formato leggibile. Sarà equivalente a 17,5 se l'aliquota è pari a 0,175. |
customer |
Oggetto cliente contenente gli attributi dell'output del cliente. |
billing_address |
L'indirizzo di fatturazione. |
billing_address.first_name |
Il nome del cliente. |
billing_address.last_name |
Il cognome del cliente. |
billing_address.company |
Il nome dell'azienda per la fatturazione. |
billing_address.phone |
Il numero di telefono indicato nell'indirizzo di fatturazione. |
shop.name |
Il nome del tuo negozio. |
shop.phone |
Il numero di telefono del tuo negozio. |
subtotal_price |
La somma dei prezzi degli articoli dell'ordine dopo la detrazione di eventuali sconti su articoli o sul carrello. Il subtotale non include le imposte (salvo che le imposte non siano incluse nei prezzi), i costi di spedizione o le mance. |
discounts |
Un elenco degli sconti. |
discounts_amount |
L'importo dello sconto applicato da tutti gli sconti. Esempio: + 5,00 $ |
discounts_savings |
L'importo dei risparmi derivanti da tutti gli sconti. Esempio: -5,00 $ |
total_price |
Il totale dell'ordine (subtotale + costi di spedizione - sconto di spedizione + imposte). |
financial_status |
Lo stato attuale del pagamento. Può essere nil, pending, authorized, paid, voided, refunded. |
requires_shipping |
(booleano) Restituisce TRUE se c'è almeno un articolo nell'ordine che richiede la spedizione. |
shipping_method.title |
Il nome della tariffa di spedizione. Esempio: spedizione standard |
shipping_method.price |
Il prezzo di spedizione comprensivo di eventuali sconti di spedizione. Esempio: |
shipping_price |
Il prezzo di spedizione. Esempio: |
shipping_address |
L'indirizzo di spedizione. |
shipping_address.first_name |
Il nome per l'indirizzo di spedizione. |
shipping_address.company |
Il nome dell'azienda per l'indirizzo di spedizione. |
shipping_address.phone |
Numero di telefono indicato nell'indirizzo di fatturazione. |
line_items |
L'elenco di tutti gli Articoli nell'ordine. |
item_count |
Una somma di tutte le quantità degli articoli. |
fulfillment_status |
L'attuale stato di evasione. Può essere: inevaso, parzialmente evaso, evaso. |
note |
La nota allegata all'ordine. La nota può essere inviata dal cliente e/o modificata nella schermata con i dettagli dell'ordine all'interno dell'interfaccia del tuo pannello di controllo. |
attributes |
Ogni attributo che è stato allegato all'ordine. Esempio: |
referring_site |
Contiene l'URL del referrer che ha portato il cliente al tuo negozio. Esempio: |
landing_site |
Contiene il percorso del landing site utilizzato dal cliente. Si tratta della prima pagina che il cliente ha visto una volta arrivato sul tuo negozio. Esempio: |
landing_site_ref |
Controlla il landing site e ne estrae un parametro di riferimento. I parametri di riferimento possono essere: Se il {% if landing_site_ref == 'my-tracking-token' %} La mia azione... {% endif %}
|
cancelled |
(booleano) Restituisce TRUE se l'ordine è stato annullato. |
cancelled_at |
L'ora in cui l'ordine è stato annullato. |
cancel_reason |
Il motivo selezionato al momento dell'annullamento dell'ordine. Può essere inventory, customer, declined, fraud o other. |
has_high_risks? |
Restituisce TRUE se l'ordine ha un rischio elevato. |
translate="no"unique_gateways |
Fornisce un elenco di gestori univoci dei pagamenti per un ordine. Ad esempio, se qualcuno pagasse con una carta VISA, una Mastercard e in contanti, l'elenco restituito sarebbe |
location (POS only) |
Mostra la sede fisica dell'ordine. Esistono diverse proprietà di sedi disponibili elencate qui. Puoi configurare le sedi nell'area Sedi del pannello di controllo. |
order_status_url |
Fornisce il link alla pagina di stato dell'ordine relativa a questo ordine. |
|
L'elenco degli Articoli che sono stati evasi. |
|
L'elenco delle Voci che non sono state completamente evase. |
Proprietà degli ordini preliminari
Le proprietà degli ordini preliminari sono disponibili sul modello di email Fattura Ordine Preliminare, che avvisa i tuoi clienti in merito alle fatture in sospeso.
| Proprietà | Descrizione |
|---|---|
id |
Un ID univoco dell'ordine preliminare per uso interno. |
invoice_url |
Un link che il cliente può seguire per pagare la fattura utilizzando il check-out sicuro di Shopify. |
reserve_inventory_until |
La data e l'ora fino a quando le voci presenti nell'ordine preliminare sono prenotate, ad esempio Puoi formattare le date utilizzando il filtro della data Liquid. |
user |
L'ultimo membro dello staff che ha modificato l'ordine preliminare. |
user.name |
Il nome dell'ultimo membro dello staff che ha modificato l'ordine preliminare. |
user.email |
L'indirizzo email dell'ultimo membro dello staff che ha modificato l'ordine preliminare. |
| L'indirizzo email associato all'ordine preliminare. | |
name |
Valore number univoco dell'ordine preliminare, con un cancelletto # come prefisso. |
number |
Il numero univoco dell'ordine preliminare senza il prefisso o suffisso dell'ordine. |
created_at |
La data e l'ora in cui il cliente ha creato l'ordine preliminare, ad esempio, Puoi formattare le date utilizzando il filtro della data Liquid. |
| tags | Restituisce una serie di tutti i tag dell'ordine. I tag vengono elencati in ordine alfabetico. Consulta la nostra documentazione di riferimento su Liquid per ulteriori dettagli. |
tax_price |
Le imposte complessive di tutti gli articoli nell'ordine preliminare. |
tax_lines |
Le imposte suddivise per tipo di imposta: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
|
tax_line.title |
Il nome dell'imposta. Esempi: QST o IVA |
tax_line.price |
L'importo dell'imposta. |
tax_line.rate |
L'aliquota fiscale in formato decimale. Ad esempio, un'aliquota fiscale del 17,5% risulterà 0,175. |
tax_line.rate_percentage |
L'aliquota fiscale in formato percentuale. Ad esempio, un'aliquota dello 0,175 risulterà 17,5. |
customer |
Oggetto cliente contenente gli attributi dell'output del cliente. |
billing_address |
L'indirizzo di fatturazione per l'ordine preliminare. |
billing_address.first_name |
Il nome del cliente. |
billing_address.last_name |
Il cognome del cliente. |
billing_address.company |
Il nome dell'azienda indicato nell'indirizzo di fatturazione. |
billing_address.phone |
Il numero di telefono indicato nell'indirizzo di fatturazione. |
shop.name |
Il nome del tuo negozio. |
shop.phone |
Il numero di telefono del tuo negozio. |
subtotal_price |
La somma dei prezzi degli articoli dell'ordine preliminare dopo la detrazione di eventuali sconti su articoli o sul carrello. Il subtotale non include le imposte (salvo che le imposte non siano incluse nei prezzi) o i costi di spedizione. |
discounts |
Un elenco degli sconti. |
discounts_amount |
L'importo dello sconto applicato per tutti gli sconti. Esempio: + 5,00 $ |
discounts_savings |
L'importo dei risparmi derivante da tutti gli sconti applicati. Esempio: -5,00 $ |
total_price |
Il prezzo totale dell'ordine (subtotale + costo di spedizione - sconto di spedizione + imposte). |
requires_shipping |
Restituisce true se nell'ordine preliminare c'è almeno un articolo che richiede la spedizione. Restituisce false se nell'ordine preliminare non ci sono articoli che richiedono la spedizione. |
shipping_method.title |
Il nome della tariffa di spedizione. Esempio: spedizione standard |
shipping_method.price |
Il prezzo del metodo di spedizione. Restituisce le stesse informazioni di shipping_price. |
shipping_price |
Il prezzo di spedizione. Puoi formattare questo importo utilizzando i filtri dell'importo Liquid. |
shipping_address |
Nota: a differenza degli ordini standard, l'indirizzo di spedizione di un ordine preliminare può essere incompleto. |
shipping_address.first_name |
Il nome per l'indirizzo di spedizione. |
shipping_address.company |
Il nome dell'azienda indicato nell'indirizzo di spedizione. |
shipping_address.phone |
Il numero di telefono indicato nell'indirizzo di spedizione. |
line_items |
Un elenco di tutti gli articoli nell'ordine preliminare. |
item_count |
Una somma di tutte le quantità degli articoli nell'ordine preliminare. |
note |
La nota allegata all'ordine preliminare. La nota può essere inviata al cliente e anche modificata nella schermata con i dettagli dell'ordine preliminare all'interno del tuo pannello di controllo Shopify. |
location |
La posizione fisica dell'ordine. Esistono diverse proprietà di posizione disponibili. Puoi configurare le sedi nella pagina Sedi del tuo pannello di controllo Shopify. |
proprietà voce
Ogni line nell'elenco line_items o subtotal_line_items ha le seguenti proprietà.
| Proprietà | Descrizione |
|---|---|
|
Elenco degli sconti applicati a questo articolo (ciascuno sconto ha le proprietà: titolo, codice, importo, risparmio e tipo). |
|
(booleano) Restituisce VERO se la voce è personalizzata per un ordine preliminare. |
line.grams |
Il peso di un singolo articolo. |
line.image |
Restituisce l'URL dell'immagine associata a questa voce. È possibile utilizzare anche il filtro img_url per ottenere dimensioni di immagine specifiche, per esempio {{ line.image | img_url: 'small' }}
|
line.line_price |
Il prezzo moltiplicato per la quantità di quell'articolo. |
line.original_line_price |
Il prezzo complessivo della quantità di articoli inclusi nella voce, prima dell'applicazione degli sconti. |
line.final_line_price |
Il prezzo complessivo di tutti gli articoli nella voce, inclusi tutti gli importi degli sconti per voce. |
line.price |
Il prezzo di un singolo articolo. |
line.product.metafields |
I metafield a livello di prodotto. Utilizza la sintassi seguente: line.product.metafields.NAMESPACE.KEY |
line.product.title |
Nome del prodotto |
line.product.vendor |
Il fornitore dell'articolo. |
line.properties |
Restituisce una serie di informazioni personalizzate su una voce. Le proprietà delle voci vengono specificate dal cliente sulla pagina del prodotto, prima di aggiungere un prodotto al carrello. |
line.quantity |
La quantità di quell'articolo. |
line.requires_shipping |
(booleano) Restituisce true se la variante dell'articolo ha la casella di spunta Questo è un prodotto fisico selezionata nella pagina del prodotto. |
line.selling_plan_allocation |
Restituisce un oggetto selling_plan_allocation, che descrive le modalità con cui un piano di vendita, ad esempio un abbonamento, influisce sulla voce. |
line.taxable |
(booleano) Restituisce VERO se la variante di quell'articolo ha la casella di spunta "Applica imposte su questo prodotto" selezionata sulla pagina del prodotto. |
line.title |
Il nome del prodotto seguito da un trattino seguito dal nome della variante. Il nome della variante non è compreso quando si tratta di un "Titolo predefinito". |
line.url |
L'URL relativo della variante della voce. L'URL relativo non include l'URL root del negozio (mystore.myshopify.com). |
line.line_item.variant.barcode |
Codice a barre associato alla variante di prodotto. |
line.variant.compare_at_price |
Il prezzo di confronto associato alla variante di prodotto. |
line.variant.image |
L'immagine della variante di prodotto. Restituisce un'immagine solo se c'è un'immagine specifica assegnata alla variante nella voce. |
line.variant.metafields |
I metafield a livello di variante. Utilizza la sintassi seguente: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku |
La SKU associata alla variante di prodotto. |
line.variant.title |
I valori opzione della variante, uniti dai caratteri Esempio: small/red |
Proprietà "Rimborsi"
Queste proprietà aggiuntive sono disponibili sul modello di email Rimborsi. Questo modello di email è utilizzato per informare i tuoi clienti in merito a un rimborso (completo o parziale) che è stato applicato al loro ordine. Puoi utilizzare qualsiasi variabile disponibile per il modello di notifica email dell'ordine, in aggiunta alle seguenti variabili:
| Proprietà | Descrizione |
|---|---|
amount |
L'importo di denaro rimborsato. |
refund_line_items |
Un elenco di voci di rimborso da rimborsare. |
Proprietà "refund_line_item"
Ogni refund_line nell'elenco refund_line_items ha le seguenti proprietà:
| Proprietà | Descrizione |
|---|---|
refund_line.line_item |
L'articolo che è in fase di rimborso. Questo ha accesso a tutte le proprietà del line_item. |
refund_line.quantity |
La quantità della voce da rimborsare. |
Proprietà "Evasione"
Queste proprietà aggiuntive sono disponibili sui modelli di email Conferma di spedizione, Aggiornamento sulla spedizione e Richiesta di evasione.
La Conferma di spedizione e l'Aggiornamento sulla spedizione sono utilizzati per comunicare ai tuoi clienti che alcuni o tutti gli articoli riportati nel loro ordine, sono stati evasi correttamente o aggiornati con le nuove informazioni sulla spedizione.
Il modello di email Richiesta di evasione è utilizzato per ogni servizio logistico personalizzato definito all'interno del pannello di controllo del negozio. Per aggiungere un servizio logistico personalizzato, vai a Impostazioni > Spedizione e scorri verso il basso fino a Fulfillment/Dropshipping (Evasione ordini/Dropshipping).
| Proprietà | Descrizione |
|---|---|
service_name |
Il nome del servizio personalizzato così come definito in Impostazioni > Pagina di spedizione . (Solo richiesta di evasione) |
fulfillment.estimated_delivery_at |
Una data di consegna prevista in base al numero di tracking (se disponibile) fornito da uno dei seguenti corrieri: USPS, FedEx, UPS, Canada Post (solo in Canada). Questa proprietà è disponibile esclusivamente quando sono in uso le tariffe calcolate dal corriere. |
fulfillment.fulfillment_line_items |
Un elenco delle voci di evasione da evadere. |
fulfillment.item_count |
Una somma di tutte le quantità degli articoli. Il numero totale di articoli in fase di evasione. |
fulfillment.requires_shipping |
(booleano) Restituisce VERO se questa richiesta di evasione necessita della spedizione. |
fulfillment.tracking_company |
La società che effettua il tracking. |
fulfillment.tracking_numbers |
Un elenco dei numeri di tracking. |
fulfillment.tracking_urls |
Un elenco degli URL di tracking. |
|
L'elenco delle voci che devono essere evase da questo specifico servizio logistico personalizzato. (Solo richiesta di evasione) |
|
Il numero totale di articoli da evadere secondo questa richiesta. (Solo richiesta di evasione) |
Proprietà "fulfillment_line_item"
Ogni fulfillment_line nell'elenco fulfillment_line_items ha le proprietà seguenti.
| Proprietà | Descrizione |
|---|---|
fulfillment_line.line_item |
Il line_item in fase di evasione. Questo ha accesso a tutte le proprietà del line_item. |
fulfillment_line.quantity |
La quantità della voce che è in fase di evasione. |
Proprietà "Consegna"
| Proprietà | Descrizione |
|---|---|
delivery_instructions |
Informazioni sulla consegna locale da condividere con il cliente. Queste informazioni sono controllate tramite il campo Informazioni sulla consegna all'interno delle impostazioni di consegna locale. |
Proprietà "Sconto"
Esistono due tipi di proprietà "sconto".
discount_applications descrive il motivo per cui un articolo è stato scontato e con quali modalità.
discount_allocations descrive il modo in cui un determinato sconto influisce su una voce e ne riduce il prezzo. Utilizza questa proprietà a livello della voce.
Puoi combinare le due proprietà per mostrare informazioni sugli sconti a livello della voce o dell'ordine.
Esempio
Questo esempio verifica se è stato applicato uno sconto alla voce. Se lo sconto non è stato applicato a livello dell'ordine (all), verranno visualizzati il nome e l'importo dello sconto.
{% if line.discount_allocations %}
{% for discount_allocation in line.discount_allocations %}
{% if discount_allocation.discount_application.target_selection != 'all' %}
{{ discount_allocation.discount_application.title | upcase }}
(-{{ discount_allocation.amount | money }})
{% endif %}
{% endfor %}
{% endif %}Il risultato potrebbe essere simile a questo:
SPRING5 (-$5.00)Proprietà "discount_allocation"
Ogni discount_allocation nell'elenco discount_allocations ha le proprietà seguenti.
| Proprietà | Descrizione |
|---|---|
discount_allocation.amount |
L'importo di denaro risparmiato dal cliente su una voce. Per autorizzare più codici sconto l'importo deve essere inserito in un ciclo. |
discount_allocation.discount_application |
L'applicazione di sconto che assegna l'importo alla voce. |
Proprietà discount_application
Ogni discount_application nell'elenco discount_applications ha le proprietà seguenti.
| Proprietà | Descrizione |
|---|---|
discount_application.target_selection |
Descrive le modalità con cui uno sconto seleziona le voci da scontare nel carrello. Può essere:
|
discount_application.target_type |
Il tipo di articolo a cui si applica uno sconto (line_item o shipping_line). |
discount_application.title |
Il nome dello sconto mostrato ai clienti. Esempi: Welcome10 o CBBWQQAKYBYY |
discount_application.total_allocated_amount |
L'importo totale dedotto dal prezzo di un ordine tramite sconto. |
discount_application.type |
Il tipo di sconto. Può essere automatic, discount_code, manual o script. |
discount_application.value |
Il valore dello sconto. |
discount_application.value_type |
Il tipo di valore dello sconto. Può essere fixed_amount o percentage. |
Proprietà "notifiche via email"
| Proprietà | Descrizione |
|---|---|
shop.email_logo_url |
L'URL del logo specificato nella sezione Personalizza modelli di email del pannello di controllo. |
shop.email_logo_width |
La larghezza del logo (pixel) specificato nella sezione Personalizza modelli di email del pannello di controllo. |
shop.email_accent_color |
Il codice HEX per il colore in risalto specificato nella sezione Personalizza modelli di email del pannello di controllo. |