L'objet commande et les variables courantes

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.

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

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

Bienvenue

Premiers pas

Impression

Modèles

Éditeur de modèles

Designs

Envoi des PDF

Modèles d'e-mail

Comptes clients

Exportations

Factures et numérotation

Taxes et mentions légales

Intégrations

Facturation et forfaits

Paramètres

Dépannage

Mentions légales