DPersoPlus – Documents Personnalisés +

1. Présentation

DPersoPlus (Documents Personnalisés +) fournit une gamme de modèles PDF pour Dolibarr et une page de réglages complète pour les mettre à vos couleurs, sans aucune modification du cœur de Dolibarr.

• Mise en forme : couleurs des titres, cadres, textes et totaux, angles arrondis, épaisseur des cadres, largeur des colonnes, trait entre les lignes.
• Logos : logo au format SVG (net à toutes les tailles), hauteur réglable sur la première page et les suivantes, logo en bas à droite (ex. label RGE), logo de la banque près du RIB.
• Conditions générales : CGV, CGL (location) et CGA (achats) ajoutées automatiquement en fin de PDF, dans la langue du tiers.
• Mentions et cas particuliers : duplicata, filigranes, mentions de TVA export, TVA suisse, RGE, Chorus, catégorie d’opérations, rédacteur et commercial principal, adresse e-mail propre à chaque type de document.
• Modèles spécialisés : proforma, proposition sans total, location, bon de livraison avec reliquats, étiquette de transport, mandat SEPA, note de frais avec justificatifs, rapports de projet…

Documents pris en charge

Clients	Fournisseurs et autres
Propositions commerciales (dont location)	Demandes de prix fournisseurs
Commandes clients et proformas	Commandes fournisseurs
Bons de livraison et étiquettes de transport	Notes de frais
Factures clients (dont Chorus)	Projets (rapport, temps passé, objets liés)
Contrats	Fiches produits, mandats SEPA, remises de chèques

Le détail des modèles figure en section 5.1.

2. Prérequis et installation

2.1 Prérequis

Élément	Version
Dolibarr	19.0 à 24.0
PHP	7.4 à 8.3
Framework NSINFO (module « NSINFO », gratuit)	Installé et activé

Le framework NSINFO est obligatoire : il fournit les pages de réglages, le ChangeLog et l’onglet À propos du module. Voir la page framework NSINFO.

2.2 Installation

1. Installer et activer le module NSINFO.
2. Depuis Accueil > Configuration > Modules/Applications > Déployer/Installer un module externe, envoyer l’archive module_dpersoplus-X.Y.Z.zip (voir installer un module).
3. Dans la liste des modules, famille NSINFO, activer « Documents Personnalisés + ».
4. Ouvrir la configuration (roue crantée du module) et régler couleurs et logos.
5. Dans la configuration de chaque module de Dolibarr (Propositions commerciales, Commandes, Factures…), activer les modèles PDF voulus et choisir le modèle par défaut (voir Utilisation).

À l’activation, le module enregistre des valeurs par défaut pour ses options (couleurs neutres, largeurs de colonnes, noms des modèles…) et crée sur les tiers deux champs complémentaires utilisés par les options TVA suisse et Autoliquidation.

2.3 Mise à jour / réactivation

Après une mise à jour du module, ou après avoir renommé un modèle PDF dans les réglages, désactiver puis réactiver le module : c’est cette opération qui enregistre les modèles et les extensions du module dans Dolibarr. Les réglages sont conservés.

3. Configuration générale

Page de réglages : Configuration > Modules, roue crantée du module (voir activation et paramètres). Réservée aux administrateurs. Les onglets sont : Réglages, Logo, Haut de page, Bas de page, CGV, CGL (si le module Location est activé), CGA, Documents PDF, Cadres supplémentaires PDF, Banque / Multi-devise, Divers, ChangeLog et À propos.

Les couleurs se choisissent avec un sélecteur de couleur ; le bouton « Valeur par défaut » d’une option remet sa valeur d’origine.

3.1 Réglages

Réglages généraux

