Cette mise en page (layout) de facture vous permet de modifier les paramètres d'impression via la boîte de dialogue Paramètres.  Les paramètres sont similaires à ceux de la mise en page (layout) UNI11, avec la possibilité supplémentaire d'imprimer le Code QR Suisse.

Voir aussi :

• Informations générales sur la personnalisation de l'impression des factures.
• Offres et factures
  • Imprimer Offres et Factures
  • Comment imprimer les Offres et les Factures.
• Factures dans la comptabilité
  • Imprimer les factures.
  • Comment imprimer des factures intégrées dans la comptabilité.

Dialogue des paramètres de facturation

Pour accéder au dialogue de paramétrage des factures, vous avez deux possibilités :

• Dans la boîte de dialogue Imprimer factures, section Mise en page (layout), bouton Paramètres.
  • Dialogue d'impression de factures pour la facturation intégrée à la comptabilité.
  • Dialogue Imprimer Factures pour l'application Offres et Factures.
        Dans l'aperçu avant impression, cliquez sur le symbole de la roue dentée (paramètres).
• Dans l'Aperçu d'impression, cliquez sur le symbole de la roue dentée (paramètres).

Le dialogue se compose de plusieurs niveaux et sous-niveaux qui vous permettent d'intervenir sur des parties spécifiques de la facture :

• Imprimer
  Les éléments qui composent l'impression de la facture, avec la possibilité de les personnaliser.
• Textes
  Les textes, dans les différentes langues, qui sont utilisés pour l'impression.
• QR-Code
  Les paramètres pour l'impression du QR-Code Suisse.
• Styles
  Changez la police et les couleurs.
• Programmation (fichiers JavaScript/CSS propres)
  Il s'agit d'un niveau de personnalisation encore plus élevé, mais qui nécessite des connaissances en programmation.
  Vous pouvez intervenir sur les différents éléments d'impression, les modifier ou les remplacer.

 Propriété d'impression

Ce niveau définit les éléments de la facture à inclure et ceux à exclure de l'impression de la facture.

Fenêtre paramètres - Propriété d'impression

Elle est divisé en plusieurs sous-niveaux qui vous permettent de gérer un élément spécifique de la facture.

En-tête

Élément de dialogue qui vous permet de définir l'en-tête en haut de la page de la facture.

• En-tête de page 
  Cochez la case pour inclure des textes dans l'en-tête.
  Les textes sont extraits des données d'adresse de la comptabilité, définies dans Fichier > Propriétés Fichier > Adresse.
  Le code TVA est obligatoire et doit être saisi dans le champ approprié.
• Texte ligne 1 ... Texte ligne 5
  Si vous ne souhaitez pas utiliser les données d'adresse de base, vous pouvez saisir manuellement les textes que vous souhaitez utiliser.
  Ces textes seront affichés dans l'en-tête et remplaceront tous les textes définis dans Propriétés Fichier.
  Dans ce cas, le numéro de TVA n'est pas imprimé automatiquement. Comme il est obligatoire, vous devez l'ajouter manuellement dans l'une des lignes.
• Logo
  Cochez la case pour inclure le logo dans l'en-tête.
  Le logo est défini avec la commande menu Fichier > Configuration Logo où vous pouvez également définir la taille, choisir la façon de l'aligner (gauche, centre, droite), et également choisir la façon d'aligner l'adresse par rapport au logo.
• Nom du Logo
  Saisissez le nom de la personnalisation du logo défini dans le menu Fichier > Configuration logo, en respectant les majuscules et les minuscules.

Adresse client

Élément du dialogue qui vous permet de définir certains paramètres pour l'adresse de facturation.

Les adresses des clients sont extraites des colonnes spécifiques du tableau, voir Comptes > Vue Adresse pour la facturation intégrée, et du tableau Contacts pour l'application Offres et factures.

• Texte adresse de l'expéditeur.
  Au-dessus de l’adresse du client, vous pouvez insérer une ligne indiquant l’adresse de l’expéditeur, au cas où vous utilisez une enveloppe à fenêtre.
  Laissez le champ vide pour utiliser l’adresse définie dans le menu. Fichier > Propriétés Fichier > Adresse ou saisissez le texte manuellement.
  Entrez <none> pour ne pas inclure la ligne soulignée de l’expéditeur au-dessus de l’adresse du client.
• Composition de l'adresse
  Décider comment composer l'adresse. Entrez les noms XML des colonnes d'adresses dans l'ordre que vous préférez: pour la facturation intégrée tableau Comptes (vue Adresse), pour l'application Offres et Factures le tableau Contacts. Le nom de chaque colonne doit être défini entre "<" et ">".
  Vous pouvez voir le nom XML de chaque colonne avec la commande Organiser colonnes, onglet Paramètres.
  
  Vous ne pouvez utiliser que les colonnes suivantes (les autres colonnes ne peuvent pas être utilisées) :
  
  Colonne Préfixe (nom XML = NamePrefix).
  Colonne Organisation (nom XML = OrganisationName).
  Colonne Prénom (nom XML = FirstName).
  Colonne Nom de Famille (nom XML = FamilyName).
  Colonne Rue (nom XML = Street).
  Colonne N. rue (nome XML = BuildingNumber).
  Colonne Adresse extra (nom XML = AddressExtra).
  Colonne Boîte Postale (nom XML = POBox).
  Colonne Code postal (nom XML = PostalCode).
  Colonne Lieu (nom XML = Locality).
  Colonne Région (nom XML = Region).
  Colonne Pays (nom XML = Country).
  Colonne Code Pays (nom XML = CountryCode).
  Colonne Email Travail (nom XML = EmailWork).
  
  Quelques exemples:
  • Indiquez le nom de l'organisation, son adresse, son code postal et son lieu :
    <OrganisationName>
    <Street>
    <PostalCode> <Locality>
  • Indiquez le préfixe, le prénom, le nom de famille, l'adresse, le code postal et le lieu :
    <NamePrefix>
    <FirstName> <FamilyName>
    <Street>
    <PostalCode> <Locality>
  • Indiquez une adresse supplémentaire, une boîte postale et le code du pays :
    <OrganisationName>
    <NamePrefix>
    <FirstName> <FamilyName>
    <Street> <AddressExtra>
    <POBox>
    <CountryCode> - <PostalCode> <Locality
• Aligner à gauche
  Cochez la case pour imprimer l'adresse à gauche, sinon elle sera imprimée à droite
• Déplacer horizontalement
  Saisissez une valeur en cm pour déplacer l'adresse du client vers la droite (valeur positive) ou vers la gauche (valeur négative).
• Déplacer verticalement
  Saisissez une valeur en cm pour déplacer l'adresse du client vers le bas (valeur positive) ou vers le haut (valeur négative).
• Adresse de livraison
  Uniquement disponible pour la facturation intégrée à la comptabilité.
  L'adresse de livraison est également imprimée.
  L'adresse de livraison est saisie à l'aide du code :sadr dans la colonne TypeDoc du tableau Écritures pour définir l'adresse de livraison

Informations

Élément de dialogue qui vous permet de définir les informations de la facture à inclure et celles à exclure de l'impression (en haut à gauche).

Facturation intégrée :

• Numéro de facture / Note de crédit
  Spécifié dans la colonne PièceFacture du tableau Écritures.
• Date facture
  Spécifié dans la colonne Date du tableau Écritures.
• Numéro commande
  Spécifié dans la colonne TypeDoc du tableau Écritures par le code :ordn
• Date commande
  Spécifié dans la colonne TypeDoc du tableau Écritures par le code :ordd
• Numéro Client
  Spécifié dans l'opération de facturation du tableau Écritures.
• Numéro de TVA Client
  Spécifié dans la colonne Numéro de TVA du tableau Comptes, vue Divers.
• Numéro fiscal Client
  Spécifié dans la colonne Numéro fiscal du tableau Comptes, vue Divers.
• Échéance facture
  L'échéance d'une facture peut être insérée de différentes manières. Pour plus d'informations, veuillez consulter la page Échéances et modalités de paiement.
• Numéro de page
  Le numéro de la page en cours.

Application Offres et Factures :

• Numéro de facture / Offre
  Spécifié dans la colonne Id du tableau Factures / Offres.
• Date facture
  Spécifié dans la colonne Date du tableau Factures / Offres.
• Numéro commande
  Spécifié dans le champ Nr commande du dialogue de creation/modification de la facture.
• Date commande
  Spécifié dans le champ Date commande du dialogue de creation/modification de la facture.
• Numéro Client
  Spécifié dans la colonne Contact ID du tableau Factures/Offres.
• Numéro de TVA Client
  Spécifié dans la colonne Numéro de TVA du tableau Contacts.
• Numéro fiscal Client
  Spécifié dans la colonne Numéro fiscal du tableau Contacts.
• Échéance facture
  Spécifié dans la colonne Échéance du tableau Factures / Offres.
  L'échéance d'une facture peut être insérée de différentes manières. Pour plus d'informations, veuillez consulter Définir le délai de paiement.
• Numéro page
  Le numéro de la page en cours.
• Champs personnalisés
  Seulement avec le Plan Advanced.
  Tous les champs d'informations supplémentaires personnalisés définis dans la section Dialogue des facture sont ajoutés.

Détails de la facture

Par détails de la facture, nous entendons le tableau indiquant les articles, les quantités, les prix et les totaux.

Compositions de colonnes prédéfinies

Permet de sélectionner les colonnes à afficher dans les détails de la facture directement à partir d'une liste.
La liste comprend des compositions de colonnes prédéfinies parmi lesquelles vous pouvez choisir. Certains d'entre eux nécessitent le plan avancé de Banana Comptabilité Plus.

Sélectionnez une composition de colonne dans la liste et confirmez.
Les valeurs des propriétés Noms des colonnes, Largeur des colonnes, Alignement des titres, Alignment des textes de la section Détails de la facture et de la propriété Noms des colonnes détails facture de la section Textes sont définies automatiquement par le programme.

Disponible à partir de la version 10.0.10.21348 ou plus récente de Banana Comptabilité Plus.

Logique de disposition des colonnes

Les colonnes à afficher peuvent être définies manuellement de cette manière :

• Dans les noms de colonnes, vous indiquez les noms XML des colonnes à imprimer.
• Dans les champs suivants, les caractéristiques d'impression des différentes colonnes sont indiquées.
  • Largeur de la colonne.
  • Alignement du titre.
  • Alignement du texte.
• Dans la section Textes, vous indiquez les textes d'en-tête de colonne.
  • Pour chaque langue, le texte de l'en-tête doit être indiqué.

Si vous sélectionnez un paramètre Colonnes par défaut, tous les éléments sont modifiés automatiquement.

Valable pour tous les éléments

• Les éléments sont séparés par des ';' et doivent correspondre au nombre de colonnes définies.
• Si l'un de ces éléments est laissé vide, les valeurs par défaut sont prises.

Noms des colonnes

Indiquez manuellement les colonnes à afficher dans les détails de la facture.
Entrez les noms XML des colonnes dans le tableau Écritures. Vous pouvez afficher le nom XML de chaque colonne avec la commande Organiser colonnes, onglet Paramètres. Séparez les noms de colonnes par un ';' (point-virgule).

Les colonnes par défaut sont les suivantes :

• Pour les factures intégrées dans la comptabilité :
  • Number (Id article). Cela s'applique à la fois à la colonne Id de la table Articles dans l'application Offres et Factures, et à la colonne Article de la table Écritures dans la facturation intégrée.
  • Description
  • Quantity
  • ReferenceUnit
  • UnitPrice
  • Amount
  • VatRate
• Supplémentaire pour l'application de l'offre de facturation :
  • Date
  • Discount

