Module Doli-Nextcloud (Envoyer vos documents et contacts vers Nextcloud)

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Nom du module Doli-NextCloud
Éditeur Joliciel - https://joliciel.fr
Page d'achat ou de téléchargement https://www.dolistore.com/product.php?id=657
Statut Stable
Prérequis Dolibarr 16 minimum
Date mise à jour fiche 2026-08-25
Note



Présentation

Le module Doli-Nextcloud relie votre compte Nextcloud à Dolibarr et automatise deux échanges :

  • une gestion documentaire : chaque document PDF généré par Dolibarr (proposition commerciale, commande, facture, fiche d'intervention...) est envoyé automatiquement sur votre serveur Nextcloud, via le protocole WebDAV ;
  • une synchronisation d'annuaire : les fiches des tiers (prospects, clients, fournisseurs), des contacts et des utilisateurs internes de Dolibarr sont envoyées vers le carnet d'adresses Contacts de Nextcloud, via le protocole CardDAV.

Vous obtenez ainsi un classement documentaire par tiers, consultable et synchronisable sur tous vos appareils (ordinateur, smartphone) grâce au client Nextcloud, ainsi qu'un carnet d'adresses toujours à jour, exploitable depuis votre smartphone ou votre client de messagerie (Thunderbird, FairEmail, etc.).

Un seul compte Nextcloud (avec un mot de passe d'application dédié) suffit : il est utilisé de façon transparente pour tous les utilisateurs connectés à Dolibarr, sans configuration individuelle.

IMPORTANT : Accès illimité aux mises à jour. Support technique : dolibarr@joliciel.fr



Fonctionnalités

Envoi automatique des documents vers Nextcloud (WebDAV)

À chaque génération ou régénération d'un document PDF dans Dolibarr, celui-ci est transmis au serveur Nextcloud configuré. Les types de documents pouvant être envoyés dépendent des modules Dolibarr activés, et se règlent individuellement dans la configuration :

  • Propositions commerciales
  • Commandes clients
  • Fiches d'expédition
  • Factures clients (et factures électroniques)
  • Fiches d'intervention
  • Projets
  • Contrats
  • Demandes de prix fournisseurs
  • Commandes fournisseurs
  • Réceptions fournisseurs
  • Factures fournisseurs
  • États des dûs clients et fournisseurs
  • Résumé des ventes

Chaque type peut être activé ou désactivé indépendamment, via un simple interrupteur, dans l'onglet Paramètres du module.

Organisation automatique des dossiers

Le module structure lui-même l'arborescence créée sur le serveur Nextcloud, selon plusieurs options combinables :

  • Dossier racine : nom du dossier, dans le compte Nextcloud, dans lequel tous les documents envoyés par Dolibarr seront rangés (facultatif).
  • Dossier « Tiers » : nom du sous-dossier utilisé pour regrouper les documents par tiers (paramétrable, ex. "TIERS").
  • Un dossier par tiers : un sous-dossier est créé automatiquement au nom de chaque tiers (client, prospect ou fournisseur).
  • Identifiant du tiers dans le nom du dossier : ajoute l'identifiant Dolibarr du tiers au nom de son dossier, pour différencier des tiers homonymes.
  • Un seul dossier pour tous les tiers : option inverse, pour ne pas créer de dossier individuel par tiers.
  • Un dossier par type de document : à l'intérieur du dossier de chaque tiers, les documents sont rangés par type (ex. sous-dossier "FACTURES", "COMMANDES"...).
  • Ne pas envoyer les documents à l'état "Brouillon" : seuls les documents validés sont transmis à Nextcloud (les objets liés restent envoyés si l'option correspondante est active).
  • Dossier d'équipe Nextcloud (« Team folder ») : au lieu d'utiliser le dossier personnel du compte WebDAV, le module peut envoyer tous les documents dans un dossier d'équipe Nextcloud partagé entre plusieurs utilisateurs. Cette option nécessite que la fonctionnalité "Dossiers d'équipe" soit activée côté serveur Nextcloud, que le dossier existe déjà, et que le compte WebDAV en soit membre avec les droits lecture/écriture/création.

Synchronisation des contacts (CardDAV)

À chaque création ou modification, dans Dolibarr, d'une fiche tiers, contact ou utilisateur, la fiche correspondante (vCard) est créée ou mise à jour dans le carnet d'adresses Nextcloud choisi. Trois flux sont paramétrables indépendamment :

  • Envoi des fiches des tiers (prospects, clients, fournisseurs)
  • Envoi des fiches des contacts
  • Envoi des fiches des utilisateurs internes Dolibarr

Des boutons denvoi en masse (« Envoyer tous les tiers », « Envoyer tous les contacts », « Envoyer tous les utilisateurs ») permettent d'initialiser la synchronisation complète d'une base existante, avec possibilité de traiter les enregistrements par lots (ligne de début / ligne de fin), pour les grosses bases de données.

Onglet "Nextcloud" sur la fiche tiers

Un nouvel onglet Nextcloud apparaît sur la fiche de chaque tiers dans Dolibarr. Il liste tous les documents déjà envoyés pour ce tiers : nom du fichier, type de document, référence, date d'envoi, taille, avec un lien direct pour visualiser ou télécharger le fichier depuis Nextcloud, sans avoir à quitter Dolibarr.

Outils de diagnostic et de maintenance

La page de configuration propose plusieurs outils pratiques pour fiabiliser l'installation :

  • Tester la connexion aux "Fichiers" de Nextcloud : vérifie que les identifiants WebDAV sont valides et affiche la liste des dossiers racine du compte.
  • Envoyer un fichier de test vers le serveur Nextcloud (texte ou PDF) : permet de valider de bout en bout l'envoi d'un document.
  • Tester la connexion aux "Contacts" de Nextcloud : vérifie les identifiants CardDAV et affiche la liste des carnets d'adresses disponibles.
  • Vérifier les tables du module (contrôle simple et contrôle approfondi) : s'assure que les tables SQL utilisées par le module (fichiers, tiers, contacts, utilisateurs synchronisés) existent et possèdent bien toutes les colonnes attendues ; propose de créer automatiquement les tables manquantes.
  • Notifications détaillées : une option permet d'afficher, à l'administrateur, un message dans Dolibarr chaque fois qu'un évènement (création de document, synchronisation de fiche...) est traité par le module, pratique pour le diagnostic.

Sécurité

La connexion à Nextcloud utilise exclusivement des mots de passe d'application générés depuis Nextcloud (et non le mot de passe principal du compte), aussi bien pour l'accès WebDAV que pour l'accès CardDAV. Les mots de passe enregistrés dans Dolibarr sont stockés sous forme encodée et jamais réaffichés en clair dans l'interface.



Copies d'écran

Configuration - Fichiers (WebDAV)

Paramétrage de l'accès WebDAV aux fichiers Nextcloud

La première section de la page de configuration (Accueil ➡ Configuration ➡ Modules/Applications ➡ Doli-Nextcloud) permet de renseigner l'URL du serveur Nextcloud, le nom d'utilisateur et le mot de passe d'application dédiés à l'accès aux fichiers, ainsi que le dossier racine facultatif dans lequel seront rangés les documents envoyés par Dolibarr. Les boutons Tester la connexion aux 'Fichiers' de Nextcloud et Envoyer un fichier de test vers le serveur Nextcloud permettent de valider immédiatement le paramétrage.

Configuration - Contacts (CardDAV) et envoi en masse

Paramétrage de l'accès CardDAV et envoi en masse des fiches

La deuxième section concerne l'accès au carnet d'adresses Nextcloud (URL, utilisateur, mot de passe d'application, nom du carnet d'adresses). Le bouton Tester la connexion aux 'Contacts' de Nextcloud vérifie l'accès, tandis que les boutons Envoyer tous les tiers, Envoyer tous les contacts et Envoyer tous les utilisateurs déclenchent la synchronisation initiale de l'ensemble des fiches déjà présentes dans Dolibarr.

En dessous démarre la liste des paramètres d'envoi automatique par type de document (propositions, commandes, expéditions, factures...), chacun activable ou désactivable via un interrupteur.

Configuration - Options avancées

Options avancées d'organisation des dossiers et de synchronisation

La suite de la page regroupe les options avancées d'organisation des documents : nom du dossier "Tiers", ajout de l'identifiant du tiers dans le nom de son dossier, création d'un dossier par type de document, exclusion des documents à l'état brouillon, ainsi que les interrupteurs d'envoi des fiches des tiers/contacts/utilisateurs vers Nextcloud et l'affichage des notifications de débogage.

Résultat côté serveur Nextcloud

Arborescence des documents créée automatiquement dans Nextcloud

Côté serveur Nextcloud, les documents envoyés par Dolibarr apparaissent automatiquement classés dans l'arborescence de dossiers définie par la configuration (ici un dossier par société, avec un sous-dossier "TIERS" et un sous-dossier "FACTURES"), directement accessibles et synchronisables comme n'importe quel fichier Nextcloud, depuis un ordinateur, un smartphone ou l'interface web.



Installation

  1. Connectez-vous à votre Dolibarr avec un compte administrateur.
  2. Rendez vous dans la section pour déployer un module : Accueil ➡ Configuration ➡ Modules/Applications ➡ Déployer/Installer un module externe.
  3. Téléversez le fichier zip du module via le formulaire.
  4. Activez le module via la section : Accueil ➡ Configuration ➡ Modules/Applications, dans la section Interfaces avec des systèmes externes
  5. Rendez-vous sur la page de configuration du module (icône réglages en face du module) pour renseigner les paramètres d'accès à votre serveur Nextcloud (voir copies d'écran ci-dessus).

Prérequis côté Nextcloud

  • Un compte Nextcloud (dédié de préférence) accessible par le serveur Dolibarr.
  • Un mot de passe d'application généré depuis Paramètres personnels ➡ Sécurité sur Nextcloud, pour l'accès WebDAV, et un second pour l'accès CardDAV (ils peuvent être identiques).
  • Facultatif : la fonctionnalité "Dossiers d'équipe" activée si vous souhaitez centraliser les documents dans un dossier partagé plutôt que dans le dossier personnel du compte.