Table des Matières

  1. Introduction

  2. Comprendre comment Dolibarr gère la génération de PDF

  3. La nature temporaire des fichiers PDF dans Dolibarr

  4. Où sont stockés les PDF (et pendant combien de temps) ?

  5. Idées fausses courantes sur la sauvegarde de documents

  6. Génération de fichiers vs. stockage de fichiers dans Dolibarr

  7. Comportement du module : factures, commandes, propositions, etc.

  8. Paramètres de configuration affectant la gestion des PDF

  9. Considérations relatives aux autorisations et à l'environnement du serveur

  10. Que se passe-t-il lorsque vous régénérez un PDF ?

  11. Comment enregistrer et archiver automatiquement des PDF

  12. Suivi des fichiers PDF générés pour des raisons juridiques ou d'audit

  13. Utilisation de référentiels de fichiers externes (Dropbox, Nextcloud, FTP)

  14. Solution de contournement : copie automatique des fichiers PDF

  15. Bonnes pratiques de conservation des documents dans Dolibarr

  16. Éviter la perte de données à partir de fichiers temporaires

  17. Comment les modules personnalisés gèrent l'enregistrement des PDF

  18. Différences de comportement entre Dolibarr hébergé et auto-hébergé

  19. Quand demander l'aide d'un développeur

  20. Conclusion : Gérer les fichiers PDF dans Dolibarr en toute confiance

1. Introduction

Dolibarr est une solution ERP et CRM robuste conçue pour les petites et moyennes entreprises. Parmi ses nombreuses fonctionnalités, on trouve la possibilité de générer des documents PDF tels que des factures, des devis, des bons de livraison, etc. Cependant, une question fréquente des nouveaux utilisateurs est : « Pourquoi Dolibarr n'enregistre-t-il pas les documents PDF générés par défaut ? »

Cet article explore en profondeur l'architecture, la logique et les bonnes pratiques de gestion des documents PDF dans Dolibarr. Comprendre cela vous aidera à mieux gérer vos fichiers, à éviter les pertes de données et à adapter votre système aux besoins de votre entreprise.

2. Comprendre comment Dolibarr gère la génération de PDF

Dolibarr n'utilise pas de PDF préenregistrés par défaut. Il génère des documents à la demande. Lorsqu'un utilisateur clique pour afficher ou télécharger un PDF, Dolibarr le crée dynamiquement à partir des données de sa base de données et d'un modèle prédéfini.

Cette approche garantit que :

  • Le PDF reflète les données les plus récentes

  • Aucun espace disque n'est gaspillé sur des fichiers obsolètes ou inutilisés

  • Les modèles et les mises en page peuvent être mis à jour sans avoir besoin de régénérer tous les fichiers existants

3. La nature temporaire des fichiers PDF dans Dolibarr

Par défaut, Dolibarr enregistre les fichiers PDF de manière temporaire. Le système les stocke dans le dossier /documents/ répertoire, souvent sous une structure comme /documents/facture/, /documents/propal/, ou /documents/commande/.

Cependant, si le fichier existe déjà, Dolibarr peut l'écraser, sauf configuration contraire. Si vous régénérez un document, Dolibarr le recrée avec les données les plus récentes.

4. Où sont stockés les PDF (et pendant combien de temps) ?

Dolibarr organise les fichiers par module :

  • Factures: /documents/facture/REF/

  • Ordres: /documents/commande/REF/

  • Les propositions: /documents/propal/REF/

Ces dossiers contiennent des fichiers PDF téléchargés ou générés explicitement. Cependant, si vous n'avez jamais cliqué pour générer un PDF, il est possible qu'il n'existe pas sur le disque.

Les PDF restent enregistrés, sauf s'ils sont supprimés manuellement ou supprimés par un nettoyage du système. Il n'y a pas d'expiration automatique, mais la régénération écrasera les fichiers, sauf si le contrôle de version des fichiers est utilisé.

5. Idées fausses courantes sur la sauvegarde de documents

Les utilisateurs supposent souvent :

  • Les PDF sont automatiquement enregistrés après validation — ils ne sont pas

  • Toutes les actions créent des fichiers sur le disque — seule la génération de documents le fait

  • Les fichiers PDF sont stockés de manière permanente, uniquement s'ils sont conservés manuellement

Comprendre que la génération de PDF est distincte du stockage est essentiel pour gérer les documents dans Dolibarr.

6. Génération de fichiers vs. Stockage de fichiers dans Dolibarr

Voici comment fonctionne généralement Dolibarr :

  • Un document (par exemple, une facture) est créé et validé

  • Aucun fichier n'est enregistré à ce stade

  • L'utilisateur clique sur « Générer un PDF »

  • Dolibarr construit le fichier à l'aide du modèle et l'enregistre dans le répertoire approprié

  • Le fichier reste jusqu'à ce qu'il soit supprimé ou écrasé

Cette séparation offre de la flexibilité mais nécessite une certaine vigilance pour éviter de manquer des fichiers ultérieurement.

7. Comportement du module : factures, commandes, propositions, etc.

Chaque module gère les documents légèrement différemment :

  • Factures:Les PDF sont créés uniquement lorsque vous cliquez dessus ; ils peuvent être régénérés à tout moment

  • Commandes:La même logique s'applique

  • Propositions:Peut inclure un filigrane et un statut facultatifs

Il est recommandé de générer et d'enregistrer des fichiers PDF après validation afin de conserver une trace du document au moment de sa finalisation.

8. Paramètres de configuration affectant la gestion des PDF