Avec le Plan Advanced de Banana Comptabilité Plus, vous pouvez imprimer d'autres colonnes du tableau des Écritures (pour la facturation intégrée) et du tableau Articles (pour la facturation intégrée et l'application Offres et Factures) qui ne figurent pas dans la liste ci-dessus.

• Tableau Écritures (Transactions).
  • La syntaxe à utiliser est T.NomColonne.
    "T." indique qu'il s'agit d'une colonne de la table Écritures (Transactions),
    "NomColonne" est le nom XML de la colonne (par exemple "T.Notes", "T.DateWork", etc.).
• Tableau Articles (Items).
  • La syntaxe à utiliser est I.NomColonne.
    "I." indique qu'il s'agit d'une colonne du tableau Articles (Items) ,
    "NomColonne"est le nom XML de la colonne (par exemple "I.Links", etc.).

Largeur des colonnes

Entrez la largeur de chaque colonne avec une valeur en pourcentage. Chaque valeur définit l'espace qu'occupe une colonne par rapport à la largeur totale de la page. La somme doit être de 100%.
Séparez les largeurs de colonne par un " ;" (point-virgule).

Alignement des titres

Saisissez l'alignement du titre pour chaque colonne. Vous pouvez aligner le texte à gauche (left) , au centre (center) et à droite (right). Séparez chaque alignement par un " ;" (point-virgule).

Alignement du texte

Entrez l'alignement du texte de chaque colonne. Vous pouvez aligner le texte à gauche (left), au centre (center)  et à droite (right). Séparez chaque alignement par un " ;" (point-virgule).

Montants bruts ( TVA compris)

Vous pouvez décider d'utiliser les montants bruts incluant la TVA ou les montants nets hors TVA.

Impression de descriptions supplémentaires

Disponible uniquement pour la facturation intégrée à la comptabilité.
Vous pouvez décider si vous souhaitez saisir des descriptions supplémentaires sur plusieurs lignes.

• Dans le tableau Écritures, ajoutez une ou plusieurs colonnes de description supplémentaires à l'aide de la commande Organiser colonnes.
  Pour chaque ligne de description supplémentaire, ajoutez une colonne distincte.
  Créez des colonnes de type Texte avec le nom "Description" suivi d'un numéro (par exemple Description1, Description2, Description3, etc.)
  Le "nom XML" de chaque colonne doit commencer par le mot "Description" (en anglais) suivi d'un nombre.
  Dans le champ "Nom", saisissez ce que vous voulez.
  
  
   
• Dans ces colonnes, saisissez des textes supplémentaires pour les descriptions des factures.
  Le texte de chaque colonne est inséré sur une nouvelle ligne immédiatement en dessous de la description principale.

Quelques exemples

Inclure les colonnes Description, Quantité, Unité, Prix unitaire et Montant :

• Description;Quantity;ReferenceUnit;UnitPrice;Amount
  50%;10%;10%;15%;15%
  center;center;center;center;center
  left;center;center;right;right
• N'incluez que les colonnes Description et Montant :
  • Description;Amount
    70%;30%
    center;right
    left;right
• Incluez les colonnes Description, Notes et Montant. Notes n'est pas une colonne par défaut, le nom doit être précédé de "T.". Nécessite le plan Banana Accounting Plus Advanced.I
  • Description;T.Notes;Amount
    35%;35%;30%
    left;left;right
    left;left;right
• Inclure les colonnes Description, DateTravail, Quantité, Prix unitaire et Montant (DateTravail est une colonne créée manuellement, le nom doit être précédé de "T."). Nécessite le plan avancé de Banana Comptabilité Plus.
  Description;T.DateWork;Quantity;ReferenceUnit;UnitPrice;Amount
  35%;15%;10%;10%;15%;15%
  left;center;center;center;right;right
  left;center;center;center;right;right
• Dans l'application Offres et Factures: inclure les colonnes Numéro, Date, Description, Quantité, Unité, Prix unitaire, Remise e Montant.
  Number;Date;Description;Quantity;ReferenceUnit;UnitPrice;Discount;Amount
  10%;10%;50%;10%;10%,10%;15%;15%
  left;left;left;right;right;right;right;right
  left;left;left;right;right;right;right;right

Pied de page

Élément de dialogue qui permet d'insérer un pied de page.

• Imprimer pied de page
  Indique s'il faut inclure le pied de page, qui se compose de trois colonnes (voir le chapitre "Propriétés des textes" ci-dessous).
• Imprimer la bordure de séparation
  Indique s'il faut inclure la bordure en haut du pied de page.

Le pied de page est divisé en trois blocs de texte, disposés comme trois colonnes :

• Bloc de gauche, aligné à gauche
• Bloc central, aligné au centre
• Bloc de droite, aligné à droite

Chaque bloc peut contenir une ou plusieurs lignes de texte. Les contenus sont saisis dans les champs de la section Textes > Pied de page gauche / centre / droite.

Les champs "Pied de page gauche" et "Pied de page droite" contiennent des textes prédéfinis, modifiables à tout moment.

Si vous souhaitez laisser un bloc vide et éviter l’impression de tout contenu, vous devez saisir le texte <none>.

Il est également possible d’imprimer un seul texte occupant toute la largeur de la page. Pour ce faire, saisissez le texte souhaité dans le champ "Pied de page gauche" et indiquez <none> dans les champs "Pied de page centre" et "Pied de page droite".

Le pied de page ne peut être inclus que si le code QR est exclu de l'impression. Lorsque le code QR est inclus, le pied de page est automatiquement exclu de l'impression.

Propriété des textes

Ce niveau définit tous les textes de la facture, qui sont regroupés et subdivisés par langue.

Settings Dialogue - Texts Property

Langues

Vous pouvez modifier les textes à utiliser pour chaque langue et également ajouter des traductions pour d'autres langues.

La langue à utiliser est choisie en fonction de la langue indiquée pour le client:

• Pour la facturation intégrée, elle est définie dans le tableau Comptes, vue Adresse, colonne Langue.
• Pour l'application Offres et Factures, elle est définie dans le tableau des contacts, colonne Langue.

Si aucune langue n'est indiquée pour le client, la langue de comptabilité par défaut est utilisée.

Les langues par défaut pour lesquelles il existe une traduction complète sont les suivantes: allemand, anglais, français et italien.

La première langue qui apparaît dans le dialogue est toujours la langue courante du fichier, définie dans le menu Fichier → Propriétés fichier → Divers. Les autres langues sont classées par ordre alphabétique.

Definir langues

• Valeurs par défaut: de;en;fr;it
• Entrez la liste des langues en utilisant les codes à deux caractères.
  • de = allemand
  • en = anglais
  • fr = français
  • it = italien
• Séparez les codes de langue par un " ;" (point-virgule).

Ajouter des langues

• Dans le champ Langue, entrez le code de la langue que vous voulez ajouter.
• Cliquez sur Ok.
• Réouvrez le dialogue des Paramètres. Il y a maintenant une nouvelle section pour la langue que vous avez insérée avec des textes en anglais.
• Dans la section de la langue ajoutée, remplacez les textes existants par les textes corrects.

Supprimer des langues

• Dans le champ Langue, supprimez le code de la langue que vous voulez supprimer.
• Cliquez sur Ok.
• Confirmez par Oui pour supprimer la langue et ses textes de la liste.
• Réouvrez le dialogue des Paramètres. Maintenant, la section de la langue concernée a été supprimée.

Section textes pour chaque langue

Pour chaque langue définie, il y a une section commençant par le code de la langue. Elle contient la liste des textes que vous pouvez modifier.
Si vous supprimez le contenu, lorsque vous confirmez avec OK, le texte par défaut sera repris automatiquement.

• Numéro de facture.
  Saisissez les informations qui précèdent le numéro de facture.
• Date de la facture.
  Texte dans les informations précédant la date de la facture.
• Ordre de facturation.
  Saisissez les informations qui précèdent le numéro de commande.
• Date de commande.
  Texte dans les informations précédant la date de la commande.
• Numéro de client.
  Saisissez les informations qui précèdent le numéro de client.
• Numéro de TVA du client.
  Saisissez les informations précédant le numéro de TVA du client.
• Numéro fiscal du client.
  Saisissez les informations précédant le numéro d'identification fiscale du client.
• Date d'échéance de la facture.
  Texte dans les informations précédant la date d'échéance de la facture.
• Numéro de page.
  Texte dans l'information précédant le numéro de page.
• Adresse de livraison.
  Texte apparaissant au-dessus de l'adresse de livraison.
• Titre de la facture.
  Texte facultatif inséré avant le tableau des détails.
  Entrez <none> pour ne pas afficher de texte.
• Titre de la note de crédit
  Texte facultatif inséré avant le tableau des détails.
  Entrez <none> pour ne pas afficher de texte.
• Texte initial
  Texte facultatif, sur une ou plusieurs lignes, inséré immédiatement après le titre de la facture.
• Noms des colonnes détails de la facture.
  Textes des intitulés des différentes colonnes du détail de la facture.
  Doivent être séparés par un ';' (point-virgule).
  Lorsque vous modifiez les colonnes à afficher dans la facture (section Impression, Détails de la facture, Noms des colonnes), vous devez toujours adapter également les textes des titres des colonnes.
• Total de la facture.
  Texte qui apparaît dans la ligne du total de la facture.
• Texte final
  Texte facultatif, sur une ou plusieurs lignes, inséré à la fin de la facture.
  Ce texte a la priorité sur le texte ajouté à partir du dialogue Imprimer les factures → Options → Texte final.
• Pied de page gauche/centre/droite.
  Le code <Page> est remplacé par le numéro de page.
  Entrez <none> pour ne pas afficher de texte.

Textes spécifiques pour l'impression des Factures Proforma, Offres, Bons de livraison, Confirmations de commande et des rappels de paiement (nécessite le plan Advanced):

• Facture Proforma
  • Titre.
    Texte facultatif inséré avant le tableau des détails. Entrez <none> pour ne pas afficher de texte.
  • Texte de début.
    Texte facultatif, sur une ou plusieurs lignes, inséré immédiatement après le titre du facture.
  • Texte final.
    Texte facultatif, sur une ou plusieurs lignes, inséré à la fin du facture.
• Offre
  • Numéro.
    Saisissez les informations qui précèdent le numéro de l'offre.
  • Date.
    Saisissez les informations précédant la date de l'offre.
  • Validité.
    Saisissez les informations précédant la date de validité de l'offre.
  • Titre.
    Texte facultatif inséré avant le tableau des détails.
  • Texte de début.
    Texte facultatif, sur une ou plusieurs lignes, inséré immédiatement après le titre de l'offre.
  • Texte final.
    Texte facultatif, sur une ou plusieurs lignes, inséré à la fin de l'offre.
• Bon de livraison
  • Numéro du bon de livraison.
    Texte dans les informations précédant le numéro du bon de livraison.
  • Date du bon de livraison.
    Texte figurant dans les informations précédant la date du bon de livraison.
  • Titre.
    Texte facultatif inséré avant le tableau des détails. Entrez <none> pour ne pas afficher de texte.
  • Texte début.
    Texte facultatif, sur une ou plusieurs lignes, inséré immédiatement après le titre du bon de livraison.
  • Texte final.
    Texte facultatif, sur une ou plusieurs lignes, inséré à la fin du bon de livraison.
• Confirmation de commande
  • Numéro confirmation de commande.
    Texte dans les informations précédant le numéro du confirmation de commande.
  • Date confirmation de commande.
    Texte figurant dans les informations précédant la date du confirmation de commande.
  • Titre.
    Texte facultatif inséré avant le tableau des détails. Entrez <none> pour ne pas afficher de texte.
  • Texte de début.
    Texte facultatif, sur une ou plusieurs lignes, inséré immédiatement après le titre.
  • Texte final.
    Texte facultatif, sur une ou plusieurs lignes, inséré à la fin.
