Dans cet article, vous trouverez des substituants qui placent automatiquement des données sur votre facture. Il s’agit de substituants que vous pouvez utiliser partout dans votre modèle, pour :
-
vos propres données d’entreprise
Nom, adresse, n° de TVA, RPM… -
les données client (depuis le dossier relation)
Coordonnées de votre client - les données de mission
-
les données de facture
Numéro de facture, date de facture, référence… -
les montants totaux et TVA
Total hors/TVA incluse, taux de TVA... - la ristourne au niveau de la facture
-
les données de paiement
QR code, lien de paiement, mode de paiement, IBAN,...
👉 Les substituants que vous pouvez utiliser uniquement avec des tableaux (par ex. pour les lignes de facture ou les enregistrements) se trouvent dans ces articles séparés :
- ⏭️ Modèles de facture : substituants pour les tableaux
- ⏭️ Modèles de détails de facture : structure, tableaux et substituants
💡 Astuce : utilisez la table des matières à droite pour accéder directement à une section spécifique de cet article.
Première utilisation des modèles de facture ? Commencez ici !
Vous débutez avec les modèles de facture ? Lisez d’abord les articles généraux sur les modèles de facture. Ils vous donnent les bases nécessaires avant de commencer à utiliser des substituants :
- Pour une introduction générale aux modèles de facture : Modèles de facture : vue d’ensemble de l’écran, les types et leur usage
- Pour gérer vos modèles de facture : Modèles de facture : actions clés pour la gestion
- Pour créer ou modifier des modèles de facture dans Word : Modèles de facture : personnalisez vos factures - substituants, tableaux et identité visuelle
- Vous voulez tirer davantage parti de votre document Word ? Consultez aussi cet article : Modèles de facture : astuces pour la mise en page dans Word
👉 Vous n’avez pas à partir de zéro. Dans AdminPulse, allez à Paramètres > Modèles de facture > Exemples de modèles. Vous pouvez utiliser les modèles d’exemple tels quels, ou les adapter pour en faire votre propre modèle.
Vous cherchez d’autres modèles d’exemple ? Consultez alors l’article suivant : Exemples de modèles pour factures et détails de facture
Comment ajouter des substituants à un modèle de facture ?
Ajouter un substituant est simple : copiez-le depuis les tableaux ci-dessous et collez-le à l’endroit voulu dans votre modèle Word.
Étapes :
-
Copiez le substituant depuis le tableau ci-dessous (par exemple
{CompanyName}). - Collez-le à l’endroit adéquat dans votre document Word.
Vous souhaitez remplacer un substituant existant ? Supprimez-le et collez le nouveau substituant au même endroit.
💡 Astuces :
- Vous pouvez placer plusieurs substituants côte à côte ou l’un en dessous de l’autre — cela fonctionne parfaitement.
- Vous pouvez aussi mettre en forme les substituants (gras, italique, couleur…). Ce style apparaîtra également sur votre facture.
- 👉 Attention : les substituants doivent correspondre exactement. Pas d’espaces ou caractères en trop, et respectez les majuscules/minuscules — sinon le substituant ne fonctionnera pas.
Substituants pour modèles de facture : substituants généraux expliqués
Comment afficher les données de votre propre entreprise sur les factures ?
Les substituants {Company...} remplissent automatiquement, sur vos factures, les données de votre propre entreprise (Paramètres> Propre entreprise) telles que le nom, l’adresse, les coordonnées et le numéro de TVA ou d’entreprise.
Substituants avec les données de votre 'Propre entreprise' :
| Substituant | Description |
| {CompanyName} | Dénomination légale de votre entreprise, forme juridique incluse |
| {CompanyCommercialName} | Nom commercial ou abrégé de votre entreprise |
| {CompanyEnterpriseNumber} | Numéro d’entreprise de votre société |
| {CompanyVatNumber} | Numéro de TVA de votre entreprise |
| {CompanyTelephone} | Numéro de téléphone de votre entreprise |
| {CompanyEmail} | Adresse e-mail de votre entreprise |
| {CompanyWebsite} | Site web de votre entreprise |
| {CompanyProfessionalAssociation} | Abréviation de votre association professionnelle (IAB, ITAA, IBR ou BIBF) |
| {CompanyProfessionalAssociationNumber} | Numéro d’affiliation auprès de votre association professionnelle |
| {CompanyJurisdiction} | Numéro RPM de votre société (registre des personnes morales) (p. ex. : « Anvers, division Malines ») |
| {CompanyIban} | Numéro de compte IBAN de votre entreprise |
| {CompanyBic} | Code BIC de votre compte bancaire |
| {CompanyStreetAndNr} | Nom de rue, numéro et éventuellement boîte (p. ex. « Puursesteenweg 390/C ») |
| {CompanyStreet2} | Deuxième ligne d’adresse de votre entreprise |
| {CompanyZipCode} | Code postal de l’adresse de votre entreprise |
| {CompanyCity} | Commune de l’adresse de votre entreprise |
| {CompanyCountry} | Pays de l’adresse de votre entreprise |
| {CompanyLegalForm} | Uniquement la forme juridique de votre entreprise (p. ex. « BV/SRL » ou « NV/SA ») |
Exemple :
💡 Vous avez plusieurs numéros de compte à afficher sur votre facture ? Utilisez alors un tableau, comme expliqué dans l’article suivant : Modèles de facture : substituants pour les tableaux
Comment placer les données client sur votre facture ?
Les substituants {Relation...} récupèrent automatiquement des données depuis le dossier relation de votre client, telles que le nom, l’adresse, les coordonnées et les numéros d’identification (Dossier relation > section : Identification) pour les afficher sur la facture.
Substituants avec des données des dossiers relation :
| Substituant | Description |
| {RelationName} | Nom avec forme juridique (pour les entreprises) ou civilité (pour les personnes) de votre client (p. ex. « Syneton BVBA ») |
| {RelationLastName} | Nom de famille de votre client (ou dénomination de l’entreprise le cas échéant) |
| {RelationFirstName} | Prénom de votre client (vide pour les entreprises) |
| {RelationSalutation} | Civilité de la relation |
| {RelationCommercialName} | Nom court / commercial de la relation |
| {RelationNameOrCommercialName} | Affiche le nom ou le nom commercial de la relation |
| {RelationNameFirstNameLeadingOrCommercialName} | Affiche prénom + nom ou le nom commercial de la relation |
| {RelationCustomSalutationOrRelationOrContactLastNameSalutation} | Civilité personnalisée ou nom de famille de votre client |
| {RelationCustomSalutationOrRelationOrContactFirstNameSalutation} | Civilité personnalisée ou prénom de votre client |
| {RelationCustomSalutationOrRelationOrContactNameSalutation} | Civilité personnalisée ou nom de votre client |
| {RelationStreetAndNr} | Nom de rue, numéro et éventuellement boîte (p. ex. : « Boerenkrijglaan 34/C ») |
| {RelationStreet2} | Deuxième ligne d’adresse de la relation |
| {RelationZipCode} | Code postal de l’adresse de la relation |
| {RelationCity} | Commune de l’adresse de la relation |
| {RelationCountry} | Pays de l’adresse de la relation |
| {RelationVatNumber} | Numéro de TVA de la relation |
| {RelationCode} | Code client |
| {RelationUniqueIdentifier} | Identifiant unique de la relation dans AdminPulse (APR...) |
| {RelationAccountingNumber} | N° comptabilité : numéro de référence comptable |
| {RelationEnterpriseNumber} | Numéro d’entreprise de la relation |
| {RelationMatricule} | Numéro de matricule de la relation (Luxembourg) |
| {RelationOrContactFirstName} | Prénom de la relation ou du contact principal de la relation |
| {RelationOrContactLastName} | Nom de famille de la relation ou du contact principal de la relation |
| {RelationOrContactName} | Nom complet de la relation ou du contact principal de la relation |
| {RelationOrContactSalutation} | Civilité de la relation ou de la personne de contact |
| {RelationOrContactInitials} | Initiales de la relation ou du contact principal de la relation |
| {RelationVatEnterpriceNumberLabel} | Le texte « Numéro de TVA » ou « Numéro d’entreprise » (si le n° de TVA n’est pas connu) |
| {RelationVatEnterpriceNumber} | Affiche le numéro de TVA ou, à défaut, le numéro d’entreprise |
| {RelationVatEnterpriseNumberLabel} |
Le texte « Numéro de TVA » ou « Numéro d’entreprise » (si le n° de TVA n’est pas connu) (substituant recommandé) |
| {RelationVatEnterpriseNumber} | Numéro de TVA ou numéro d’entreprise (si le n° de TVA n’est pas connu) (substituant recommandé) |
| {RelationTradeRegister} | Registre de commerce de la relation (Luxembourg) |
Exemple :
Comment afficher les informations de mission ?
Les substituants {Assignment...} remplissent automatiquement les informations relatives à la mission pour laquelle la facture est établie — même en dehors des tableaux.
Substituants avec les données de la mission :
| Substituant | Description |
| {AssignmentName} | Nom de la mission (vide s’il s’agit de la mission standard) |
| {AssignmentOrDefault} | Affiche le nom de la mission ou le texte par défaut « Mission standard » |
Exemple :
Comment afficher les informations essentielles de votre facture ?
Les substituants de la liste ci-dessous remplissent automatiquement les informations essentielles de la facture, telles que le numéro de facture, la date, l’échéance, le texte de facture et la description.
Substituants avec les informations essentielles de la facture :
| Substituant | Description |
| {InvoiceNumber} | Numéro de facture |
| {InvoiceDate} | Date de facture |
| {PurchaseOrderNumber} | Numéro de bon de commande (numéro PO), renseigné sur le dossier relation ou par mission |
| {ExpiryDate} | Date d’échéance de la facture |
| {PaymentReference} | Référence de paiement de la facture |
| {InvoiceNumberReference} | Numéro de la facture d’origine pour les notes de crédit |
| {BelgianCreditNoteText} | Texte légal pour les notes de crédit belges : « TVA à reverser à l’État dans la mesure où elle a été initialement déduite. » |
| {InvoiceDescription} | Description de facture que vous saisissez manuellement dans la proposition de facture |
| {InvoiceText} | Texte de facture depuis Paramètres > Textes de facture, utilisé uniquement lors de la création automatique de factures par la planification de facturation |
| {RelationInvoiceRemark} | Remarque de facture depuis le dossier relation (section : Facturation), qui apparaît sur chaque facture pour cette relation |
| {InvoiceRemark} | Texte sur la facture depuis Paramètres > Paramètres généraux > Facturation : création de PDF qui apparaît sur chaque facture |
| {TransactionType} | Type de transaction de la facture, p. ex. « Taux normal », « Autoliquidation intracom services » ou « Exportation ». |
| {VatExemptionReason} | Motif d’exonération de TVA. |
Exemple :
Comment afficher les totaux et les montants de TVA sur la facture ?
Les substituants de la liste ci-dessous affichent les totaux de votre facture, comme le montant de TVA et le total TVA incluse. Vous pouvez les placer de manière flexible — par exemple en haut de votre modèle pour rendre immédiatement visible le montant à payer, ou en bas comme clôture du récapitulatif.
Vous pouvez aussi combiner ces substituants avec des conditions (voir plus loin dans cet article sous Utiliser des conditions pour afficher des informations dynamiquement).
👉 Important : les substituants relatifs aux totaux fonctionnent indépendamment des tableaux tels que InvoiceLines ou Registrations. Ils affichent le résultat final calculé de la facture et n’ont donc pas besoin de structure {TableStart:...}.
⏭️ Plus d’explications sur les tableaux dans les modèles de facture se trouvent dans cet article séparé : Modèles de facture : substituants pour les tableaux
Substituants avec totaux et montants de TVA :
| Substituant | Description |
| {InvoiceSubtotalAmount} | Montant avant ristourne et avant TVA. |
| {InvoiceTaxableAmount} | Montant total hors TVA |
| {InvoiceBaseAmount} | Identique à {InvoiceTaxableAmount}, mais avec un nom de substituant plus explicite |
| {InvoiceAmount} | Montant total TVA incluse |
| {InvoiceVatAmount} | TVA totale sur la facture |
| {InvoiceTimeAmount} | Total de toutes les lignes de facture sauf les frais, hors TVA |
| {InvoiceCostAmount} | Total de toutes les lignes basées sur les coûts (frais, frais administratifs), hors TVA |
| {InvoiceFixedAmountAmount} | Montant total du forfait, hors TVA |
| {InvoiceFixedAmountVatAmount} | Montant de la TVA sur le forfait |
| {InvoiceTimeAmountExcludedFromFixedAmount} | Montant total des lignes basées sur le temps qui ne sont pas comprises dans le montant du forfait, hors TVA |
| {InvoiceTimeVatAmountExcludedFromFixedAmount} | Montant de la TVA sur les lignes basées sur le temps qui ne sont pas comprises dans le montant du forfait |
| {InvoiceCostAmountExcludedFromFixedAmount} | Montant total des lignes basées sur les coûts qui ne sont pas comprises dans le montant du forfait, hors TVA |
| {InvoiceCostVatAmountExcludedFromFixedAmount} | Montant de la TVA sur les lignes basées sur les coûts qui ne sont pas comprises dans le montant du forfait |
| {InvoicePaidAdvancesVatAmount} | TVA sur les acomptes payés (montant négatif) |
| {InvoicePaidAdvancesAmount} | Montant total des acomptes payés (montant négatif) |
| {InvoicePaidAdvancesSubTotalAmount} | Sous-total des acomptes payés, hors TVA (montant négatif) |
| {InvoiceTotalSettlementVatAmount} | TVA sur le montant total lorsqu’aucun acompte n’a été imputé |
| {InvoiceTotalSettlementAmount} | Montant total de la facture lorsqu’aucun acompte n’a été imputé |
| {InvoiceTotalSettlementSubTotalAmount} | Sous-total de la facture sans acomptes, hors TVA |
| {InvoiceAdministrativeCostAmount} | Frais administratifs sur la facture, hors TVA |
| {InvoiceAdministrativeCostVatAmount} | TVA sur les frais administratifs |
Exemple :
Dans cet exemple, vous voyez comment les substituants de total peuvent être placés en bas d’un tableau, comme clôture visuelle du récapitulatif de facture.
Comment afficher une ristourne sur la facture ?
Les substituants ci-dessous affichent des informations sur la ristourne générale sur la facture, les ristournes sur les lignes et la combinaison des deux.
Substituants liés aux ristournes :
| Substituant | Description |
| {DiscountAmount} | La ristourne de facture. Il peut s’agir d’un pourcentage ou d’un montant TVA comprise |
| {DiscountVatAmount} | La part de TVA de la ristourne de facture |
| {DiscountBaseAmount} | Montant de la ristourne de facture hors TVA |
| {DiscountLabel} | Le mot « Ristourne », uniquement renseigné s’il y a effectivement une ristourne de facture. |
| {DiscountPercentage} | Le pourcentage de ristourne de la ristourne générale sur la facture. Vide lorsque la ristourne a été saisie comme montant fixe |
| {DiscountIsPercentage} | Indique si {DiscountAmount} est un pourcentage : Oui = ristourne en pourcentage, Non = ristourne en montant |
| {HasLineDiscounts} | Oui lorsqu’il y a au moins une ligne de facture avec une ristourne, sinon Non. |
| {LineDiscountBaseAmount} | Ristourne totale sur les lignes hors TVA (somme de toutes les ristournes sur les lignes de facture). |
| {HasTotalDiscounts} | Oui lorsqu’il y a n’importe quelle ristourne (ristourne générale sur la facture et/ou ristourne sur ligne), sinon Non. |
| {TotalDiscountBaseAmount} | Ristourne totale hors TVA : {DiscountBaseAmount} + {LineDiscountBaseAmount}. |
Exemple :
Comment afficher les données de paiement sur la facture ?
Les substituants dans la liste ci-dessous contiennent toutes les informations nécessaires pour payer une facture — comme le code QR et le lien de paiement.
Substituants relatifs aux données de paiement :
| Substituant | Description |
| {Image:PaymentQrCode} |
Ajoute un code QR de paiement sur la facture.
|
| {PaymentQrCodeText} | Texte fixe associé au code QR : « Veuillez scanner le code QR avec votre app bancaire. » ou « Veuillez scanner le code QR avec votre application appareil photo. » Ce texte ne peut pas être modifié. Vous souhaitez ajouter des instructions supplémentaires ? Ajoutez-les directement dans votre modèle de facture Word : tapez le texte dans le document, autour de {Image:PaymentQrCode} (p. ex. au-dessus, en dessous ou à côté). |
| {PaymentUrl} | Lien unique sur lequel le client peut cliquer pour payer la facture. 👉 Ce substituant est uniquement disponible si vous utilisez un prestataire de paiement tel que POM, Twikey ou Mollie. |
Utiliser des conditions pour afficher des informations dynamiquement
À quoi servent les conditions dans votre modèle de facture?
Grâce à des conditions comme {IF} et {IFNOTEMPTY}, vous déterminez quand certains éléments ou textes doivent s’afficher sur la facture.
Cela rend votre modèle dynamique : seules les informations pertinentes pour le client ou la situation spécifique sont affichées - par exemple un code QR, une référence ou des instructions supplémentaires.
Quand utiliser des conditions dans les modèles de facture ?
Voici quelques exemples typiques :
- Afficher un code QR uniquement lorsqu’un lien de paiement est disponible.
- Afficher un texte différent selon qu’il s’agit d’une domiciliation ou d’un virement manuel.
Quels types de conditions pouvez-vous utiliser ?
- Avec
{IF}, vous indiquez : « Afficher ceci uniquement si la condition est vraie. » - Avec
{IFNOTEMPTY}, vous affichez un élément uniquement si un champ donné n’est pas vide.
Conditions IF liées au paiement et au mode de paiement
Ces conditions utilisent des champs dits booléens : ils sont soit vrais (true), soit faux (false). Le contenu compris entre {IF} et {ENDIF} s’affiche uniquement si le champ est « vrai ».
-
{IF HasPaymentQrCode} ... {ENDIF HasPaymentQrCode}
Affiche le contenu uniquement lorsqu’un code QR est disponible. -
{IF IsSameDayPayment} ... {ENDIF IsSameDayPayment}
Affiche le contenu uniquement si la date de facture et la date d’échéance sont identiques (par ex. « Paiement immédiat requis »). -
{IF RelationPaymentMethodDirectDebit} ... {ENDIF RelationPaymentMethodDirectDebit}
Affiche le contenu uniquement si le client utilise la domiciliation. -
{IF RelationPaymentMethodManual} ... {ENDIF RelationPaymentMethodManual}
Affiche le contenu uniquement si le client effectue un virement manuel.
Exemple :
Dans cet exemple :
- Si le client paie par domiciliation, seul le texte « Paiement par domiciliation » apparaît.
- En cas de virement manuel, le texte « Référence de paiement : XXX » s’affiche, accompagné du code QR et d’instructions supplémentaires.
Conditions IF pour ristourne et frais administratifs
Utilisez ces conditions pour afficher un texte spécifique lorsqu’une remise ou des frais administratifs sont appliqués à une facture :
-
{IF HasDiscountAmount} ... {ENDIF HasDiscountAmount}
Affiche le contenu uniquement s’il y a une ristourne. -
{IF InvoiceHasAdministrativeCostAmount} ... {ENDIF InvoiceHasAdministrativeCostAmount}
Affiche le contenu uniquement s’il y a des frais administratifs.
Exemple :
{IF HasDiscountAmount}Une remise a été appliquée sur cette facture.{ENDIF HasDiscountAmount}
{IF InvoiceHasAdministrativeCostAmount}Des frais administratifs ont été ajoutés.{ENDIF InvoiceHasAdministrativeCostAmount}Conditions IF selon le type de client
Ces conditions permettent de définir une formule d’appel différente selon le type de client :
-
{IF_relation.isEnterprise} ... {ENDIF_relation.isEnterprise}
Affiche le contenu uniquement si la relation correspond à une entreprise individuelle ou société. -
{IF_relation.isPerson} ... {ENDIF_relation.isPerson}
Affiche le contenu uniquement si la relation correspond à une personne physique. -
{IF_relation.isCompany} ... {ENDIF_relation.isCompany}
Affiche le contenu uniquement si la relation correspond à une société. -
{IF_relation.issoleproprietor} ... {ENDIF_relation.issoleproprietor}
Affiche le contenu uniquement si la relation correspond à une entreprise individuelle.
Exemple (formule d’appel selon le type) :
{IF_relation.isCompany}Madame, Monsieur,{ENDIF_relation.isCompany}
{IF_relation.issoleproprietor}Cher entrepreneur,{ENDIF_relation.issoleproprietor}
{IF_relation.isPerson}Cher client,{ENDIF_relation.isPerson}Condition IFNOTEMPTY : afficher un élément uniquement si un champ n’est pas vide
Avec {IFNOTEMPTY}, vous pouvez afficher un élément uniquement lorsqu’un champ contient une valeur.
Exemple :
Dans cet exemple :
- La ligne « Frais refacturés » apparaît uniquement si
{InvoiceCostAmount}n’est pas vide.
💡Conseils pour l’utilisation des conditions
-
Fermez correctement chaque bloc : un
{IF}ne peut jamais rester ouvert. Utilisez toujours{ENDIF}.{IFNOTEMPTY}se ferme avec{/IFNOTEMPTY}. - Gardez des conditions lisibles : utilisez une structure claire et limitez la complexité autant que possible.
- Testez soigneusement : essayez votre modèle auprès de différentes relations et avec des réglages variés pour vous assurer que tout fonctionne comme prévu.
-
Attention à la casse : des substituants comme
HasPaymentQrCodesont sensibles aux majuscules/minuscules et doivent être orthographiés exactement.
💡Bon à lire
- Vous débutez avec les modèles ? Consultez d’abord nos articles de base sur les modèles de facture. Commencez ici : Premiers pas : les modèles de factures dans AdminPulse
- ⏭️ Cet article fait partie d’une série. L’article suivant approfondit les tableaux dans les modèles de facture : Modèles de facture : substituants pour les tableaux
- Vous cherchez des modèles d’exemple ? Consultez alors l’article suivant : Exemples de modèles pour factures et détails de facture
- Vous utilisez un modèle pour les détails de facture ? Vous trouverez ici les bons substituants et la bonne structure : Modèles de détails de facture : structure, tableaux et substituants
- Vous n’arrivez pas à télécharger correctement votre modèle ? Consultez cet article FAQ : FAQ - Pourquoi est-ce que je reçois un message d’erreur lors du chargement de mon modèle de facture ?
- Vous voyez un message d’erreur ou un texte étrange sur votre aperçu ou votre facture ? FAQ - Pourquoi ma facture affiche-t-elle « System.Collections.Generic… » au lieu de données?