Riferimento per le variabili delle notifiche

Le notifiche inviate dal negozio vengono elaborate utilizzando Liquid. Liquid è il linguaggio di programmazione di Shopify, semplice e facile da usare. È lo stesso linguaggio di programmazione su cui sono basati i temi del Theme Store.

Per modificare le notifiche inviate dal negozio, puoi apportare 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 ricevere assistenza con modifiche più avanzate o per modificare i modelli di notifica personalizzati, puoi rivolgerti alla community sui nostri forum oppure puoi anche incaricare un Partner di Shopify di eseguire le personalizzazioni per te. Maggiori informazioni su come incaricare un Partner di Shopify.

In questa pagina

Proprietà dell'ordine

Molte proprietà di un ordine sono disponibili direttamente tramite Liquid e nei modelli.

Descrizioni delle proprietà Liquid che puoi usare con l'oggetto ordine nei modelli di notifica
Proprietà	Descrizione
`id`	Un ID univoco dell'ordine a livello di sistema per uso interno. Usa l'esempio seguente per generare un link all'ordine nella sezione del pannello di controllo del negozio. Ad esempio, nel modello Nuovo ordine puoi aggiungere il seguente codice: `Visualizza ordine`
`email`	L'email associata all'ordine.
`name`	Generalmente si tratta di un cancelletto seguito dal `order_number`. Esempio: #1004
`order_name`	Uguale a name.
`order_number`	Numero univoco dell'ordine nel negozio, senza il prefisso # né alcun prefisso o suffisso aggiunto all'ID ordine dal proprietario del negozio nelle preferenze del negozio. Esempio: 1004
`confirmation_number`	Un identificatore alfanumerico generato casualmente per l'ordine, che può essere mostrato al cliente al posto del nome 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. Puoi formattarle utilizzando il filtro data. Esempio: 2009-05-30T17:43:51+02:00
`payment_terms`	I termini di pagamento specificano la data di scadenza del pagamento per un ordine. Scopri come aggiungere i termini di pagamento alle fatture degli ordini. Per maggiori dettagli, consulta il riferimento Liquid per payment_terms.
`destination`	La destinazione a cui devono essere inviati gli articoli.
`tags`	Restituisce un array di tutti i tag dell’ordine. I tag sono restituiti in ordine alfabetico. I tag applicati dinamicamente da app o funzionalità della piattaforma, come il tag `Shopify Collective`, potrebbero non essere disponibili quando viene generata l’email di notifica. Per rilevare gli articoli di una funzionalità specifica, controlla invece i tag a livello di prodotto su ciascuna voce. Per maggiori dettagli, consulta la documentazione di riferimento di Liquid.
`transactions`	Restituisce un array di transazioni dell'ordine.
`tax_price`	L'importo totale delle imposte per tutti gli articoli dell'ordine.
`tax_lines`	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. Ad esempio, QST o IVA.
`tax_line.price`	L'importo dell'imposta.
`tax_line.rate`	L'aliquota fiscale come numero decimale. Restituirà 0,175 se è 17,5%.
`tax_line.rate_percentage`	L'aliquota fiscale in formato leggibile. Restituirà 17,5 se l'aliquota è 0,175.
`customer`	Oggetto Cliente contenente gli attributi dell'output cliente.
`billing_address`	L'indirizzo di fatturazione.
`billing_address.first_name`	Nome del cliente.
`billing_address.last_name`	Cognome del cliente.
`billing_address.company`	Nome dell'azienda per la fatturazione.
`billing_address.phone`	Numero di telefono dall'indirizzo di fatturazione.
`shop.name`	Nome del negozio.
`shop.phone`	Numero di telefono del negozio.
`subtotal_price`	Somma dei prezzi delle voci dell'ordine dopo la detrazione di eventuali sconti sulle voci o sconti sul carrello. Il subtotale non include imposte (a meno che non siano incluse nei prezzi), costi di spedizione o mance.
`discounts`	Un elenco di sconti.
`discounts_amount`	L'importo totale degli sconti applicati. Esempio: +5,00 $
`discounts_savings`	L'importo del risparmio generato da tutti gli sconti. Esempio: -5,00 $
`total_price`	Totale dell'ordine (subtotale + costo di spedizione - sconto sulla spedizione + imposta).
`financial_status`	Lo stato di pagamento attuale. Uno tra: nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(booleano) Restituisce true se nell'ordine è presente almeno un articolo che richiede la spedizione.
`shipping_method.title`	Il nome della tariffa di spedizione. Nelle notifiche rivolte ai clienti, il nome della tariffa di spedizione viene tradotto nella lingua utilizzata dal cliente per il check-out, se diversa dalla lingua predefinita del negozio. Esempio: Spedizione standard
`shipping_method.price`	Il prezzo della spedizione, comprensivo di eventuali sconti sulla spedizione. Esempio: `{{ shipping_method.price \| money }}`
`shipping_price`	Il prezzo della 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`	Nome dell'azienda per l'indirizzo di spedizione.
`shipping_address.phone`	Numero di telefono dall'indirizzo di spedizione.
`line_items`	Elenco di tutte le voci dell'ordine.
`line_items_including_zero_quantity`	Elenco di tutte le voci dell'ordine, incluse quelle con quantità pari a zero. Le voci hanno una quantità pari a zero quando vengono rimborsate completamente.
`line_item_groups`(Orders and POS only)	Elenco di tutti i gruppi di voci contenenti i componenti delle voci dell'ordine.
`item_count`	La somma delle quantità di tutti gli articoli.
`fulfillment_status`	Lo stato di evasione attuale dell'ordine. Uno tra: `unfulfilled`, `partial`, `fulfilled`.
`note`	La nota allegata all'ordine. La nota può essere ottenuta dal cliente e/o modificata nella schermata dei dettagli dell'ordine nel pannello di controllo.
`attributes`	Eventuali attributi allegati all'ordine. Esempio: `{{ attributes.gift-note }}`
`metafields`	Eventuali metafield sull'ordine. Utilizza la seguente sintassi: metafields.NAMESPACE.KEY
`referring_site`	Contiene l'URL del referrer che ha indirizzato il cliente al negozio. Esempio: `https://www.google.com/?s=great+products`
`landing_site`	Contiene il percorso della pagina di destinazione utilizzata dal cliente. È la prima pagina che il cliente ha visualizzato quando ha raggiunto il negozio. Esempio: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Analizza la pagina di destinazione ed estrae un parametro di riferimento. I parametri di riferimento possono essere: `ref`, `source`, `r`. Se `landing_site` è `/products/great-product?ref=my-tracking-token`, allora il `landing_site_ref` è `my-tracking-token`. Puoi eseguire una determinata azione se il tuo ref è uguale a un determinato 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`	La motivazione selezionata durante l'annullamento dell'ordine. Una tra: `inventory`, `customer`, `declined`, `fraud` o `other`.
`has_high_risks?`(deprecated)	Restituisce true se l'ordine è ad alto rischio.
`unique_gateways`	Restituisce un elenco di gestori dei pagamenti univoci per un ordine. Ad esempio, se un cliente ha pagato con Visa, Mastercard e in contanti, l’elenco restituito sarà `shopify_payments, cash`.
`location`(POS only)	Visualizza la sede fisica dell'ordine. Sono disponibili diverse proprietà della sede, elencate qui. Puoi configurare le sedi nella sezione Sedi del pannello di controllo.
`order_status_url`	Restituisce il link alla pagina di stato dell’ordine per questo ordine.
`fulfilled_line_items`(deprecated)	Elenco delle voci che sono state evase.
`unfulfilled_line_items`(deprecated)	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 visualizzare informazioni pertinenti, come il nome dell'azienda, la sede aziendale e l'indirizzo nelle email. Ad esempio, per gli ordini B2B, potresti 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 vendi 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 aziendale in un ordine B2B.
`company_location.id`	Il numero ID della sede aziendale in un ordine B2B.
`company_location.shipping_address`	L'indirizzo di spedizione della sede aziendale in un ordine B2B.
`company_location.billing_address`	L'indirizzo di fatturazione della sede aziendale in un ordine B2B.
`customer_order_url`	La nuova pagina di stato dell'ordine di un ordine per il quale un cliente ha richiesto un reso utilizzando gli account cliente.

Proprietà della bozza di ordine

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto bozza di ordine nei modelli di notifica
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 cui le voci nella bozza sono riservate, ad esempio `2015-05-30T17:43:51+02:00`. Puoi formattare le date utilizzando il filtro data di 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`	L'univoco `number` della bozza di ordine, preceduto dal simbolo del cancelletto `#`.
`number`	Il numero univoco della bozza di ordine senza il prefisso o il suffisso dell'ordine.
`created_at`	La data e l'ora in cui il cliente ha creato la bozza di ordine, ad esempio `2009-05-30T17:43:51+02:00`. Puoi formattare le date utilizzando il filtro data di Liquid.
`tags`	Restituisce un array di tutti i tag dell'ordine. I tag vengono restituiti in ordine alfabetico. Per maggiori dettagli, consulta la documentazione di riferimento di Liquid.
`tax_price`	Le imposte totali di tutti gli articoli nella bozza di ordine.
`tax_lines`	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% restituirà `0,175`.
`tax_line.rate_percentage`	L'aliquota fiscale in formato percentuale. Ad esempio, un `rate` di 0,175 restituirà `17,5`.
`customer`	Oggetto Cliente contenente gli attributi dell'output 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 nell'indirizzo di fatturazione.
`billing_address.phone`	Il numero di telefono nell'indirizzo di fatturazione.
`shop.name`	Il nome del tuo negozio.
`shop.phone`	Numero di telefono del negozio.
`subtotal_price`	Somma dei prezzi delle voci della bozza di ordine dopo la detrazione di eventuali sconti sulla voce o sul carrello. Il subtotale non include le imposte (a meno che non siano incluse nei prezzi) né i costi di spedizione.
`discounts`	Un elenco di sconti.
`discounts_amount`	Importo totale degli sconti. Esempio: +5,00 $
`discounts_savings`	Importo del risparmio generato da tutti gli sconti. Esempio: -5,00 $
`total_price`	Il prezzo totale dell'ordine (subtotale + costo di spedizione - sconto sulla spedizione + imposta).
`amount_due_now`	L'importo dovuto per la fattura della bozza di ordine.
`requires_shipping`	Restituisce `true` se nella bozza di ordine è presente almeno un articolo che richiede la spedizione. Restituisce `false` se nessun articolo nella bozza di ordine richiede 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 della spedizione. Puoi formattare questo importo utilizzando i filtri money di Liquid.
`shipping_address`	L'indirizzo di spedizione. Nota: a differenza degli ordini normali, 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 nell'indirizzo di spedizione.
`shipping_address.phone`	Il numero di telefono nell'indirizzo di spedizione.
`line_items`	Un elenco di tutte le voci nella bozza di ordine.
`item_count`	La somma di tutte le quantità degli articoli nella bozza di ordine.
`note`	La nota allegata alla bozza di ordine. La nota può essere ottenuta dal cliente e anche modificata nella schermata dei dettagli della bozza di ordine nel tuo pannello di controllo Shopify.
`metafields`	Eventuali metafield sulla bozza di ordine. Utilizza la seguente sintassi: metafields.NAMESPACE.KEY
`location`	La sede fisica dell'ordine. Sono disponibili diverse proprietà della sede. 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 visualizzare informazioni pertinenti, come il nome dell'azienda, la sede aziendale e l'indirizzo nelle email. Ad esempio, per gli ordini B2B, potresti 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 vendi 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 aziendale in un ordine B2B.
`company_location.id`	Il numero ID della sede aziendale in un ordine B2B.
`company_location.shipping_address`	L'indirizzo di spedizione della sede aziendale in un ordine B2B.
`company_location.billing_address`	L'indirizzo di fatturazione della sede aziendale in un ordine B2B.
`payment_methods`	Un elenco di metodi di pagamento salvati disponibili per elaborare il totale della bozza.
`payment_method.payment_instrument`	Lo strumento di pagamento, contenente i dettagli sul metodo di pagamento salvato.
`payment_method.payment_instrument.payment_type`	Il tipo di metodo di pagamento salvato. Ad es. “credit_card, apple_pay”
`payment_method.payment_instrument.credit_card_brand`	Il brand della carta, quando `payment_type` è “credit_card”
`payment_method.payment_instrument.credit_card_company`	L'emittente della carta, quando `payment_type` è “credit_card”
`payment_method.payment_instrument.credit_card_company`	Le ultime 4 cifre della carta, quando `payment_type` è “credit_card”