• Rappel
  • Date facture (uniquement pour la facturation intégrée dans le fichier comptable).
    Texte figurant dans les informations précédant la date de la facture.
    Utilisé s'il existe la transaction avec la date de rappel créée via la commande Rapports > Clients > Imprimer rappels de paiement.
  • Date (uniquement pour la facturation intégrée dans le fichier comptable).
    Texte figurant dans les informations précédant la date de rappel.
    Utilisé s'il existe la transaction avec la date de rappel créée via la commande Rapports > Clients > Imprimer rappels de paiement.
  • Échéance (uniquement pour la facturation intégrée dans le fichier comptable).
    Texte figurant dans les informations précédant la date d'échéance du rappel.
    Utilisé s'il existe la transaction avec la date de rappel créée via la commande Rapports > Clients > Imprimer rappels de paiement.
  • Titre.
    Texte facultatif inséré avant le tableau des détails. Entrez <none> pour ne pas afficher de texte.
  • Texte de début.
    Texte facultatif, sur une ou plusieurs lignes, inséré immédiatement après le titre d'appel.
  • Texte final.
    Texte facultatif, sur une ou plusieurs lignes, inséré à la fin du rappel.

En gras

Avec une annotation spécifique, vous pouvez appliquer le style en gras à certains textes. Pour ce faire, insérez les textes souhaités entre les doubles astérisques ** .

Applicable à :

• Texte de départ.
• Texte final..
• Descriptions des éléments apparaissant dans les détails de la facture.

Exemples :

**text** = texte
**texte1 texte2**, texte3 = texte1 texte2, texte3

Personnaliser le titre, le texte initial et le texte final

Les données relatives au titre, au texte initial et au texte final sont reprises et insérées automatiquement à chaque nouvelle facture.

Si vous souhaitez également inclure des informations sur le client (nom, prénom, etc.) ou le numéro de facture dans ces textes, vous pouvez le faire :

• Avec le Plan Professionnel, les données doivent être saisies manuellement chaque fois que vous créez une facture.
• Avec le Plan Advanced, vous pouvez automatiser la saisie des données sur toutes les factures.

Pour la saisie automatisée des données (uniquement avec le Plan Avanced), vous devez utiliser les colonnes prédéfinies dont les données sont extraites :

• Colonnes d'adresse du client
  • Dans la facturation intégrée, à partir du tableau Comptes, vue Adresse.
  • Dans l'application Offres et factures, à partir du tableau des Contacts.
• Colonne du numéro de facture
  • Dans la facturation intégrée, à partir du tableau Comptes, colonne Facture.
  • Dans l'application Offres et Factures, dans le tableau Factures, colonne Id.

Dans les textes, vous devez saisir les colonnes suivantes, en spécifiant les noms de colonnes XML entre les signes "<" et ">".

• Adresse
  • <NamePrefix>, <OrganisationName>, <FirstName>, <FamilyName>, <Street>, <BuildingNumber>, <AddressExtra>, <POBox>, <PostalCode>, <Locality>, <Region>, <Country>, <CountryCode>, <EmailWork>.
• Numéro de facture
  • <DocInvoice>.
    Dans ce cas, DocInvoice est utilisé à la fois pour la facturation intégrée et pour l'application offre et facture.

Pour afficher le nom XML de chaque colonne, utilisez la commande Organiser colonnes, section Paramètres.

Lorsque la facture est créée, ces textes sont remplacés par les valeurs réelles.

Exemples :

• Le texte "Facture <DocInvoice>" est converti en "Facture 10".
• Le texte "Facture <DocInvoice>, <FirstName> <FamilyName>" est converti en "Facture 10, James Johnson".

Propriétés de Styles

Ce niveau définit les paramètres qui affectent l'aspect visuel de la facture, comme le type de police, la taille et les couleurs.

Settings Dialogue - Styles Property

Type et taille de caractère

Le type de police et la taille sont appliqués à tous les textes de la facture, sauf l'en-tête, qui a une taille fixe qui ne peut être modifiée qu'avec les fonctions CSS.

La taille du titre et la ligne totale sont automatiquement redimensionnées en fonction de la taille du caractère choisi.

Voir la page Créer PDF pour plus d'informations concernant la police que vous pouvez utiliser et exporter au format PDF.

Couleurs

Saisissez les couleurs que vous souhaitez appliquer à l'impression de la facture.

• Couleur du texte.
  La couleur appliquée à tout le texte de la facture : en-tête, informations, adresse, texte de départ, détails de la facture, texte de fin, pied de page.
  La couleur du bulletin QR ne peut pas être modifiée.
• Couleur de fond des détails de l'en-tête.
  La couleur principale de la facture. Il s'applique au titre, à l'en-tête des détails de la facture, aux lignes horizontales, à la ligne totale et au double soulignement.
• Couleur du texte de l'en-tête.
  La couleur du texte dans les en-têtes de colonne du tableau des détails de la facture.
• Couleur de fond pour les lignes alternés.
  La couleur de fond appliquée aux lignes des différents détails de la facture.

Pour saisir une couleur, vous avez deux possibilités :

• Sélectionnez une couleur parmi celles disponibles.
• Entrez le code hexadécimal de la couleur (HEX). Il s'agit d'un code commençant par # suivi de six caractères (par exemple #0000, #009FE3, #FF00EA).
  Les codes de couleur se trouvent facilement sur l'internet. Par exemple, vous pouvez consulter le tableau à l'adresse https://www.w3schools.com/cssref/css_colors.asp.

Textes de facturation intégrée

Dans la facturation intégrée, certains textes peuvent également être définis dans le tableau des Écritures lors de la saisie des données de la facture.

• Titre de la facture / note de crédit.
  • Saisir dans la colonne TypeDoc la commande 10:tit (12:tit pour la note de crédit).
  • Saisissez le texte souhaité dans la colonne Description.
  • Il a la priorité sur tout texte défini dans les paramètres de la mise en page de la facture.
• Texte initial.
  • Saisissez dans la colonne TypeDoc la commande 10:beg.
  • Saisissez le texte souhaité dans la colonne Description.
  • È possibile inserire solamente una riga di testo.
  • Ce texte a la priorité sur tout autre texte défini dans les paramètres de la mise en page (layout) de la facture.
• Notes.
  • Dans la colonne TypeDoc, saisissez la commande 10:not.
  • Saisissez le texte souhaité dans la colonne Description.
  • Il est possible de saisir plusieurs lignes de notes. Chaque note doit être définie sur une nouvelle ligne dans le tableau Écritures.
• Salutations.
  • Saisissez la commande 10:gre dans la colonne TypeDoc.
  • Saisissez le texte souhaité dans la colonne Description.
  • Une seule ligne de messages d'accueil peut être saisie.

Priorité du Titre et du Texte Initial:

Priorité du Texte final:

Messages d'erreur

• @error Les noms des textes et les colonnes ne correspondent pas
  Le nombre de colonnes du tableau des détails de la facture (Imprimer → Détails de la facture → Noms des colonnes) ne correspondent pas avec les textes à imprimer (Textes → Code langue → Noms des colonnes sous détails de la facture). Contrôlez les paramètres de la facture.

Cette page explique comment configurer l'impression du Code QR suisse sur les factures et renvoie également à des informations techniques sur les possibilités de personnalisation, l'utilisation des formats d'adresse, etc.
Pour les spécifications techniques, veuillez vous référer aux Références et normes relatives aux codes QR.

Section QR

Dans les Paramètres de la facture, il y a une section spéciale pour la saisie des données pour l'impression de la section QR.

• Pour imprimer le QR sur la facture, vous devez cocher la case "Imprimer code QR".

Il y a également un choix très important à faire. Le système de code QR comporte deux modes principaux en fonction du type de compte que vous souhaitez utiliser. Dans le Type de référence, vous devez indiquer le système que vous souhaitez utiliser.

• Imprimer facture QR avec compte IBAN
  Avec cela, vous pouvez immédiatement commencer à imprimer des factures avec le QR. Le relevé bancaire indique le numéro de compte du client et la facture. Vous aurez ainsi un contrôle immédiat et automatisé des paiements.
• Imprimer facture QR avec compte QR-IBAN
  Si vous souhaitez disposer d'un système compatible avec le DSI, ou si vous souhaitez que les données relatives au paiement de vos factures soient reçues dans un fichier de données différent de celui de l'extrait de compte.
  Votre banque doit vous donner un numéro de compte QR-IBAN et les données de paiement individuel n'apparaîtront pas sur le relevé de compte normal, mais sur un relevé séparé.

Enfin, les paramètres disponibles suivent, quelque soit le type de référence QR choisi.

Changer l'adresse de l'émetteur

• Adresse payable à
  Le programme définit l'adresse de la personne qui reçoit le paiement en utilisant les données d'adresse dans les Propriétés fichier (à partir du menu Fichier). 
  Cependant, vous pouvez indiquer une autre adresse en remplissant les champs de la section Payable à.

Inclure / exclure de l'impression

• Inclure des informations supplémentaires (nom XML de la colonne)

  Vous pouvez saisir des informations supplémentaires sur la facture à afficher sur le bulletin QR dans la section "Informations supplémentaires".

  

Dans la boîte de dialogue des paramètres de la facture → Section QR → Inclure des informations supplémentaires, saisissez le nom XML de la colonne utilisée d'où doivent provenir les informations supplémentaires.
Voir comment afficher les noms de colonnes XML.
Voir comment ajouter de nouvelles colonnes.

• Facturation intégrée
  Dans le tableau Ecritures, ajouter une nouvelle colonne où les informations supplémentaires doivent être saisies, ou utiliser une colonne existante telle que la colonne Notes.

• Application Offres et Factures
  Dans le tableau Factures, ajouter une nouvelle colonne dans laquelle les informations supplémentaires doivent être saisies, par exemple Info.
  N'utiliser pas la colonne "Notes", car elle est utilisée pour afficher le texte final de la facture.

• Inclure les informations de facturation (facultatif).
  Ajouter des informations de facturation structurées générées automatiquement.
  S'ils sont présents, ils sont ajoutés après les informations complémentaires (voir point précédent).
• Exclure l'adresse de facturation.
  Exclure l'adresse de facturation du client et laisser une case vide pour entrer l'adresse à la main.
• Exclure le montant de la facture.
  Exclure le montant de la facture et laisser une case vide pour inscrire le montant à la main.
  A utiliser lorsque le client peut choisir le montant à payer.
  

Format d'impression de la section QR

• QR sur une page séparée.
  Imprimer les sections de paiement et de réception de la QR-bill sur une page séparée.
  De cette façon, il y a plus de place pour la facture.
• Impression de la bordure de séparation.
  Imprimer une bordure de séparation en pointillés pour séparer la facture des parties paiement et réception.
• Imprimer le symbole des ciseaux.
  Imprime le symbole des ciseaux sur la bordure de séparation.
• QR Position X et QR Position Y (facultatif).
  Modifie la position horizontale et verticale de la section QR Code - en général, vous n'avez pas besoin de modifier les valeurs par défaut.

Informations complémentaires

• Les adresses qui apparaissent dans les sections de paiement et de réception doivent contenir:
  • Prénom et le nom ou raison sociale (la raison sociale est prioritaire si les deux sont définis).
  • Adresse.
  • Code postal et lieu.
  • Code du pays (inclus uniquement dans le code QR).
• Le code pays est un code à deux caractères selon les spécifications de la norme ISO 3166-1 (es. CH, LI, AT, DE, IT, FR).
  • Le code pays de l'expéditeur de la facture est défini dans Fichier → Propriétés fichier (données de base) → Section adresse, champ Code pays.
  • Le code pays du client est défini dans la colonne Code pays du tableau Comptes, vue Adresse.

Informations techniques