Option	Description
Rayon des angles des tableaux et cadres	De 0 (angles vifs) à 5 (angles arrondis).
Couleurs	Texte des lignes de produits / services, titres du tableau des lignes, remplissage des titres, cadres de la zone titre, texte et fond de la zone Total, champs complémentaires imprimés sur une ligne.
Valeur du dégradé (case TVA)	Intensité du dégradé de couleur, de 0 à 1.
Remplissage et gras	Remplir de couleur les titres de colonnes ; titres de colonnes en gras ; zone Total en gras.
Colonne TVA	Masquer la colonne TVA.
Note de TVA export	Texte de la mention d’exonération pour un client dans l’Union européenne, et hors Union européenne.
Documentation produit	Joindre aux propositions la documentation PDF des produits / services.
Projet	Afficher le projet, son libellé, et « réf. – titre » sur la même ligne.

Options

Interrupteurs Proposition & Facturation Suisse (TVA), Proposition & Facturation RGE et Autoliquidation : voir Options particulières.

3.2 Logo

Option	Description
Utiliser l’extension SVG	Utilise le logo SVG téléversé ci-dessous ; sinon, les logos de la société dans Dolibarr.
Hauteur du logo sur la première page	Hauteur du logo en haut de la première page.
Entête réduite à partir de la page 2	Les pages suivantes reçoivent une entête allégée, avec un logo de hauteur réglable.
Gestion du logo	Téléversement du logo au format SVG (un seul fichier).

Sous-onglet Bas Droite : logo placé en bas à droite des documents (par exemple le label RGE), au format SVG ou PNG, avec sa hauteur.

3.3 Haut de page

Sous-onglet	Options
Générales	Couleur du titre du document et des textes fixes ; titre et numéro sur la même ligne ; date de proposition et de validité sur la même ligne ; masquer le code client / fournisseur ; afficher le rédacteur ; masquer les libellés « Émetteur » et « Adressé à » ; épaisseur du cadre ; position de l’émetteur à droite du cadre et décalage vertical du bloc expéditeur / destinataire.
Expéditeur	Couleurs du nom et des informations de la société, du cadre et du fond ; cadre tracé ou rempli ; masquer le pays, le téléphone / fax, l’e-mail ou le site web ; afficher le commercial principal du client, choisi dans un champ complémentaire des tiers.
Destinataire	Couleurs du nom, de l’adresse, du cadre et du fond ; cadre tracé ou rempli ; masquer le pays.

3.4 Bas de page

• Générales : hauteur du tableau des totaux.
• Pied de page : détails affichés (aucun, informations de la société, gérants, ou les deux) ; puis choix des éléments : nom, adresse, téléphone / fax, site web, e-mail de la société ; et une information libre.

Chaque type de document dispose en plus d’un texte libre de bas de page (onglet Documents PDF).

3.5 Banque / Multi-devise

• N’afficher que le BIC / IBAN (sans le numéro de compte).
• Afficher la banque par défaut selon la devise du document.
• Utiliser la banque du tiers.
• Logo de la banque près du RIB : fichier logo.png ou logo.svg joint au compte bancaire dans Dolibarr (hauteur réglable pour le SVG).
• Mandat SEPA : nom du modèle et texte légal imprimé sur le mandat ; lien vers les paramètres SEPA du module Banque.

3.6 Divers

Les options de cet onglet sont des réglages généraux de Dolibarr regroupés ici par commodité : elles s’appliquent à toute l’installation, y compris aux modèles PDF qui ne viennent pas du module.

• Logos : hauteur du logo des documents.
• PDF : trait entre les produits et sa couleur ; espace supplémentaire entre les lignes ; enlever le titre des colonnes ; transférer la référence client de la proposition dans la commande ; cacher la colonne référence produit ; données principales sur la page précédente ; nombre de décimales du prix unitaire HT.
• Autres : index kilométriques par type de véhicule ; nombre maximal d’onglets visibles sur les fiches ; correcteur orthographique ; interdire les lignes libres dans les documents.

4. Conditions générales (CGV, CGL, CGA)

Les conditions générales sont des fichiers PDF ajoutés automatiquement à la fin des documents générés. Chaque onglet comporte deux sous-onglets : Réglages (documents concernés) et Fichier (téléversement d’un PDF par langue).