Proprietà del piano di pagamento

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto piano di pagamento nei modelli di notifica
Proprietà	Descrizione
`payment_schedule.amount_due`	L'importo da pagare per un piano di pagamento. Puoi formattare gli importi con le valute utilizzando il filtro money di Liquid.
`payment_schedule.due_at`	La data di scadenza del piano di pagamento. Puoi formattare le date utilizzando il filtro data di Liquid.
`payment_schedule.due_in_days`	Il numero di giorni che mancano alla data di scadenza, se il piano di pagamento è ancora da saldare (non pagato).
`payment_schedule.due_later?`	Restituisce true se un piano di pagamento non è stato pagato e la sua data di scadenza è futura.
`payment_schedule.number_of_days_overdue?`	Il numero di giorni trascorsi dalla data di scadenza quando un piano di pagamento è scaduto.
`payment_schedule.overdue?`	Restituisce true se un piano di pagamento non è stato pagato e ha superato la sua data di scadenza.

Proprietà dello stato del pagamento

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto stato del pagamento nei modelli di notifica
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 è richiesta un'azione da parte dell'acquirente. Quando questo valore restituisce true e il metodo di pagamento supporta le istruzioni di pagamento, `buyer_pending_payment_instructions` fornisce i dettagli che il cliente può utilizzare per completare l'acquisto offline. Scopri di più sull'oggetto transaction di Liquid.