Dans le code QR de la QR facture, les adresses de l'émetteur de la facture et du client sont toujours de type structuré (S). Le type définit la manière dont les données d'adresse sont représentées dans l'image du code QR.

L'impression de l'adresse sur la police QR, tant dans la section des reçus que dans celle des paiements, sera la même.

Détails de l’adresse structurée

Les lignes de l’adresse structurée dans le code QR sont composées comme suit :

Les adresses du QR doivent toujours contenir le nom de l'organisation ou bienle prénom et le nom de famille.
Le nom de l'organisation a priorité sur le nom / nom de famille: s'il est présent alors le nom de l'organisation sera entré, sinon le nom / nom de famille sera entré.
La saisie des deux n'est pas possible car les lignes sont limitées et chaque ligne doit contenir des informations précises.

Dans l’impression de la facture, la structure des adresses est la suivante :

• nom de l'organisation ou prénom / nom
• Rue et numéro de maison
• code postal et ville

Les adresses qui apparaissent dans la partie payante du QR sous les rubriques "payable à" et "payable par" suivent les règles du standard QR Suisse.
Il n'est pas possible d'ajouter des lignes ou de modifier la composition des adresses sur la partie paiement du QR de quelque manière que ce soit.

Adresse de l'émetteur

L’adresse de l’émetteur de la facture peut être définie de deux manières :

• Depuis les propriétés du fichier
  • L'adresse est reprise de Fichier > Propriétés fichier (données de base) > Section adresse.
• Depuis les paramètres de la facture
  • L'adresse est reprise des paramètres de la facture, section Code QR > Payable à.
  • Cochez la section Code QR > Payable à.
  • Saisir les données de l’adresse dans les champs appropriés ci-dessous.
    
    

Adresse Client

L’adresse du client de la facture est saisie dans le tableau Comptes (facturation intégrée) ou dans le tableau Contacts (application Offres et Factures).

Le numéro de rue peut être inséré soit dans la colonne Rue, soit dans la colonne Numéro de Rue. Les deux options sont correctes.

La colonne Numéro de Rue accepte tout caractère jusqu'à un maximum de 16 caractères :

La colonne Rue accepte tout caractère jusqu'à un maximum de 70 caractères :

Imprimer et envoyer en format papier

La QR facture peut être imprimée et envoyée en format papier. Pour ce faire, il faut utiliser une feuille de papier blanc spécialement perforée.

Tester le code QR

Les PDF de factures avec codes QR peuvent être testés avec le site officiel de validation, comme décrit ci-dessous :

• Créez et enregistrez la facture QR au format PDF.
• Visitez le site officiel de validation https://www.swiss-qr-invoice.org/validator
• Faites glisser le fichier PDF dans la zone bleue.

Si le code est correct, la page affiche le contenu du code QR. En revanche, en cas de problème, celui-ci s'affiche en rouge.

Si aucun message rouge ne s'affiche, le QR est considéré comme correct (voir l'exemple ci-dessous).

Les fonctions de personnalisation avancées suivantes nécessitent le plan Banana Comptabilité Plus Advanced.

Personnalisation avancée de la mise en page (avec programmation)

Le layout du CH10 peut être personnalisé par une programmation spécifique.

• Programmation en Javascript (documentation en anglais)
  • Vous pouvez personnaliser davantage votre impression en créant des fonctions qui remplacent les fonctions par défaut, pour l'impression de l'en-tête, des adresses, des détails, du texte et du pied de page.
• Création de styles CSS (documentation en anglais)
  • Vous pouvez adapter encore davantage votre impression en créant vos propres styles afin de modifier l'apparence de votre facture (mise en forme du texte, positionnement des éléments, etc.).

Créer vos propre layout d'impression

• Personnalisation en créant votre propre mise en page personnalisée (documentation en anglais)
  • Nécessite une programmation en Javascript.
  • Vous pouvez utiliser le layout existant et le modifier comme vous le souhaitez.

The Banana invoice is constructed with a Javascript program. The Extension also allows you to add Javascript programming so that you can completely customize the content and format of the invoice (this functionality requires the Advanced plan).

See more about Banana Accounting API Extensions Reference.

Add your custom Javascript file

Three steps are required to define and use your Javascript file:

1. Add the document table to the Banana Accounting file.
   If it is not already present you need to add the Documents table in the Banana document with the menu command Tools > Add new features > Add document table.
2. Add a new Javascript type document to the document table.
   1. In the ID column enter the file name including the extension .js (e.g. "myFile.js").
      If the id is missing the ".js" at the end, it won't work.
   2. In the Description column enter a comment (optional).
   3. In the Attachments column, double click on the cell or select the edit symbol, then select Javascript Code and confirm with OK.
   4. An editor will open in which you can write the code.
   5. Delete everything in it.
   6. Insert the Javascript code. You can modify the content at any time.
      
      
      Documents table - Javascript Code attachment
       
3. Tell the invoice layout to use the customized Javascript attachment file.
   1. Select Settings of the Print invoices dialogue.
   2. In the Javascript/CSS > JS file name, enter the name of the newly created Javascript attachment file with the extension ".js" at the end (e.g. "myFile.js").
   3. Click Ok to confirm.
      
      
      Settings Dialogue - Javascript File Property

Javascript Hook Replacement Functions

The invoice layout is created with a set of predefined Javascript functions.

The hook functions are Javascript replacements functions to be used instead of the the predefined.

The hook functions should be defined in the ".js" file of the Documents table.

• The name of the hook function is the name of the predefined function used in the layout, preceded by the text "hook_".
  For example, if you want to change the header printing you have to define the hook_print_header() that will replace the predefined print_header() function.
  • The parameters must be the same as those used in the main function.
  • If you create your own hook function, it is necessary to know how it works the function you want to replaces.
• When generating the invoice, the layout extension checks for the existence of a hook replacement function and, if available, utilizes it to substitute the predefined function.
• Hook functions let you selectively change some part of how the invoice is build, without directly modifying the original script of the invoice Layout.

Graphic explanation of the Hook functions

With the hook functions, you can customize the following sections of the invoice.

(1) hook_print_header()

Function that prints the header part of the invoice (logo and texts).

(2) hook_print_info_first_page() and hook_print_info_other_pages()

Functions that print the information parts of the invoice.

(3) hook_print_customer_address()

Function that prints the customer address part of the invoice.

(4) hook_print_shipping_address()

Function that prints the shipping address part of the invoice (in case it exists).

(5) hook_print_text_begin()

Function that prints the title and begin text parts of the invoice.

(6) hook_print_details_net_amounts() and hook_print_details_gross_amounts()

Functions that print the invoice details using net/gross amounts.
Use the hook_formatItemsValue() function to change the format and style of the items.

(7) hook_print_final_texts()

Function that prints the final texts, notes and greetings parts of the invoice, right after the invoice details.

(8) hook_print_footer()

Function that prints the footer at the bottom of the page (usable only when not printing the QR slip).

Invoice Layout Hook Functions Reference

This document provides a reference for all available invoice layout hook functions, including their exact names, the required parameters in the correct order, and detailed descriptions of each parameter’s purpose, and example usage. The empty function bodies should be replaced with your own implementation.

• Examples of customizing invoices with JavaScript hook functions

Rules:

• You must use the exact function name listed.
• Parameters must be passed in exact order shown.
• You cannot add, remove, or rename parameters.
• All parameters are required.

List of available invoice layout hook functions:

/**
 * Sets or updates all variables used by the invoice layout script.
 * @param {Object} variables - MUTABLE object containing layout variables (colors, fonts, decimals, margins).
 * @param {Object} userParam - User parameters that may override or extend the variables.
 * @returns {void}
 */
function hook_set_variables(variables, userParam) {...}

/**
 * Prints the header at the top of the page (logo, company name, address).
 * @param {Object} repDocObj   - Document object for output.
 * @param {Object} userParam   - User parameters that include affecting header content and style.
 * @param {Object} repStyleObj - Document CSS style object.
 * @param {Object} invoiceObj  - Invoice data (issuer, customer, logo, etc.).
 * @param {Object} texts       - Localized labels and strings (e.g., "Address", "Phone").
 * @returns {void}
 */
function hook_print_header(repDocObj, userParam, repStyleObj, invoiceObj, texts) {...}

/**
 * Prints invoice information on the first page (invoice number, date, terms, references).
 * @param {Object} repDocObj  - Document object for output.
 * @param {Object} invoiceObj - Invoice data (number, dates, payment terms, etc.).
 * @param {Object} texts      - Localized labels for displayed fields.
 * @param {Object} userParam  - User parameters that include affecting information content for page 1.
 * @returns {void}
 */
function hook_print_info_first_page(repDocObj, invoiceObj, texts, userParam) {...}

/**
 * Prints invoice information from page 2 onwards (invoice number, date, terms, references).
 * @param {Object} repDocObj  - Document object for output.
 * @param {Object} invoiceObj - Invoice data (number, dates, payment terms, etc.).
 * @param {Object} texts      - Localized labels for displayed fields.
 * @param {Object} userParam  - User parameters that include affecting information content for page > 1.
 * @returns {void}
 */
function hook_print_info_other_pages(repDocObj, invoiceObj, texts, userParam) {...}

/**
 * Prints the customer's billing address.
 * @param {Object} repDocObj  - Document object for output.
 * @param {Object} invoiceObj - Invoice data with customer information (name, street, ZIP, city, country).
 * @param {Object} userParam  - User parameters that include affecting customer address content and style.
 * @returns {void}
 */
function hook_print_customer_address(repDocObj, invoiceObj, userParam) {...}

/**
 * Prints the shipping address.
 * @param {Object} repDocObj  - Document object for output.
 * @param {Object} invoiceObj - Invoice data with shipping information (recipient, address).
 * @param {Object} texts      - Localized labels (e.g., "Ship to").
 * @param {Object} userParam  - User parameters that include affecting shipping address content visibility.
 * @returns {void}
 */
function hook_print_shipping_address(repDocObj, invoiceObj, texts, userParam) {...}

/**
 * Prints the introductory block before the invoice details (title, opening text).
 * @param {Object} repDocObj  - Document object for output.
 * @param {Object} invoiceObj - Invoice data with begin text.
 * @param {Object} texts      - Localized titles and messages (e.g., "Invoice").
 * @param {Object} userParam  - User parameters that include affecting text begin content.
 * @returns {void}
 */
function hook_print_text_begin(repDocObj, invoiceObj, texts, userParam) {...}

/**
 * Prints the details table using NET amounts (VAT excluded).
 * @param {Object} banDoc       - Accounting/data source (for calculations or lookups).
 * @param {Object} repDocObj    - Document object for output.
 * @param {Object} invoiceObj   - Invoice data (currency, items, amounts, VAT, totals, etc.).
 * @param {Object} texts        - Column labels and strings (Qty, Price, VAT, Total, etc.).
 * @param {Object} userParam    - User parameters that include affecting invoice details content and style.
 * @param {Array|Object} detailsTable - Rows/structure of the table (items, quantities, prices).
 * @param {Object} variables    - Calculated layout variables (column widths, CSS classes, partial totals).
 * @returns {void}
 */
function hook_print_details_net_amounts(banDoc, repDocObj, invoiceObj, texts, userParam, detailsTable, variables) {...}

/**
 * Prints the details table using GROSS amounts (VAT included).
 * @param {Object} banDoc       - Accounting/data source (for calculations or lookups).
 * @param {Object} repDocObj    - Document object for output.
 * @param {Object} invoiceObj   - Invoice data (currency, items, amounts, VAT, totals, etc.).
 * @param {Object} texts        - Column labels and strings (Qty, Price, VAT, Total, etc.).
 * @param {Object} userParam    - User parameters that include affecting invoice details content and style.
 * @param {Array|Object} detailsTable - Rows/structure of the table (items, quantities, prices).
 * @param {Object} variables    - Calculated layout variables (column widths, CSS classes, partial totals).
 * @returns {void}
 */