Onglet	Documents concernés	Options
CGV (ventes)	Propositions, commandes (ou accusés de réception de commande), bons de livraison avec reliquats, factures.	Bas de page sur les pages de CGV ; case à cocher de prise de connaissance des CGV, avec son texte (défaut : « Je reconnais avoir pris connaissance des CGV »).
CGL (location, si le module Location est activé)	Propositions, factures.	Bas de page sur les pages de CGL.
CGA (achats)	Demandes de prix, commandes fournisseurs.	—

• Un fichier par langue : le PDF imprimé est celui de la langue du document (langue du tiers). Si cette langue n’a pas de fichier, la langue par défaut choisie dans le sous-onglet Fichier est utilisée.
• Sur les factures, la case « Sans CGV » du formulaire de génération permet d’imprimer exceptionnellement une facture sans ses CGV. Cette case n’apparaît que si les CGV sont ajoutées aux factures et si l’option « sans CGV » est activée dans l’onglet Documents PDF > Facture.

5. Modèles PDF

5.1 Liste des modèles

Noms par défaut, tels qu’affichés dans la liste des modèles de Dolibarr. Chaque nom peut être modifié dans l’onglet Documents PDF (puis réactiver le module).

Document	Modèle	Particularités
Proposition commerciale	Propal Dpp	Modèle complet : tableau de TVA par taux, cadre de signature du client, CGV / CGL, mentions TVA suisse et RGE, filigrane brouillon.
	Propal Sans Total Dpp	Même présentation, sans le tableau des totaux.
	Propal Proforma Dpp	Proposition présentée comme une facture proforma.
	Proposition Location Dpp	Module Location : colonne durée, coefficient de location, bloc de caution, CGL et CGV.
Commande client	Commande Dpp	Modèle complet, CGV de commande, cadres supplémentaires.
	Proforma Dpp	Facture proforma établie depuis la commande.
Expédition	BL Reliquat Dpp	Quantités commandée, déjà livrée, livrée et reliquat ; lots / séries ; contenu des kits ; CGV ; cadre de signature.
	BL Classic	Bon de livraison sans gestion des reliquats : poids, volume, bloc « Reçu à / Le » et signature, code-barres de la référence (si activé dans Dolibarr).
	BL Proforma	Bon de livraison valorisé : quantités commandée et livrée, prix, sous-totaux.
	Etiquette Dpp	Étiquette de transport A5 sur papier A4 : expéditeur, destinataire, référence de commande.
Facture client	Facture Dpp	Modèle complet : QR code de paiement (selon la configuration de Dolibarr), duplicata, filigranes, CGV / CGL, mentions TVA suisse et RGE, catégorie d’opérations.
	Chorus Dpp	Facture pour Chorus Pro : numéro d’engagement (tiré de la référence client), SIRET du client.
Contrat	Contrat Dpp	Modèle de contrat aux couleurs du module.
Demande de prix fournisseur	Demande de prix Dpp	CGA de demande de prix.
Commande fournisseur	Commande fournisseur Dpp	Référence fournisseur (masquable), CGA de bon de commande.
Note de frais	Note de frais Dpp	Les justificatifs joints (PDF et images JPG / PNG) sont ajoutés à la fin du document.
Projet	Rapport projet Dpp	Rapport des tâches du projet.
	Temps passé Dpp	Rapport du temps passé.
	Objets liés Dpp	Aperçu des objets liés au projet.
Produit	Fiche produit Dpp	Fiche produit : poids, volume, fournisseurs.
Compte bancaire	sepamandat	Mandat de prélèvement SEPA avec texte légal et signature.
Remise de chèques	Remise Chèque	Bordereau de remise de chèques.

Avec le module Ouvrage (Inovéa Conseil), des modèles « Ouvrage » de proposition et de facture regroupent les lignes par ouvrage.

5.2 Réglages communs (onglet Documents PDF)

