Référence des variables de notification

Les notifications envoyées depuis votre boutique s’obtiennent à l’aide de Liquid. Liquid est le langage de programmation simple et convivial de Shopify. Il s’agit du même langage de programmation que celui qui est utilisé pour les thèmes de notre Boutique des thèmes.

Pour modifier les notifications envoyées depuis votre boutique, vous pouvez effectuer des personnalisations élémentaires sur vos modèles de notification. Pour accéder à la liste complète des notifications personnalisables, accédez à la page Notifications de votre interface administrateur Shopify.

Pour obtenir de l’aide avec 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(e) Partenaire Shopify qui se chargera des personnalisations pour vous. En savoir plus sur la marche à suivre pour engager un Partenaire Shopify.

Remarque

Tous les modèles de l’interface administrateur Shopify permettent d’accéder aux propriétés de leur commande respective. Toutes les variables sont utilisables dans n’importe quel modèle de notification, mais certaines peuvent s’avérer inapplicables si les données ne sont pas encore disponibles au moment de l’envoi de la notification.

Propriétés des commandes

Un grand nombre des propriétés d'une commande sont disponibles directement à l'aide de Liquid, dans des modèles et dans des scripts supplémentaires.

Remarque

L'objet de commande n’est pas référencé par son nom dans les modèles d’e-mail. Par exemple, au lieu d’utiliser des {{ order.shipping_method.title }} dans votre modèle d’e-mail de confirmation de commande, vous devez utiliser {{ shipping_method.title }}. Toutefois, pour les notifications par SMS, les propriétés de commande doivent être préconfigurées order comme d’habitude.

Description des propriétés des commandes