function hook_print_details_gross_amounts(banDoc, repDocObj, invoiceObj, texts, userParam, detailsTable, variables) {...}

/**
 * Prints the final texts (notes, terms, thanks) after the details table.
 * @param {Object} repDocObj  - Document object for output.
 * @param {Object} invoiceObj - Invoice data with final texts.
 * @param {Object} userParam  - User parameters that include affecting final texts content and style.
 * @returns {void}
 */
function hook_print_final_texts(repDocObj, invoiceObj, userParam) {...}

/**
 * Prints the footer at the bottom of the page. Use only when NOT printing the QR slip section.
 * @param {Object} repDocObj - Document object for output.
 * @param {Object} texts     - Localized labels and strings.
 * @param {Object} userParam - User parameters that include affecting footer content and style.
 * @returns {void}
 */
function hook_print_footer(repDocObj, texts, userParam) {...}

/**
 * Formats the value and sets the CSS className of the item.
 * @param {*} value           - Original cell value (number, string, date).
 * @param {Object} variables  - Layout/context variables for formatting rules.
 * @param {string} columnName - Column name (for column-specific rules).
 * @param {string} className  - Initial className that can be changed.
 * @param {Object} item       - The current row/item object (for data-dependent rules).
 * @returns {Object}          - Return the formatted value and className.
 */
function hook_formatItemsValue(value, variables, columnName, className, item) {...}

/**
 * Allows modification of QR code settings (fields and formatting) before printing.
 * @param {Object} invoiceObj - Invoice data relevant to payment/QR.
 * @param {Object} qrcodeData - QR settings object to read/overwrite (IBAN, amount, reference).
 * @returns {void}
 */
function hook_modify_settings_qr(invoiceObj, qrcodeData) {...}

Examples of a hook functions 

Within your hook function you can call the original hook function. This way you can limit the changes to the code.
For example this hook function call the original one, only in a specific case.

/** 
 * This function prints the final text only for INVOICES and not for CREDIT NOTES.
 * Invoices = DocType 10
 * Credit notes = DocType 12
 */
function hook_print_final_texts(sectionClassFinalTexts, invoiceObj, userParam) {
   // We can check the DocType and print the text only when is not 12
   if (invoiceObj.document_info.doc_type !== "12") {
      print_final_texts(sectionClassFinalTexts, invoiceObj, userParam);
   }
}

Predefined variables

The predefined variables are the default used by the invoice layout script.

The variables for decimals start with "decimals_". (decimals_quantity, decimals_unit_price, decimals_amounts).

The variable that start with "$" are template variable that you can use in the CSS styles ($font_family, $font_size, $text_color, ...).
Example of an extract of the predefined CSS invoice layout.

body {
  font-family: $font_family;
  font-size: $font_size;
  color: $text_color;
}

List of all predefined variables and their default values that you can override with the hook_set_variables() function:

/* Variable that sets the decimals of the Quantity column */
variables.decimals_quantity = "";
/* Variable that sets the decimals of the Unit Price column */
variables.decimals_unit_price = 2;
/* Variable that sets the decimals of the Amount column */
variables.decimals_amounts = 2;
/* Variables that set the colors */
variables.$text_color = userParam.text_color;
variables.$background_color_details_header = userParam.background_color_details_header;
variables.$text_color_details_header = userParam.text_color_details_header;
variables.$background_color_alternate_lines = userParam.background_color_alternate_lines;
variables.$color_title_total = userParam.color_title_total;
/* Variables that set the font */
variables.$font_family = userParam.font_family;
variables.$font_size = userParam.font_size+"pt";
/* Variables that set the font size and margins of the Invoice Begin Text */
variables.$font_size_title = userParam.font_size*1.4 +"pt";
/* Variables that set font size, margins, padding and borders of the Invoice Details */
variables.$font_size_header = userParam.font_size*1.2 +"pt";
variables.$font_size_total = userParam.font_size*1.2 +"pt";
/* Variables that set the position of the invoice address
 * Default margins when the address on right: 12.3cm margin left, 4.5cm margin top
 * Default margins when the address on left: 2.2cm margin left, 5.5cm margin top
 * Sum userParam dX and dY adjustments to default values */
variables.$right_address_margin_left = parseFloat(12.3) + parseFloat(userParam.address_position_dX)+"cm";
variables.$right_address_margin_top = parseFloat(4.5) + parseFloat(userParam.address_position_dY)+"cm";
variables.$left_address_margin_left = parseFloat(2.2) + parseFloat(userParam.address_position_dX)+"cm";
variables.$left_address_margin_top = parseFloat(5.5) + parseFloat(userParam.address_position_dY)+"cm"; 

Example of 'hook_set_variables' function

You can overwrite the predefined variable with the hook_set_variables() function. 
Only use the variable that you want to replace. 

// Example of hook function usage that sets
// the decimals of the Amounts columns to 4
// the font type to Times New Roman
function hook_set_variables(variables, userParam) {
   variables.decimals_amounts = 4;
   variables.$font_family = "Times New Roman";
}

Banana invoices are formatted through a CSS Stylesheet. The extension allows you to use a customized stylesheet so you can fully modify the appearance of the invoice (this functionality requires the Advanced plan).

Following you will find information and examples that let anyone understand the basic of the CSS so that you are able to do a lot of customization to your invoice, even if you are not a CSS professional.

• See also the page CSS Examples. 

Banana CSS Stylesheet file

The CSS file property let you specify an CSS stylesheet file to be used for formatting the invoice. You have to enter the name of a CSS document, contained in the Documents table.

The properties you define in the custom CSS file will extend or overwrite the styles of the default stylesheet.

Cascading Style Sheet (CSS) is a specification language that allows to customize the appearance of web pages, and a subset of the whole CSS specification is also used in Banana to prepare reports. 
Here are some basics about CSS Stylesheet formatting.

• The document, in our case the invoice, is composed by a series of Elements that contains all the data of the invoice.
• Each element can have one or more class properties that specify which style should be used for that element.
• Each element can contain other elements.
• In the CSS stylesheet you specify the formatting properties of each class of style.
• The elements hynnerit the styles of the parent element.
• The main element for the invoice is the Document.

Add your custom CSS stylesheet

Three steps are required to define and use your CSS file:

1. Add the document table to the Banana Accounting file.
   If it is not already present you need to add the Documents table in the Banana document with the menu command Tools > Add new features > Add document table.
2. Add a new CSS type document to the document table.
   1. In the ID column enter the file name including the extension .css (e.g. "myStyle.css").
      If the id is missing the ".css" at the end, it won't work.
   2. In the Description column enter a comment (optional).
   3. In the Attachments column, double click on the cell or select the edit symbol, then select CSS stylesheet and confirm with Ok.
   4. An editor will open in which you can write the code.
   5. Enter or edit the script and confirm with Ok.
   6. Save the Banana Accounting file.
      
      
      Documents table - CSS stylesheet attachment
       
3. Specify the CSS file created in the invoice layout extension.
   1. Select Settings of the Print invoices dialogue.
   2. In the Javascript/CSS > CSS file name, enter the name of the newly created CSS attachment file with the extension ".css" at the end (e.g. "myFile.css").
   3. Click Ok to confirm.
      
      
      Settings Dialogue - CSS File Property

Syntax of a CSS stylesheet

The syntax of the CSS is quite simple as you see in this style definition that set the size of the Invoice title text element to 14 points and without bold.

/* this two lines are comment 
   title_text is for the invoice number */
.title_text {
  font-family: Arial;
  font-size: 14;
  font-weight: normal;
  color: #6495ED;
}

Syntax rules:

• Element are case sensitive.
• You specify the style name ".title_text" starting with a dot (".") and followed by the  curly open bracket "{".
  • Property name, followed by the colon ":"
  • Values followed by the semicolon ";"
  • You can have has many allowed properties you need.
• End with the curly close bracket "}".
• You can have has many allowed style classes.
• The defined values overwrite the predefined one.

Comments:

• Add comments to the css by including the text within a /*    comment */,
  It help you remember the purpose of the code.
  See the comments in the predefined CSS for explanations of the elements.

Most used properties

Font

• font-family
  Specify the font name.
• font-size
  Specify the font size in points.
• font-weight
  Specify the font weight: normal, bold or value between 1-1000.

Text alignment

• text-align
  Specify the horizontal alignment of the text.
  It is used for example to align on the right of the cell all the amounts of the invoice (i.e. "text-align: right").

Colors

For the main colors you can use the name in English (black, yellow, white, blue, red, ...) or the hexadecimal values (HEX) preceded by the # sign (e.g. #000000, #009FE3, #FF00EA).
For codes see the table at https://www.w3schools.com/cssref/css_colors.asp.

• color
  Define the color of a text.
• background-color
  Define the background color of an element.
  It is used for example to set the background color of the header row of the invoice details.

Positioning

All elements in the invoice are positioned relative to the prior element. You can change the positioning.

• margin
  • margin-top
    To set the margin on the top of the element.
  • margin-right
    To set the margin on the right side of the element.
  • margin-bottom
    To set the margin on the bottom of the element.
  • margin-left
    To set the margin on the left side of the element.
    It is used for example in case it is required to move an element a bit to the right. More margin on the left means move the element to the right.
• padding
  • padding-top
    Sets the height of the area on the top of an element.
  • padding-right
    Sets the width of the area on the right of an element.
  • padding-bottom
    Sets the height of the area on the bottom of an element.
  • padding-left
    Sets the width of the area on the left of an element.

/* For example it is used for the details table, to avoid that
all the texts are printed too close to the table border. */
.doc_table td {
  padding-top: 5px;
  padding-bottom: 1px;
  padding-left: 4px;
  padding-right: 4px;
}

Absolute positioning

Some elements are positioned relative to the begin of the document. The position of these elements does not depend on any other element in the document.

• postion
  • For the logo, header text and address elements it is used the absolute positioning ("position: absolute").

Borders

To apply borders to tables and table rows.

• border-style
  Sets the line style for all four sides of an element's border.
  • border-top-style
  • border-right-style
  • border-bottom-style
  • border-left-style
• border-color
  Sets the color for all four sides of an element's border.
  • border-top-color
  • border-right-color
  • border-bottom-color
  • border-left-color
• border-width
  Sets the width for all four sides of an element's border.
  • border-top-width
  • border-right-width
  • border-bottom-width
  • border-left-width

/* For example use it to apply a double underline
 to the total line of the invoice. */
  .total_cell {
  border-bottom-style: double;
  border-bottom-color: #337ab7;
  border-bottom-width: 1px;
}

Display / Hide element

Set the attribute display to none to hide an element.  In this case the Invoice number is hidden.

.title_text {
   display: none;
}

Predefined Invoice CSS stylesheet

The JavaScript layout generates an invoice document where each element is assigned a specific CSS class. These classes control the position, spacing, and formatting of the elements according to the stylesheet rules.

If you need to introduce additional style classes, you must also update the JavaScript code to reference them, typically by using the available hook functions.

The following section shows the complete CSS stylesheet used for invoice documents. This stylesheet defines how each part of the invoice is displayed (e.g., headers, addresses, tables, totals, footers).

• Some style properties use predefined variables (values starting with $).
  For example, $font_family is replaced with the font name selected by the user, while other variables are initialized through the JavaScript variable initialization function.
• Comments inside the CSS are written between /* ... */.
  They describe the purpose of each selector and when it should be applied.

Full CSS Code

/* @page
   PURPOSE: Defines the physical page margins for printing.
   EFFECT: All elements are positioned relative to these margins.
   WHEN TO USE: When the user wants to change the page’s margin sizes. */
