Créer des devis professionnels, personnalisés et adaptés à votre image est essentiel pour toute entreprise. Cela reflète l’identité de votre marque et renforce la clarté de votre communication avec vos clients. Si vous utilisez Dolibarr ERP & CRM pour gérer vos opérations, vous avez accès à un système de génération de devis puissant — mais les modèles proposés par défaut ne répondent pas toujours à vos attentes visuelles ou fonctionnelles.

La bonne nouvelle, c’est que Dolibarr permet de créer des modèles de devis entièrement personnalisés, adaptés à vos besoins spécifiques.

Cet article vous propose un guide complet pour créer un devis personnalisé dans Dolibarr, incluant :

• Une explication claire du fonctionnement des devis dans Dolibarr

• La structure des modèles PDF et leur intégration dans le système

• Un tutoriel étape par étape pour créer et activer un modèle personnalisé

• Comment modifier la mise en page, ajouter un logo ou insérer des champs personnalisés

• Les erreurs à éviter

• Des conseils pour maintenir vos modèles après les mises à jour

Que vous soyez développeur, freelance ou gestionnaire d’entreprise, ce guide vous accompagne de A à Z — sans supposer de connaissances techniques avancées.

Comprendre comment fonctionnent les devis dans Dolibarr

Dans Dolibarr, les devis (aussi appelés "propositions commerciales") sont créés dans le module Commercial. Vous les générez via l’interface utilisateur en saisissant les données : client, produits/services, prix, TVA, etc.

Dolibarr enregistre ces informations dans la base de données, mais le document PDF généré provient d’un fichier PHP qui contrôle la mise en page.

Voici le processus de base :

1. L’utilisateur crée un devis via l’interface

2. Dolibarr utilise un fichier modèle PHP pour générer le PDF

3. Le modèle extrait les données de la base et les met en forme avec des instructions FPDF

Dolibarr propose plusieurs modèles par défaut (comme crabe, azur, einstein), mais ils sont souvent génériques. C’est pourquoi la personnalisation de vos modèles est si précieuse.

Pourquoi créer un modèle de devis personnalisé ?

Les modèles standards sont fonctionnels mais limités :

• Branding (logo, couleurs, polices)

• Mise en page (ordonnancement des colonnes, en-têtes/pieds)

• Conformité locale (langues, mentions légales, normes fiscales)

• Données personnalisées (code projet, référence interne, etc.)

Créer un modèle personnalisé vous permet de :

• Renforcer votre image de marque

• Afficher des informations spécifiques à vos processus

• Traduire le document selon vos marchés

• Uniformiser votre communication commerciale

Étape 1 : Préparer votre environnement de travail

Avant toute modification, vous devez accéder aux fichiers Dolibarr. Cela suppose :

• Accès à votre serveur ou installation locale

• Possibilité d’éditer des fichiers PHP

• Connaissance du chemin d’installation (par exemple : /var/www/html/dolibarr/)

Les modèles de devis se trouvent dans :

⚠️ Ne modifiez jamais les modèles de base directement. Créez toujours une copie pour éviter d’écraser vos changements lors d’une mise à jour.

Étape 2 : Copier et renommer un modèle existant

1. Rendez-vous dans le dossier htdocs/core/modules/propale/doc/

2. Choisissez un modèle à copier (ex. pdf_crabe.modules.php)

3. Faites une copie et nommez-la pdf_monentreprise.modules.php

4. Dans le fichier, changez le nom de la classe :

en :

5. Mettez à jour les références internes :

6. Enregistrez.

Étape 3 : Activer le modèle personnalisé dans Dolibarr

1. Connectez-vous à Dolibarr

2. Allez dans Accueil > Modules > Propositions commerciales

3. Cliquez sur Configurer

4. Dans la section Modèles disponibles pour la génération PDF, trouvez monentreprise

5. Cliquez sur Activer

6. (Optionnel) Définissez-le comme modèle par défaut

Étape 4 : Personnaliser la mise en page

Le fichier est un script PHP utilisant les fonctions de la librairie FPDF. Les sections principales :

a) En-tête

• Position du logo

• Nom du document (Devis, Offre, etc.)

• Coordonnées de votre société

b) Bloc client

• Nom, adresse, numéro TVA du client

c) Tableau des produits/services

• Colonnes à afficher (description, quantité, prix, etc.)

• Ordre et largeur des colonnes

• Format de la devise

d) Totaux

• Libellés personnalisés ("Total HT", "TVA", etc.)

• Règles d’arrondi

• Remises, frais, etc.

e) Pied de page

• Modalités de paiement

• Coordonnées bancaires

• Mentions légales

• Signature ou disclaimer

Étape 5 : Ajouter des champs personnalisés

Si vous avez activé des champs extra (via ExtraFields), vous pouvez les insérer dans le PDF.

Exemple : champ personnalisé code_projet :

N’oubliez pas de vérifier si le champ est vide avant de l’afficher.

Étape 6 : Tester votre modèle

1. Créez un devis ou ouvrez-en un existant

2. Cliquez sur Générer PDF

3. Choisissez votre modèle personnalisé

4. Vérifiez l’affichage : contenu, marges, alignements, totaux

Corrigez dans le code ce qui ne s’affiche pas correctement.

Étape 7 : Assurer la compatibilité avec les mises à jour

• Ne touchez jamais aux fichiers du noyau

• Utilisez un système de versioning (ex. Git)

• Après chaque mise à jour de Dolibarr, comparez les évolutions des fichiers de base avec votre modèle

Conseils avancés

A) Ajouter une image ou un filigrane

B) Affichage conditionnel

C) Multilingue

Utilisez les fonctions de traduction :

Erreurs fréquentes à éviter

• Modifier un fichier système par défaut

• Ne pas renommer correctement la classe PHP

• Oublier d’activer le modèle dans l’interface

• Utiliser des valeurs fixes au lieu de champs dynamiques

• Négliger l’alignement ou les débordements de texte

Quand utiliser un module au lieu d’un modèle

Si vous avez besoin de :

• Logique avancée

• Connexions à des API

• Interfaces de personnalisation visuelle

…alors il vaut mieux créer un module Dolibarr plutôt qu’un simple modèle PDF.

Conclusion

Créer un modèle de devis personnalisé dans Dolibarr vous permet de :

• Valoriser votre image de marque

• Afficher des données spécifiques à votre entreprise

• Offrir à vos clients des documents clairs et cohérents

• Gagner du temps et éviter les retouches manuelles

Ce guide vous donne les clés pour créer, adapter et maintenir vos modèles dans la durée. Avec un peu de rigueur, vos devis Dolibarr deviendront de véritables outils professionnels, esthétiques et efficaces.