Quelles variables puis-je utiliser dans le modèle de facture ?

Cet article liste les espaces réservés/variables dont vous disposez pour personnaliser la mise en page du modèle de facture.

Remarque sur les blocs conditionnels : les espaces réservés de la forme {#has...}{/...} permettent un affichage conditionnel. Ils ne s'affichent donc que si une valeur correspondante existe.

Important : veuillez noter que les majuscules et les minuscules doivent être respectées exactement comme indiqué pour toutes les variables.

Variables de date de la facture

• {date} 18.08.2025
• {dateDay} 18
• {dateMonth} 8
• {dateYear} 2025
• {dateMonthName} août
• {dateMonthNameShort} août
• {dateMonthYearDisplay} août 2025
• {dateWithMonthName} 18 août 2025

Informations générales de la facture

• {number} Numéro de facture
• {poNumber} Numéro de bon de commande
• {#hasPoNumber}{/hasPoNumber} Numéro de bon de commande (conditionnel, affiché uniquement s'il existe)
• {location} Lieu de la facture
• {currentDate} Date complète au format JJ.MM.AAAA (p. ex. 08.07.2025)
• {currentDateDay}.{currentDateMonth}.{currentDateYear} (p. ex. 8.7.2025)
  • {currentDateDay} Jour du mois de la date actuelle (p. ex. 8)
  • {currentDateMonth} Mois de la date actuelle (numérique, sans zéro initial) (p. ex. 7)
  • {currentDateYear} Année à quatre chiffres (p. ex. 2025)
• {sender} Nom et adresse de l'émetteur de la facture (sur plusieurs lignes)
• {senderLine} Comme {sender}, mais sur une seule ligne
• {vatNumber} Numéro de TVA
• {receiver} Nom et adresse du destinataire de la facture (sur plusieurs lignes).
• Si vous souhaitez retirer un élément de l'espace réservé sur plusieurs lignes {receiver}, vous devez décomposer la variable en ses différentes parties et n'utiliser que les éléments dont vous avez besoin.
  • {#receiverName}{receiverName}{/} : nom
  • {receiverAddress} : ligne d'adresse 1
  • {#receiverZip}{receiverZip}{/} {#receiverCity}{receiverCity}{/} : ligne d'adresse 2
  • {#receiverCountry}{receiverCountry}{/} : pays
• {subject} Titre de la facture
• {description} Texte de la facture
• {#hasDescription}{/hasDescription} Texte de la facture (conditionnel, affiché uniquement s'il existe)
• {bankDetails} Informations de paiement (sur plusieurs lignes)
• {dueDate} Date d'échéance
• {customDueDate} Date d'échéance si des conditions de paiement personnalisées ont été définies ; sinon identique à {dueDate}
• {epcreference} Numéro de référence QR pour les factures QR en Suisse
• {qr} Code QR pour la facture QR SEPA

Variables de projet

• {projects[0].name} Nom du projet
• {projects[0].notes} Remarques sur le projet
• {projects[0].referenceNumber} Numéro de référence
• {projects[0].customfield} Champ personnalisé au niveau du projet (remplacez « customfield » par le nom du champ personnalisé, par exemple : {projects[0].contactperson})

Dans le bloc {#projects}{/projects}, vous pouvez aussi utiliser les espaces réservés suivants pour afficher des informations propres au projet :

• {name} Nom et période du projet
• {nameWithNoPeriod} Nom du projet sans la période entre parenthèses. Exemple : « Projet Alpha (1234) » devient « Projet Alpha ».
• {total} Montant total du projet
• {referenceNumber} Numéro de référence du projet
• {leaderName} Noms des chefs de projet (séparés par des virgules)
• {leaderEmail} Adresses e-mail des chefs de projet (séparées par des virgules)
• {notes} Remarques sur le projet
• {#hasNotes}{/hasNotes} Remarques sur le projet (conditionnel, affiché uniquement s'il en existe)
• {totalCount} Nombre total d'heures ou d'unités du projet (formaté avec deux décimales)
• {rate} Taux horaire ou prix unitaire du projet
• {expensesFlatrate} Libellé des frais forfaitaires, p. ex. « Frais forfaitaires 10 % »
• {expensesFlatrateAmount} Montant des frais forfaitaires.
• {expensesFlatrateApplyTax} Indique si des taxes sont appliquées aux frais forfaitaires
• {expensesFlatrateApplyDiscount} Indique si des remises sont appliquées aux frais forfaitaires

Dans le bloc {#entries}{/entries}, vous pouvez utiliser les espaces réservés supplémentaires suivants pour afficher des informations par entrée de projet.

• {name} Description de l'entrée de projet
• {count} Quantité de l'entrée
• {rate} Taux de l'entrée
• {amount} Montant total de l'entrée
• {countHHMM} Durée de l'entrée au format heures:minutes

Paiements anticipés

Dans le bloc {#advancePayments}{/advancePayments}, vous pouvez utiliser les espaces réservés suivants pour afficher des informations par paiement anticipé.

• {date} Date du paiement anticipé (au format JJ.MM.AAAA)
• {amount} Montant du paiement anticipé

Montants de la facture, taxes et remises

• {totalBeforeTaxWithoutExpensesFlatRateAmount} Montant de la facture avant taxes, déduction faite des frais forfaitaires.
• {totalExpensesFlatRateAmount} Montant total des frais forfaitaires
• {discountableAmount} Montant auquel la remise est appliquée
• {totalBeforeDiscount} Total de la facture avant remises
• {discount} Remise en %
• {#hasDiscount}{/hasDiscount} Remise en % (conditionnel, affiché uniquement s'il en existe une)
• {discountAmount} Montant de la remise
• {totalBeforeTax} Total de la facture hors TVA
• {#hasTax}{/hasTax} Taxe en % (conditionnel, affiché uniquement s'il en existe une)
• {tax} Taxe en %
• {taxAmount} Montant de la taxe
• {total} Montant de la facture, taxes et remises comprises
• {%logo} Logo de l'entreprise
• {currency} Devise de la facture
• {text.*} Texte traduit. Remplacez « * » par le nom d'une entrée sous « Paramètres » -> « Traductions »
• {totalCount} Total des heures (affiche le total du projet à l'intérieur des projets et le total général en dehors des projets)

Plages de temps et périodes

• {yearPeriod} Année de la période de facturation
• {fromPeriod} Date de début de la période de facturation (au format JJ.MM.AAAA)
• {toPeriod} Date de fin de la période de facturation (au format JJ.MM.AAAA)
• {fromPeriodWithFirstDayOfMonth} Premier jour du mois de la date de début (au format JJ.MM.AAAA)
• {toPeriodWithLastDayOfMonth} Dernier jour du mois de la date de fin (au format JJ.MM.AAAA)
• {fromPeriodFirstDay} Jour numérique (1–31) de la date de début
• {toPeriodLastDay} Jour numérique (1–31) de la date de fin
• {fromPeriodFirstMonth} Mois numérique (1–12) de la date de début
• {toPeriodLastMonth} Mois numérique (1–12) de la date de fin
• {fromPeriodFirstYear} Année de la date de début
• {toPeriodLastYear} Année de la date de fin
• {fromPeriodMonthName} Nom du mois de la date de début, localisé selon la langue du client
• {toPeriodMonthName} Nom du mois de la date de fin, localisé selon la langue du client
• {periodMonthYearDisplay} Période formatée, p. ex. « janvier 2025 – mars 2025 »