@page {
  margin-top: 0cm;
  margin-bottom: 0cm;
  margin-left: 0cm;
  margin-right: 0cm;
}

/* body
   PURPOSE: Base style for the whole document.
   EFFECT: Sets default font family, size, and text color for all content.
   WHEN TO USE: When the user wants to change the default font, size, or text color for the whole document. */
body {
  font-family: $font_family;
  font-size: $font_size;
  color: $text_color;
}

/* td
   PURPOSE: Aligns table cell content vertically to the top.
   WHEN TO USE: When the user wants all table cells aligned to the top vertically. */
td {
  vertical-align: top;
}

/* .right
   PURPOSE: Aligns text to the right.
   USAGE: Often combined with other classes for layout control.
   WHEN TO USE: When the user requests right-aligned text. */
.right {
  text-align: right;
}

/* .center
   PURPOSE: Centers text horizontally.
   USAGE: Often combined with other classes for layout control.
   WHEN TO USE: When the user requests centered text. */
.center {
  text-align: center;
}

/* .bold
   PURPOSE: Makes text bold.
   USAGE: Often combined with other classes for layout control.
   WHEN TO USE: When the user wants bold text. */
.bold {
  font-weight: bold;
}

/* .padding-right
   PURPOSE: Adds space inside the element on the right side.
   EFFECT: 20px right padding.
   WHEN TO USE: When the user wants extra padding on the right. */
.padding-right {
  padding-right: 20px;
}

/* .padding-left
   PURPOSE: Adds space inside the element on the left side.
   EFFECT: 20px left padding.
   WHEN TO USE: When the user wants extra padding on the left. */
.padding-left {
  padding-left: 20px;
}

/* .border-top
   PURPOSE: Adds a top border to an element.
   TYPICAL USE: Horizontal separator (e.g., between item list and totals).
   EFFECT: Solid, thin border in $color_title_total.
   WHEN TO USE: When the user requests a horizontal line above an element. */
.border-top {
  border-top-style: solid;
  border-top-color: $color_title_total;
  border-top-width: thin;
}

/* .header_text
   PURPOSE: Styles the header text block alignment and position.
   EFFECT: Sets margins, text alignment, and absolute positioning.
   NOTE: Used when no logo is present, or with right-aligned text layouts.
   WHEN TO USE: When the user wants to change or reposition the main header text. */
.header_text {
  margin-top: 1.2cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
  text-align: right;
  position: absolute;
}

/* .header_row_1
   PURPOSE: Styles the first header row.
   EFFECT: Bold text, 16pt font size.
   WHEN TO USE: When the user wants to style the first line of header text (font weight, font size, font color, etc.). */
.header_row_1 {
  font-weight: bold;
  font-size: 16pt;
}

/* .header_row_2_to_5
   PURPOSE: Styles header rows 2–5.
   EFFECT: Bold text, 10pt font size.
   WHEN TO USE: When the user wants to style the lines 2,3,4 and 5 of header text (font weight, font size, font color, etc.). */
.header_row_2_to_5 {
  font-weight: bold;
  font-size: 10pt;
}

/* .logo
   PURPOSE: Positions the logo in the header.
   EFFECT: Sets margins and absolute positioning.
   WHEN TO USE: When the user wants to move or resize the logo position. */
.logo {
  margin-top: 1.2cm;
  margin-left: 1.34cm;
  margin-right: 1.2cm;
  position: absolute;
}

/* .info_table_left
   PURPOSE: Positions and styles the information table on the left side, when the customer address block is positioned on the right side.
   EFFECT: Sets font size and margins.
   WHEN TO USE: When the user wants to style/move the left-side info table. */
.info_table_left {
  font-size: $font_size;
  margin-top: 4.5cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
}

/* .info_table_right
   PURPOSE: Positions and styles the information table on the right side, when the customer address block is positioned on the left side.
   EFFECT: Sets font size and margins.
   WHEN TO USE: When the user wants to style/move the right-side info table. */
.info_table_right {
  font-size: $font_size;
  margin-top: 5.5cm;
  margin-left: 12.3cm;
  margin-right: 1.2cm;
}

/* .info_table_row0
   PURPOSE: Positions and styles the information table for page 2 and later.
   EFFECT: Sets font size and margins.
   WHEN TO USE: When the user wants to change the info table style for second and later pages. */
.info_table_row0 {
  font-size: $font_size;
  margin-top: 4.5cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
}

/* table.info_table_left td
   PURPOSE: Removes extra vertical padding in cells of left-side info tables.
   WHEN TO USE: When the user wants to change spacing in left-side info table cells. */
table.info_table_left td {
  padding-top: 0px;
  padding-bottom: 0px;
}

/* table.info_table_right td
   PURPOSE: Removes extra vertical padding in cells of right-side info tables.
   WHEN TO USE: When the user wants to change spacing in right-side info table cells. */
table.info_table_right td {
  padding-top: 0px;
  padding-bottom: 0px;
}

/* table.info_table_row0 td
   PURPOSE: Removes extra vertical padding in cells for page 2+ info tables.
   WHEN TO USE: When the user wants to change spacing in page 2+ info table cells. */
table.info_table_row0 td {
  padding-top: 0px;
  padding-bottom: 0px;
}

/* @page:first-view table.info_table_row0
   PURPOSE: Hides the page 2+ info table on the first page only.
   NOTE: :first-view is a custom pseudo-class used to target the first rendering of an element.
   WHEN TO USE: When the user wants to hide elements on the first page only. */
@page:first-view table.info_table_row0 {
  display: none;
}

/* .info_table_first_column
   PURPOSE: Optional override for the width of the first info-table column.
   DEFAULT: If unset, the column uses the default width.
   EXAMPLE: width: 100px;
   WHEN TO USE: When the user wants to set a specific width for the first column. */
.info_table_first_column {}

/* .info_table_second_column
   PURPOSE: Optional override for the width of the second info-table column.
   DEFAULT: If unset, the column uses the default width.
   EXAMPLE: width: 100px;
   WHEN TO USE: When the user wants to set a specific width for the second column. */
.info_table_second_column {}

/* .address_table_right
   PURPOSE: Positions the customer address block on the right side.
   EFFECT: Sets font size, absolute position, and width.
   WHEN TO USE: When the user wants to style or reposition the right-side address block. */
.address_table_right {
  font-size: $font_size;
  top: 4.5cm;
  left: 12.3cm;
  width: 7.5cm;
  position: absolute;
}

/* .address_table_left
   PURPOSE: Positions the customer address block on the left side.
   EFFECT: Sets absolute position and width.
   WHEN TO USE: When the user wants to style or reposition the left-side address block. */
.address_table_left {
  top: 5.5cm;
  left: 2.2cm;
  width: 7.5cm;
  position: absolute;
}

/* .custom_address_table_right
   PURPOSE: Positions the right-side address using configurable margins.
   SOURCE: $right_address_margin_top / $right_address_margin_left come from invoice settings.
   WHEN TO USE: When the user wants to move the right address block using specific measurements. */
.custom_address_table_right {
  font-size: $font_size;
  top: $right_address_margin_top;
  left: $right_address_margin_left;
  width: 7.5cm;
  position: absolute;
}

/* .custom_address_table_left
   PURPOSE: Positions the left-side address using configurable margins.
   SOURCE: $left_address_margin_top / $left_address_margin_left come from invoice settings.
   WHEN TO USE: When the user wants to move the left address block using specific measurements. */
.custom_address_table_left {
  top: $left_address_margin_top;
  left: $left_address_margin_left;
  width: 7.5cm;
  position: absolute;
}

/* .small_address
   PURPOSE: Styles the sender's small address line above the customer address.
   EFFECT: 7pt font, centered text, bottom underline, 0.3cm bottom margin.
   WHEN TO USE: When the user wants to style the small sender address above the customer’s. */
.small_address {
  font-size: 7pt;
  text-align: center;
  border-bottom-style: solid;
  border-bottom-color: $text_color;
  border-bottom-width: 1px;
  margin-bottom: 0.3cm;
}

/* .shipping_address
   PURPOSE: Styles the shipping address block.
   EFFECT: Sets font size and top/side margins.
   WHEN TO USE: When the user wants to style the shipping address section. */
.shipping_address {
  font-size: $font_size;
  margin-top: 0.4cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
}

/* .title_shipping_address
   PURPOSE: Styles the "Shipping Address" title.
   EFFECT: Bold text, $color_title_total color.
   WHEN TO USE: When the user wants to style the shipping address title text. */
.title_shipping_address {
  font-weight: bold;
  color: $color_title_total;
}

/* .title_text
   PURPOSE: Styles the invoice title.
   EFFECT: Bold text, $font_size_title size, $color_title_total color.
   WHEN TO USE: When the user wants to style the invoice title text. */
.title_text {
  font-size: $font_size_title;
  font-weight: bold;
  color: $color_title_total;
}

/* .section_class_begin
   PURPOSE: Container for the introductory (begin) text after the invoice title.
   EFFECT: Full width with top/side margins.
   WHEN TO USE: When the user wants to change the position or spacing of the intro text section. */
.section_class_begin {
  margin-top: 1.0cm;
  margin-left: 1.2cm;
  margin-right: 1.2cm;
  width: 100%;
}

/* .begin_text_table
   PURPOSE: Table container for the "begin" text.
   EFFECT: Full width.
   WHEN TO USE: When the user wants to style the table of the begin text. */
.begin_text_table {
  width: 100%;
}

/* .begin_text
   PURPOSE: Styles the "begin" text.
   EFFECT: Sets font size.
   WHEN TO USE: When the user wants to change the style of the introductory text. */
.begin_text {
  font-size: $font_size;
}

/* .section_class_details:first-view
   PURPOSE: Applies a specific top margin to the details section on first render only.
   NOTE: :first-view targets the first time the section is displayed.
   WHEN TO USE: When the user wants to change the details section margin only on the first page. */
.section_class_details:first-view {
  margin-top: 0.5cm;
}

/* .section_class_details
   PURPOSE: Styles the invoice details section on all pages.
   EFFECT: Sets font size and outer margins.
   WHEN TO USE: When the user wants to style or adjust margins for the details section. */
.section_class_details {
  font-size: $font_size;
  margin-top: 0.5cm;
  margin-bottom: 0.5cm;
  margin-left: 1.3cm;
  margin-right: 1.2cm;
}

/* .doc_table
   PURPOSE: Table for invoice details.
   EFFECT: Full width.
   WHEN TO USE: When the user wants to style the details table. */
.doc_table {
  width: 100%;
}

/* .doc_table_header
   PURPOSE: Styles the header row of the invoice details table.
   EFFECT: Bold, $font_size_header, custom text/background colors, bottom border.
   WHEN TO USE: When the user wants to style the column headers of the details table. */
.doc_table_header {
  font-size: $font_size_header;
  font-weight: bold;
  color: $text_color_details_header;
  background-color: $background_color_details_header;
  border-bottom: thin solid $color_title_total;
}

/* .doc_table td
   PURPOSE: Sets cell padding for invoice details rows.
   WHEN TO USE: When the user wants to adjust padding inside detail table cells. */
.doc_table td {
  padding-top: 5px;
  padding-bottom: 1px;
  padding-left: 0px;
  padding-right: 0px;
}

/* .doc_table_header td
   PURPOSE: Sets cell padding for the invoice header row.
   WHEN TO USE: When the user wants to adjust header cell padding in the details table. */
.doc_table_header td {
  padding-top: 4px;
  padding-bottom: 2px;
  padding-left: 0px;
  padding-right: 0px;
}

/* .item_cell
   PURPOSE: Define the text style for each invoice item row.
   USAGE: Apply to cells/rows containing individual items.
   NOTE: Empty by default, add font/spacing/color rules as needed.
   WHEN TO USE: When the user wants to style the text of each line item in the details table. */