• Supprimer la colonne TVA sur tous les documents ; libellés des produits en gras.
• SIREN du client sous son adresse, ou sous son numéro de TVA intracommunautaire.
• Position de la signature manuscrite en ligne sur le PDF.
• Cacher le libellé des produits / services dans les documents fournisseurs.
• Décalage vertical du bandeau TVA et Total, pour les propositions et pour les factures.
• Cadre de signature des propositions et bons de livraison : couleur du cadre, du texte, hauteur.
• Avec l’entête réduite à partir de la page 2 : référence et date sur une ligne.

5.3 Largeur des colonnes

Sous-onglet Colonne : largeur en millimètres des colonnes Référence (25), TVA (16), PU HT (19), Quantité (16), Unité (11), Remise (13), Total HT (26) et Total TTC (26).

5.4 Propositions

• Noms des modèles standard, sans total et proforma.
• Afficher la référence de la commande quand elle a été créée.
• Date de proposition et date de validité sur la même ligne.
• Rédacteur (nom, prénom, téléphone, e-mail) dans le cadre expéditeur ; adresse e-mail propre aux propositions.
• Décalage du bas de page en cas de ligne supplémentaire ; texte libre de bas de page.
• Avec le module Propale-Historique (ATM) : numéro de version de la proposition.
• Sous-onglet Proposition location (module Location) : libellés « Émetteur » / « Locataire » masquables, adresse e-mail, libellé de l’adresse de livraison, hauteur des cadres, texte de bas de page.

5.5 Commandes

• Noms des modèles commande et proforma.
• Forcer l’affichage de la référence produit, ou la placer dans la ligne de description.
• Texte libre de bas de page.

5.6 Bons de livraison

• Noms des modèles BL reliquat, BL classic, étiquette de transport et BL proforma valorisé.
• Masquer les services, la colonne poids / volume, les descriptions longues, les lots / séries, la référence produit.
• Cadre de signature ; colonne « Quantité déjà livrée » ; champs complémentaires imprimables sous le libellé.
• Contenu des kits (si les sous-produits sont utilisés).
• Adresse e-mail propre aux bons de livraison ; texte libre de bas de page.

5.7 Factures

Groupe	Options
Options	Case Duplicata à la génération d’une facture clôturée ; case Sans CGV ; remplacer « Acompte » par la référence et la date de la facture d’acompte ; référence et date du devis initial ; nombre total de colis en bas de page ; préfixe et suffixe du nom du fichier PDF ; date du transfert dans Dolibarr (les factures antérieures sont automatiquement imprimées en duplicata).
Filigrane et textes	Libellé du duplicata ; filigranes « Brouillon », « À payer », « Payée » ; libellés avant et après la référence du devis.
Cas particuliers	Mention « catégorie d’opérations » (non, sous le bloc d’adresses, ou en bas à gauche) ; adresse de livraison ; option de paiement de la taxe d’après les débits ; adresse e-mail propre aux factures.
Chorus	Libellé de la référence client (défaut : « Numéro engagement CHORUS »).
Zone expéditeur	Deux zones de texte complémentaires (ex. numéro d’assurance, agrément) ; texte libre de bas de page.

5.8 Fournisseurs

• Noms des modèles commande fournisseur et demande de prix.
• Commande : cacher la colonne référence fournisseur ; supprimer la mise en forme des libellés produits ; adresse e-mail propre.
• Demande de prix : options équivalentes.

5.9 Autres documents

• Note de frais : nom du modèle ; masquer la colonne du numéro de ligne.
• Autres : noms des modèles fiche produit, contrat, objets liés, rapport projet et temps passé.
• Ouvrage (module Ouvrage) : noms des modèles de proposition et de facture.

6. Options particulières

6.1 TVA suisse

Interrupteur Proposition & Facturation Suisse (TVA) (onglet Réglages). Il ajoute sur la fiche des tiers le champ « Société soumise à la gestion TVA Suisse » et le sous-onglet Facture Suisse (Documents PDF) : représentant fiscal (choisi parmi les tiers) et numéro de TVA suisse, imprimés sur les propositions et factures des tiers concernés.

6.2 RGE

