> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# L'oggetto order e le variabili comuni

> Le variabili Liquid che i modelli usano per ordine, cliente, indirizzi, negozio, spedizione, pagamenti, rimborsi ed evasioni.

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](https://foliant-help.iforiti.com/it/template-editor/liquid-money-and-currency.md).

## 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

```liquid theme={null}
<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](https://foliant-help.iforiti.com/it/tax-and-legal.md).

## Articoli correlati

* [Articoli nei modelli](https://foliant-help.iforiti.com/it/template-editor/liquid-line-items.md)
* [Importi e valuta nei modelli](https://foliant-help.iforiti.com/it/template-editor/liquid-money-and-currency.md)
* [Filtri Liquid](https://foliant-help.iforiti.com/it/template-editor/liquid-filters.md)
* [Modifica il codice di un modello](https://foliant-help.iforiti.com/it/template-editor/code-editor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.