Référence sur les variables de notification

Les notifications envoyées depuis votre boutique sont générées à l’aide de Liquid. Liquid est le langage de programmation simple et facile à utiliser de Shopify. C’est le même langage de programmation que celui sur lequel sont basés les thèmes de la boutique de thèmes.

Pour modifier les notifications qui sont envoyées depuis votre boutique, vous pouvez apporter des personnalisations de base à vos modèles de notification. Pour accéder à la liste complète des notifications que vous pouvez personnaliser, accédez à la page Notifications dans votre interface administrateur Shopify.

Pour obtenir de l’aide sur des modifications plus avancées ou pour modifier des modèles de notification personnalisés, vous pouvez contacter la communauté sur nos forums ou engager un Partenaire Shopify pour qu’il effectue les personnalisations à votre place. En savoir plus sur l’engagement d’un Partenaire Shopify.

Sur cette page

Propriétés de la commande

De nombreuses propriétés d’une commande sont disponibles directement dans Liquid et dans les modèles.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de la commande dans les modèles de notification
Propriété	Description
`id`	Un ID unique de la commande à l’échelle du système pour un usage interne. Utilisez l’exemple suivant pour générer un lien vers la commande dans la section de l’interface administrateur de votre boutique. Par exemple, dans votre modèle Nouvelle commande, vous pouvez ajouter le code suivant : `Voir la commande`
`email`	L’e-mail associé à la commande.
`name`	Généralement, il s’agit d’un dièse suivi du `order_number`. Exemple : #1004
`order_name`	Identique à name.
`order_number`	Numéro de commande unique de la boutique, sans le préfixe dièse (#) ni les préfixes ou suffixes ajoutés à la référence de la commande par le propriétaire de la boutique dans ses préférences. Exemple : 1004
`confirmation_number`	Un identifiant alphanumérique généré de manière aléatoire pour la commande, qui peut être présenté au client à la place du nom séquentiel de la commande. Il n’est pas garanti que cette valeur soit unique. Exemple : XPAV284CT
`created_at`	La date et l’heure auxquelles le client a créé la commande. Vous pouvez mettre cette valeur en forme à l’aide du filtre de date. Exemple : 2009-05-30T17:43:51+02:00
`payment_terms`	Les modalités de paiement indiquent la date d’échéance du paiement d’une commande. Découvrez comment ajouter des modalités de paiement aux factures de commande. Pour plus de détails, consultez la référence Liquid pour payment_terms.
`destination`	La destination où les articles doivent être envoyés.
`tags`	Renvoie un tableau de toutes les balises de la commande. Les balises sont renvoyées par ordre alphabétique. Les balises qui sont appliquées de manière dynamique par des applis ou des fonctionnalités de la plateforme, telles que la balise `Shopify Collective`, peuvent ne pas être disponibles lors de la génération de l’e-mail de notification. Pour détecter les articles d’une fonctionnalité spécifique, vérifiez plutôt les balises au niveau du produit pour chaque article du panier. Consultez la documentation de référence Liquid pour plus de détails.
`transactions`	Renvoie un tableau des transactions de la commande.
`tax_price`	Le total des taxes de tous les articles de la commande.
`tax_lines`	Taxes ventilées par type de taxation : `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Le nom de la taxe. Par exemple, TVQ ou TVA.
`tax_line.price`	Le montant de la taxe.
`tax_line.rate`	Le taux de taxation au format décimal. Cette variable renverra 0,175 si le taux est de 17,5 %.
`tax_line.rate_percentage`	Le taux de taxation dans un format lisible. Cette variable renverra 17,5 si le taux est de 0,175.
`customer`	Objet Client contenant les attributs de la sortie client.
`billing_address`	L’adresse de facturation.
`billing_address.first_name`	Prénom du client.
`billing_address.last_name`	Nom de famille du client.
`billing_address.company`	Nom de l’entreprise pour la facturation.
`billing_address.phone`	Numéro de téléphone de l’adresse de facturation.
`shop.name`	Nom de votre boutique.
`shop.phone`	Le numéro de téléphone de votre boutique.
`subtotal_price`	Somme des prix des articles de la commande après déduction de toute réduction appliquée à un article ou au panier. Le sous-total n’inclut pas les taxes (sauf si elles sont comprises dans les prix), les coûts d’expédition ou les pourboires.
`discounts`	Une liste de réductions.
`discounts_amount`	Le montant de la réduction appliqué par l’ensemble des réductions. Exemple : +5,00 $
`discounts_savings`	Le montant de l’économie réalisée grâce à toutes les réductions. Exemple : -5,00 $
`total_price`	Total de la commande (sous-total + coûts d’expédition - réduction sur l’expédition + taxe).
`financial_status`	Le statut de paiement actuel. L’un des suivants : nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(booléen) Renvoie true s’il y a au moins un article dans la commande qui nécessite une expédition.
`shipping_method.title`	Le nom du tarif d’expédition. Dans les notifications destinées aux clients, le nom du tarif d’expédition est traduit dans la langue de paiement du client, lorsque celle-ci est différente de la langue par défaut de la boutique. Exemple : Expédition standard
`shipping_method.price`	Le prix de l’expédition, y compris toute réduction sur l’expédition. Exemple : `{{ shipping_method.price \| money }}`
`shipping_price`	Le prix de l’expédition. Exemple : `{{ shipping_price \| money }}`
`shipping_address`	L’adresse de livraison.
`shipping_address.first_name`	Le prénom pour l’adresse de livraison.
`shipping_address.company`	Nom de l’entreprise pour l’adresse de livraison.
`shipping_address.phone`	Numéro de téléphone de l’adresse de livraison.
`line_items`	Liste de tous les articles du panier de la commande.
`line_items_including_zero_quantity`	Liste de tous les articles du panier de la commande, y compris ceux dont la quantité est de zéro. Les articles du panier ont une quantité de zéro lorsqu’ils sont entièrement remboursés.
`line_item_groups`(Orders and POS only)	Liste de tous les groupes d’articles du panier de la commande contenant des composants d’article du panier.
`item_count`	La somme des quantités de tous les articles.
`fulfillment_status`	Le statut actuel du traitement de la commande. L’un des suivants : `unfulfilled`, `partial` ou `fulfilled`.
`note`	La note qui est jointe à la commande. Elle peut provenir du client et/ou être modifiée dans l’écran des détails de la commande de votre interface administrateur.
`attributes`	Tous les attributs qui ont été joints à la commande. Exemple : `{{ attributes.gift-note }}`
`metafields`	Tous les champs méta de la commande. Utilisez la syntaxe suivante : metafields.NAMESPACE.KEY
`referring_site`	Contient l’URL du référent qui a amené le client sur votre boutique. Exemple : `https://www.google.com/?s=great+products`
`landing_site`	Contient le chemin d’accès de la page de destination utilisée par le client. Il s’agit de la première page que le client a vue en arrivant sur la boutique. Exemple : `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Examine la page de destination et en extrait un paramètre de référence. Les paramètres de référence peuvent être : `ref`, `source` ou `r`. Si la valeur de `landing_site` est `/products/great-product?ref=my-tracking-token`, alors `landing_site_ref` est `my-tracking-token`. Vous pouvez effectuer une certaine action si votre référence est égale à une certaine valeur : `{% if landing_site_ref == 'my-tracking-token' %} Mon action... {% endif %}`
`cancelled`	(booléen) Renvoie true si la commande a été annulée.
`cancelled_at`	L’heure à laquelle la commande a été annulée.
`cancel_reason`	Le motif sélectionné lors de l’annulation de la commande. L’un des suivants : `inventory`, `customer`, `declined`, `fraud` ou `other`.
`has_high_risks?`(deprecated)	Renvoie true si la commande présente un risque élevé
`unique_gateways`	Renvoie une liste des fournisseurs de services de paiement uniques d’une commande. Par exemple, si une personne a payé avec une carte Visa, une Mastercard et en espèces, la liste renvoyée sera `shopify_payments, cash`.
`location`(POS only)	Affiche l’emplacement physique de la commande. Plusieurs propriétés d’emplacement sont disponibles et répertoriées ici. Vous pouvez configurer les emplacements dans la section Emplacements de l’interface administrateur.
`order_status_url`	Renvoie le lien vers la page de statut de cette commande.
`fulfilled_line_items`(deprecated)	Liste des articles du panier qui ont été traités.
`unfulfilled_line_items`(deprecated)	Liste des articles du panier qui n’ont pas été entièrement traités.
`b2b?`	Renvoie true si la commande est une commande B2B. Utilisez la propriété avec les variables B2B pour afficher des informations pertinentes, telles que le nom de l’entreprise, l’emplacement d’entreprise et l’adresse dans les e-mails. Par exemple, sur les commandes B2B, vous pouvez ajouter un en-tête à un modèle avec les informations suivantes : `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	L’entreprise à laquelle vous vendez dans le cadre d’une commande B2B.
`company.name`	Le nom de l’entreprise sur une commande B2B.
`company.id`	L’ID de l’entreprise sur une commande B2B.
`company_location`	L’emplacement de l’entreprise sur une commande B2B. Une entreprise qui achète chez vous peut avoir plusieurs emplacements.
`company_location.name`	Le nom de l’emplacement d’entreprise sur une commande B2B.
`company_location.id`	Le numéro d’ID de l’emplacement d’entreprise sur une commande B2B.
`company_location.shipping_address`	L’adresse de livraison de l’emplacement d’entreprise sur une commande B2B.
`company_location.billing_address`	L’adresse de facturation de l’emplacement d’entreprise sur une commande B2B.
`customer_order_url`	La nouvelle page de statut de commande d’une commande pour laquelle un client a demandé un retour en utilisant les comptes client.

Propriétés de la commande provisoire

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de commande provisoire dans les modèles de notification
Propriété	Description
`id`	Un ID unique de la commande provisoire pour un usage interne.
`invoice_url`	Un lien que le client peut suivre pour payer la facture en utilisant le paiement sécurisé de Shopify.
`reserve_inventory_until`	La date et l’heure jusqu’auxquelles les articles de la commande provisoire sont réservés, par exemple : `2015-05-30T17:43:51+02:00`. Vous pouvez mettre en forme les dates à l’aide du filtre de date Liquid.
`user`	Le dernier employé ayant modifié la commande provisoire.
`user.name`	Le nom du dernier employé ayant modifié la commande provisoire.
`user.email`	L’adresse e-mail du dernier employé ayant modifié la commande provisoire.
`email`	L’adresse e-mail associée à la commande provisoire.
`name`	L’unique `number` de la commande provisoire, précédé du symbole dièse `#`.
`number`	Le numéro unique de la commande provisoire sans le préfixe ni le suffixe de la commande.
`created_at`	La date et l’heure auxquelles le client a créé la commande provisoire, par exemple : `2009-05-30T17:43:51+02:00`. Vous pouvez mettre en forme les dates à l’aide du filtre de date Liquid.
`tags`	Renvoie un tableau de toutes les balises de la commande. Les balises sont renvoyées par ordre alphabétique. Pour en savoir plus, consultez la documentation de référence de Liquid.
`tax_price`	Le total des taxes pour tous les articles de la commande provisoire.
`tax_lines`	Taxes réparties par type de taxe : `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Le nom de la taxe. Exemples : QST ou TVA
`tax_line.price`	Le montant de la taxe.
`tax_line.rate`	Le taux de taxation sous forme décimale. Par exemple, un taux de taxation de 17,5 % renverra `0,175`.
`tax_line.rate_percentage`	Le taux de taxation sous forme de pourcentage. Par exemple, un `taux` de 0,175 renverra `17,5`.
`customer`	Objet Client contenant les attributs de la sortie client.
`billing_address`	L’adresse de facturation de la commande provisoire.
`billing_address.first_name`	Le prénom du client.
`billing_address.last_name`	Le nom de famille du client.
`billing_address.company`	Le nom de l’entreprise dans l’adresse de facturation.
`billing_address.phone`	Le numéro de téléphone dans l’adresse de facturation.
`shop.name`	Le nom de votre boutique.
`shop.phone`	Le numéro de téléphone de votre boutique.
`subtotal_price`	Somme des prix des articles de la commande provisoire après déduction de toute réduction sur un article du panier ou sur le panier. Le sous-total n’inclut pas les taxes (sauf si les taxes sont incluses dans les prix) ni les coûts d’expédition.
`discounts`	Une liste de réductions.
`discounts_amount`	Montant total des réductions. Exemple : +5,00 $
`discounts_savings`	Montant des économies réalisées grâce à toutes les réductions. Exemple : -5,00 $
`total_price`	Le prix total de la commande (sous-total + coûts d’expédition - réduction sur l’expédition + taxe).
`amount_due_now`	Le montant requis par la facture de la commande provisoire.
`requires_shipping`	Renvoie `true` s’il y a au moins un article dans la commande provisoire qui nécessite une expédition. Renvoie `false` si aucun article de la commande provisoire ne nécessite d’expédition.
`shipping_method.title`	Le nom du tarif d’expédition. Exemple : Expédition standard
`shipping_method.price`	Le prix du mode d’expédition. Renvoie la même information que `shipping_price`.
`shipping_price`	Le prix de l’expédition. Vous pouvez mettre en forme ce montant à l’aide des filtres monétaires Liquid.
`shipping_address`	L’adresse de livraison. Remarque : contrairement aux commandes habituelles, l’adresse de livraison d’une commande provisoire peut être incomplète.
`shipping_address.first_name`	Le prénom pour l’adresse de livraison.
`shipping_address.company`	Le nom de l’entreprise dans l’adresse de livraison.
`shipping_address.phone`	Le numéro de téléphone dans l’adresse de livraison.
`line_items`	Une liste de tous les articles du panier de la commande provisoire.
`item_count`	La somme de toutes les quantités d’articles de la commande provisoire.
`note`	La note jointe à la commande provisoire. La note peut être obtenue auprès du client et également modifiée dans l’écran des détails de la commande provisoire de votre interface administrateur Shopify.
`metafields`	Tous les champs méta de la commande provisoire. Utilisez la syntaxe suivante : metafields.NAMESPACE.KEY
`location`	L’emplacement physique de la commande. Plusieurs propriétés d’emplacement sont disponibles. Vous pouvez configurer les emplacements sur la page Emplacements de votre interface administrateur Shopify.
`b2b?`	Renvoie true si la commande est une commande B2B. Utilisez la propriété avec les variables B2B pour afficher des informations pertinentes, telles que le nom de l’entreprise, l’emplacement d’entreprise et l’adresse dans les e-mails. Par exemple, sur les commandes B2B, vous pouvez ajouter un en-tête à un modèle avec les informations suivantes : `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	L’entreprise à laquelle vous vendez dans le cadre d’une commande B2B.
`company.name`	Le nom de l’entreprise sur une commande B2B.
`company.id`	L’ID de l’entreprise sur une commande B2B.
`company_location`	L’emplacement de l’entreprise sur une commande B2B. Une entreprise qui achète chez vous peut avoir plusieurs emplacements.
`company_location.name`	Le nom de l’emplacement d’entreprise sur une commande B2B.
`company_location.id`	Le numéro d’ID de l’emplacement d’entreprise sur une commande B2B.
`company_location.shipping_address`	L’adresse de livraison de l’emplacement d’entreprise sur une commande B2B.
`company_location.billing_address`	L’adresse de facturation de l’emplacement d’entreprise sur une commande B2B.
`payment_methods`	Une liste de moyens de paiement enregistrés disponibles pour traiter le total de la commande provisoire.
`payment_method.payment_instrument`	L’instrument de paiement, qui contient des détails sur le moyen de paiement enregistré.
`payment_method.payment_instrument.payment_type`	Le type de moyen de paiement enregistré. Par exemple : « credit_card, apple_pay »
`payment_method.payment_instrument.credit_card_brand`	La marque de la carte, lorsque `payment_type` est « credit_card »
`payment_method.payment_instrument.credit_card_company`	La société émettrice de la carte, lorsque `payment_type` est « credit_card »
`payment_method.payment_instrument.credit_card_company`	Les 4 derniers chiffres de la carte, lorsque `payment_type` est « credit_card »

Propriétés de l’échéancier de paiement

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet `payment_schedule` dans les modèles de notification
Propriété	Description
`payment_schedule.amount_due`	Le montant à payer pour un échéancier de paiement. Vous pouvez formater les montants avec les devises en utilisant le filtre money de Liquid.
`payment_schedule.due_at`	La date d’échéance de l’échéancier de paiement. Vous pouvez mettre en forme les dates à l’aide du filtre de date Liquid.
`payment_schedule.due_in_days`	Le nombre de jours jusqu’à la date d’échéance si l’échéancier de paiement est toujours dû (impayé).
`payment_schedule.due_later?`	Renvoie `true` si un échéancier de paiement n’a pas été réglé et que sa date d’échéance est ultérieure.
`payment_schedule.number_of_days_overdue?`	Le nombre de jours écoulés depuis la date d’échéance lorsqu’un échéancier de paiement est en retard.
`payment_schedule.overdue?`	Renvoie `true` si un échéancier de paiement n’a pas été réglé et que sa date d’échéance est passée.

Propriétés du statut de paiement

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de statut de paiement dans les modèles de notification
Propriété	Description
`has_pending_payment`	(booléen) Renvoie `true` si la commande comporte une transaction avec un paiement en attente. En savoir plus sur les paiements en attente.
`buyer_action_required`	(booléen) Renvoie `true` si une commande comporte une transaction avec un paiement en attente et qu’une action de l’acheteur est requise pour débloquer le paiement. Lorsque cette valeur renvoie `true` et que le moyen de paiement prend en charge les instructions de paiement, le `buyer_pending_payment_instructions` fournit des détails que le client peut utiliser pour finaliser son achat hors ligne. En savoir plus sur l’objet transaction de Liquid.

Propriétés des composants de lot

Chaque bundle_component de la liste de line_item.bundle_components possède les propriétés suivantes. (Commandes provisoires uniquement)

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de composant de lot dans les modèles de notification
Propriété	Description
`bundle_component.image_url`	L’URL de l’image du composant de lot.
`bundle_component.product.title`	Le titre du produit du composant de lot.
`bundle_component.quantity`	Quantité pour le composant de lot.
`bundle_component.variant.title`	Les noms actuels des valeurs d’option de la variante du composant de lot, joints par des caractères `/`. Exemple : petit / rouge

Propriétés des composants

Chaque component de la liste de line_item.components possède les propriétés suivantes. (Paiement abandonné uniquement) `

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de composant dans les modèles de notification
Propriété	Description
`component.image_url`	L’URL de l’image du composant.
`component.product.title`	Le titre du produit du composant.
`component.quantity`	Quantité pour le composant.
`component.variant.title`	Les noms actuels des valeurs d’option de la variante du composant, joints par des caractères `/`. Exemple : petit / rouge

Propriétés de l’article du panier

Chaque line de la liste line_items ou subtotal_line_items possède les propriétés suivantes.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet d’article du panier dans les modèles de notification
Propriété	Description
`line.applied_discounts`(POS and draft orders only)	Liste des réductions appliquées à cet article (chaque réduction possède les propriétés `title`, `code`, `amount`, `savings` et `type`).
`line.bundle_components`(Draft orders only)	Liste des articles du panier qui sont des composants de lot de cet article. Ne renvoie une liste que si cet article du panier est un produit en lot.
`line.bundle_parent?`(Draft orders only)	(booléen) Renvoie `true` si l’article du panier est un produit en lot.
`line.components`(Abandoned checkout only)	Liste des articles du panier qui sont des composants de cet article.
`line.parent?`(Abandoned checkout only)	(booléen) Renvoie `true` si l’article du panier a des composants.
`line.custom`(Draft orders only)	(booléen) Renvoie `true` si l’article est un article du panier personnalisé pour une commande provisoire.
`line.delivery_agreement`	Le contrat de livraison associé à cet article du panier.
`line.grams`	Poids d’un seul article.
`line.groups`	Groupe d’articles du panier de l’article.
`line.image`	Renvoie l’URL de l’image associée à cet article du panier. Vous pouvez également utiliser le filtre img_url pour obtenir des tailles d’image spécifiques, par exemple `{{ line.image \| img_url: 'small' }}`
`line.line_price`	Le prix multiplié par la quantité pour cet article.
`line.original_line_price`	Le prix combiné de la quantité d’articles inclus dans l’article du panier, avant l’application des réductions.
`line.final_line_price`	Le prix combiné de tous les articles de l’article du panier, y compris tous les montants de réduction au niveau de l’article.
`line.pre_tax_price`	Le prix hors taxes des articles du panier, multiplié par la quantité de l’article du panier acheté.
`line.price`	Le prix d’un seul article.
`line.product.metafields`	Tous les champs méta au niveau du produit. Utilisez la syntaxe suivante : line.product.metafields.NAMESPACE.KEY
`line.product.title`	Le nom actuel du produit.
`line.product.vendor`	Le fournisseur de l’article.
`line.properties`	Renvoie un tableau d’informations personnalisées pour un article. Les propriétés de l’article du panier sont spécifiées par le client sur la page de produit, avant d’ajouter un produit au panier.
`line.quantity`	Quantité pour cet article.
`line.current_quantity`	La quantité actuelle de l’article après les retraits.
`line.requires_shipping`	(booléen) Renvoie `true` si la variante de l’article a le paramètre Produit physique activé sur la page de produit.
`line.selling_plan_allocation`	Renvoie un objet `selling_plan_allocation`, qui décrit comment un forfait de vente tel qu’un abonnement influe sur l’article du panier.
`line.taxable`	(booléen) Renvoie `true` si la variante de l’article a la case à cocher « Appliquer les taxes sur ce produit » sélectionnée sur la page de produit.
`line.title`	Le nom du produit au moment de la vente, suivi d’un tiret et du nom de la variante au moment de la vente. Le nom de la variante n’est pas inclus lorsqu’il s’agit d’un « Titre par défaut ». Dans les notifications destinées aux clients, le nom du produit et le nom de la variante sont traduits dans la langue que le client a utilisée lors du paiement, lorsque cette langue est différente de la langue par défaut de la boutique.
`line.url`	L’URL relative de la variante de l’article du panier. L’URL relative n’inclut pas l’URL racine de votre boutique (`mystore.myshopify.com`).
`line.variant.barcode`	Le code-barres associé à la variante de produit.
`line.variant.compare_at_price`	Le prix de comparaison associé à la variante de produit.
`line.variant.image`	L’image de la variante de produit. Renvoie une image uniquement si une image spécifique est attribuée à la variante dans l’article du panier.
`line.variant.metafields`	Tous les champs méta au niveau de la variante. Utilisez la syntaxe suivante : line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	Le SKU associé à la variante de produit.
`line.variant.title`	Les noms actuels des valeurs d’option de la variante, joints par des caractères `/`. Exemple : petit / rouge
`line.refunded.quantity`(within refund notifications)	La quantité d’un article à rembourser. Vous pouvez utiliser cette propriété pour ajouter un identifiant aux articles remboursés dans une commande. Par exemple : `{% if line.refunded_quantity > 0 %}Identifiant d’article remboursé{% endif %}`

Détecter les articles Shopify Collective dans les modèles de notification

La balise Shopify Collective est appliquée à une commande après l’envoi de l’e-mail de confirmation de commande. Par conséquent, {% if tags contains 'Shopify Collective' %} n’est jamais true dans un modèle de confirmation de commande. Pour détecter les articles Shopify Collective, vérifiez plutôt les balises au niveau du produit pour chaque article du panier :

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

Propriétés du groupe d’articles du panier

Chaque line_item_group de la liste de line_item_groups possède les propriétés suivantes.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de groupe d’articles du panier dans les modèles de notification
Propriété	Description
`line_item_group.display_title`	Le titre du groupe d’articles du panier.
`line_item_group.components`	Liste des composants d’articles du panier appartenant au groupe.
`line_item_group.image`	L’image du groupe d’articles du panier.
`line_item_group.product_id`	L’ID de produit du groupe d’articles du panier.
`line_item_group.variant`	L’objet de variante du groupe d’articles du panier.
`line_item_group.variant_id`	L’ID de variante du groupe d’articles du panier.

Propriétés des remboursements

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de remboursement dans les modèles de notification
Propriété	Description
`amount`	Le montant remboursé.
`refund_line_items`	Une liste des articles du panier à rembourser.

Propriétés de l’article du panier de remboursement

Chaque refund_line de la liste de refund_line_items possède les propriétés suivantes :

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet d’articles du panier de remboursement dans les modèles de notification
Propriété	Description
`refund_line.line_item`	L’article du panier qui est remboursé. Cela donne accès à toutes les propriétés de l’article du panier.
`refund_line.quantity`	La quantité de l’article du panier à rembourser.

Propriétés du traitement des commandes

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de traitement des commandes dans les modèles de notification
Propriété	Description
`service_name`	Le nom du service personnalisé tel que défini à la page Paramètres > Expédition et livraison. (Demande de traitement uniquement)
`fulfillment.estimated_delivery_at`	Une date de livraison estimée basée sur le numéro de suivi (le cas échéant) fourni par l’un des transporteurs suivants : USPS, FedEx, UPS, Postes Canada (Canada uniquement). Cette propriété n’est disponible que lorsque les tarifs calculés par le transporteur sont utilisés.
`fulfillment.fulfillment_line_items`	Une liste des articles du panier à traiter.
`fulfillment.item_count`	La somme des quantités de tous les articles. Le nombre total d’articles en cours de traitement.
`fulfillment.requires_shipping`	(booléen) Renvoie « true » si cette demande de traitement nécessite une expédition.
`fulfillment.tracking_company`	L’entreprise qui effectue le suivi.
`fulfillment.tracking_numbers`	Une liste de numéros de suivi.
`fulfillment.tracking_urls`	Une liste d’URL de suivi.
`items_to_fulfill`(deprecated)	Une liste d’articles du panier à traiter par ce service personnalisé de traitement des commandes. (Demande de traitement uniquement)
`items_to_fulfill_count`(deprecated)	Le nombre total d’articles à traiter par cette demande. (Demande de traitement uniquement)

Propriétés de l’article du panier de traitement des commandes

Chaque fulfillment_line de la liste de fulfillment_line_items possède les propriétés suivantes.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet d’articles du panier de traitement des commandes dans les modèles de notification
Propriété	Description
`fulfillment_line.line_item`	L’article du panier en cours de traitement. Cela donne accès à toutes les propriétés de l’article du panier.
`fulfillment_line.quantity`	La quantité de l’article du panier en cours de traitement.

Propriétés du colis préparé

Un colis préparé inclut les articles marqués comme étant prêts pour le retrait.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de colis préparé dans les modèles de notification
Propriété	Description
`item_count`	La somme de toutes les quantités d’articles dans le colis préparé.
`prepared_package_line_items`	Une liste d’articles du panier du colis préparé.

Propriétés de l’article du panier du colis préparé

Chaque prepared_package_line_item de la liste de prepared_package_line_items possède les propriétés suivantes.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet d’article du panier du colis préparé dans les modèles de notification
Propriété	Description
`line_item`	L’article du panier associé. Cela donne accès à toutes les propriétés de l’article du panier.
`quantity`	La quantité de l’article du panier qui a été marqué comme étant prêt pour le retrait.

Propriétés de livraison

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de livraison dans les modèles de notification
Propriété	Description
`delivery_agreements`	Liste de tous les accords de livraison pour la commande.
`delivery_instructions`	Informations sur la livraison locale à partager avec le client. Ces informations sont contrôlées par le champ Informations sur la livraison dans vos paramètres de livraison locale.
`consolidated_estimated_delivery_time`	Informations sur les dates de livraison de la commande à partager avec le client. Ces informations sont contrôlées par le paramètre Temps de traitement que vous configurez sur votre page Expédition et livraison. Lorsque la commande comporte plusieurs modes de livraison, une liste des modes de livraison et des dates s’affiche.
`has_multiple_delivery_methods`	(booléen) Renvoie « true » si la commande comporte plusieurs modes de livraison.

Propriétés de l’accord de livraison

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet d’accord de livraison dans les modèles de notification
Propriété	Description
`delivery_agreement.delivery_method_type`	Le type de mode de livraison.
`delivery_agreement.delivery_method_name`	Le type de mode de livraison traduit dans la langue que l’acheteur a utilisée pour passer à la caisse, lorsque cette langue est différente de la langue par défaut de la boutique.
`delivery_agreement.line_item_groups`	Liste de tous les groupes d’articles du panier contenant des composants d’articles du panier groupés dans l’accord de livraison.
`delivery_agreement.line_items`	Liste de tous les articles du panier associés à cet accord de livraison.

Propriétés de la réduction

Il existe deux types de propriétés de réduction.

Les discount_applications décrivent pourquoi et comment une réduction a été appliquée à un article.

Les discount_allocations décrivent la manière dont une réduction particulière affecte un article du panier et comment elle en réduit le prix. Vous devez utiliser cette propriété au niveau de l’article du panier.

Vous pouvez combiner ces propriétés pour afficher les informations sur la réduction au niveau de l’article du panier ou de la commande.

Exemple

Cet exemple vérifie si une réduction a été appliquée à l’article du panier. Si la réduction n’a pas été appliquée au niveau de la commande (all), le nom et le montant de la réduction s’affichent.

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

Le résultat pourrait ressembler à ceci :

SPRING5 (-$5.00)

Propriétés de discount_allocation

Chaque discount_allocation de la liste discount_allocations possède les propriétés suivantes.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet discount_allocation dans les modèles de notification
Propriété	Description
`discount_allocation.amount`	Le montant économisé par le client sur un article du panier. Doit être saisi dans une boucle si vous souhaitez autoriser plusieurs codes de réduction.
`discount_allocation.discount_application`	L’application de réduction qui alloue le montant à l’article du panier.

Propriétés de discount_application

Chaque discount_application de la liste discount_applications possède les propriétés suivantes.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet discount_application dans les modèles de notification
Propriété	Description
`discount_application.target_selection`	Décrit la manière dont une réduction sélectionne les articles du panier auxquels elle doit être appliquée. L’une des suivantes : `all` : la réduction s’applique à tous les articles du panier. `entitled` : la réduction s’applique à un sous-ensemble particulier d’articles du panier, souvent défini par une condition. `explicit` : la réduction s’applique à un article du panier ou à une ligne d’expédition spécifiquement sélectionné.
`discount_application.target_type`	Le type d’article auquel une réduction s’applique (`line_item` ou `shipping_line`).
`discount_application.title`	Le nom de la réduction visible par le client. Exemples : Welcome10 ou CBBWQQAKYBYY
`discount_application.total_allocated_amount`	Le montant total de la réduction appliquée au prix d’une commande.
`discount_application.type`	Le type de réduction. L’un des suivants : `automatic`, `discount_code`, `manual` ou `script`.
`discount_application.value`	La valeur de la réduction.
`discount_application.value_type`	Le type de valeur de la réduction. L’un des suivants : `fixed_amount` ou `percentage`.

Propriétés d’abonnement

Les détails d’un contrat d’abonnement, du cycle de facturation actuel et de ses articles, de son mode de livraison et de son moyen de paiement sont disponibles pour tous les modèles d’e-mails d’abonnement.

Pour modifier les modèles de notification d’abonnement, installez l’application Shopify Subscriptions, puis recherchez le modèle sous Paramètres > Notifications dans la section Abonnements.

Propriétés du cycle de facturation du contrat d’abonnement

Pour accéder aux propriétés du contrat d’abonnement et de son cycle de facturation, utilisez l’objet subscription_contract_billing_cycle.

Exemple

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Résultat :

This contract is currently paused.

Propriétés

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de cycle de facturation du contrat d’abonnement dans les modèles de notification
Propriété	Description
`status`	L’état du contrat. L’un des suivants : `active`, `paused`, `cancelled`, `failed`, `expired`, `stale`,
`delivery_method`	Le mode de livraison de l’abonnement. Si l’abonnement est destiné à un service ou à un produit numérique, la valeur `nil` est renvoyée.
`billing_frequency`	La fréquence de facturation de l’abonnement.
`delivery_frequency`	La fréquence de livraison de l’abonnement.
`origin_order`	La commande d’origine qui a créé l’abonnement. Si l’abonnement n’a pas été créé à partir d’une commande Shopify, la valeur `nil` est renvoyée.
`customer`	Le client de l’abonnement.
`line_items`	Les articles du cycle de facturation de l’abonnement.
`product_names`	Une liste des noms des produits inclus dans le cycle de facturation de l’abonnement.
`update_payment_method_url`	L’URL que le client peut utiliser pour mettre à jour le moyen de paiement de ce contrat.
`shipping_address`	L’adresse de livraison de l’abonnement. Si l’abonnement est destiné à un service ou à un produit numérique, la valeur `nil` est renvoyée.
`billing_address`	L’adresse de facturation de l’abonnement.
`subtotal_price`	Le sous-total des articles de l’abonnement.
`shipping_price`	Les frais d’expédition de l’abonnement.
`total_tax`	Le montant total des taxes de l’abonnement.
`total_price`	Le prix total de l’abonnement.
`total_discounts`	Le montant total des réductions de l’abonnement.
`customer_self_serve_url`	L’URL de libre-service que le client peut utiliser pour gérer ses abonnements.
`billing_attempt_expected_date`	La date de facturation de ce cycle de facturation.
`next_billing_date`	La prochaine date de facturation non ignorée après ce cycle de facturation.
`last_attempted_billing_date`	La dernière date de tentative de facturation pour le cycle de facturation.
`days_overdue`	Le nombre de jours de retard de la facturation pour ce cycle de facturation.
`payment_instrument`	L’instrument de paiement associé au contrat d’abonnement. Cet instrument de paiement est utilisé pour facturer le client.

Propriétés des articles du contrat d’abonnement

Les propriétés de chaque article inclus dans le cycle de facturation. Accédez aux propriétés des articles du contrat par le biais de la propriété parente subscription_contract_billing_cycle.line_items.

Exemple

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet d’article de contrat d’abonnement dans les modèles de notification
Propriété	Description
`url`	L’URL de la page de détails du produit pour la variante de produit de l’article.
`requires_shipping`	Indique si l’article nécessite une expédition physique.
`unit_price_measurement`	La mesure du prix unitaire de l’article.
`selling_plan_allocation`	L’attribution du plan de vente de l’article.

Propriétés du mode de livraison du contrat d’abonnement

Les propriétés du mode de livraison utilisé dans ce cycle de facturation. Accédez aux propriétés du mode de livraison par le biais de la propriété parent subscription_contract_billing_cycle.delivery_method.

Exemple

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet du mode de livraison du contrat d’abonnement dans les modèles de notification
Propriété	Description
`title`	Le titre de l’option d’expédition associée au mode de livraison.
`type`	Le type de mode de livraison. L’une des valeurs suivantes : `expédition`, `livraison locale` ou `retrait`.

Propriétés de l’instrument de paiement du contrat d’abonnement

Détails sur l’instrument de paiement pour le contrat d’abonnement. Cet instrument de paiement est utilisé pour facturer le client. Accédez aux propriétés de l’instrument de paiement par le biais de la propriété parent subscription_contract_billing_cycle.payment_instrument.

Exemple

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

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de l’instrument de paiement du contrat d’abonnement dans les modèles de notification.
Propriété	Description
`payment_type`	Le type de moyen de paiement représenté par l’instrument de paiement. Utilisez les filtres de paiement pour générer une URL d’image ou un SVG.
`credit_card_brand`	La marque de la carte de crédit.
`credit_card_company`	Le nom de la société émettrice de la carte de crédit.
`credit_card_last_four_digits`	Les 4 derniers chiffres de la carte de crédit.

Propriétés de la notification par e-mail

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet des notifications par e-mail dans les modèles de notification
Propriété	Description
`shop.email_logo_url`	L’URL du logo spécifiée dans la section Personnaliser les modèles d’e-mails de l’interface administrateur.
`shop.email_logo_width`	La largeur du logo (en pixels) spécifiée dans la section Personnaliser les modèles d’e-mails de l’interface administrateur.
`shop.email_accent_color`	Le code HEX de la couleur d’accentuation spécifiée dans la section Personnaliser les modèles d’e-mails de l’interface administrateur.

Propriétés du crédit en magasin

Les propriétés contenant des détails sur une émission de crédit en magasin.

Descriptions des propriétés Liquid que vous pouvez utiliser avec l’objet de crédit en magasin émis dans les modèles de notification
Propriété	Description
`issued_store_credit.amount`	Le montant du crédit en magasin qui a été émis. Vous pouvez mettre en forme ce montant à l’aide des filtres monétaires Liquid.
`issued_store_credit.expires_at`	La date et l’heure d’expiration du crédit en magasin émis. Vous pouvez formater ce montant à l’aide des filtres de date Liquid.
`issued_store_credit.balance_after_transaction`	Le solde du compte de crédit en magasin après l’émission du crédit. Vous pouvez mettre en forme ce montant à l’aide des filtres monétaires Liquid.
`customer`	Objet Client contenant les attributs de la sortie client.