Interrupteur Proposition & Facturation RGE. Sous-onglet RGE : hauteur du bas de page, largeur du logo, couleur du trait et numéro de certificat. Le logo RGE se téléverse dans l’onglet Logo > Bas Droite.

6.3 Autoliquidation

Interrupteur Autoliquidation. Il ajoute une case sur la fiche des tiers et, dans l’onglet Documents PDF, le libellé de la mention.

Dans cette version, la mention d’autoliquidation n’est pas encore imprimée par les modèles PDF.

6.4 Factures d’abonnement

Sous-onglet Abonnement : produit ou service qui indique la période facturée, couleur et mise en gras du texte de la période.

6.5 Cadres supplémentaires

Onglet Cadres supplémentaires PDF : ajoute des cadres d’adresse de livraison et de facturation sur les propositions, commandes, expéditions et factures, avec la hauteur de la zone d’adresse.

7. Droits d’accès

Le module ne crée aucune permission ni entrée de menu.

• La configuration est réservée aux administrateurs.
• La génération des PDF suit les droits habituels de Dolibarr sur chaque document (lire, créer / modifier).

8. Utilisation

1. Dans la configuration du module Dolibarr concerné (ex. Configuration > Modules > Propositions commerciales), activer le modèle DPersoPlus et, si vous le souhaitez, le définir comme modèle par défaut.
2. Sur la fiche du document, choisir le modèle dans la liste et cliquer sur Générer.
3. Le PDF reprend les couleurs, logos, mentions et conditions générales réglés dans le module.

• Factures : selon les options, le formulaire de génération propose les cases Duplicata (facture clôturée) et Sans CGV (si les CGV sont ajoutées aux factures).
• Liste des fichiers joints : une icône loupe permet d’afficher l’aperçu des fichiers.

9. Modules compatibles

Module	Prise en charge
Sous-total (ATM, Iouston)	Compatible ; sous-totaux imprimés notamment sur le bon de livraison valorisé (BL Proforma).
Propale-Historique (ATM)	Numéro de version de la proposition.
Ouvrage (Inovéa Conseil)	Modèles « Ouvrage » de proposition et de facture.
Location	Modèle de proposition location et conditions générales de location.
Multi-société	Conditions générales par société.

10. Limites connues et FAQ

Un modèle n’apparaît pas dans la liste des modèles.

• Activer le modèle dans la configuration du module Dolibarr concerné.
• Après une mise à jour ou un changement de nom de modèle, désactiver puis réactiver le module.
• Les modèles de location, d’ouvrage et les onglets associés n’apparaissent que si le module correspondant est activé.

Les CGV ne sont pas ajoutées au PDF.

• Vérifier que le document est coché dans l’onglet CGV > Réglages.
• Vérifier qu’un fichier PDF existe pour la langue du tiers, ou qu’une langue par défaut est définie.
• Facture : vérifier que la case « Sans CGV » n’était pas cochée à la génération.

Le logo SVG ne s’affiche pas.

Activer « Utiliser l’extension SVG » dans l’onglet Logo et téléverser le fichier SVG. Sinon, ce sont les logos de la société définis dans Dolibarr qui sont utilisés.

Une option de l’onglet Divers modifie un modèle qui n’est pas du module.

C’est normal : ces options sont des réglages généraux de Dolibarr (voir 3.6).

Les adresses e-mail réglées par document servent-elles à l’envoi des e-mails ?

Non : elles sont seulement imprimées sur le PDF, à la place de l’e-mail de la société. L’envoi des e-mails reste géré par Dolibarr.

Autres limites

• Le module ne fait pas de signature électronique : il imprime un cadre de signature et peut placer la signature manuscrite saisie en ligne dans Dolibarr.
• Les PDF déjà générés ne sont pas modifiés : régénérer le document pour appliquer de nouveaux réglages.
• La mention d’autoliquidation n’est pas encore imprimée (voir 6.3).

Une question ? Assistance NSINFO au 03 70 999 730 ou sur la page Assistance.