Proprietà del componente del pacchetto

Ogni bundle_component nell'elenco di line_item.bundle_components ha le seguenti proprietà. (Solo bozze di ordine)

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto componente del pacchetto nei modelli di notifica
Proprietà	Descrizione
`bundle_component.image_url`	L'URL dell'immagine del componente del pacchetto.
`bundle_component.product.title`	Il titolo del prodotto del componente del pacchetto.
`bundle_component.quantity`	Quantità per il componente del pacchetto.
`bundle_component.variant.title`	I nomi correnti dei valori dell'opzione della variante del componente del pacchetto, uniti da caratteri `/`. Esempio: piccolo / rosso

Proprietà del componente

Ogni componente nell'elenco di line_item.components ha le seguenti proprietà. (Solo check-out abbandonati) `

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto componente nei modelli di notifica
Proprietà	Descrizione
`component.image_url`	L'URL dell'immagine del componente.
`component.product.title`	Il titolo del prodotto del componente.
`component.quantity`	Quantità per il componente.
`component.variant.title`	I nomi correnti dei valori dell'opzione della variante del componente, uniti da caratteri `/`. Esempio: piccolo / rosso

Proprietà della voce

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

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto voce nei modelli di notifica
Proprietà	Descrizione
`line.applied_discounts`(POS and draft orders only)	Elenco di sconti applicati a questo articolo (ogni sconto ha le proprietà `title`, `code`, `amount`, `savings` e `type`).
`line.bundle_components`(Draft orders only)	Elenco di voci che sono componenti del pacchetto di questo articolo. Restituisce un elenco solo se questa voce è un prodotto pacchetto.
`line.bundle_parent?`(Draft orders only)	(booleano) Restituisce true se la voce è un prodotto pacchetto.
`line.components`(Abandoned checkout only)	Elenco di voci che sono componenti di questo articolo.
`line.parent?`(Abandoned checkout only)	(booleano) Restituisce true se la voce ha componenti.
`line.custom`(Draft orders only)	(booleano) Restituisce true se l'articolo è una voce personalizzata per una bozza di ordine.
`line.delivery_agreement`	Il Contratto di consegna associato a questa voce.
`line.grams`	Peso di un singolo articolo.
`line.groups`	Gruppo di voci dell'articolo.
`line.image`	Restituisce l'URL dell'immagine associata a questa voce. Puoi anche utilizzare il filtro img_url per ottenere dimensioni specifiche dell'immagine, ad esempio `{{ line.image \| img_url: 'small' }}`
`line.line_price`	Il prezzo moltiplicato per la quantità di quell'articolo.
`line.original_line_price`	Il prezzo combinato della quantità di articoli inclusi nella voce, prima dell'applicazione degli sconti.
`line.final_line_price`	Il prezzo combinato di tutti gli articoli nella voce, inclusi tutti gli importi degli sconti a livello di voce.
`line.pre_tax_price`	Il prezzo al netto di imposte per le voci, moltiplicato per la quantità della voce acquistata.
`line.price`	Il prezzo di un singolo articolo.
`line.product.metafields`	Eventuali metafield a livello di prodotto. Usa la seguente sintassi: line.product.metafields.NAMESPACE.KEY
`line.product.title`	Il nome corrente del prodotto.
`line.product.vendor`	Il venditore dell'articolo.
`line.properties`	Restituisce un array di informazioni personalizzate per un articolo. Le proprietà della voce sono specificate dal cliente sulla pagina del prodotto, prima di aggiungere un prodotto al carrello.
`line.quantity`	Quantità per quell'articolo.
`line.current_quantity`	La quantità corrente dell'articolo dopo le rimozioni.
`line.requires_shipping`	(booleano) Restituisce true se per la variante dell’articolo è attivata l'impostazione Prodotto fisico nella pagina del prodotto.
`line.selling_plan_allocation`	Restituisce un oggetto `selling_plan_allocation`, che descrive in che modo un piano di vendita come un abbonamento influisce sulla voce.
`line.taxable`	(booleano) Restituisce true se per la variante dell’articolo è selezionata la casella di spunta “Applica imposte su questo prodotto” nella 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 è incluso quando è “Default Title”. Nelle notifiche rivolte ai clienti, il nome del prodotto e il nome della variante vengono tradotti nella lingua in cui il cliente ha effettuato il check-out, quando la lingua è diversa da quella predefinita del negozio.
`line.url`	L'URL relativo della variante della voce. L'URL relativo non include l'URL di root del negozio (`mystore.myshopify.com`).
`line.variant.barcode`	Il 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 alla variante nella voce è assegnata un'immagine specifica.
`line.variant.metafields`	Eventuali metafield a livello di variante. Usa la seguente sintassi: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	Lo SKU associato alla variante di prodotto.
`line.variant.title`	I nomi correnti dei valori delle opzioni della variante, uniti da caratteri `/`. Esempio: piccolo / rosso
`line.refunded.quantity`(within refund notifications)	La quantità di un articolo da rimborsare. Puoi utilizzare questa proprietà per aggiungere un identificatore agli articoli rimborsati in un ordine. Ad esempio: `{% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}`

