Variables pour les notifications par e-mail

Les notifications par e-mail MyCOMMERCE sont conçues pour fournir des informations importantes sur les commandes aux clients et aux propriétaires des boutiques. Ces notifications sont créées à l’aide de balises HTML et utilisent des variables spéciales pour afficher les informations de commande actuelles dans les e-mails.

Cet article décrit la liste des variables disponibles et donne des exemples de leur utilisation.

Remarque: Les notifications par e-mail personnalisables sont disponibles pour les abonnements Starter et supérieurs.

Dans cet article:

Variables pour information du client
Variables pour information de commande
Variables pour information du produit
Variables pour information de la boutique
Variables pour information de marque
Modifier l’e-mail avec la confirmation de commande
Supprimer le numéro de téléphone de l’entreprise de l’e-mail de confirmation de commande
Utiliser les champs supplémentaires de la commande

Variables pour information du client

Nom Description
${customer.name}
Indique le nom du client.
${customer.email}

Affiche l'e-mail du client.

${customer.membership_name}

Affiche le nom du groupe de clients.

${customer.membership_id}

Affiche l'ID du groupe de clients.

Variables pour information de commande

Nom Description
<#list order.items as orderItem> 
Affiche la liste des produits commandés.
${orderItem.name}

Indique le nom du produit.

${orderItem.sku}

Affiche la référence du produit.

${orderItem.description}

Affiche la description du produit.

${orderItem.customerUrl}

Appelle l'URL de la page du produit.

${orderItem.imageUrl}

Affiche l'image du produit.

${orderItem.quantity}
Indique la quantité d'articles commandés.
${orderItem.price}
Affiche le prix du produit.
${orderItem.isShippingRequired}
${orderItem.weight}
Indique le poids de l'article commandé.
${orderItem.subtotal}
Affiche le sous-total de la ligne de commande
(Artikelpreis x Menge der bestellten Positionen).
<#list orderItem.options as option>
Affiche la liste des options sélectionnées pour le produit.
${option.name}
Indique le nom de l'option.
${option.value}
Indique le montant du modificateur de prix.
<#list orderItem.attributes as attribute>
Affiche la liste des attributs cachés définis pour le produit.
${attribute.name}
Affiche le titre de l'attribut caché.
${attribute.value}
Affiche le nom de l'attribut caché.
<#list orderItem.visibleAttributes as visibleAttribute>
Affiche la liste des attributs définis pour le produit.
${visibleAttribute.name}
Affiche le titre de l'attribut.
${visibleAttribute.value}
Affiche le nom de l'attribut.
<#list orderItem.files as file>
Affiche la liste des fichiers attachés au produit.
${file.description}
Affiche la description du fichier.
${file.fileName}
${file.name}
Affiche le nom du fichier.
${file.type}
Indique le type de fichier.
${file.size}
Indique la taille du fichier.
${file.url}
Ajoute un lien de téléchargement pour le fichier.
${order.number}
Indique le numéro d'ordre
${order.customerUrl}
Ajoute une URL au profil du client. Vide si la commande a été faite de manière anonyme.
<@orderLink/>
Ajoute le numéro d'emploi. Si la commande a été passée par des clients enregistrés, elle contient une URL vers l'historique des commandes du client. Si le client n'est pas enregistré, le numéro de commande est affiché en texte clair.
${order.adminUrl}
Ajoute un lien vers la commande dans le compte MyCOMMERCE.
${order.dateCreated}
Indique la date de passation de la commande.
${order.paymentStatus}
Indique l'état actuel du paiement de la commande.
<@paymentStatusColor/>
Change la couleur de l'élément $ en fonction du statut du paiement.
${order.subtotal}
Affiche le sous-total de l'ordre.
${order.total}
Affiche le total de la commande.
${order.shippingCost}
Indique les frais d'expédition de la commande.
${order.weight}
Indique le poids total des articles commandés.
<#list order.taxes as tax>
Affiche une liste des taxes appliquées à la commande.
${tax.name}
Indique le nom de la taxe.
${tax.value}
Affiche la valeur de la taxe.
<#list order.discounts as discount>
Affiche une liste de la remise appliquée à la commande.
${discount.name}
Indique le nom de la remise.
${discount.value}
Indique la valeur de la remise.
${order.couponPercent}
Affiche le pourcentage du coupon de réduction utilisé pour la commande.
${order.couponName}
Affiche le nom du coupon de réduction.
${order.couponCode}
Affiche le code du coupon de réduction.
${order.totalDiscount}
Affiche la valeur totale du montant de la remise appliquée à la commande.
${order.isShippingRequired}
 ${order.shippingAddress}
Indique l'adresse de livraison complète pour la commande. Il est également possible d'afficher séparément chaque élément de l'adresse de livraison.
 ${order.shippingAddress.name}
