L'oggetto order e le variabili comuni

Ogni documento viene generato da un ordine (o, per i modelli cumulativi, dagli ordini selezionati). In Liquid, i campi dell’ordine sono disponibili direttamente, come {{ name }}, e anche sotto order, come {{ order.name }}. Funzionano allo stesso modo. Le variabili seguono quelle di Shopify Order Printer, quindi la maggior parte dei modelli di Order Printer funziona in Foliant così com’è. La scheda Variabili Liquid nell’editor del codice le elenca tutte, con una ricerca. Questo articolo tratta quelle che userai più spesso. Gli importi sono in centesimi; consulta Importi e valuta nei modelli.

L’ordine

Variabile	Cosa stampa
`{{ order_name }}` o `{{ name }}`	Il nome dell’ordine, con # (`#1042`)
`{{ order_number }}`	Il numero dell’ordine (`1042`)
`{{ id }}`	L’ID dell’ordine
`{{ po_number }}`	Il numero dell’ordine d’acquisto
`{{ date }}` o `{{ created_at }}`	Quando è stato effettuato l’ordine. Formattalo con il filtro `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Altre date dell’ordine
`{{ completed_at }}`	Quando è stata completata una bozza di ordine
`{{ financial_status }}`	Lo stato del pagamento, come `paid`, `pending` o `partially_refunded`
`{{ fulfillment_status }}`	Lo stato di evasione, come `unfulfilled` o `fulfilled`
`{{ note }}`	La nota dell’ordine
`{{ tags }}`	I tag dell’ordine (una lista: scorrila con `{% for tag in tags %}`)
`{{ email }}`	L’email dell’ordine
`{{ customer_locale }}`	La lingua in cui il cliente ha acquistato
`{{ order_status_url }}`	Il link alla pagina di stato dell’ordine (ordini online)
`{{ total_items }}` o `{{ item_count }}`	Quanti articoli
`{{ total_weight }}`	Il peso totale; `{{ total_weight_in_grams \| weight_with_unit }}` aggiunge l’unità
`{{ order_currency }}` o `{{ currency }}`	Il codice valuta dell’ordine
`{% if pickup_in_store? %}…{% endif %}`	Se l’ordine viene ritirato in negozio
`{{ location.name }}`	La sede POS (ordini POS), con `address1`, `city`, `zip`, `country`, `phone`…

Totali

Stampa i totali con un filtro per gli importi, ad esempio {{ total_price | money }}.

Variabile	Cos’è
`subtotal_price`	Il subtotale
`shipping_price`	La spedizione
`total_discounts`	Tutti gli sconti
`order_level_discounts`	Gli sconti sull’intero ordine (non inclusi nei prezzi delle righe)
`total_tax`	Le imposte
`total_line_items_tax`, `total_shipping_tax`	Le imposte sugli articoli e sulla spedizione
`total_duties`	I dazi
`total_price`	Il totale dell’ordine
`total_paid`	L’importo pagato
`total_refunds`	L’importo rimborsato
`total_gift_cards`	L’importo pagato con carte regalo

Sono disponibili anche current_subtotal_price, current_total_discounts, current_total_tax e current_total_price.

Cliente e indirizzi

Variabile	Cosa stampa
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Il nome del cliente
`{{ customer.email }}`, `{{ customer.phone }}`	I recapiti
`{{ customer.note }}`	La nota sul cliente
`{{ customer.tags }}`	I tag del cliente
`{{ customer.total_spent \| money }}`	Quanto ha speso il cliente
`{% if customer.tax_exempt %}`	Se il cliente è esente da imposte
`{{ shipping_address \| format_address }}`	L’indirizzo di spedizione, impaginato con interruzioni di riga
`{{ billing_address \| format_address }}`	L’indirizzo di fatturazione

Ogni indirizzo (shipping_address, billing_address e customer.default_address) ha name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone e city_province_zip. {% if shipping_address.member_of_eu %} verifica se il paese è nell’UE.

Il tuo negozio

Variabile	Cosa stampa
`{{ shop.name }}` o `{{ shop_name }}`	Il nome del tuo negozio
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	I recapiti
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Il tuo indirizzo, come impostato in Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Il tuo logo e il colore principale da Impostazioni › Branding
`{{ shop.vat_number }}`, `{{ shop.eori }}`	La tua partita IVA e il codice EORI da Impostazioni › Imposte e dati legali
`{{ seller.legal_lines \| join: ' · ' }}`	I tuoi dati legali, uno per riga, nella lingua del documento

Spedizione, pagamenti ed evasioni

Variabile	Cosa stampa
`{{ shipping_method.title }}`	Il metodo di spedizione
`{% for shipping_line in shipping_lines %}`	Ogni riga di spedizione: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Come è stato pagato l’ordine
`{% for transaction in transactions %}`	Ogni transazione: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Ogni imposta: `title`, `rate`, `price`
`{% for discount in discounts %}`	Ogni sconto: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Ogni evasione: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	L’evasione più recente
`{% for refund in refunds %}`	Ogni rimborso: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Il rimborso più recente (note di credito)
`{{ payment_terms.due_in_days }}`	I termini di pagamento (B2B e bozze di ordini), con `payment_schedules` e `current_payment_schedule.due_at`

Esempio

<h1>{{ 'titles.invoice' | t }} {{ order_name }}</h1>
<p>{{ created_at | date: '%d %B %Y' }}</p>
<p>{{ shipping_address | format_address }}</p>
<p>{{ 'total' | t }}: {{ total_price | money }}</p>
{% if note != blank %}<p>{{ note | escape }}</p>{% endif %}

Buono a sapersi

Un valore vuoto non stampa nulla. Usa {% if … != blank %} per omettere un’etichetta quando non c’è un valore.
I modelli per tutti gli ordini selezionati usano orders (scorrili con {% for order in orders %}), batch e pick_list invece di un singolo ordine. Consulta la sezione Modelli cumulativi della scheda Variabili Liquid.
Per le fatture con IVA, consulta la sezione IVA del riferimento: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} e {% include 'legal_notes' %}. Consulta Imposte e dati legali.

Benvenuto

Primi passi

Stampa

Modelli

Editor dei modelli

Design

Invio dei PDF

Modelli email

Account cliente

Esportazioni

Fatture e numerazione

Imposte e dati legali

Integrazioni

Fatturazione e piani

Impostazioni

Risoluzione dei problemi

Note legali