Rileva gli articoli di Shopify Collective nei modelli di notifica

Il tag Shopify Collective viene applicato a un ordine dopo l’invio dell’email di conferma dell’ordine, pertanto {% if tags contains 'Shopify Collective' %} non è mai true in un modello di conferma dell’ordine. Per rilevare gli articoli di Shopify Collective, controlla invece i tag a livello di prodotto su ciascuna voce:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Proprietà del gruppo di voci

Ogni line_item_group nell'elenco di line_item_groups ha le seguenti proprietà.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto gruppo di voci nei modelli di notifica
Proprietà	Descrizione
`line_item_group.display_title`	Il titolo del gruppo di voci.
`line_item_group.components`	Elenco dei componenti della voce appartenenti al gruppo.
`line_item_group.image`	L'immagine del gruppo di voci.
`line_item_group.product_id`	L'ID prodotto del gruppo di voci.
`line_item_group.variant`	L'oggetto variante del gruppo di voci.
`line_item_group.variant_id`	L'ID variante del gruppo di voci.

Proprietà dei rimborsi

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto rimborso nei modelli di notifica
Proprietà	Descrizione
`amount`	L'importo di denaro rimborsato.
`refund_line_items`	Un elenco di voci di rimborso da rimborsare.

Proprietà della voce di rimborso