Vous pouvez configurer certains comportements :

  • Allez dans Configuration > Modules > Modèles PDF

  • Définir des modèles par défaut et activer la génération automatique (dans des modules limités)

  • Utilisez les paramètres du chemin du répertoire de documents sous Configuration > Autre configuration si vous personnalisez la structure du fichier

Ces paramètres influencent où et comment les PDF sont générés et stockés.

9. Considérations relatives aux autorisations et à l'environnement du serveur

Dolibarr doit avoir des droits d'écriture sur le /documents/ dossier. Si les autorisations sont mal configurées :

  • Les fichiers PDF ne peuvent pas être enregistrés

  • La génération de fichiers peut échouer silencieusement

Assurez-vous que votre utilisateur Apache/Nginx dispose d'un accès correct et que votre environnement serveur (en particulier dans l'hébergement partagé) prend en charge l'écriture de fichiers.

10. Que se passe-t-il lorsque vous régénérez un PDF ?

Lorsque vous régénérez un document :

  • L'ancien fichier est écrasé (si le nom du fichier est le même)

  • Le contenu est mis à jour pour refléter les données actuelles

Cela est utile pour corriger les données, mais problématique si vous devez conserver la version originale à des fins juridiques ou d'audit.

11. Comment enregistrer et archiver automatiquement des PDF

Options de sauvegarde automatique :

  • Utiliser une tâche cron pour déclencher la génération de PDF après validation

  • Ajoutez un module ou un hook pour générer et verrouiller automatiquement les PDF

  • Déplacer les fichiers PDF vers un répertoire d'archives via un script

Cela garantit que chaque document validé est également conservé dans son état d'origine.

12. Suivi des PDF générés pour des raisons juridiques ou d'audit

Pour garantir la préparation à l’audit :

  • Générer des PDF au moment de la validation du document

  • Déplacer ou copier les fichiers vers une archive en lecture seule

  • Utilisez le contrôle de version (par exemple, facture-2025-01-V1.pdf) pour éviter les écrasements

Cela est particulièrement important dans les pays ayant des exigences strictes en matière de facturation électronique ou d’archivage de la TVA.

13. Utilisation de référentiels de fichiers externes (Dropbox, Nextcloud, FTP)

Dolibarr peut s'intégrer avec un stockage externe :

  • Utiliser des modules pour synchroniser /documents/ aux services cloud

  • Automatiser la sauvegarde des fichiers PDF sur FTP ou SFTP

  • Implémenter WebDAV ou des dossiers partagés pour l'accès en équipe

Cela améliore la sécurité et la disponibilité des documents.

14. Solution de contournement : Copie automatique des fichiers PDF

Utilisez un script (bash, Python, etc.) pour surveiller le /documents/ répertoire et :

  • Détecter les nouveaux fichiers

  • Copiez-les vers un autre emplacement

  • Renommez-les pour les archiver

Définissez ce script comme une tâche cron à exécuter toutes les heures ou tous les jours.

15. Bonnes pratiques de conservation des documents dans Dolibarr

  • Générer toujours des PDF après validation du document

  • Utiliser des conventions de nommage pour le suivi des versions

  • Maintenir une sauvegarde séparée en dehors du serveur Dolibarr

  • Former les utilisateurs sur quand et comment générer des PDF

16. Éviter la perte de données à partir de fichiers temporaires

Si un PDF n'a jamais été généré ou enregistré :

  • On ne peut pas le récupérer dans l'histoire

  • Vous devrez le régénérer, ce qui peut ne plus refléter les données d'origine.

Protégez-vous contre cela en appliquant des politiques de génération au moment de l’approbation du document.

17. Comment les modules personnalisés gèrent l'enregistrement des PDF

Certaines extensions Dolibarr ajoutent des fonctionnalités de sauvegarde automatique ou de journalisation PDF. Ces modules peuvent :

  • Générer automatiquement des PDF lors de déclencheurs d'événements

  • Enregistrer quand un PDF a été créé et par qui

  • Enregistrer les sauvegardes sur des systèmes externes

Choisissez des modules réputés de Dolistore ou travaillez avec un développeur pour ajouter cette fonctionnalité.

18. Différences de comportement entre Dolibarr hébergé et auto-hébergé

Versions Dolibarr hébergées (par exemple, fournisseurs SaaS) :

  • Peut limiter l'accès au système de fichiers

  • Peut nettoyer automatiquement les anciens fichiers

  • Un ticket d'assistance est souvent requis pour les téléchargements en masse

Les installations auto-hébergées offrent davantage de contrôle sur le stockage des documents, les scripts et les sauvegardes.

19. Quand demander l'aide d'un développeur

Contactez un intégrateur Dolibarr si :

  • Vous avez besoin d'un archivage automatique

  • Vous souhaitez intégrer le stockage cloud

  • Vous avez des exigences de versionnage PDF spécifiques à l'audit

Des scripts ou des modules personnalisés peuvent combler efficacement ces lacunes.

20. Conclusion : Gérer ses fichiers PDF dans Dolibarr en toute confiance

L'approche de Dolibarr en matière de génération de PDF privilégie la flexibilité et l'efficacité, mais confie la responsabilité de l'enregistrement et de l'archivage des documents à l'utilisateur. Une fois que vous aurez compris comment les PDF sont générés, où ils sont stockés et comment contrôler le processus, vous pourrez garantir la conformité, minimiser les pertes de données et rationaliser vos flux de travail.

Que ce soit via des outils intégrés, des scripts intelligents ou un stockage externe, Dolibarr offre tout ce dont vous avez besoin pour gérer vos documents, si vous savez comment le configurer correctement.