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 notifica. Per accedere all'elenco completo delle notifiche che puoi personalizzare, vai alla pagina Notifiche nel pannello di controllo Shopify.

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 Partner di Shopify perché si occupi delle tue personalizzazioni. Scopri di più su come contattare un Partner di Shopify.

Nota

Tutti i modelli nel pannello di controllo Shopify hanno accesso alle proprietà dell'ordine corrispondente. Tutte le variabili sono disponibili per l'utilizzo in qualsiasi modello di notifica, ma alcune variabili potrebbero non essere applicabili se i dati non sono ancora disponibili quando viene inviata la notifica.

Proprietà dell'ordine

Molte proprietà di un ordine sono disponibili direttamente utilizzando Liquid nei modelli email e negli script aggiuntivi.

Nota

L'oggetto "ordine" non viene indicato per nome nei modelli di email. Ad esempio, invece di utilizzare {{ order.shipping_method.title }} nel modello di email di conferma dell'ordine, devi utilizzare {{ shipping_method.title }}. Tuttavia, per le notifiche via SMS le proprietà dell'ordine devono essere come sempre precedute da order.

Descrizione delle proprietà dell'ordine

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>
email	L'email associata all'ordine.
name	Normalmente è formato dal simbolo del cancelletto seguito da order_number. 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
confirmation_number	Un identificatore alfanumerico generato in modo casuale per l'ordine che potrebbe essere mostrato al cliente al posto del nome dell'ordine sequenziale. Non è garantito che questo valore sia univoco. Esempio: XPAV284CT
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.
destination	La destinazione in cui devono essere inviati gli articoli.
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: {% 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.
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. Nelle notifiche destinate all'acquirente, la tariffa di spedizione viene tradotta nella lingua in cui l'acquirente ha effettuato il check-out, quando è diversa dalla lingua predefinita del negozio. Esempio: spedizione standard
shipping_method.price	Il prezzo di spedizione comprensivo di eventuali sconti di spedizione. Esempio: {{ shipping_method.price | money }}
shipping_price	Il prezzo di spedizione. Esempio: {{ shipping_price | money }}
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: {{ attributes.gift-note }}
referring_site	Contiene l'URL del referrer che ha portato il cliente al tuo negozio. Esempio: https://www.google.com/?s=great+products
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: /products/great-product?ref=my-tracking-token
landing_site_ref	Controlla il landing site e ne estrae un parametro di riferimento. I parametri di riferimento possono essere: ref, source, r. Se il landing_site fosse /products/great-product?ref=my-tracking-token, allora il landing_site_ref sarebbe my-tracking-token. È possibile compiere una determinata azione se il tuo ref è uguale a un certo valore: {% 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? (deprecated)	Restituisce TRUE se l'ordine ha un rischio elevato.
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 shopify_payments, cash.
location (POS only)	Mostra la sede fisica dell'ordine. Esistono diverse proprietà di sedi disponibili qui elencate. 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.
fulfilled_line_items (deprecated)	L'elenco degli Articoli che sono stati evasi.
unfulfilled_line_items (deprecated)	L'elenco delle Voci che non sono state completamente evase.
b2b?	Restituisce TRUE se l'ordine è un ordine B2B. Utilizza la proprietà con le variabili B2B per mostrare informazioni rilevanti nelle email, come il nome, la sede e l'indirizzo dell'azienda. Ad esempio, negli ordini B2B puoi aggiungere un header a un modello con le seguenti informazioni: {% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company	L'azienda a cui stai vendendo in un ordine B2B.
company.name	Il nome dell'azienda in un ordine B2B.
company.id	L'ID dell'azienda in un ordine B2B.
company_location	La sede dell'azienda in un ordine B2B. Un'azienda che acquista da te può avere più di una sede.
company_location.name	Il nome della sede dell'azienda su un ordine B2B.
company_location.id	Il numero ID della sede dell'azienda in un ordine B2B.
company_location.shipping_address	L'indirizzo di spedizione della sede dell'azienda in un ordine B2B.
company_location.billing_address	L'indirizzo di fatturazione della sede dell'azienda in un ordine B2B.
customer_order_url	La nuova pagina dei dettagli dell'ordine di un ordine per il quale il cliente ha richiesto il reso, utilizzando i nuovi account cliente.

Proprietà delle bozze di ordini

Nota

Non puoi inviare notifiche di bozza di ordine utilizzando gli SMS.

Descrizione delle proprietà delle bozze di ordini

Proprietà	Descrizione
id	Un ID univoco della bozza di ordine 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'bozza di ordine sono prenotate, ad esempio 2015-05-30T17:43:51+02:00. Puoi formattare le date utilizzando il filtro della data Liquid.
user	L'ultimo membro dello staff che ha modificato la bozza di ordine.
user.name	Il nome dell'ultimo membro dello staff che ha modificato la bozza di ordine.
user.email	L'indirizzo email dell'ultimo membro dello staff che ha modificato la bozza di ordine.
email	L'indirizzo email associato alla bozza di ordine.
name	Valore number univoco della bozza di ordine, con un cancelletto # come prefisso.
number	Il numero univoco della bozza di ordine senza il prefisso o suffisso dell'ordine.
created_at	La data e l'ora in cui il cliente ha creato l'bozza di ordine, ad esempio, 2009-05-30T17:43:51+02:00. 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 nella bozza di ordine.
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 la bozza di ordine.
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'bozza di 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) 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	L'indirizzo di spedizione. Nota: A differenza degli ordini standard, l'indirizzo di spedizione di una bozza di ordine potrebbe 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 nella bozza di ordine.
item_count	Una somma di tutte le quantità degli articoli nella bozza di ordine.
note	La nota allegata alla bozza di ordine. La nota può essere inviata al cliente e anche modificata nella schermata con i dettagli della bozza di ordine 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.
b2b?	Restituisce TRUE se l'ordine è un ordine B2B. Utilizza la proprietà con le variabili B2B per mostrare informazioni rilevanti nelle email, come il nome, la sede e l'indirizzo dell'azienda. Ad esempio, negli ordini B2B puoi aggiungere un header a un modello con le seguenti informazioni: {% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif %}
company	L'azienda a cui stai vendendo in un ordine B2B.
company.name	Il nome dell'azienda in un ordine B2B.
company.id	L'ID dell'azienda in un ordine B2B.
company_location	La sede dell'azienda in un ordine B2B. Un'azienda che acquista da te può avere più di una sede.
company_location.name	Il nome della sede dell'azienda su un ordine B2B.
company_location.id	Il numero ID della sede dell'azienda in un ordine B2B.
company_location.shipping_address	L'indirizzo di spedizione della sede dell'azienda in un ordine B2B.
company_location.billing_address	L'indirizzo di fatturazione della sede dell'azienda in un ordine B2B.

Proprietà del programma di pagamento

Nota

Non puoi inviare notifiche di promemoria di pagamento tramite SMS.

Descrizione delle proprietà del programma di pagamento

Proprietà	Descrizione
payment_schedule.amount_due	L'importo da pagare per un programma di pagamento. Puoi formattare gli importi con le valute utilizzando il filtro dell'importo Liquid.
payment_schedule.due_at	La data di scadenza del programma di pagamento. Puoi formattare le date utilizzando il filtro della data Liquid.
payment_schedule.due_in_days	Il numero di giorni fino alla data di scadenza se il programma di pagamento è ancora dovuto (non pagato).
payment_schedule.due_later?	Restituisce true se un programma di pagamento non è stato pagato e la data di scadenza è successiva.
payment_schedule.number_of_days_overdue?	Il numero di giorni successivi alla data di scadenza in cui un programma di pagamento è scaduto.
payment_schedule.overdue?	Restituisce true se un programma di pagamenti non è stato pagato ed è passata la data di scadenza.

Proprietà dello stato del pagamento

Descrizione delle proprietà dello stato del pagamento

Proprietà	Descrizione
has_pending_payment	(booleano) Restituisce TRUE se l'ordine ha una transazione con un pagamento in attesa. Scopri di più sui pagamenti in attesa.
buyer_action_required	(booleano) Restituisce TRUE se un ordine ha una transazione con un pagamento in attesa e per sbloccare il pagamento è necessaria un'azione dell'acquirente. Quando questo valore restituisce TRUE e il metodo di pagamento supporta le istruzioni di pagamento, il buyer_pending_payment_instructions fornisce informazioni che l'acquirente può utilizzare per completare l'acquisto offline. Scopri di più sull'oggetto transazione Liquid.

Proprietà delle voci

Ogni line nell'elenco line_items o subtotal_line_items ha le seguenti proprietà.

Suggerimento

subtotal_line_items restituisce le voci utilizzate per calcolare il subtotal_price di un ordine. subtotal_line_items esclude le voci di esempio.

Descrizione delle proprietà dell'ordine

Proprietà	Descrizione
line.applied_discounts (POS and draft orders only)	Elenco degli sconti applicati a questo articolo (ciascuno sconto ha le proprietà: titolo, codice, importo, risparmio e tipo).
line.custom (Draft orders only)	(booleano) Restituisce VERO se la voce è personalizzata per una bozza di ordine.
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	Il nome attuale 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.current_quantity	La quantità attuale dell'articolo dopo la rimozione.
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 al momento della vendita, seguito da un trattino e dal nome della variante al momento della vendita. Il nome della variante non viene incluso quando si tratta di un "Titolo predefinito". Nelle notifiche destinate all'acquirente, il nome del prodotto e il nome della variante vengono tradotti nella lingua in cui l'acquirente ha effettuato il check-out, quando è diversa dalla lingua predefinita del negozio.
line.url	L'URL relativo della variante della voce. L'URL relativo non include l'URL root del negozio (mystore.myshopify.com).
line.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 nomi attuali dei valori opzione della variante, uniti dai caratteri /. Esempio: small/red
line.refunded.quantity (within refund notifications)	La quantità di un articolo da rimborsare. Puoi utilizzare questa proprietà per aggiungere un codice identificativo agli articoli rimborsati in un ordine. Ad esempio: {% if line.refunded_quantity > 0 %}codice identificativo della voce di rimborso{% endif %}

Proprietà dei rimborsi

Descrizione delle proprietà "rimborsi"

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à:

Descrizione delle proprietà delle voci di rimborso

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à di evasione

Descrizione delle proprietà di evasione ordini

Proprietà	Descrizione
service_name	Il nome del servizio personalizzato così come definito su Impostazioni > pagina 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.
items_to_fulfill (deprecated)	L'elenco delle voci che devono essere evase da questo specifico servizio logistico personalizzato. (Solo richiesta di evasione)
items_to_fulfill_count (deprecated)	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.

Descrizione delle proprietà della voce di evasione ordini

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à di consegna

Descrizione delle 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.
consolidated_estimated_delivery_time	Informazioni sulle date di consegna dell'ordine da condividere con il cliente. Queste informazioni sono controllate tramite l'impostazione Tempo di elaborazione configurata nella pagina Spedizione e consegna.

Proprietà dello 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.

Descrizione delle proprietà discount_allocation

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.

Descrizione delle proprietà "discount_application"

Proprietà	Descrizione
discount_application.target_selection	Descrive le modalità con cui uno sconto seleziona le voci da scontare nel carrello. Può essere: all: lo sconto si applica a tutte le voci; entitled: lo sconto si applica a un sottoinsieme specifico di voci, spesso definito da una condizione; explicit: lo sconto si applica a una voce o voce di spedizione appositamente selezionata.
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à dell'abbonamento

I dettagli di un contratto di abbonamento, il ciclo di fatturazione attuale e le relative voci, il metodo di consegna e il metodo di pagamento sono disponibili per tutti i modelli di email di abbonamento.

Per modificare i modelli di notifica di abbonamento, installa l'app Shopify Subscriptions e trova il modello nella sezione Impostazioni > Notifiche nella sezione Abbonamenti.

Proprietà del ciclo di fatturazione del contratto di abbonamento

Per accedere alle proprietà del contratto di abbonamento e del relativo ciclo di fatturazione, usa l'oggetto subscription_contract_billing_cycle.

Esempio

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Risultato:

This contract is currently paused.

Proprietà

Descrizione delle proprietà del ciclo di fatturazione del contratto di abbonamento

Proprietà	Descrizione
status	Lo stato del contratto. Uno tra active, paused, cancelled, failed, expired, stale.
delivery_method	Il metodo di consegna dell'abbonamento. Se l'abbonamento si riferisce a un servizio o un prodotto digitale, allora nil viene restituito.
billing_frequency	La frequenza con la quale viene addebitato il costo dell'abbonamento.
delivery_frequency	La frequenza con cui viene consegnato l'abbonamento.
origin_order	L'ordine originale che ha creato per la prima volta l'abbonamento. Se l'abbonamento non è stato creato da un ordine Shopify, viene restituito nil.
customer	Il cliente in abbonamento.
line_items	Le voci del ciclo di fatturazione dell'abbonamento.
product_names	Un elenco dei nomi dei prodotti inclusi nel ciclo di fatturazione dell'abbonamento.
update_payment_method_url	L'URL che il cliente può usare per aggiornare il metodo di pagamento per questo contratto.
shipping_address	L'indirizzo di spedizione dell'abbonamento. Se l'abbonamento si riferisce a un servizio o un prodotto digitale, viene restituito nil.
billing_address	L'indirizzo di fatturazione dell'abbonamento.
subtotal_price	Il prezzo subtotale delle voci dell'abbonamento.
shipping_price	Il prezzo di spedizione dell'abbonamento.
total_tax	L'imposta totale dell'abbonamento.
total_price	Il prezzo totale dell'abbonamento.
total_discounts	Gli sconti totali dell'abbonamento.
customer_self_serve_url	L'URL self-service che il cliente può utilizzare per gestire gli abbonamenti.
billing_attempt_expected_date	La data di fatturazione di questo ciclo di fatturazione.
next_billing_date	La prossima data di fatturazione non saltata dopo questo ciclo di fatturazione.
last_attempted_billing_date	La data dell'ultimo tentativo di fatturazione per il ciclo di fatturazione.
days_overdue	Il numero di giorni di ritardo per la fatturazione di questo ciclo di fatturazione.
payment_instrument	Lo strumento di pagamento associato al contratto di abbonamento. Questo strumento di pagamento viene usato per addebitare il prezzo dell'abbonamento al cliente.

Proprietà delle voci del contratto di abbonamento

Le proprietà di ogni voce inclusa nel ciclo di fatturazione. Accedi alle proprietà delle voci del contratto tramite la proprietà principale subscription_contract_billing_cycle.line_items.

Esempio

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Nota

Oltre alle proprietà delle voci del contratto, sono disponibili tutte le proprietà delle voci standard.

Descrizione delle proprietà delle voci del contratto di abbonamento

Proprietà	Descrizione
url	L'URL che indirizza alla pagina dei dettagli del prodotto per la variante di prodotto della voce.
requires_shipping	Se la voce si riferisce a un articolo che richiede la spedizione fisica.
unit_price_measurement	La misura del prezzo unitario dell'articolo.
selling_plan_allocation	L'allocazione del piano di vendita dell'articolo.

Proprietà del metodo di consegna del contratto di abbonamento

Le proprietà del metodo di consegna usato in questo ciclo di fatturazione. Accedi alle proprietà del metodo di consegna tramite la proprietà principale subscription_contract_billing_cycle.delivery_method.

Esempio

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Descrizione delle proprietà del metodo di consegna del contratto di abbonamento

Proprietà	Descrizione
title	Il titolo dell'opzione di spedizione associata al metodo di consegna.
type	Il tipo di metodo di consegna. Uno tra shipping, local o pick-up.

Proprietà dello strumento di pagamento per il contratto di abbonamento

Dettagli sullo strumento di pagamento per il contratto di abbonamento. Questo strumento di pagamento viene usato per addebitare il prezzo dell'abbonamento al cliente. Accedi alle proprietà del strumento di pagamento tramite la proprietà principale subscription_contract_billing_cycle.payment_instrument.

Esempio

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} " alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

Descrizione delle proprietà dello strumento di pagamento per il contratto di abbonamento

Proprietà	Descrizione
payment_type	Il tipo di metodo di pagamento costituito dallo strumento di pagamento. Usa i filtri di pagamento per generare l'URL di un'immagine o il relativo file SVG.
credit_card_brand	Il brand della carta di credito.
credit_card_company	Il nome dell'istituto che ha emesso la carta di credito.
credit_card_last_four_digits	Le ultime quattro cifre della carta di credito.

Proprietà "notifiche via email"

Descrizione delle proprietà di notifica 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.