> For the complete documentation index, see [llms.txt](https://doc.progbat.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.progbat.com/pour-aller-plus-loin/modeles-de-document.md).
# Modèles de document
### :point\_right: ProGBat met à disposition des modèles de document par défaut, **déjà prêts à être utilisés**
### :point\_right: **Il vous suffit de** [**paramétrer votre entreprise**](/pour-aller-plus-loin/parametrage-du-compte.md) **pour que s'affichent automatiquement :**
:digit\_one: Votre logo, et vos coordonnées :
:digit\_two: Les données officielles (et obligatoires) de votre entreprise :
:digit\_three: Vos coordonnées bancaires :
* Si votre compte a été créé à compter du 18/10/2021 :
Vos coordonnées bancaires seront automatiquement indiquées au pied du document, pour faciliter les règlements de vos clients :
* Si votre compte a été créé avant le 18/10/2021 :
Vos coordonnées bancaires renseignées **ne s’afficheront pas automatiquement** dans vos devis et factures. Cliquez [ici ](#ajouter-vos-coordonnees-bancaires-iban-rib)pour savoir comment les ajouter à vos documents.
### :point\_right: **Mais vous pourrez** **créer et personnaliser vos propres modèles** : Pour des documents uniques, aux couleurs de votre entreprise !
{% hint style="info" %}
**Vous n'avez pas le temps ou n'arrivez pas à personnaliser votre modèle de document?**
:point\_right: **Contactez votre support ou revendeur ProGBat !**
Faites parvenir votre(vos) modèle(s), un devis vous sera alors adressé pour la reproduction quasi à l'identique de votre modèle.
{% endhint %}
## Étape 1 : Créer un modèle de document personnalisé
Il est recommandé de partir d'un modèle existant pour créer et personnaliser votre propre modèle :
:digit\_one: Ouvrez le menu "Administration > Modèles de documents"
:digit\_two: Choisissez dans le tableau de gauche le modèle que vous souhaitez personnaliser :
* Cliquez sur le bouton "Voir", pour visualiser le modèle
* Cliquez sur le bouton "Copier dans mes modèles", pour le faire passer dans la colonne des modèles personnalisés
:digit\_three: Donnez un nom à votre modèle, et validez
:digit\_four: Vous pouvez maintenant personnaliser toutes les sections de ce modèle.
## Étape 2 : Personnaliser un modèle de document
### :one: Sections personnalisables
| Sections du document | Se répète sur chaque page du document | Section que vous pourrez dupliquer sur d'autres documents |
| ----------------------- | :-----------------------------------: | :-------------------------------------------------------: |
| **En-tête de page** | :white\_check\_mark: | :white\_check\_mark: |
| **En-tête générique** | | :white\_check\_mark: |
| **En-tête de document** | | |
| **Corps du document** | | :white\_check\_mark: |
| **Pied de document** | | |
| **Pied de page** | :white\_check\_mark: | :white\_check\_mark: |
:point\_right: Ces sections contiennent chacune un éditeur enrichi qui vous permettra d'en modifier le contenu (structure, données) :
{% hint style="danger" %}
**Pensez à bien enregistrer chaque section après modification.**
{% endhint %}
### :two: **Insérer un contenu**
Pour définir la structure, l'emplacement, la taille, et l'apparence des images et données affichées dans vos documents **:**
:digit\_one: Cliquez dans la section que vous souhaitez modifier
:digit\_two: Cliquez à l'emplacement où vous souhaitez apporter une modification
:digit\_three: Insérez ce qui vous plaît, en cliquant simplement sur l'icône correspondante, dans l'éditeur, en haut de section :
###  **Insérer un logo, une image, ou ma signature d'entreprise**
:point\_right: Cliquez simplement à l'endroit où vous souhaitez ajouter cette image, choisissez l'image dans la galerie ou importez-la depuis votre ordinateur, et cliquez sur le bouton "Insérer".
###  Insérer u**n tableau**
Le tableau vous permettra de mieux maîtriser l'emplacement de vos données, et la taille que celles-ci doivent prendre.
Vous pourrez définir ses dimensions, ainsi que celles des lignes, colonnes, et cellules contenues :
:bulb: **1 millimètre =** 3,7795275591 pixels.
###  Insérer u**ne division**
Kézako? Une division, c'est un bloc, comme une cellule de tableau, qui va accueillir du contenu, et que l'on va pouvoir mettre en forme facilement :
###  Insérer u**ne ligne séparatrice**
###  Insérer u**n saut de page**
À l'impression, le logiciel passera à la page suivante en rencontrant la ligne "Saut de page".
###  Accéder au **Code source**
Réservé au public aguerri :wink:
Pour ceux qui veulent aller plus loin, vous pourrez directement modifier le code source de vos contenus, lorsque ce bouton s'affiche.
### :three: **Insérer et saisir des données**
:digit\_one: **Les tags**
Les tags sont des données qui se présentent comme cela : **@Information**.
Le tag va aller chercher l'information là où elle se trouve sous ProGBat. Par exemple : le tag @nomTiers ira chercher le nom du client dans un devis ou une facture, ou du fournisseur dans une commande.
La **liste complète** de tags disponibles se trouve sur la partie droite de la page, dans les différentes rubriques.
:point\_right: Cliquez à l'endroit ou vous souhaitez intégrer un tag / une information
:point\_right: Cliquez sur le tag dans la liste à droite de la page
:point\_right: Il s'affichera automatiquement à l'endroit souhaité.
:digit\_two: **Les "méta-tags"**
Certains tags affichent beaucoup plus qu'une simple valeur, et reprennent toutes les informations nécessaires, pour vous garantir de ne rien oublier :
* **Numérotation automatique du document :** @numerotationDocument
Affiche le type et la date du document, y compris les numéros de révision ou de situation, ainsi que le devis d'origine pour une facture :
* **Récapitulatif des lots** : @recaptulatifLots affiche un tableau récapitulatif de tous les titres de 1er niveau de votre devis ou facture :
:digit\_three: **Les conditions : \[si] ... \[sinon] ... \[/si]**
\
Les conditions permettent d'afficher du texte ou des données selon certaines conditions.
***Les conditions s'écrivent de la manière suivante :*** \
`[si @tag]texte à afficher[/si]`
:point\_right: Prenons un exemple concret :
`[si @contactClient]À l'attention de @contactClient[/si]`
:point\_right: Il faut comprendre :
"\[Si un contact client est renseigné dans la fiche client], alors affiche le texte 'À l'attention de' et va chercher le nom du contact client dans la fiche client, \[/Fin de la condition]"
:point\_right: Résultat :
Pour aller plus loin, voici ce que vous pourrez faire avec les conditions, au travers d'exemples concrets :
* **`[si`` `*****`@estSituation`*****`]`**`Situation n°`` `*`@numSituation`***`[/si]`**
*Traduction : Si le document est une situation de travaux, alors affiche le texte 'Situation n°' et va chercher le numéro de situation dans la facture.*
* **`[si @tauxRetenueGarantie > 0]`**` ``Retenue de garantie :`` `*`@tauxRetenueGarantie`*` ``%`` `**`[/si]`**
*Traduction : Si le taux de la retenue de garantie est supérieur à 0, alors affiche le texte 'Retenue de garantie :' et va chercher le taux de la retenue de garantie, en ajoutant à la fin le texte '%'.*
* **`[si @tauxRetenueGarantie = 0]`**` ``Aucune retenue de garantie n'est appliquée`` `**`[/si]`**
*Traduction : Si le taux de retenue de garantie est égal à 0, alors affiche le texte 'Aucune retenue de garantie n'est appliquée'.*
* **`[si @numRevision]`** *`@dateRevision`* **`[sinon]`** *`@dateCreation`* **`[/si]`**
*Traduction : Si le devis contient un numéro de révision, alors affiche la date de révision du devis ; si le devis ne contient pas de numéro de révision, alors affiche la date de création du devis.*
### :four: Personnaliser le tableau du corps du document
:digit\_one: Sélectionnez un type de ligne (Titre, ouvrage, commentaire) pour y appliquer une mise en forme, à choisir dans l'éditeur juste au dessus du tableau : police, taille, couleur, couleur de fond, etc...
:bulb: Astuce : La dernière icône du menu, représentant le signe **€**, permet d'afficher ou non les prix de la ligne sélectionnée.
:digit\_two: Ajoutez ou masquez des colonnes :
:digit\_three: Cochez les éléments à afficher, ou décochez-les pour les masquer :
## Afficher mes coordonnées bancaires - IBAN / RIB
:digit\_one: Ajoutez d'abord vos données bancaires sous ProGBat : Cliquez [ici ](/aide-au-demarrage/parametrage-de-mon-entreprise/informations-officielles-de-mon-entreprise.md#comptes-bancaires-and-iban-rib)si vous ne l'avez pas encore fait
:digit\_two: Ouvrez votre modèle de document personnalisé : Cliquez [ici ](#creer-un-modele-de-document-personnalise)si vous n'en avez pas encore créé
:digit\_three: Cliquez là où vous souhaitez ajouter vos coordonnées bancaires
:digit\_four: Saisissez le texte que vous souhaitez ajouter pour présenter les données que vous allez afficher (voir exemples ci-dessous)
:digit\_five: Cliquez dans la colonne de droite sur le ou les tags d'information à afficher
:digit\_six: Enregistrez
**Exemple 1 :**
:point\_right: Ajout du RIB (Affichage plus "officiel", mais il prend de la place) :
:point\_right: Résultat de l'affichage dans un document :
**Exemple 2 :**
:point\_right: Ajout de l'IBAN et du BIC (Affichage succinct, qui prend moins de place)
:point\_right: Résultat de l'affichage dans un document :
## Afficher des sous-totaux
Par défaut, ProGBat affiche les sous-totaux au niveau des lignes de titres et de sous-titres.
Il est possible d'afficher ces sous-totaux sous forme de lignes de sous-totaux :
:digit\_one: Ouvrez votre modèle de document personnalisé : Cliquez [ici ](#creer-un-modele-de-document-personnalise)si vous n'en avez pas encore créé
:digit\_two: Cliquez sur le corps du document
:digit\_three: À droite de la page, descendez jusqu'au pavé "Lignes à afficher"
:digit\_four: Cochez la case "Lignes de sous-totaux", et les cases de lignes séparatrices pour plus de clarté :
Dans le visuel, les lignes de sous-totaux apparaissent. Elles prennent automatiquement la mise en forme des titres et sous-titres.
### :point\_right: Choisir les sous-totaux à afficher
Vous pouvez par exemple afficher uniquement les sous-totaux des titres de niveau 1 et 2 :
:digit\_one: Sélectionnez la ligne "Titre de niveau 3"
:digit\_two: Dans la barre de menu, activez ou désactivez le bouton 
:digit\_three: Faites de même pour les titres de niveau 4 et 5
:digit\_four: Enregistrez.
## Afficher mon assurance professionnelle et mes conditions générales de vente
Ces deux informations figurent dans un même "champ" sous ProGBat, qu'il vous faudra remplir en ouvrant le menu ["Administration > Mon entreprise > Assurances - Conditions générales".](/aide-au-demarrage/parametrage-de-mon-entreprise/coordonnees-et-assurances-de-lentreprise.md)
Comme ces informations figurent dans un même "champ", vous pourrez les insérer avec un seul tag : **@assurance**.
Ce tag est bien sûr déjà présent dans les modèles de document proposés par défaut.
## Afficher le récapitulatif des lots
:digit\_one: Cliquez là où vous souhaitez ajoutez le récapitulatif
:digit\_two: Cliquez sur l'icône "Tableau"  pour créer un tableau d'1 ligne et 1 colonne
:digit\_three: Cliquez dans la seule cellule de ce tableau
:digit\_four: À droite de la page, descendez jusqu'au pavé "Insérer des données" et ouvrez la section "Document"
:digit\_five: Cliquez sur le bouton "Récapitulatif des lots", qui fera apparaître le tag @recaptulatifLots
Le récapitulatif sera étendu sur toute la largeur du document, ce qui n'est pas très joli. Pour modifier la largeur de ce tableau à 1 cellule :
:digit\_six: Cliquez avec le bouton droit de votre souris **sur le tableau**, et sélectionnez "Propriétés du tableau"
:digit\_seven: Modifiez la largeur du tableau, par exemple 50%, pour qu'il n'occupe que la moitié de la page :
:digit\_eight: Enregistrez
:point\_right: **Voici un exemple de rendu :**
