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.

Proprietà dell'ordine

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

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

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

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

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.bundle_components
(Draft orders only)
L'elenco delle voci che sono componenti del pacchetto di questo articolo. Restituisce un elenco solo se questa voce è un prodotto del pacchetto.
line.bundle_parent?
(Draft orders only)
(booleano) Restituisce VERO se la voce è un prodotto del pacchetto.
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 dall'impostazione Tempo di elaborazione che hai configurato nella pagina Spedizione e consegna. Quando l'ordine dispone di più metodi di consegna, viene visualizzato un elenco di metodi e date di consegna.
has_multiple_delivery_methods
(booleano) Restituisce TRUE se l'ordine ha più metodi di 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 %}
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.

Sei pronto per iniziare a vendere con Shopify?

Provalo, è gratis