> ## 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'objet commande et les variables courantes

> Les variables Liquid utilisées par les modèles pour la commande, le client, les adresses, la boutique, l'expédition, les paiements, les remboursements et les traitements.

Chaque document est généré à partir d'une commande (ou, pour les modèles groupés, des commandes sélectionnées). En Liquid, les champs de la commande sont disponibles directement, par exemple `{{ name }}`, et aussi sous `order`, par exemple `{{ order.name }}`. Les deux fonctionnent de la même façon. Les variables reprennent celles de Shopify Order Printer : la plupart des modèles Order Printer fonctionnent donc tels quels dans Foliant.

L'onglet **Variables Liquid** de l'éditeur de code les liste toutes, avec une recherche. Cet article présente celles que vous utiliserez le plus. Les montants sont exprimés en centimes ; consultez [Montants et devises dans les modèles](https://foliant-help.iforiti.com/fr/template-editor/liquid-money-and-currency.md).

## La commande

| Variable | Ce qu'elle affiche |
| - | - |
| `{{ order_name }}` ou `{{ name }}` | Le nom de la commande, avec # (`#1042`) |
| `{{ order_number }}` | Le numéro de commande (`1042`) |
| `{{ id }}` | L'ID de la commande |
| `{{ po_number }}` | Le numéro de bon de commande |
| `{{ date }}` ou `{{ created_at }}` | La date de passage de la commande. Mettez-la en forme avec le filtre `date`. |
| `{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}` | Les autres dates de la commande |
| `{{ completed_at }}` | La date de finalisation d'un brouillon de commande |
| `{{ financial_status }}` | Le statut du paiement, par exemple `paid`, `pending` ou `partially_refunded` |
| `{{ fulfillment_status }}` | Le statut de traitement, par exemple `unfulfilled` ou `fulfilled` |
| `{{ note }}` | La remarque de la commande |
| `{{ tags }}` | Les balises de la commande (une liste : parcourez-la avec `{% for tag in tags %}`) |
| `{{ email }}` | L'adresse e-mail de la commande |
| `{{ customer_locale }}` | La langue dans laquelle le client a fait ses achats |
| `{{ order_status_url }}` | Le lien vers la page d'état de la commande (commandes en ligne) |
| `{{ total_items }}` ou `{{ item_count }}` | Le nombre d'articles |
| `{{ total_weight }}` | Le poids total ; `{{ total_weight_in_grams \| weight_with_unit }}` ajoute l'unité |
| `{{ order_currency }}` ou `{{ currency }}` | Le code de devise de la commande |
| `{% if pickup_in_store? %}…{% endif %}` | Si la commande est retirée en magasin |
| `{{ location.name }}` | L'emplacement POS (commandes POS), avec `address1`, `city`, `zip`, `country`, `phone`… |

## Totaux

Affichez les totaux avec un filtre de montant, par exemple `{{ total_price | money }}`.

| Variable | Ce que c'est |
| - | - |
| `subtotal_price` | Le sous-total |
| `shipping_price` | L'expédition |
| `total_discounts` | Toutes les réductions |
| `order_level_discounts` | Les réductions sur toute la commande (non incluses dans les prix des lignes) |
| `total_tax` | Les taxes |
| `total_line_items_tax`, `total_shipping_tax` | Les taxes sur les articles et sur l'expédition |
| `total_duties` | Les droits de douane |
| `total_price` | Le total de la commande |
| `total_paid` | Le montant payé |
| `total_refunds` | Le montant remboursé |
| `total_gift_cards` | Le montant payé par cartes-cadeaux |

`current_subtotal_price`, `current_total_discounts`, `current_total_tax` et `current_total_price` sont aussi disponibles.

## Client et adresses

| Variable | Ce qu'elle affiche |
| - | - |
| `{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}` | Le nom du client |
| `{{ customer.email }}`, `{{ customer.phone }}` | Les coordonnées |
| `{{ customer.note }}` | La remarque sur le client |
| `{{ customer.tags }}` | Les balises du client |
| `{{ customer.total_spent \| money }}` | Le montant dépensé par le client |
| `{% if customer.tax_exempt %}` | Si le client est exonéré de taxes |
| `{{ shipping_address \| format_address }}` | L'adresse d'expédition, mise en forme avec des retours à la ligne |
| `{{ billing_address \| format_address }}` | L'adresse de facturation |

Chaque adresse (`shipping_address`, `billing_address` et `customer.default_address`) comporte `name`, `first_name`, `last_name`, `company`, `address1`, `address2`, `street`, `city`, `province`, `province_code`, `zip`, `country`, `country_code`, `phone` et `city_province_zip`. `{% if shipping_address.member_of_eu %}` vérifie si le pays fait partie de l'UE.

## Votre boutique

| Variable | Ce qu'elle affiche |
| - | - |
| `{{ shop.name }}` ou `{{ shop_name }}` | Le nom de votre boutique |
| `{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}` | Les coordonnées |
| `{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`… | Votre adresse, telle que définie dans Shopify |
| `{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}` | Votre logo et votre couleur d'accent, définis dans **Paramètres › Image de marque** |
| `{{ shop.vat_number }}`, `{{ shop.eori }}` | Votre numéro de TVA et votre numéro EORI, définis dans **Paramètres › Taxes et mentions légales** |
| `{{ seller.legal_lines \| join: ' · ' }}` | Vos mentions légales, une par ligne, dans la langue du document |

## Expédition, paiements et traitements

| Variable | Ce qu'elle affiche |
| - | - |
| `{{ shipping_method.title }}` | Le mode d'expédition |
| `{% for shipping_line in shipping_lines %}` | Chaque ligne d'expédition : `title`, `code`, `price` |
| `{{ payment_method }}`, `{{ gateway }}` | Le mode de paiement de la commande |
| `{% for transaction in transactions %}` | Chaque transaction : `amount`, `kind`, `status`, `gateway`, `created_at` |
| `{% for tax_line in tax_lines %}` | Chaque taxe : `title`, `rate`, `price` |
| `{% for discount in discounts %}` | Chaque réduction : `code`, `amount`, `savings` |
| `{% for fulfillment in fulfillments %}` | Chaque traitement : `tracking_number`, `tracking_company`, `created_at` |
| `{{ latest_fulfillment }}` | Le traitement le plus récent |
| `{% for refund in refunds %}` | Chaque remboursement : `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items` |
| `{{ latest_refund }}` | Le remboursement le plus récent (avoirs) |
| `{{ payment_terms.due_in_days }}` | Les conditions de paiement (commandes B2B et brouillons de commande), avec `payment_schedules` et `current_payment_schedule.due_at` |

## Exemple

```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 %}
```

## Bon à savoir

* Une valeur vide n'affiche rien. Utilisez `{% if … != blank %}` pour masquer un libellé quand il n'y a pas de valeur.
* Les modèles pour toutes les commandes sélectionnées utilisent `orders` (parcourez-les avec `{% for order in orders %}`), `batch` et `pick_list` au lieu d'une seule commande. Consultez la section **Modèles groupés** de l'onglet **Variables Liquid**.
* Pour les factures avec TVA, consultez la section **TVA** de la référence : `tax_breakdown`, `buyer.vat_number`, `{% include 'vat_breakdown' %}` et `{% include 'legal_notes' %}`. Consultez [Taxes et mentions légales](https://foliant-help.iforiti.com/fr/tax-and-legal.md).

## Articles associés

* [Lignes d'articles dans les modèles](https://foliant-help.iforiti.com/fr/template-editor/liquid-line-items.md)
* [Montants et devises dans les modèles](https://foliant-help.iforiti.com/fr/template-editor/liquid-money-and-currency.md)
* [Filtres Liquid](https://foliant-help.iforiti.com/fr/template-editor/liquid-filters.md)
* [Modifier le code d'un modèle](https://foliant-help.iforiti.com/fr/template-editor/code-editor.md)


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