.item_cell {}

/* .total_cell
   PURPOSE: Styles the total row.
   EFFECT: Bold, $font_size_total, $color_title_total color, double bottom border.
   WHEN TO USE: When the user wants to style the row containing the total amount. */
.total_cell {
  font-size: $font_size_total;
  font-weight: bold;
  color: $color_title_total;
  border-bottom-style: double;
  border-bottom-color: $color_title_total;
  border-bottom-width: 1px;
}

/* .subtotal_cell
   PURPOSE: Styles the subtotal row.
   EFFECT: Bold text, single bottom border in $color_title_total.
   WHEN TO USE: When the user wants to style the subtotal row in the details table. */
.subtotal_cell {
  font-weight: bold;
  border-bottom-style: solid;
  border-bottom-color: $color_title_total;
  border-bottom-width: thin;
}

/* .header_cell
   PURPOSE: Styles any header cell in the invoice details.
   EFFECT: Bold text.
   WHEN TO USE: When the user wants to make any header cell bold in the details section. */
.header_cell {
  font-weight: bold;
}

/* .vat_info
   PURPOSE: Styles VAT-related text.
   EFFECT: Sets font size (used for gross amount layouts).
   WHEN TO USE: When the user wants to style VAT information text. */
.vat_info {
  font-size: $font_size;
}

/* .even_rows_background_color
   PURPOSE: Sets background color for even-numbered rows (striped tables).
   WHEN TO USE: When the user wants alternating row background colors in tables. */
.even_rows_background_color {
  background-color: $background_color_alternate_lines;
}

/* .section_class_final_texts
   PURPOSE: Styles the final notes/greetings section after the details.
   EFFECT: Sets top/side/bottom margins.
   WHEN TO USE: When the user wants to style or adjust spacing for final texts or notes. */
.section_class_final_texts {
  margin-top: 0cm;
  margin-bottom: 0.5cm;
  margin-left: 1.26cm;
  margin-right: 1.0cm;
}

/* .footer_line
   PURPOSE: Horizontal line above the footer section (separator).
   EFFECT: Top border, side margins.
   WHEN TO USE: When the user wants to add or style a separator line above the footer. */
.footer_line {
  margin-left: 1.2cm;
  margin-right: 1.0cm;
  border-top-style: solid;
  border-top-color: $color_title_total;
  border-top-width: thin;
}

/* .footer_table
   PURPOSE: Styles the footer table.
   EFFECT: 8pt font, bottom margin, full width, side margins.
   WHEN TO USE: When the user wants to style the footer section or adjust its spacing. */
.footer_table {
  font-size: 8pt;
  margin-bottom: 2.0cm;
  margin-left: 1.2cm;
  margin-right: 1.0cm;
  width: 100%;
}

CSS Class Reference

Erreur QR-IBAN manquant

@erreur QR-IBAN manquant

•  Le code QR-IBAN doit être saisi dans les paramètres de la facture sous QR-IBAN.
• Assurez-vous que le code QR-IBAN n'a pas été saisi dans les données de base Fichier → Propriétés fichier (données de base) → Adresse.

@erreur QR-IBAN incorrect

Veuillez vérifier que le code QR-IBAN saisi dans les paramètres de la facture est correct. Veuillez également consulter la section Compte QR-IBAN de notre page Web Facture QR avec utilisation d'un compte spécial QR-IBAN.

@erreur IBAN manquant

• L'IBAN pour un compte en CHF peut être indiqué de deux façons:
  • Dans les données de base Fichier → Propriétés fichier (données de base) → Adresse.
  • Dans les paramètres de la facture, sous l'entrée correspondante IBAN.
• L'IBAN d'un compte en EUR doit être saisi dans les paramètres de la facture sous IBAN EUR.

@erreur IBAN incorrect

• Le code IBAN saisi dans les données de base, menu Fichier → Propriétés fichier (données de base) → Adresse, ou dans les paramètres de la facture est incorrecte.
• Ou vous avez saisi un code QR-IBAN dans les données de base, menu Fichier → Propriétés fichier (données de base) → Adresse. Si vous souhaitez utiliser le code QR-IBAN, vous devez le saisir dans la section appropriée des paramètres de la facture.

@erreur Adresse : nom/société manquante

Configurez le prénom et le nom de l'expéditeur ou le nom de la société à partir de Fichier → Propriétés fichier (données de base) → Adresse,  et du client dans le tableau Comptes → vue Adresse.

@erreur  Adresse : Code postal manquant

Configurez le code postal de l'expéditeur à partir du menu Fichier → Propriétés fichier (données de base) → Adresse, et du client dans le tableau Comptes → vue Adresse.

@erreur Adresse : lieu manquant

Configurer la localité de l'expéditeur à partir du menu Fichier → Propriétés fichier (données de base) → Adresse, et du client dans le tableau Comptes → vue Adresse.

@erreur Adresse : code du pays manquant

Adresse de l’expéditeur (Payable à) :

• Définir le code du pays de l’expéditeur dans Fichier → Propriétés du fichier (données de base) → section Adresse.
• Ou, si vous utilisez l’adresse définie dans les paramètres de mise en page de la facture CH10, saisir le code du pays dans la fenêtre de dialogue des paramètres CH10, section « Payable à… »

Adresse du client (Payable par) :

• Dans la facturation intégrée, saisir le code du pays du client dans le tableau Comptes → vue Adresse → colonne Pays/Code.
• Dans l’application Offres et Factures, saisir le code du pays du client dans le tableau Contacts → colonne Code Pays. 

@erreur Adresse : code du pays incorrect

Le code pays doit comporter deux caractères conformément à la norme ISO 3166-1 (par exemple CH, LI, AT, DE, IT, FR).

@error isrId too long, max 8 chars. Your isrId %1

Le numéro d'adhésion est trop long. La longueur maximale autorisée est de 8 chiffres. Pour plus d'informations Référence QR (QRR).

@error isrId invalid, only digits are permitted. Your isrId %1

Le numéro d'adhésion n'est pas valide. Il ne peut être constitué que de chiffres. Pour plus d'informations Référence QR (QRR).

@error customerNo too long, max 7 digits. Your customerNo %1

Le numéro de client est trop long. La longueur maximale autorisée est de 7 chiffres. Pour plus d'informations Référence QR (QRR).

@error customerNo invalid, only digits are permitted. Your customerNo %1

Le numéro de client n'est pas valide. Il peut être composé seulement de chiffres. Il ne doit pas contenir des lettres de l'alphabet ASCII (A-Z), d'espaces, de séparateurs ou d'autres caractères. Pour plus d'informations Référence QR (QRR).

@error invoiceNo too long, max 7 digits. Your invoiceNo %1

Le numéro de facture est trop long. La longueur maximale autorisée est de 7 chiffres. Pour plus d'informations Référence QR (QRR).

@error invoiceNo invalid, only digits are permitted. Your invoiceNo %1

Le numéro de facture n'est pas valide. Il peut être composé seulement de chiffres. Il ne doit pas contenir des lettres de l'alphabet ASCII (A-Z), d'espaces, de séparateurs ou d'autres caractères. Pour plus d'informations Référence QR (QRR).

@error Nom trop long, 70 caractères maximum

Le nom est trop long. La longueur maximale autorisée est de 70 caractères. Pour plus d'informations Informations techniques.

@error Adresse trop long, 70 caractères maximum

L'adresse est trop long. La longueur maximale autorisée est de 70 caractères. Pour plus d'informations Informations techniques.

@error Numéro maison trop long, 16 caractères maximum

Le numéro maison est trop long. La longueur maximale autorisée est de 16 caractères. Pour plus d'informations Informations techniques.

@error Code postal trop long, 16 caractères maximum

Le code postal est trop long. La longueur maximale autorisée est de 16 caractères. Pour plus d'informations Informations techniques.

@error Localité trop long, 35 caractères maximum

Le texte de la localité est trop long. La longueur maximale autorisée est de 35 caractères. Pour plus d'informations Informations techniques.

@error Code postal+Localité trop long, 70 caractères maximum

Le code postal+localité est trop long. La longueur maximale autorisée est de 70 caractères. Pour plus d'informations Informations techniques.

Cette page présente quelques exemples d'impressions possibles de factures QR.

• Télécharger le fichier tutoriel utilisé pour les exemples

Facture avec paramètres par défaut

• Utilise les paramètres par défaut dans la fenêtre de dialogue des paramètres de la facture.
• Insérez un compte IBAN dans les données de base:   Fichier > Propriétés fichier (données de base) > Section adresse ou dans les paramètres de la facture

Exemple d'impression :

Facture avec logo

Via le dialogue Fichier > Configuration Logo :

• Définissez le logo, la taille et l'alignement.
• Définissez l'alignement du texte de l'en-tête de la facture.
  Définissez le texte de l'en-tête dans Fichier > Propriétés fichier (données de base) > Section adresse ou en utilisant les champs de la fenêtre de dialogue des paramètres de la facture.

Exemple de facture avec logo aligné à gauche et texte à droite :

Exemple de facture avec logo aligné à droite et texte à gauche :

Facture avec logo type papier à en-tête (format A4)

Cet exemple explique comment configurer un logo en pleine page (type papier à en-tête). Une image avec un logo en haut et un pied de page en bas est utilisée. L’objectif est d’imprimer la facture avec :

• Sur les pages contenant les détails de la facture, le logo et le pied de page sont affichés.
• Sur la dernière page avec le bulletin QR, seul le logo est affiché, sans le pied de page.

C’est utile, par exemple, si l’on souhaite imprimer une facture QR avec également le pied de page, car normalement le pied de page ne peut être ajouté que si le bulletin QR est exclu de l’impression.

Voici comment procéder :

• Créez une image au format A4 du papier à en-tête, avec le logo en haut et le pied de page en bas.
  Exemple :
  
  
   
• Insérez l’image créée comme logo via le menu Fichier > Configuration logo.
  • Définissez les dimensions : largeur 21 cm et hauteur 29,7 cm (si les dimensions de l’image sont déjà correctes, vous pouvez ignorer ces réglages).
  • Définissez l’alignement à gauche.
  • La position et l’alignement du texte sont sans importance, car aucun texte ne sera imprimé dans l’en-tête.
• Utilisez la personnalisation avec le CSS pour modifier les marges du logo.
  Dans le tableau Documents, ajoutez une nouvelle ligne et insérez le CSS en tant que pièce jointe.
  • Dans la colonne ID, saisissez un identifiant (par exemple, logo.css). Il doit se terminer par ".css".
  • Dans la colonne Pièces , double-cliquez sur la cellule et sélectionnez Feuille de style CSS.
  • Dans l’éditeur qui s’ouvre, collez le code suivant :

  • .logo {
      margin-top: 0cm;
      margin-left: 0cm;
      margin-right: 0cm;
    }

• Configurez certains paramètres dans la boîte de dialogue des paramètres de la facture :
  • Dans la section Impression > En-tête, décochez En-tête de page.
  • Dans la section Impression > En-tête, cochez Logo.
  • Dans la section Impression > En-tête, dans le champ Composition pour l’alignement du logo et de l’en-tête, saisissez le nom de la personnalisation que vous avez défini dans Fichier > Configuration logo > Personnalisation > Nom (par défaut "Logo").
  • Dans la section Code QR, cochez QR sur page séparée.
  • Dans la section Javascript / CSS, dans le champ Nom du fichier CSS, entrez l’ID du fichier CSS que vous avez défini dans le tableau Documents (par exemple logo.css).

Exemple de facture QR, avec logo et pied de page sur la première page, logo et bulletin QR sur la deuxième page :

Facture sans logo et adresse entreprise à gauche

Allez dans la fenêtre Fichier > Configuration Logo :

