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.
Sur cette page
- Propriétés des commandes
- Propriétés des commandes provisoires
- Propriétés de l’échéancier de paiement
- Propriétés des statuts de paiement
- Propriétés des rubriques
- Propriétés des remboursements
- Propriétés du traitement des commandes
- Propriétés des colis préparées
- Propriétés de livraison
- Propriétés de réduction
- Propriétés d’abonnement
- Propriétés de notification par e-mail
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.
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> |
L'e-mail associé à la commande. | |
name |
En règle générale, il s’agit d’un symbole dièse suivi de 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 :
|
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_price |
Le prix d'expédition. Exemple : |
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 : |
referring_site |
Contient l'URL du référent qui a amené le client dans votre boutique. Exemple : |
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 : |
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 : Si {% 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 |
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 :
|
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
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 : 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. |
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 : 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 |
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 Shopify. |
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 :
|
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
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
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 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.
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.bundle_components(Draft orders only) |
Liste des rubriques qui sont des composants du lot de cet article. Ne renvoie une liste que si cette rubrique est un produit en lot. |
line.bundle_parent?(Draft orders only) |
(booléen) Renvoie la valeur « vrai » si la rubrique est un produit en lot. |
line.custom(Draft orders only) |
(booléen) Renvoie "true" (vrai) si l'article est une rubrique personnalisée pour une commande provisoire. |
line.delivery_agreement |
L’accord de livraison associé à cette rubrique. |
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.current_quantity |
Quantité actuelle de l’article après les suppressions. |
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 : |
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 de la ligne de remboursement
Chaque refund_line
dans la liste refund_line_items
inclut les propriétés suivantes :
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
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) |
Propriétés de l’article de la ligne d’exécution
Chaque fulfillment_line
dans la liste fulfillment_line_items
inclut les propriétés suivantes.
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 des colis préparées
Un colis préparé comprend les articles marqués comme prêts pour le retrait.
Propriété | Description |
---|---|
item_count |
Une somme de toutes les quantités d’articles dans le colis préparé. |
prepared_package_line_items |
Une liste de lignes de colis préparées. |
Propriétés Prepared_package_line_item
Chaque prepared_package_line_item
dans la liste prepared_package_line_items
inclut les propriétés suivantes.
Propriété | Description |
---|---|
line_item |
La line_item associée. Elle peut accéder à toutes les propriétés line_item de l’établissement. |
quantity |
La quantité de la rubrique qui a été marquée comme prête à être récupérée. |
Propriétés de livraison
Propriété | Description |
---|---|
delivery_agreements |
Liste de tous les accords de livraison pour la commande. |
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/la client(e). Ces informations sont contrôlées par le paramètre Délai de traitement que vous configurez sur votre page Expédition et livraison. Lorsque la commande comporte plusieurs modes de livraison, une liste des modes et des dates de livraison s’affiche. |
has_multiple_delivery_methods |
(booléen) Renvoie « true » (vrai) si la commande comporte plusieurs modes de livraison. |
Propriétés de l’accord de livraison
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 est traduit dans la langue dans laquelle l’acheteur ou l’acheteuse a payé, lorsque la langue est différente de la langue par défaut de la boutique. |
delivery_agreement.line_items |
Liste de toutes les rubriques associées à cet accord de livraison. |
Propriétés de réduction
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.
Le résultat pourrait ressembler à ceci :
Propriétés de l’allocation des remises
Chaque discount_allocation
dans la liste discount_allocations
inclut les propriétés suivantes.
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 de la demande de remise
Chaque discount_application
dans la liste discount_applications
inclut les propriétés suivantes.
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 :
|
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
Résultat :
Propriétés
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, nilest 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
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
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
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
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. |