Ogni refund_line nell'elenco di refund_line_items ha le seguenti proprietà:

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto voci di rimborso nei modelli di notifica
Proprietà	Descrizione
`refund_line.line_item`	La `line_item` che viene rimborsata. Consente l'accesso a tutte le proprietà di line_item.
`refund_line.quantity`	La quantità della voce da rimborsare.

Proprietà di evasione

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto evasione nei modelli di notifica
Proprietà	Descrizione
`service_name`	Il nome del servizio personalizzato come definito nella pagina Impostazioni > Spedizione e consegna. (Solo richiesta di evasione)
`fulfillment.estimated_delivery_at`	Una data di consegna stimata basata sul numero di tracciamento (se disponibile) fornito da uno dei seguenti corrieri: USPS, FedEx, UPS, Canada Post (solo Canada). Questa proprietà è disponibile solo quando sono in uso le tariffe calcolate dal corriere.
`fulfillment.fulfillment_line_items`	Un elenco di voci di evasione da evadere.
`fulfillment.item_count`	La somma delle quantità di tutti gli articoli. Il numero totale di articoli in evasione.
`fulfillment.requires_shipping`	(booleano) Restituisce “true” se questa richiesta di evasione richiede la spedizione.
`fulfillment.tracking_company`	L'azienda che si occupa del tracciamento.
`fulfillment.tracking_numbers`	Un elenco di numeri di tracciamento.
`fulfillment.tracking_urls`	Un elenco di URL di tracciamento.
`items_to_fulfill`(deprecated)	Un elenco di voci da evadere da parte di questo specifico servizio di evasione ordini personalizzato. (Solo richiesta di evasione)
`items_to_fulfill_count`(deprecated)	Il numero totale di articoli da evadere con questa richiesta. (Solo richiesta di evasione)