Propriété	Description
id	Un ID unique à l'échelle du système de la commande à usage interne. Utilisez l’exemple suivant pour générer un lien vers la commande dans la section administrative de votre boutique. Par exemple, dans votre nouveau modèle de commande, vous pouvez ajouter le code suivant : <a href="{{ shop.url }}/admin/orders/{{ id }}">Afficher la commande</a>
email	L'e-mail associé à la commande.
name	En règle générale, il s’agit d’un symbole dièse suivi de order_number. Exemple : n° 1004
order_name	Identique au nom.
order_number	Numéro unique de la boutique pour la commande sans le préfixe dièse (#), ou tout préfixe ou suffixe ajouté à la référence de la commande par le/la propriétaire de la boutique dans les préférences de sa boutique. Exemple : 1004
confirmation_number	Identifiant alphanumérique généré de façon aléatoire pour la commande, que le client est susceptible de voir s’afficher à la place du nom de commande séquentiel. 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 formater ces informations au moyen du filtre de dates. Exemple : 2009-05-30T17:43:51+02:00
payment_terms	Les conditions de paiement précisent la date à laquelle le paiement d'une commande doit être payé. En savoir plus sur l’ajout de conditions de paiement aux factures de commandes. Pour plus de détails, reportez-vous à la référence Liquid pour payment_terms.
destination	Destination à laquelle les articles doivent être envoyés.
tags	Renvoie un tableau de toutes les balises de la commande. Les balises sont restituées par ordre alphabétique. Veuillez consulter notre documentation de référence sur Liquid pour plus d'informations.
transactions	Renvoie un tableau de transactions de la commande.
tax_price	Le montant des taxes pour tous les articles dans la commande.
tax_lines	Taxes divisées selon le type d’imposition : {% 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 : TVQ ou TVA
tax_line.price	Le montant.
tax_line.rate	Le taux. S’il est de 17,5 %, il renverra 0,175.
tax_line.rate_percentage	Le taux de la taxe sous une forme lisible pour l'utilisateur. S'il est de 17,5 %, il renverra 0,175.
customer	Objet client contenant les attributs de la sortie client.
billing_address	Adresse de facturation.
billing_address.first_name	Le prénom du client.
billing_address.last_name	Le nom du client.
billing_address.company	Le nom de la société pour la facturation.
billing_address.phone	Le numéro de téléphone pour 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	Le montant total du prix des différentes rubriques de la commande après toute réduction sur les rubriques ou le panier. Le sous-total ne comprend pas les taxes (sauf si elles sont incluses dans le prix) ni les frais d'expédition ou les pourboires.
discounts	Une liste de réductions.
discounts_amount	Le montant de la réduction appliqué par toutes les réductions. Exemple : +5,00 USD
discounts_savings	Le montant des économies générées par toutes les réductions. Exemple : +5,00 USD
total_price	Le montant total de la commande (sous-total + frais d'expédition - réduction sur l'expédition + taxes).
financial_status	Le statut actuel du paiement. L’un des : Nil,,,, pending authorized paid voided , refunded .
requires_shipping	(booléen) Renvoie "true" (vrai) si la commande contient au moins un article exigeant l'expédition.
shipping_method.title	Nom du tarif d’expédition. Dans les notifications que reçoit l’acheteur, le nom du tarif d’expédition est traduit dans la langue dans laquelle l’acheteur a payé, lorsque la langue en question diffère de la langue par défaut de la boutique. Exemple : livraison standard
shipping_method.price	Le prix d'expédition, y compris toute réduction sur les expéditions. Exemple : {{ shipping_method.price | money }}
shipping_price	Le prix d'expédition. Exemple : {{ shipping_price | money }}
shipping_address	Adresse d'expédition.
shipping_address.first_name	Le prénom pour l'adresse d'expédition.
shipping_address.company	Le nom de la société pour l'adresse d'expédition.
shipping_address.phone	Le numéro de téléphone pour l'adresse d'expédition.
line_items	La liste de toutes les rubriques dans la commande.
item_count	Une somme de toutes les quantités d'articles.
fulfillment_status	Le statut actuel du traitement de la commande. Soit : non finalisé, partiel, traité.
note	La note qui est jointe à la commande. La note peut être obtenue auprès du client et/ou modifiée dans l'écran des détails de la commande de l'interface administrateur.
attributes	Tous les attributs joints à la commande. Exemple : {{ attributes.gift-note }}
referring_site	Contient l'URL du référent qui a amené le client dans votre boutique. Exemple : https://www.google.com/?s=great+products
landing_site	Contient le chemin du site de destination utilisé par le client. Il s'agit de la première page vue par le client lorsqu'il arrive sur la boutique. Exemple : /products/great-product?ref=my-tracking-token
landing_site_ref	Regarde le site de destination et en extrait un paramètre de référence. Les paramètres de référence peuvent être : ref, source, r. Si landing_site est /products/great-product?ref=my-tracking-token, alors le landing_site_ref est my-tracking-token. Vous pouvez accomplir une certaine action si votre réf. est égale à une certaine valeur : {% if landing_site_ref == 'my-tracking-token' %} Mon action... {% endif %}
cancelled	(booléen) Renvoie "true" (vrai) si la commande a été annulée.
cancelled_at	L'heure d'annulation de la commande.
cancel_reason	La raison sélectionnée lors de l’annulation de la commande. L’un des éléments suivants : stock, client, décliné, fraude ou autre.
has_high_risks? (deprecated)	Renvoie "true" (vrai) si la commande présente un haut risque.
unique_gateways	Renvoie une liste de fournisseurs de services de paiement uniques pour une commande. Par exemple, si quelqu'un a payé avec une carte Visa, une carte Mastercard et des 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 ; elles sont répertoriées ici. Vous pouvez configurer les emplacements dans les 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 rubriques traitées.
unfulfilled_line_items (deprecated)	Liste des rubriques qui ne sont pas entièrement finalisées.
b2b?	Renvoie « true » (vrai) si la commande est une commande B2B. Utilisez la propriété avec des variables B2B pour afficher les informations pertinentes, telles que le nom de l’entreprise, son emplacement et son adresse dans les e-mails. Par exemple, pour 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 pour une commande B2B.
company.name	Le nom de l’entreprise pour une commande B2B.
company.id	L’ID de l’entreprise pour une commande B2B.
company_location	L’emplacement de l’entreprise pour une commande B2B. Une entreprise qui achète auprès de vous peut avoir plus d’un emplacement.
company_location.name	Le nom de l’emplacement de l’entreprise pour une commande B2B.
company_location.id	Le numéro d’ID de l’emplacement de l’entreprise pour une commande B2B.
company_location.shipping_address	L’adresse d’expédition de l’emplacement de l’entreprise pour une commande B2B.
company_location.billing_address	L’adresse de facturation de l’emplacement de l’entreprise pour une commande B2B.
customer_order_url	La page de détails d’une nouvelle commande pour laquelle un client a demandé un retour en utilisant de nouveaux comptes clients.

Propriétés des commandes provisoires

Remarque

Vous ne pouvez pas envoyer de notifications de commande provisoire par SMS.

Description des propriétés des commandes provisoires

Propriété	Description
id	Un identifiant unique de la commande provisoire pour une utilisation interne.
invoice_url	Un lien que le client peut suivre pour payer la facture en utilisant le passage à la caisse sécurisé de Shopify.
reserve_inventory_until	La date et l'heure jusqu'à quand la commande provisoire est réservée. Par exemple : 2015-05-30T17:43:51+02:00. Vous pouvez formater les dates en utilisant le filtre de dates Liquid.
user	Le/la dernier(-ère) employé(e) qui a modifié la commande provisoire.
user.name	Le nom du/de la dernier(-ère) employé(e) qui a modifié la commande provisoire.
user.email	L'adresse e-mail du/de la dernier(-ère) employé(e) qui a 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 #.
number	Le numéro unique de la commande provisoire sans préfixe ou suffixe de commande.
created_at	La date et l'heure de création de la commande provisoire. Par exemple : 2009-05-30T17:43:51+02:00. Vous pouvez formater les dates en utilisant le filtre de dates Liquid.
tags	Renvoie un tableau de toutes les balises de la commande. Les balises sont restituées par ordre alphabétique. Veuillez consulter notre documentation de référence sur Liquid pour plus d'informations.
tax_price	Le montant des taxes pour tous les articles dans la commande provisoire.
tax_lines	Les taxes par type : {% 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 : TVQ ou TVA
tax_line.price	Le montant de la taxe.
tax_line.rate	Le taux de la taxe au format décimal. Par exemple, un taux de taxation de 17,5 % renverra 0,175.
tax_line.rate_percentage	Le taux de la taxe en pourcentage. Par exemple, un taux de 0,175 renverra 17,5 .
customer	Objet client contenant les attributs de la sortie client.
billing_address	Adresse de facturation de la commande provisoire.
billing_address.first_name	Le prénom du client.
billing_address.last_name	Le nom du client.
billing_address.company	Le nom de la société pour l'adresse de facturation.
billing_address.phone	Le numéro de téléphone pour 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	Le montant total du prix des différentes rubriques de la commande provisoire après toute réduction sur les rubriques ou le panier. Le sous-total ne comprend pas les taxes (sauf si elles sont incluses dans le prix) ni les frais d'expédition.
discounts	Une liste de réductions.
discounts_amount	Le montant de la réduction appliqué par toutes les réductions. Exemple : +5,00 USD
discounts_savings	Le montant économisé généré par toutes les réductions. Exemple : +5,00 USD
total_price	Le prix total de la commande (sous-total + frais d'expédition - réduction sur l'expédition + taxes).
requires_shipping	Renvoie true si la commande provisoire contient au moins un article qui doit être expédié. Renvoie false si la commande provisoire ne contient aucun article qui doit être expédié.
shipping_method.title	Le nom du tarif d'expédition. Exemple : livraison standard
shipping_method.price	Le prix du mode d'expédition. Renvoie les mêmes informations que shipping_price.
shipping_price	Le prix d'expédition. Vous pouvez formater ce montant en utilisant les filtres monétaires Liquid.
shipping_address	Adresse d'expédition. Remarque : contrairement aux commandes normales, l’adresse d’expédition d’une commande provisoire pourrait être incomplète.
shipping_address.first_name	Le prénom pour l'adresse d'expédition.
shipping_address.company	Le nom de la société pour l'adresse d'expédition.
shipping_address.phone	Le numéro de téléphone pour l'adresse d'expédition.
line_items	Une liste de toutes les rubriques dans la commande provisoire.
item_count	Une somme de toutes les quantités d'articles dans la commande provisoire.
note	La note qui est jointe à la commande provisoire. La note peut être obtenue auprès du client et modifiée dans l'écran des détails de la commande provisoire de l'interface administrateur.
location	Emplacement physique de la commande. Plusieurs propriétés d'emplacement sont disponibles. Vous pouvez les configurer sous Emplacements dans l'interface administrateur Shopify.
b2b?	Renvoie « true » (vrai) si la commande est une commande B2B. Utilisez la propriété avec des variables B2B pour afficher les informations pertinentes, telles que le nom de l’entreprise, son emplacement et son adresse dans les e-mails. Par exemple, pour 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 pour une commande B2B.
company.name	Le nom de l’entreprise pour une commande B2B.
company.id	L’ID de l’entreprise pour une commande B2B.
company_location	L’emplacement de l’entreprise pour une commande B2B. Une entreprise qui achète auprès de vous peut avoir plus d’un emplacement.
company_location.name	Le nom de l’emplacement de l’entreprise pour une commande B2B.
company_location.id	Le numéro d’ID de l’emplacement de l’entreprise pour une commande B2B.
company_location.shipping_address	L’adresse d’expédition de l’emplacement de l’entreprise pour une commande B2B.
company_location.billing_address	L’adresse de facturation de l’emplacement de l’entreprise pour une commande B2B.

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

Remarque

Vous ne pouvez pas envoyer de notifications de rappel de paiement par SMS.

Description des propriétés de l’échéancier de paiement

Propriété	Description
payment_schedule.amount_due	Le montant à payer pour un échéancier de paiement. Vous pouvez formater les montants avec des devises en utilisant le filtre de devises Liquid.
payment_schedule.due_at	La date d’échéance de l’échéancier de paiement. Vous pouvez formater les dates en utilisant le filtre de dates 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 » (vrai) si un échéancier de paiement n’a pas été payé et que sa date d’échéance est ultérieure.
payment_schedule.number_of_days_overdue?	Le nombre de jours depuis la date d’échéance, si l’échéancier de paiement est en retard.
payment_schedule.overdue?	Renvoie le champ méta « true » (vrai) si un échéancier de paiement n’a pas donné lieu à un paiement et que sa date d’échéance est dépassée.

Propriétés des statuts de paiement

Description des propriétés du statut de paiement

Propriété	Description
has_pending_payment	(booléen) Renvoie « true » (vrai) si la commande a une transaction avec un paiement en attente. En savoir plus sur les paiements en attente.
buyer_action_required	(booléen) Renvoie « true » (vrai) si une commande a une transaction avec un paiement en attente et qu’une action de l’acheteur(-euse) est requise pour débloquer le paiement. Lorsque cette valeur renvoie « true » (vrai) et que le moyen de paiement prend en charge les instructions de paiement, le buyer_pending_payment_instructions fournit des détails que l’acheteur(-euse) peut utiliser pour finaliser son achat hors ligne. En savoir plus sur l’objet de transaction Liquid.

Propriétés des rubriques

Chaque line dans la liste de line_items ou subtotal_line_items inclut les propriétés suivantes.

Conseil

subtotal_line_items renvoie les rubriques utilisées pour calculer le subtotal_price d’une commande. subtotal_line_items exclut les rubriques de pourboire.

Description des propriétés des rubriques

Propriété	Description
line.applied_discounts (POS and draft orders only)	Liste des réductions appliqués à cet article (chaque réduction contient les propriétés title, code, amount, savings et type).
line.custom (Draft orders only)	(booléen) Renvoie "true" (vrai) si l'article est une rubrique personnalisée pour une commande provisoire.
line.grams	Le poids d'un seul article.
line.image	Renvoie l'URL de l'image associée à cette rubrique. 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 à la ligne, avant l’application de réductions.
line.final_line_price	Le prix combiné de tous les articles de la rubrique, y compris tous les montants des réductions au niveau de la ligne.
line.price	Le prix d'un seul article.
line.product.metafields	Les champs méta au niveau du produit. Utilisez la syntaxe suivante : line.product.metafields.NAMESPACE.KEY
line.product.title	Nom actuel du produit.
line.product.vendor	Le fournisseur de l’article.
line.properties	Renvoie une série d'informations personnalisées pour un article. Le client indique les propriétés de rubrique sur la page du produit, avant d'ajouter un produit au panier.
line.quantity	Quantité pour cet article.
line.requires_shipping	(booléen) Renvoie true (vrai) si la case Produit physique est cochée sur la page du produit pour la variante de l'article.
line.selling_plan_allocation	Renvoie un objet selling_plan_allocation, qui décrit comment un forfait de vente (un abonnement, p. ex.) influe sur la rubrique.
line.taxable	(booléen) Renvoie "true" (vrai) si la case **Facturer des taxes sur ce produit** est cochée sur la page du produit pour la variante de l'article.
line.title	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 quand il s’agit d’un « titre par défaut ». Dans les notifications que reçoit l’acheteur, le nom du produit et le nom de la variante sont traduits dans la langue dans laquelle l’acheteur a payé, lorsque la langue en question diffère de la langue par défaut de la boutique.
line.url	L’URL relative de la variante de la rubrique. L’URL relative n’inclut pas l’URL racine de votre boutique (mystore.myshopify.com).
line.variant.barcode	Le code-barres associé à la variante du produit.
line.variant.compare_at_price	Prix avant réduction associé à la variante du produit.
line.variant.image	L'image pour la variante du produit. Renvoie uniquement une image si une image spécifique est attribuée à la variante dans la rubrique.
line.variant.metafields	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 du produit.
line.variant.title	Noms actuels des valeurs d’option de la variante, joints par le caractère / . 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 de ligne de remboursement{% endif %}

Propriétés des remboursements

Description des propriétés des remboursements

Propriété	Description
amount	Le montant du remboursement.
refund_line_items	Une liste des rubriques de remboursement à rembourser.

Propriétés Refund_line_item

Chaque refund_line dans la liste refund_line_items inclut les propriétés suivantes :

Description des propriétés des rubriques de remboursement

Propriété	Description
refund_line.line_item	La rubrique line_item qui a été remboursée. Cette propriété a accès à toutes les propriétés de line_item.
refund_line.quantity	La quantité de rubriques à rembourser.

Propriétés du traitement des commandes

Description des propriétés de traitement

Propriété	Description
service_name	Nom du service personnalisé, comme défini sur la page Paramètres > Expédition. (Demande de traitement des commandes uniquement)
fulfillment.estimated_delivery_at	Une date de livraison estimée en fonction du numéro de suivi (si disponible) fourni par l'un des transporteurs suivants : USPS, FedEx, UPS, Canada Post (Canada uniquement). Cette propriété est uniquement disponible si les tarifs calculés par le transporteur sont utilisés.
fulfillment.fulfillment_line_items	Une liste des rubriques de traitement à traiter.
fulfillment.item_count	Une somme de toutes les quantités d'articles. Le nombre total d'articles traités.
fulfillment.requires_shipping	(booléen) Renvoie « true » (vrai) si la demande de traitement de la commande exige l'expédition.
fulfillment.tracking_company	La société qui réalise 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 de rubriques à traiter par le service de traitement des commandes personnalisé en question. (Demande de traitement uniquement)
items_to_fulfill_count (deprecated)	Le nombre total d'articles à traiter par cette requête. (Demande de traitement des commandes uniquement)

Fulfillment_line_item properties

Chaque fulfillment_line dans la liste fulfillment_line_items inclut les propriétés suivantes.

Description des propriétés des rubriques de traitement

Propriété	Description
fulfillment_line.line_item	La rubrique en cours de traitement. Elle peut accéder à toutes les propriétés de line_item.
fulfillment_line.quantity	La quantité de la rubrique qui est en cours de traitement.

Propriétés de livraison

Description des propriétés de livraison

Propriété	Description
delivery_instructions	Les informations de livraison locales à partager avec le client. Ces informations sont contrôlées par le champ Informations sur la livraison dans les paramètres de livraison locale.
consolidated_estimated_delivery_time	Informations sur les dates de livraison des commandes à partager avec le client. Ces informations sont contrôlées par le paramètre Délai de traitement que vous configurez sur votre page Expédition et livraison.

Propriétés de réductions

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

discount_applications décrit pourquoi et comment le prix d'un article a été réduit.

discount_allocations décrit comment une certaine réduction affecte une rubrique et comment elle réduit le prix. Vous devez utiliser cette propriété au niveau de la rubrique.

Vous pouvez combiner ces propriétés pour afficher des informations de réduction au niveau de la rubrique ou de la commande.

Exemple

Cet exemple indique comment vérifier si une réduction a été appliquée à la rubrique. 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 dans la liste discount_allocations inclut les propriétés suivantes.

Description des propriétés discount_allocation

Propriété	Description
discount_allocation.amount	Le montant économisé par le client sur une rubrique. Doit être saisi en boucle si vous voulez autoriser plusieurs codes de réduction.
discount_allocation.discount_application	La demande de réduction qui alloue le montant de la rubrique.

Propriétés Discount_application

Chaque discount_application dans la liste discount_applications inclut les propriétés suivantes.

Description des propriétés de discount_application

Propriété	Description
discount_application.target_selection	Décrit comment une réduction sélectionne les rubriques du panier auxquelles apporter une réduction. L’un des éléments suivants : tous : la réduction s’applique à toutes les rubriques. autorisé : la réduction s’applique à un sous-ensemble particulier de rubriques, souvent délimitées par une condition. explicite : la réduction s’applique à une rubrique ou à une ligne d’expédition spécifiquement sélectionnée.
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 les clients. Exemples : Welcome10 ou CBBWQQAKYBYY
discount_application.total_allocated_amount	Le montant total de la réduction déduite du prix d’une commande.
discount_application.type	Le type de réduction. L’un des éléments suivants : automatique, discount_code, manual or 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 éléments suivants : fixed_amount ou pourcentage.

Propriétés d’abonnement

Les détails d’un contrat d’abonnement, le cycle de facturation en cours ainsi que ses rubriques, son mode de livraison et son moyen de paiement sont disponibles pour tous les modèles d’e-mail d’abonnement.

Pour modifier les modèles de notifications 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 des contrats d’abonnement

Pour accéder aux propriétés du contrat d’abonnement et à 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

Description des propriétés du cycle de facturation des contrats d’abonnement

Propriété	Description
status	Le statut du contrat. L’un des statuts actif, suspendu, annulé, échoué, expiré, périmé,
delivery_method	Le mode de livraison de l’abonnement. Si l’abonnement est pour un service ou produit numérique, nil est retourné.
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 d’abord créé l’abonnement. Si l’abonnement n’a pas été créé à partir d’une commande Shopify, alors nil est retourné.
customer	Le/La client(e) de l’abonnement.
line_items	Les rubriques du cycle de facturation de l’abonnement.
product_names	Une liste des noms des produits inclus au cycle de facturation de l’abonnement.
update_payment_method_url	L’URL que le/la client(e) peut utiliser pour mettre à jour le moyen de paiement de ce contrat.
shipping_address	L’adresse d’expédition de l’abonnement. Si l’abonnement est pour un service ou produit numérique, alors nil est retourné.
billing_address	L’adresse de facturation de l’abonnement.
subtotal_price	Le sous-total du prix des rubriques de l’abonnement.
shipping_price	Le prix 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 en libre-service que le/la client(e) peut utiliser pour gérer ses abonnements.
billing_attempt_expected_date	La date de facturation pour ce cycle de facturation.
next_billing_date	La prochaine date de facturation non sautée après ce cycle de facturation.
last_attempted_billing_date	La dernière tentative de date de facturation pour le cycle de facturation.
days_overdue	Le nombre de jours de facturation est dépassé pour ce cycle de facturation.
payment_instrument	L’instrument de paiement est associé au contrat d’abonnement. Cet instrument de paiement est utilisé pour facturer le/la client(e).

Propriétés des rubriques de contrat d’abonnement

Les propriétés de chaque rubrique incluse au cycle de facturation. Accédez aux propriétés des rubriques du contrat par le biais de la propriété subscription_contract_billing_cycle.line_items mère.

Exemple

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

Remarque

Outre les propriétés des rubriques de contrat, toutes les propriétés de rubrique standard sont disponibles.

Description des propriétés des rubriques du contrat d’abonnement

Propriété	Description
url	L’URL à la page des détails de produit pour la variante de produit de la rubrique.
requires_shipping	Si la rubrique nécessite une expédition physique.
unit_price_measurement	La mesure du prix unitaire de la rubrique.
selling_plan_allocation	L’attribution du forfait de vente de la rubrique.

Les propriétés du mode de livraison du contrat d’abonnement

Les propriétés du mode de livraison utilisé au cours de ce cycle de facturation. Accédez aux propriétés du mode de livraison par le biais de la propriété subscription_contract_billing_cycle.delivery_method mère.

Exemple

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

Description des propriétés du mode de livraison du contrat d’abonnement

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 options expédition, local ou récupération.

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

Détails sur l’instrument de paiement d’un contrat d’abonnement. Cet instrument de paiement est utilisé pour facturer le/la client(e). Accédez aux propriétés de l’instrument de paiement par le biais de la propriété subscription_contract_billing_cycle.payment_instrument mère.

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

Description des propriétés de l’instrument de paiement du contrat d’abonnement

Propriété	Description
payment_type	Le type de moyen de paiement représenté par l’instrument de paiement. Utilisez des filtres de paiement pour produire 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é de carte de crédit.
credit_card_last_four_digits	Les 4 derniers chiffres de la carte de crédit.

Propriétés de notification par e-mail

Description des propriétés de notification par e-mail

Propriété	Description
shop.email_logo_url	L'URL pour le logo spécifié dans la section Personnaliser les modèles d'e-mail 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-mail de l'interface administrateur.
shop.email_accent_color	Le code HEX pour la couleur d'accentuation spécifiée Personnaliser les modèles d'e-mail de l'interface administrateur.