• N'ajoutez aucune image de logo
• Comme Position du texte, entrez les paramètres suivants :
  • Position relative par rapport au logo : À gauche
  • Alignement horizontal : Gauche
• Allez dans la section Personnalisation et, dans le champ Nom, saisissez un nom pour la personnalisation (par exemple, "Logo").

Allez maintenant dans la fenêtre de configuration de la facture, dans la section Impression > En-tête :

• Activez la case En-tête de page.
• Activez la case Logo (bien qu'aucune image de logo ne soit affichée).
• Dans le champ Composition pour l'alignement du logo et de l'en-tête, entrez le nom de la personnalisation que vous avez définie précédemment dans la fenêtre Configuration logo > Personnalisation > Nom (par exemple, "Logo").

Impression d'exemple:

Facture avec adresse clients à gauche

Via la fenêtre de dialogue des paramètres de la facture, section Adresse client :

• Définissez la composition des adresses en spécifiant les noms XML des colonnes d'adresses du tableau Comptes.
• Cochez la case Aligner à gauche pour imprimer l'adresse à gauche et la partie des informations à droite.
  
  

Exemple d'impression :

Facture avec les en-têtes et les totaux intermédiaires de façon détaillée

Dans certains cas, il peut être utile d'ajouter des en-têtes et des totaux intermédiaires dans les détails de la facture.

Dans le tableau Écritures, définissez les lignes d'en-tête et les totaux intermédiaires à l'aide de la colonne Type :

• Lignes d'en-tête : entrez la commande 10:hdr et le texte dans la colonne Description.
• Lignes de totaux intermédiaires : entrez la commande 10:tot et le texte dans la colonne Description.
  
  

Exemple de facture sur plusieurs pages :
  

Les informations concernant l’insertion de l’adresse de l’expéditeur pour les enveloppes à fenêtre se trouvent dans la section Adresse client de la page Personnalisation de l’impression.

Facture avec adresse de livraison et colonnes Description et Montant

Via le dialogue de paramétrage des factures :

• Dans la section Adresse du client, cochez la case Adresse de livraison.
• Dans la section Détails de la facture, définissez :
  • Les noms des colonnes à utiliser, en précisant les noms de colonnes XML du tableau Écritures
  • La largeur de chaque colonne.
  • L'alignement des titres et des textes des colonnes.
• Dans la section Textes, définissez le texte d'en-tête de chaque colonne.
  Ajoutez la traduction pour chaque langue que vous avez l'intention d'utiliser.
  
  

Exemple d'impression de la facture avec autres paramètres :

Utiliser colonne tableau Écritures

Conditions préalables:

• Avoir le plan Advanced de Banana Comptabilité Plus.

Outre les colonnes par défaut (Libellé, Quantité, Unité, Prix unitaire et Montant) de l'impression de la facture, vous pouvez ajouter d'autres colonnes à partir du tableau Écritures, y compris celles qui ont été ajoutées manuellement au tableau.

Dans certains cas, il peut être utile d'inclure votre propre colonne (non prédéfinie dans le programme) dans les détails de la facture, comme par exemple une colonne dans laquelle indiquer la date d'exécution d'un travail.

Création d'une colonne :

• Utilisez la commande Organiser colonnes pour ajouter une colonne dans le tableau Écritures.
• Créez une colonne nommée DateWork de type Date.
  Le nom XML de chaque colonne du type Date doit commencer par le mot Date (par exemple DateWork, DateExecution, DateXXX).
• Lors de l'impression de la facture, le programme utilise le format de date défini dans les paramètres de votre système d'exploitation.
  
  
   
• Saisissez vos écritures pour créer la facture et indiquez dans cette colonne la date d'exécution du travail.

Via la fenêtre de dialogue des paramètres de la facture :

• Dans la section Détails de la facture, définissez :
  • Les noms de colonnes à utiliser, en précisant les noms XML des colonnes du tableau Écritures ;
    Saisissez la colonne créée ainsi : T.DateWork (vos propres colonnes doivent être précédées par "T.").
  • La largeur de chaque colonne ajoutée, et adapter celles qui existent déjà.
  • Les alignements des titres et des textes de chaque colonne ajoutée, et adapter celles qui existent déjà.
• Dans la section Textes, définissez le texte d'en-tête de chaque colonne.
  • Ajouter le texte de la colonne ajoutée et éventuellement adapter les colonnes existantes.
  • Ajoutez la traduction pour chaque langue que vous souhaitez utiliser.
     
  • 

Avec une personnalisation avancée en Javascript, vous pouvez créer une fonction qui change le format dans lequel la date est imprimée. Pour plus d'informations, voir Use another date format.

Exemple d'impression de la facture :

Facture avec texte initial et final, notes et salutations

Dans le tableau Écritures, définissez les textes initiaux, les notes et les salutations en utilisant la colonne Type :

• Texte initial : insérez la commande 10:beg et le texte dans la colonne Libellé.
• Notes : insérez la commande 10:not et le texte dans la colonne Libellé.
• Salutations :insérez la commande 10:gre et le texte dans la colonne Libellé.
• Le texte inséré entre les doubles astérisques (**) est affiché en gras.
  
  

Via la fenêtre de dialogue des paramètres de la facture :

• Dans la section Textes, définissez le texte final à inclure immédiatement après les détails de la facture.
  Le texte inséré entre les doubles astérisques (**) est affiché en gras.
  
  

Exemple d'impression de la facture :

Facture sans montant

Cette option est utilisée lorsque vous souhaitez laisser la possibilité de choisir le montant à payer à la personne qui effectue le paiement (par exemple pour un don).
Dans la partie QR, le montant est exclu, laissant une case vide pour saisir le montant à la main.

Dans le tableau Écritures, insérez l'écriture du don sans le montant.

Dans la boîte de dialogue de Paramétrage des factures, dans la section QR Code, cochez la case Exclure le montant de la facture.

Exemple d'impression de la facture :

Facture avec descriptions sur plusieurs lignes (facturation intégrée)

Cet exemple pour la facturation intégrée montre comment créer des factures avec des descriptions sur plusieurs lignes.

Les étapes à suivre sont les suivantes :

• Avec la commande Organiser colonnes, ajoutez une ou plusieurs colonnes de descriptions supplémentaires dans le tableau Écritures.
  Créez des colonnes de type Texte avec le nom "Description" suivi d’un numéro (ex. "Description1", "Description2", "Description3", etc.).
  Le nom XML de chaque colonne doit commencer par le mot "Description" (en anglais) suivi d’un numéro.
  
  
   
• Dans les colonnes nouvellement créées, insérez les textes supplémentaires pour les descriptions des factures.
  Le texte de chaque colonne sera affiché sur une nouvelle ligne dans la description de la facture.
  
  
   
• Via la boîte de dialogue des paramètres facture, dans la section Impression > Détails facture, cochez la case Imprimer les descriptions supplémentaires.
  
  

À ce stade, si le tableau Écritures contient des colonnes de descriptions supplémentaires et que celles-ci contiennent du texte, ce texte sera ajouté à l'impression de la facture.

Exemple d'impression de facture :

Facture avec descriptions sur plusieurs lignes (Offres-Factures)

Cet exemple pour l'application Offres et Factures montre comment créer des factures avec des descriptions sur plusieurs lignes.

• Dans la boîte de dialogue de création/modification de facture, section Détails de la facture, colonne Description :
  • Saisissez les textes des descriptions.
  • Vous pouvez aller à la ligne et insérer autant de lignes que vous le souhaitez.
  • Vous pouvez également laisser des lignes vides.
  • Vous pouvez insérer un ou plusieurs textes entre deux astérisques pour les mettre en gras (ex. **Texte en gras**).
  • Vous pouvez saisir le montant sur la même ligne que la description multi-lignes, ou bien sur une nouvelle ligne (voir image).
    
    

Lors de l’impression de la facture, les descriptions seront affichées sur plusieurs lignes, comme dans la boîte de dialogue.

Exemple d'impression de facture :

Facture avec colonne de Remise par article

Cet exemple pour la facturation avec l’application Offres et Factures montre comment ajouter la colonne Remise de l'article dans les détails de la facture.

Prérequis :

• Plan Advanced de Banana Comptabilité Plus.
• Version Beta de l’application Offres et Factures.

Les étapes à suivre sont les suivantes :

• Créez les factures en utilisant la colonne Remise. Indiquez un pourcentage ou une valeur.
  
  
   
• Via le dialogue des paramètres de la facture :
  • Dans la section Impression > Détails de la facture, ajoutez la colonne Remise, définissez les largeurs de colonnes ainsi que l’alignement des titres et du texte.
    • Description;Quantity;ReferenceUnit;UnitPrice;Discount;Amount
      35%;10%;10%;15%;15%;15%
      left;center;center;right;right;right
      left;center;center;right;right;right
  • Dans la section Textes > En-têtes des colonnes de détails de la facture, définissez pour chaque langue les textes des en-têtes de tableau, en ajoutant également le texte pour la colonne Remise.
    • Description;Quantité;Unité;Prix unitaire;Remise;Montant

Exemple impression fatcure: 

Facture avec images des produits

Cet exemple montre comment ajouter et imprimer les images des produits dans les détails de la facture.

Prérequis

• Plan Advanced de Banana Comptabilité Plus.
• Personnalisation avancée avec Javascript.

Étapes

1. Ajouter les images des produits.
   • Enregistrez les images de chaque produit.
     Utilisez le même dossier que celui du fichier .ac2 ou un sous-dossier.
     Les formats pris en charge sont PNG et JPG.
     Utilisez des images de petite taille pour réduire la taille du fichier PDF généré.
2. Modifier le tableau Articles
   • Ajouter la colonne Links.
     Dans le tableau Articles, rendez visible la colonne Links avec la commande Organiser les colonnes.
   • Lier les images aux articles.
     Dans la colonne Links du tableau Articles, ajoutez le lien vers l’image pour chaque produit.
     Cliquez sur l’icône en haut à droite de la cellule et sélectionnez l’image correspondante.
3. Ajouter le tableau Documents.
   • S’il n’est pas déjà présent, ajoutez le tableau Documents.
     Depuis le menu Outils > Ajouter fonctions > Tableau Documents.
4. Ajouter le code JavaScript comme pièce jointe dans le tableau Documents.
   • Dans la colonne ID, saisissez le nom de la pièce jointe avec l’extension .js (ex. "monFichier.js").
   • Dans la colonne Pièces jointes, cliquez sur l’icône en haut à droite et sélectionnez Code Javascript.
     Un éditeur s’ouvre, videz tout son contenu.
   • Copiez-collez le code Javascript de la fonction 'hook_print_details_net_amounts' (fonction qui imprime la facture avec les montants nets).
   • Copiez-collez le code Javascript de la fonction 'hook_print_details_gross_amounts' (fonction qui imprime la facture avec les montants bruts).
   • Cliquez sur OK.
5. Configurer les paramètres de mise en page de la facture.
   • Dans les Paramètres de la facture :
     • Dans la section Détails de la facture, ajoutez les colonnes "I.Links" (colonne pour les images) et "Number" (numéro d'article).
       
       I.Links;Number;Description;Quantity;ReferenceUnit;UnitPrice;Amount
       10%;10%;30%;10%;10%;15%;15%
       left;left;left;right;center;right;right
       left;left;left;right;center;right;right
        
     • Dans la section Textes, ajoutez les en-têtes des colonnes (ex. "Image;Article;Description;Quantité;Unité;Prix unitaire;Montant").
     • Dans la section Javascript / CSS > Nom du fichier JS saisissez l’ID de la pièce jointe contenant le code JavaScript (ex. "monFichier.js").

Les images des produits seront également incluses dans l’impression de la facture.

Exemple d’impression :