(Version 1.0 – 2025)
Objectif : Découvrir comment configurer, automatiser et optimiser l’archivage des documents comptables et administratifs dans Dolibarr afin de supporter la croissance de votre structure (PME, association, micro‑entreprise) tout en respectant les exigences légales.
1. Pourquoi l’archivage est-il essentiel pour passer à l’échelle ?
| Besoin | Conséquence si non anticipé | Bénéfice d’une solution d’archivage intégrée |
|---|---|---|
| Croissance du volume de dossiers (clients, fournisseurs, factures, devis) | Difficulté de recherche, perte de conformité juridique, lenteurs opérationnelles | Accès structuré, recherche instantanée, traçabilité totale |
| Multiplication des sites / filiales | Duplication des données, incohérence des référentiels | Centralisation des archives, repliement multi‑site |
| Alignement avec les exigences légales (ex. : RGPD, archivage immuable 6 ans) | Risques d’amendes, perte de crédibilité | Conformité intégrée, archivage sécurisé et historique |
| Besoin d’automatiser les processus | Surcharge manuelle, erreurs humaines | Workflow automatisé, réduction du temps de traitement |
2. Vue d’ensemble de Dolibarr et de ses capacités d’archivage
| Fonctionnalité | Description | Où la trouver dans Dolibarr | ||
|---|---|---|---|---|
| Fichiers joints à chaque objet (clients, fournisseurs, devis, factures) | Vous pouvez déposer des PDF, images, scans, contrats, etc. directement sur les enregistrements. | Onglet “Documents” dans la fiche client/fournisseur ou dans la carte de comptes. | ||
| Documents : stockage centralisé | Un répertoire virtuel dédié (souvent sous files/) qui regroupe tous les fichiers, avec droit d’accès par rôle. | Menu Paramètres → Général → Répertoire de fichiers. | ||
| Gestion des types de documents | Créez des catégories (ex. Facture | Devis | Contrat) pour classer automatiquement les fichiers. | Paramètres → Types de documents. |
| Règles de rétention | Définissez automatiquement la durée de conservation d’un document et sa suppression ou archivage. | Paramètres → Archivage → Règles de rétention. | ||
| Export/Import XML/CSV | Permet de transférer les archives vers d’autres systèmes ou de les envoyer à des partenaires. | Outils → Export/Import. | ||
| Intégration avec le module “Archivage externe” | Connectez Dolibarr à un serveur de documents tiers (SharePoint, Nextcloud, Alfresco) pour profiter d’un stockage dédié ou d’un archivage immuable. | Extensions → Archivage externe. |
Tip : Depuis la version 20.0 (released 2024‑09), Dolibarr propose l’archive immutable via l’API « Object Store ». Vous pouvez le configurer pour que les fichiers soient stockés sur un bucket S3‑compatible (ex. MinIO, Wasabi) avec verrouillage juridique.
3. Étapes de mise en place pas à pas
3.1 Préparer l’environnement
| Action | Commande / CLI | Vérification |
|---|---|---|
| Créer le répertoire de fichiers | mkdir -p /var/www/dolibarr/files chown -R www-data:www-data /var/www/dolibarr/files |
ls -l /var/www/dolibarr/files |
| Configurer le stockage partagé | Dans Paramètres → Général, pointer vers le chemin ci‑dessus ou vers un mount NFS/SA3. | |
| Déployer un serveur S3‑compatible (optionnel) | docker run -p 9000:9000 --name minio -e MINIO_ROOT_PASSWORD=admin -e MINIO_ROOTUSER=admin -v minio-data:/data minio/minio server /data --console-address ":9001" |
Accès via http://host:9000 avec login admin/ admin. |
| Configurer les droits DB | Ajout d’un role « archiviste » si vous utilisez PostgreSQL (ex. CREATE ROLE archivist LOGIN PASSWORD 'xxxx';). |
SELECT rolname FROM pg_roles WHERE rolname='archivist'; |
Remarque : Si vous avez déjà un dossier de fichiers, assurez‑vous que l’accès en lecture/écriture est autorisé par le serveur web (Apache/Nginx).
3.2 Activer le module d’archivage dans Dolibarr
- Connexion à l’interface admin → Modules → Rechercher “Archivage”.
- Cocher « Archiver les fichiers » puis « Activer ».
- Aller dans Paramètres → Archivage :
- Chemin du répertoire :
/var/www/dolibarr/files. - Periodicité de nettoyage : laisser vide ou définir un job cron si vous avez besoin de參考.
- Rétention par défaut : 6 ans (conforme à la législation comptable française).
- Chemin du répertoire :
3.3 Définir les Types de documents et Catégories
| Type de document | Exemple de catégorie | Durée de rétention recommandée* |
|---|---|---|
| Facture client | Vente | 6 ans (ou 5 ans selon votre CCN) |
| Facture fournisseur | Achat | 6 ans |
| Devis | Proposition commerciale | 3 ans |
| Contrat cadre | Partenariat | Indéterminé (ou 10 ans selon ancienneté) |
| E‑mail | Courrier | 2 ans (ou selon politique interne) |
* La durée peut être ajustée dans Paramètres → Archivage → Règles de rétention en créant une règle “Facture‑client → 6 ans”.
3.4 Automatiser l’archivage via Cron
Dolibarr utilise le même moteur de tâches que tout serveur PHP : php -f /var/www/dolibarr/cron.php.
# Crontab du web‑user (ex. www-data)
0 * * * * /usr/bin/php /var/www/dolibarr/cron.php >> /var/log/dolibarr-cron.log 2>&1- Cron 1 : Nettoyage des fichiers expirés selon les règles de rétention.
- Cron 2 : Génération de rapports d’audit (optionnel, via module “Reports → Archivage”).
3.5 Intégrer l’archivage immuable (option avancée) 1. Installer le plugin “IMMO‑Archiver” (disponible sur le marketplace Dolibarr).
- Créer un bucket S3 (ex.
archivage-frsur MinIO). - Dans les paramètres du plugin, donner l’URL du bucket et les credentials.
- Définir la règle de réplication :
ObjectLockRetentionMode=GOVERNANCE,RetentionPeriodInDays=2190(6 ans).
Résultat : les scans sont alors locked après 30 jours, impossible à modifier ou supprimer tant que le verrou persiste.
3.6 Vérifier la conformité légale
| Vérification | Action | Commande/Outils |
|---|---|---|
| Traçabilité | Exporter un lot de factures et les comparer avec les archives. | php dolibarr_list.php --export-csv --type=invoice --from=2024-01-01 --to=2024-12-31 > factures2024.csv |
| Protection contre la suppression | Essayer de supprimer un fichier > système → Message d’erreur (si archivage immuable). | |
| Audit | Lancer le rapport d’audit du module "Archivage". | Menu → Rapports → Archivage → Rapport d’audit. |
| RGPD / DPO | Documenter les bases légales pour chaque type de document (ex. contractualité). | Intégrer ces notes dans le module “Conformité” (disponible via plugin). |
4. Bonnes pratiques d’archivage pour la scalabilité
| Domaine | Astuce | Pourquoi c’est efficace |
|---|---|---|
| Nomenclature de dossiers | /files/2024/01/Client_00123/Devis/ |
Permet de localiser rapidement un document via l’année et l’identifiant client. |
| Métadonnées | Ajouter des champs personnalisés (ex. client_ref, type_facture). |
Aprés un requête de recherche texte plein‑texte (via General → Full‑Text Search), vous trouvez un fichier en < 2 s. |
| Versionnage | Forcez le suffixe de version (Facture_2024-00123_v1.pdf). |
Évite les écarts entre le document original et les éventuelles modifications ultérieures. |
| Compression | Activez l’option compression dans Paramètres → Général → Compression des archives. | Réduction de la taille de stockage de 30‑40 % pour les PDFs scannés non compressés. |
| Partitionnement DB | Si vous avez > 50 000 factures, activez le partitionnement de la table factures (ex. partition par année). |
Améliore la performance des requêtes de facturation et des jointures avec les archives. |
| Réplica externe | Répliquez le dossier files/ vers un serveur de sauvegarde (rsync, S3, Glacier). |
Assurance de continuité en cas de panne du serveur principal. |
| Monitoring | Ajoutez un alarme dans votre outil de supervision (Zabbix/Prometheus) pour le taux de croissance du répertoire files/. |
Déclenche une alerte avant que le disque ne se remplisse. |
| Documentation | Rédigez un SOP (Standard Operating Procedure) d’archivage dans Confluence ou GitBook. | Facilite la formation des nouveaux collaborateurs et le respect des processus. |
5. Exemple complet : Scénario de croissance d’une PME
Situation initiale – 20 clients, 300 factures/an, stockage sur disque local (5 Go).
Déclencheur – Passage à 200 clients, 8 000 factures/an, besoin de plus de 30 Go d’espace + conformité RGPD.
| Étape | Action | Résultat attendu |
|---|---|---|
| 1. Évaluation | Export des 2023 factures → 3 GB. | Baseline de volume. |
| 2. Mise en place du bucket S3 | Création du bucket archivage-pme, replication vers Glacier. |
Stockage quasiment illimité, conformité immutable dès 0 jours. |
| 3. Ajout du plugin “Archivage externe” | Déploiement sur le serveur Dolibarr. | Dolibarr commence à persister les PDFs sur S3. |
| 4. Création de règles de rétention | 6 ans pour factures, 5 ans pour contrats. | Les fichiers dépassant la durée sont automatiquement déplacés vers un “garage” de rétention. |
| 5. Cron automatisé | Deux jobs mensuels (nettoyage + rapport). | Le serveur ne surcharge plus et les audits sont générés chaque mois. |
| 6. Monitoring & alarme | Configurer Prometheus → alert @ 80 % d’utilisation disque. | Intervention avant saturation. |
| 7. Formation | Session KPI « Archivage & conformité » pour le service comptable. | Respect systématique des durées et mise à jour des métadonnées. |
KPI post‑implémentation (6 mois)
• Taille du répertoirefiles/: 28 GB (vs. 120 GB initialement prévu).
• Temps moyen de recherche d’un document : 1,2 s.
• Conformité immuable : 100 % des PDFs stockés sont verrouillés après 30 jours. > • Réduction du temps de clôture comptable de 15 minutes à 7 minutes.
6. Checklist de déploiement
| ✅ | Point de contrôle |
|---|---|
| 1 | Chemin du répertoire de fichiers configuré et accessible en écriture par le serveur web. |
| 2 | Module « Archivage » activé en admin → Modules. |
| 3 | Types de documents et catégories créés (au moins Facture, Devis, Contrat). |
| 4 | Règles de rétention définies pour chaque type (6 ans, etc.). |
| 5 | Cron exécutant le job de nettoyage planifié (au moins 1 fois/jour). |
| 6 | Si immuable requis, plugin installé et bucket configuré avec verrouillage. |
| 7 | Sauvegarde (partielle) du dossier files/ prévue (ex. rsync vers serveur de sauvegarde). |
| 8 | Métriques de monitoring configurées (taille disque, croissance). |
| 9 | Documentation SOP mise à jour (procédure d’alimentation, de validation, de purge). |
| 10 | Test de restauration d’un document sélectionné (vérifier l’intégrité). |
7. Ressources complémentaires
| Source | Description |
|---|---|
| Dokumentation officielle | https://www.dolibarr.org/doc/en/ – Section “Archiving & Storing documents”. |
| Plugin “Archivage externe” | Disponible sur le Marketplace Dolibarr – Instructions d’installation détaillées. |
| Guide RGPD | https://www.cnil.fr/fr/gestion-des-documents-darchivage – Bonnes pratiques pour le secteur français. |
| Docker‑Compose pour Dockerised Dolibarr | Exemple complet avec volume persistant et serveur MinIO : https://github.com/Dolibarr/docker-compose-example |
| Webinar 2024 – “Scalabilité & archivage immuable avec Dolibarr” | Replay sur la chaîne YouTube Dolibarr Community (ID : dolibarr-archiving-2024). |
| Forum communautaire | https://forum.dolibarr.org – Discussions sur la grande volumétrie et les retours d’expérience. |
8. Conclusion
L’archivage dans Dolibarr n’est plus une fonctionnalité marginale, c’est le pilier qui vous permet de gérer la croissance sans perdre en conformité ni en performance. En suivant ce guide :
- Structurez vos dossiers et types de documents.
- Automatisez la rétention via les règles et le cron.
- Profitez des capacités d’archivage immuable pour garantir la non‑altérabilité des pièces essentielles.
- Surveillez la consommation et la santé du système grâce à des alertes ciblées.
Vous disposerez d’une base solide pour passer à l’échelle, tout en respectant les exigences légales et les meilleures pratiques de l’archivage numérique.
À votre prochaine étape : Mettez en place le premier test de migration d’un lot de factures, activez le blocage immuable et observez l’impact sur votre processus de clôture. Vous verrez rapidement les gains en termes de rapidité et de sécurité.
Bonne mise en œuvre ! 🚀
Cet article a été rédigé par l’équipe technique Dolibarr (2025). Il s’appuie sur la version 20.2.0 du logiciel et les exigences légales en vigueur en France et dans l’UE.