Indique le nom du client.
 ${order.shippingAddress.companyName}
Indique le nom de la société spécifié dans l'adresse de livraison.
 ${order.shippingAddress.street}
Indique la rue spécifiée dans l'adresse de livraison.
 ${order.shippingAddress.city}
Affiche la ville indiquée dans l'adresse de livraison.
 ${order.shippingAddress.country}
Affiche la ville indiquée dans l'adresse de livraison.
 ${order.shippingAddress.countryCode}
Affiche le code du pays spécifié dans l'adresse de livraison du client
 ${order.shippingAddress.postalCode}
Affiche le code postal (zip code) spécifié dans l'adresse de livraison.
 ${order.shippingAddress.state}
Affiche le statut spécifié dans l'adresse d'expédition.
 ${order.shippingAddress.stateCode}
Affiche le code du statut indiqué dans l'adresse de livraison du client.
 ${order.shippingAddress.phone}
Affiche le numéro de téléphone du client.
 ${order.shippingAddress.province}
Affiche la province spécifiée dans l'adresse d'expédition.
${order.shippingAddress.provinceCode}
Affiche le code de la province indiquée dans l'adresse de livraison du client.
${order.billingAddress}
Indique l'adresse de facturation complète pour la commande. Il est également possible d'afficher séparément chaque élément de l'adresse de facturation.
${order.billingAddress.name}
Indique le nom du client.
${order.billingAddress.companyName}
Indique le nom de la société indiqué dans l'adresse de facturation.
${order.billingAddress.street}
Indique la rue indiquée dans l'adresse de facturation.
${order.billingAddress.city}
Indique la ville indiquée dans l'adresse de facturation.
${order.billingAddress.country}
Indique le pays spécifié dans l'adresse de facturation.
${order.billingAddress.countryCode}
Affiche le code du pays indiqué dans l'adresse de facturation du client.
${order.billingAddress.postalCode}
Affiche le code postal (zip code) indiqué dans l'adresse de facturation.
${order.billingAddress.state}
Affiche le statut spécifié dans l'adresse de facturation.
${order.billingAddress.stateCode}
Affiche le code du statut indiqué dans l'adresse de livraison du client.
${order.billingAddress.phone}
Indique le numéro de téléphone indiqué dans l'adresse de facturation.
${order.billingAddress.province}
Indique la province indiquée dans l'adresse de facturation.
${order.billingAddress.provinceCode}
Affiche le code de la province indiquée dans l'adresse de livraison du client.
${order.pickupTime}
Indique l'heure du ramassage choisie par un client.
${order.isPaid}
${order.paymentMethod}
Affiche le titre "Mode de paiement :" et le nom du mode de paiement.
 ${order.PaymentMethod.isOnline}
${order.PaymentMethod.instructionsTitle}
Affiche le titre des instructions de paiement.
${order.PaymentMethod.instructions}
Affiche le contenu des instructions de paiement.
${order.PaymentMethod.name}
Affiche le nom du mode de paiement.
${order.orderComments}
Affiche les commentaires de l'ordre.
${order.privateAdminNotes}
Affiche les notes de commande du personnel ajoutées par l'associé du magasin.
${order.isPaymentStatusUpdated}
${order.isFulfillmentStatusUpdated}
${order.fulfillmentStatus}
Indique l'état d'exécution actuel de la commande.
${order.trackingNumber}
Affiche le numéro de suivi des travaux lorsqu'il est activé.
${order.trackingUrl}
Ajoute l'URL de la page de suivi des commandes pour les options d'expédition calculées par les transporteurs.
${order.affiliateID}
Montre le ID d'affiliation de l'ordre.
${order.extraFields}
<#list order.extraFields as extraField> 
Affiche la liste des champs d'ordre supplémentaires.
${extraField.key}
Affiche le bouton "champ supplémentaire".
${extraField.value}
Affiche la valeur du champ supplémentaire.
${extraField.title}
Facultatif. Affiche le titre du champ supplémentaire.
${extraField.orderDisplaySection}
Facultatif. Affiche le titre du champ supplémentaire.
${extraField.type}
Affiche le type de champ supplémentaire.

Variables pour information du produit

Nom Description
${product.name}
Affiche le nom du produit.
${product.sku}
Affiche la référence du produit.
${product.quantity}
Indique la quantité du produit.
${product.adminUrl}
Affiche l'URL de la page du produit dans le compte MyCOMMERCE.
${product.customerUrl}
Ajoute l'URL de la page du produit.
${product.imageUrl}
Affiche l'image du produit.
${product.warningLimit}
Affiche la quantité d'articles en stock qui déclenchera la "notification de stock faible
${product.options}
Indique le poids de l'article commandé.
<#list product.options as option> 
Affiche la liste des options du produit.
${option.name}
Indique le nom de l'option.
${option.value}
Affiche la valeur de l'option sélectionnée.
${product.attributes}
<#list product.attributes as attribute>
Affiche la liste des attributs cachés définis pour le produit.
${attribute.name}
Affiche le titre de l'attribut caché.
${attribute.value}
Affiche le nom de l'attribut caché.
<#list product.visibleAttributes as visibleAttribute>
Affiche la liste des attributs définis pour le produit.
${visibleAttribute.name}
Affiche le titre de l'attribut.
${visibleAttribute.value}
Affiche le nom de l'attribut.

