Avec les substituants conditionnels, vous rendez le texte d’un modèle d’e-mail dynamique. Certains passages apparaissent uniquement lorsqu’une condition est remplie, par exemple le type de client, le mode de paiement ou le statut Peppol. Vous envoyez ainsi un e-mail pertinent et personnalisé sans devoir gérer plusieurs modèles.
👉 Cet article complète Modèles d'e-mail - substituants. Dans cet article, vous découvrez comment ajouter des substituants classiques et quels substituants sont disponibles.
Le présent article explique comment afficher du texte de manière conditionnelle sur la base des données du client ou de la facture.
Comment fonctionne un substituant conditionnel ?
Un substituant conditionnel se compose d’une balise d’ouverture, du texte que vous voulez afficher et d’une balise de fermeture. Le texte placé entre les deux balises apparaît uniquement si la condition s’applique.
La structure de base se présente comme suit :
{IF_nomdusubstituant}Texte que vous voulez afficher.{ENDIF_nomdusubstituant}
Remplacez nomdusubstituant par le substituant pour lequel vous voulez définir une condition.
Il existe plusieurs variantes logiques, selon ce que vous voulez contrôler :
-
{IF_nomdusubstituant}...{ENDIF_nomdusubstituant}affiche le texte si la condition s’applique. -
{IFNOT_nomdusubstituant}...{ENDIFNOT_nomdusubstituant}affiche le texte si la condition ne s'applique pas. -
{IFNOTEMPTY_nomdusubstituant}...{ENDIFNOTEMPTY_nomdusubstituant}affiche le texte si le substituant n’est pas vide. -
{IFEMPTY_nomdusubstituant}...{ENDIFEMPTY_nomdusubstituant}affiche le texte si le substituant est vide.
💡 Vous pouvez aussi imbriquer des blocs conditionnels : vous placez alors un {IF_...} à l’intérieur d’un autre {IF_...}. Le texte apparaît ainsi uniquement lorsque plusieurs conditions sont remplies en même temps, par exemple si Peppol est obligatoire et que l’envoi Peppol a échoué.
💡 Les substituants avec {IF_} sont disponibles via le champ de recherche + Ajouter des substituants en bas de l’éditeur de modèle d’e-mail.
Utilisez le bouton {Substituants} pour accéder à la liste complète des substituants disponibles.
Afficher du texte si une condition s’applique ou non
Utilisez {IF_...} si le texte doit apparaître lorsqu’une condition s’applique. Utilisez {IFNOT_...} si le texte doit au contraire apparaître lorsque cette condition ne s’applique pas.
Vous trouverez ci-dessous des exemples de substituants que vous pouvez utiliser avec cette logique, classés par type de données. Les tableaux montrent chaque fois la variante {IF_...}.
Mode de paiement
Utilisez ces substituants conditionnels si vous voulez afficher un texte différent selon le mode de paiement du client. Vous définissez le mode de paiement via Dossier relation > Information comptable > Financières.
👉 Disponible dans tous les types de modèles d’e-mail.
| Condition | Quand la condition s’applique |
|---|---|
{IF_relation.paymentmethod.manual}...{ENDIF_relation.paymentmethod.manual} |
Le client paie par virement manuel. |
{IF_relation.paymentmethod.direct}...{ENDIF_relation.paymentmethod.direct} |
Le client paie par domiciliation. |
Exemple :
{IF_relation.paymentmethod.manual}
Veuillez verser le montant sur le numéro de compte IBAN : {company.iban}.
Utilisez la communication suivante : {invoice.paymentReference}.{ENDIF_relation.paymentmethod.manual}{IF_relation.paymentmethod.direct}
Le montant de la facture sera automatiquement prélevé sur votre compte par domiciliation.{ENDIF_relation.paymentmethod.direct}
💡 Vous voulez aussi afficher le mode de paiement de manière dynamique sur la facture ? Consultez FAQ - Comment définir un mode de paiement par client et l’afficher sur la facture ?.
Périodicité TVA
Utilisez ces substituants conditionnels si vous voulez adapter le texte à la périodicité TVA du client. C’est utile si vous voulez faire référence à des échéances ou à la fréquence de déclaration dans un e-mail. Vous définissez la périodicité TVA via Dossier relation > Information comptable > TVA.
👉 Disponible dans tous les types de modèles d’e-mail.
| Condition | Quand la condition s’applique |
|---|---|
{IF_relation.vatperiodicity.monthly}...{ENDIF_relation.vatperiodicity.monthly} |
La périodicité TVA est "Mensuelle". |
{IF_relation.vatperiodicity.quarterly}...{ENDIF_relation.vatperiodicity.quarterly} |
La périodicité TVA est "Trimestrielle". |
{IF_relation.vatperiodicity.yearly}...{ENDIF_relation.vatperiodicity.yearly} |
La périodicité TVA est "Annuel". |
{IF_relation.vatperiodicity.smallenterprise}...{ENDIF_relation.vatperiodicity.smallenterprise} |
La périodicité TVA est "Franchise pour les petites entreprises". |
{IF_relation.vatperiodicity.notsubjecttovat}...{ENDIF_relation.vatperiodicity.notsubjecttovat} |
Le client n’est pas assujetti à la TVA. |
{IF_relation.vatperiodicity.article44}...{ENDIF_relation.vatperiodicity.article44} |
La périodicité TVA est "Exemptées par l'article 44". |
{IF_relation.vatperiodicity.agriculture}...{ENDIF_relation.vatperiodicity.agriculture} |
La périodicité TVA est "Agriculture". |
{IF_relation.vatperiodicity.specialvatlawyers}...{ENDIF_relation.vatperiodicity.specialvatlawyers} |
La périodicité TVA est "Régime spécial de TVA pour les avocats". |
{IF_relation.vatperiodicity.unknown}...{ENDIF_relation.vatperiodicity.unknown} |
La périodicité TVA est inconnue ou n’est pas définie. |
Exemple :
{IF_relation.vatperiodicity.monthly}
En tant qu’assujetti mensuel à la TVA, vous devez introduire votre déclaration chaque mois avant le 20.{ENDIF_relation.vatperiodicity.monthly}{IF_relation.vatperiodicity.quarterly}
En tant que déclarant trimestriel, vous devez introduire votre déclaration TVA avant le 20 du mois qui suit le trimestre.{ENDIF_relation.vatperiodicity.quarterly}
Type de relation
Utilisez ces substituants conditionnels si vous voulez adapter la formule d’appel ou le contenu au type de relation : une personne privée, une société ou une entreprise individuelle. Vous définissez le type de relation via Dossier relation > Identification.
👉 Disponible dans tous les types de modèles d’e-mail.
| Condition | Quand la condition s’applique |
|---|---|
{IF_relation.isPerson}...{ENDIF_relation.isPerson} |
La relation est une personne. |
{IF_relation.isEnterprise}...{ENDIF_relation.isEnterprise} |
La relation est une entreprise : une société ou une entreprise individuelle, mais pas une personne privée. |
{IF_relation.iscompany}...{ENDIF_relation.iscompany} |
La relation est une société, par exemple une SRL ou une SA. |
{IF_relation.issoleproprietor}...{ENDIF_relation.issoleproprietor} |
La relation est une entreprise individuelle. |
Exemple (formule d’appel adaptée) :
{IF_relation.iscompany}Madame, Monsieur,{ENDIF_relation.iscompany}{IF_relation.issoleproprietor}Bonjour,{ENDIF_relation.issoleproprietor}{IF_relation.isPerson}Bonjour,{ENDIF_relation.isPerson}
Peppol
Utilisez ces substituants conditionnels si vous voulez afficher du texte sur la base du statut Peppol du client ou du statut de livraison d’une facture.
👉 {IF_relation.isPeppolRequired} est disponible dans tous les types de modèles d’e-mail. {IF_invoice.peppoldeliveryfailed} est uniquement disponible dans les modèles d’e-mail liés à l’envoi de factures, comme "Envoyer la facture" ou les rappels.
| Condition | Quand la condition s’applique |
|---|---|
{IF_relation.isPeppolRequired}...{ENDIF_relation.isPeppolRequired} |
Peppol est obligatoire pour cette relation. |
{IF_invoice.peppoldeliveryfailed}...{ENDIF_invoice.peppoldeliveryfailed} |
L’envoi Peppol de la facture a échoué. |
Exemple (condition imbriquée pour un message Peppol) :
{IF_relation.isPeppolRequired}
À partir du 01/01/2026, nous sommes obligés d’envoyer les factures par voie électronique via Peppol pour les entreprises belges. Vos factures seront donc automatiquement envoyées via ce réseau.{IF_invoice.peppoldeliveryfailed}
La facture a été envoyée via Peppol, mais la livraison n’a pas abouti. Nous vous l’envoyons donc par e-mail. Veuillez contrôler votre enregistrement Peppol ou prendre contact avec nous afin que nous puissions vous envoyer correctement les prochaines factures.{ENDIF_invoice.peppoldeliveryfailed}{ENDIF_relation.isPeppolRequired}
Dans cet exemple, le message d’erreur Peppol apparaît uniquement si Peppol est obligatoire pour le client et que l’envoi a échoué. Dans les autres cas, aucun texte n’apparaît.
Caractéristiques de la facture
Utilisez ces substituants conditionnels si vous voulez adapter le texte sur la base des caractéristiques de la facture envoyée : s’il s’agit d’une facture ou d’une note de crédit, et si le paiement est immédiatement requis.
👉 Uniquement disponible dans les modèles d’e-mail liés à l’envoi de factures, comme "Envoyer la facture" ou les rappels. Dans les autres types de modèles, ces conditions ne deviennent jamais actives.
| Condition | Quand la condition s’applique |
|---|---|
{IF_invoice.isinvoice}...{ENDIF_invoice.isinvoice} |
Le document est une facture, pas une note de crédit. |
{IF_invoice.issamedaypayment}...{ENDIF_invoice.issamedaypayment} |
La date de facture et la date d’échéance tombent le même jour. Le paiement est donc requis immédiatement. |
Exemple :
{IF_invoice.isinvoice}
Veuillez payer le montant avant le {invoice.dueDate}.{ENDIF_invoice.isinvoice}{IF_invoice.issamedaypayment}
Cette facture est payable immédiatement.{ENDIF_invoice.issamedaypayment}
Schéma des comptes annuels
Utilisez ces substituants conditionnels si vous voulez faire référence dans un e-mail au schéma des comptes annuels du client. Vous définissez ce schéma via Dossier relation > Légal > Financier.
👉 Disponible dans tous les types de modèles d’e-mail.
| Condition | Quand la condition s’applique |
|---|---|
{IF_relation.financialstatementscheme.full}...{ENDIF_relation.financialstatementscheme.full} |
La relation utilise le schéma complet. |
{IF_relation.financialstatementscheme.reduced}...{ENDIF_relation.financialstatementscheme.reduced} |
La relation utilise le schéma abrégé. |
{IF_relation.financialstatementscheme.micro}...{ENDIF_relation.financialstatementscheme.micro} |
La relation utilise le microschéma. |
{IF_relation.financialstatementscheme.minimal}...{ENDIF_relation.financialstatementscheme.minimal} |
La relation utilise le schéma minimal. |
{IF_relation.financialstatementscheme.notapplicable}...{ENDIF_relation.financialstatementscheme.notapplicable} |
Le schéma ne s’applique pas à cette relation. |
Afficher du texte si un substituant est vide ou renseigné
Utilisez {IFNOTEMPTY_...} et {IFEMPTY_...} lorsqu’un texte ne peut apparaître que sur la base du contenu d’un substituant de votre choix : renseigné ou vide.
Ces conditions fonctionnent avec les substituants du dossier relation, comme une remarque, une référence ou une personne de contact. Vous trouverez tous les substituants disponibles via le bouton {Substituants} dans l’éditeur de modèle.
👉 Disponible dans tous les types de modèles d’e-mail.
Exemple (afficher une remarque si elle est complétée) :
{IFNOTEMPTY_relation.remark}
Remarque : {relation.remark}{ENDIFNOTEMPTY_relation.remark}
Exemple (afficher un message si un substituant est vide) :
{IFEMPTY_relation.remark}
Aucune remarque n’a encore été ajoutée à votre dossier.{ENDIFEMPTY_relation.remark}
Conseils pour utiliser les substituants conditionnels
-
Fermez correctement chaque bloc. Un
{IF_}ne peut jamais rester ouvert. Utilisez toujours le{ENDIF_}correspondant. Sinon, AdminPulse ne traitera pas correctement le modèle. - Testez votre modèle. Utilisez un client test fictif avec les bonnes caractéristiques, par exemple un client avec domiciliation. Remplacez l’adresse e-mail de ce client test par votre propre adresse e-mail et envoyez-vous un e-mail de test. Vous contrôlez ainsi si le bon texte apparaît.
- Utilisez l’imbrication pour combiner plusieurs conditions. Placez un bloc conditionnel dans un autre bloc conditionnel si vous voulez contrôler plusieurs conditions en même temps.
💡 Bon à lire
- Introduction générale aux modèles d’e-mail et à leur gestion : Créer, modifier et utiliser des modèles d’e-mail
- Introduction à l’utilisation des substituants dans les modèles d’e-mail : Modèles d'e-mail - substituants
- Vous voulez aussi afficher le mode de paiement sur la facture même ? Découvrez comment le configurer avec des substituants conditionnels dans le modèle de facture : FAQ - Comment définir un mode de paiement par client et l’afficher sur la facture ?