Proprietà della voce di evasione

Ogni fulfillment_line nell'elenco di fulfillment_line_items ha le seguenti proprietà.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto voci di evasione nei modelli di notifica
Proprietà	Descrizione
`fulfillment_line.line_item`	La `line_item` in fase di evasione. Consente l'accesso a tutte le proprietà di line_item.
`fulfillment_line.quantity`	La quantità della voce in fase di evasione.

Proprietà del pacco preparato

Un pacco preparato include gli articoli contrassegnati come pronti per il ritiro.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto pacco preparato nei modelli di notifica
Proprietà	Descrizione
`item_count`	La somma di tutte le quantità degli articoli nel pacco preparato.
`prepared_package_line_items`	Un elenco di voci del pacco preparato.

Proprietà della voce del pacco preparato

Ogni prepared_package_line_item nell'elenco di prepared_package_line_items ha le seguenti proprietà.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto voce del pacco preparato nei modelli di notifica
Proprietà	Descrizione
`line_item`	La `line_item` associata. Consente l'accesso a tutte le proprietà di line_item.
`quantity`	La quantità della voce contrassegnata come pronta per il ritiro.

Proprietà di consegna

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto consegna nei modelli di notifica
Proprietà	Descrizione
`delivery_agreements`	Elenco di tutti gli accordi di consegna per l'ordine.
`delivery_instructions`	Informazioni sulla consegna locale da condividere con il cliente. Queste informazioni sono gestite dal campo Informazioni sulla consegna nelle impostazioni della consegna locale.
`consolidated_estimated_delivery_time`	Informazioni sulle date di consegna dell'ordine da condividere con il cliente. Queste informazioni sono gestite dall'impostazione Tempo di elaborazione che configuri nella pagina Spedizione e consegna. Quando l'ordine ha 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à dell'accordo di consegna

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto accordo di consegna nei modelli di notifica
Proprietà	Descrizione
`delivery_agreement.delivery_method_type`	Il tipo di metodo di consegna.
`delivery_agreement.delivery_method_name`	Il tipo di metodo di consegna tradotto nella lingua in cui l'acquirente ha effettuato il check-out, quando la lingua è diversa da quella predefinita del negozio.
`delivery_agreement.line_item_groups`	Elenco di tutti i gruppi di voci contenenti componenti della voce raggruppati nell'accordo di consegna.
`delivery_agreement.line_items`	Elenco di tutte le voci associate a questo accordo di consegna.