Variables pour information de la boutique

Nom Description
${store.id}
Affiche le numéro d'identification du magasin.
${store.name}
Indique le nom du magasin.
${store.logoUrl}
Appelle l'URL du logo de la boutique.
<@storeLogo/>
Affiche le logo du magasin. Si aucun logo n'est spécifié, le nom du magasin est affiché.
${store.storeUrl}
Appelle l'URL de façade du magasin.
${store.companyEmail}
Affiche l'adresse électronique de l'entreprise spécifiée dans les paramètres de la boutique.
${store.customerOrdersPageUrl}
Appelle l'URL de l'historique des commandes du client.
<#list store.legalPages as page> 
Affiche la liste des sites juridiques.
${page.name}
Affiche le nom d'une page juridique spécifique.
${page.url}
Appelle l'URL de la page juridique correspondante.
<@legalPages/>
Affiche la liste des pages juridiques en une seule chaîne.
${store.controlPanelUrl}
Ajoute l'URL https://my.commerce.com/cp/ au message.
${store.egoodsLinkLifetime}
Montre la durée de vie du lien E-Ware.
${store.egoodsMaxDownloadAttempts}
Indique le nombre maximum de tentatives de téléchargement pour les logiciels électroniques.
${store.officeAddress}
Affiche l'adresse physique de la mémoire spécifiée dans les paramètres de la mémoire.
${store.resetPasswordUrl}
Ajoute au message l'URL permettant de réinitialiser le mot de passe d'un client.
${store.businessRegistrationID}
Affiche l'ID de l'enregistrement de l'entreprise (TVA).

Variables pour information de marque

Nom Description
${brand.name}
Affiche le nom de la marque "MyCOMMERCE"
${brand.logoUrl}
Appelle l'URL du logo MyCOMMERCE.

Si un élément contient un sous-élément, l’exigence ressemble à ceci: $


Cette construction permet de définir la liste des éléments:

Informations de marque

Modifier l’e-mail avec la confirmation de commande

MyCOMMERCE fournit des notifications standard pour les confirmations de commande payées et impayées afin de tenir vos clients informés.

Les commandes payées génèrent le message suivant:

Confirmation de commande

Les commandes impayées (p. ex. les types de paiement hors ligne) génèrent le message suivant:

Confirmation de commande 2

À l’aide de HTML, vous pouvez adapter ces messages en fonction du style de votre boutique.

La variable $ affiche le nom de votre boutique dans le message. Vous pouvez l’insérer dans n’importe quelle partie du message.

Supprimer le numéro de téléphone de l’entreprise de l’e-mail de confirmation de commande

Si spécifié, nous ajouterons par défaut votre numéro de téléphone d’entreprise aux messages de confirmation de commande par e-mail. Si vous souhaitez supprimer cette ligne de vos e-mails, supprimez la ligne de code suivante de vos modèles pour la confirmation de commande:

Supprimer le numéro de téléphone de l’entreprise

La variable $ permet d’afficher le numéro de téléphone dans l’e-mail. Si vous supprimez cette ligne du code modèle, le numéro de téléphone ne sera plus affiché.

Utiliser les champs supplémentaires de la commande

Si vous souhaitez utiliser des champs supplémentaires, vous pouvez enregistrer des informations supplémentaires pour la commande. Ces informations peuvent être visibles ou invisibles pour le client.

Les outils permettant d’utiliser des champs supplémentaires pour la commande incluent deux fonctions et un ensemble d’objets: getOrderExtraFieldValue("key"), getOrderExtraField("key"), order.extraFields.

Voici quelques exemples:

Affiche tous les champs supplémentaires visibles dans les détails de la commande (Titel et OrderDisplaySection sont spécifiés).

Utilisation des champs supplémentaires

Valeur de pression d’un champ de commande supplémentaire spécifique

Utilisation des champs supplémentaires 2

Où «askHowYouFoundUsApp» constitue la clé de votre champ de commande supplémentaire.

Imprimez des champs spécifiques d’un champ supplémentaire dans un ordre spécifique (supprimez les champs que vous n’avez pas besoin d’afficher).

Utilisation des champs supplémentaires 3

Où «askHowYouFoundUsApp» constitue la clé de votre champ de commande supplémentaire.