Proprietà dello sconto

Esistono due tipi di proprietà di sconto.

discount_applications descrive il motivo e il modo in cui un articolo è stato scontato.

discount_allocations descrive in che modo un particolare sconto influisce su una voce e ne riduce il prezzo. Dovresti utilizzare questa proprietà a livello di voce.

Puoi combinare queste proprietà per visualizzare le informazioni sugli sconti a livello di voce o di ordine.

Esempio

Questo esempio controlla se uno sconto è stato applicato alla voce. Se lo sconto non è stato applicato a livello di ordine (all), vengono 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à di discount_allocation

Ogni discount_allocation nell'elenco di discount_allocations ha le seguenti proprietà.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto discount_allocation nei modelli di notifica
Proprietà	Descrizione
`discount_allocation.amount`	L'importo di denaro risparmiato dal cliente su una voce. Deve essere inserito in un loop se desideri consentire più codici sconto.
`discount_allocation.discount_application`	L'applicazione dello sconto che alloca l'importo sulla voce.

Proprietà di discount_application

Ogni discount_application nell'elenco di discount_applications ha le seguenti proprietà.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto discount_application nei modelli di notifica
Proprietà	Descrizione
`discount_application.target_selection`	Descrive il modo in cui uno sconto seleziona le voci nel carrello da scontare. Uno dei seguenti: `all`: lo sconto si applica a tutte le voci. `entitled`: lo sconto si applica a un particolare sottoinsieme di voci, spesso definito da una condizione. `explicit`: lo sconto si applica a una voce o a una voce di spedizione selezionata in modo specifico.
`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 visibile al cliente. Esempi: Welcome10 o CBBWQQAKYBYY
`discount_application.total_allocated_amount`	L'importo totale di cui viene ridotto il prezzo di un ordine tramite lo sconto.
`discount_application.type`	Il tipo di sconto. Uno dei seguenti: `automatic`, `discount_code`, `manual` o `script`.
`discount_application.value`	Il valore dello sconto.
`discount_application.value_type`	Il tipo di valore dello sconto. Uno dei seguenti: `fixed_amount` o `percentage`.

Proprietà dell'abbonamento

I dettagli di un contratto di abbonamento, del ciclo di fatturazione corrente e delle relative voci, del metodo di consegna e del metodo di pagamento sono disponibili per tutti i modelli di email di abbonamento.

Per modificare i modelli di notifica dell'abbonamento, installa l'app Shopify Subscriptions, quindi trova il modello in 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, utilizza 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à

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto del ciclo di fatturazione del contratto di abbonamento nei modelli di notifica.
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 è per un servizio o prodotto digitale, viene restituito `nil`.
`billing_frequency`	La frequenza con cui l'abbonamento viene fatturato.
`delivery_frequency`	La frequenza con cui l'abbonamento viene consegnato.
`origin_order`	L'ordine originale che ha creato l'abbonamento. Se l'abbonamento non è stato creato da un ordine Shopify, viene restituito `nil`.
`customer`	Il cliente dell'abbonamento.
`line_items`	Le voci nel 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ò utilizzare per aggiornare il metodo di pagamento per questo contratto.
`shipping_address`	L'indirizzo di spedizione dell'abbonamento. Se l'abbonamento è per un servizio o prodotto digitale, viene restituito `nil`.
`billing_address`	L'indirizzo di fatturazione dell'abbonamento.
`subtotal_price`	Il prezzo del 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 i propri abbonamenti.
`billing_attempt_expected_date`	La data di fatturazione per questo ciclo di fatturazione.
`next_billing_date`	La data di fatturazione successiva non saltata dopo questo ciclo di fatturazione.
`last_attempted_billing_date`	L'ultima data del tentativo di fatturazione per il ciclo di fatturazione.
`days_overdue`	Il numero di giorni di ritardo della fatturazione per questo ciclo di fatturazione.
`payment_instrument`	Lo strumento di pagamento associato al contratto di abbonamento. Questo strumento di pagamento viene utilizzato per addebitare il cliente.

Proprietà della voce del contratto di abbonamento

Le proprietà per ogni voce inclusa nel ciclo di fatturazione. Accedi alle proprietà della voce 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 %}

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto della voce del contratto di abbonamento nei modelli di notifica.
Proprietà	Descrizione
`url`	L'URL della pagina dei dettagli del prodotto per la variante di prodotto della voce.
`requires_shipping`	Indica se la voce richiede una spedizione fisica.
`unit_price_measurement`	La misurazione del prezzo unitario della voce.
`selling_plan_allocation`	L'allocazione del piano di vendita della voce.

Proprietà del metodo di consegna del contratto di abbonamento

Le proprietà del metodo di consegna utilizzato 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 %}

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto del metodo di consegna del contratto di abbonamento nei modelli di notifica.
Proprietà	Descrizione
`title`	Il titolo dell'opzione di spedizione associata al metodo di consegna.
`type`	Il tipo di metodo di consegna. Uno tra `spedizione`, `locale` o `ritiro`.

Proprietà dello strumento di pagamento del contratto di abbonamento

Dettagli sullo strumento di pagamento per il contratto di abbonamento. Questo strumento di pagamento viene utilizzato per addebitare i costi al cliente. Accedi alle proprietà dello 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 }}

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto dello strumento di pagamento del contratto di abbonamento nei modelli di notifica.
Proprietà	Descrizione
`payment_type`	Il tipo di metodo di pagamento rappresentato dallo strumento di pagamento. Usa i filtri di pagamento per generare l'URL di un'immagine o un SVG.
`credit_card_brand`	Il brand della carta di credito.
`credit_card_company`	Il nome della società emittente della carta di credito.
`credit_card_last_four_digits`	Le ultime 4 cifre della carta di credito.

Proprietà delle notifiche email

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto delle notifiche email nei modelli di notifica.
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 (in pixel) specificata nella sezione Personalizza modelli di email del pannello di controllo.
`shop.email_accent_color`	Il codice HEX per il colore principale specificato nella sezione Personalizza modelli di email del pannello di controllo.

Proprietà del credito in negozio

Le proprietà che contengono i dettagli sull'emissione di un credito in negozio.

Descrizioni delle proprietà Liquid che puoi utilizzare con l'oggetto del credito in negozio emesso nei modelli di notifica.
Proprietà	Descrizione
`issued_store_credit.amount`	L'importo del credito in negozio che è stato emesso. Puoi formattare questo importo utilizzando i filtri money di Liquid.
`issued_store_credit.expires_at`	La data e l'ora di scadenza del credito in negozio emesso. Puoi formattare questa data utilizzando i filtri di data Liquid.
`issued_store_credit.balance_after_transaction`	Il saldo del conto del credito in negozio dopo l'emissione del credito. Puoi formattare questo importo utilizzando i filtri money di Liquid.
`customer`	Oggetto Cliente contenente gli attributi dell'output cliente.