Qualité des données

Détection de doublons

dolixdoublons · version 1.1.3

Vous retrouvez les fiches saisies deux fois, et vous les fusionnez : tiers, contacts et adhérents.

Prix: 79 € HT
Dolibarr: 19.0 minimum
Version: 1.1.3
Licence: GPL v3+
Langues: Français, anglais

En validation sur le DoliStore

Il n’est pas achetable aujourd’hui. La vente, l’encaissement, la facture et le téléchargement se feront sur le DoliStore, jamais sur ce site. Pour être prévenu de sa mise en vente, écrivez à contact@dolix.fr.

Support et contact

Analyse des contacts sous Dolibarr 24.0.0, objet « Contacts / adresses » : « 4 groupe(s) de doublons trouvé(s), soit 8 fiche(s) concernée(s) sur 14 analysée(s). ». Chaque groupe rapproche le même contact saisi sur deux tiers différents — Julien Weber existe à la fois chez « Cabinet Vaillant » et chez « Association Les Trois Ponts » — et propose le bouton « Fusionner dans la fiche conservée ». — Analyse des contacts sous Dolibarr 24.0.0, objet « Contacts / adresses » : « 4 groupe(s) de doublons trouvé(s), soit 8 fiche(s) concernée(s) sur 14 analysée(s). ». Chaque groupe rapproche le même contact saisi sur deux tiers différents — Julien Weber existe à la fois chez « Cabinet Vaillant » et chez « Association Les Trois Ponts » — et propose le bouton « Fusionner dans la fiche conservée ».

Ce que fait le module

Quatre critères pour les tiers : même email, même nom, même téléphone, même SIRET / SIREN / n° de TVA. Trois pour les contacts et les adhérents : email, nom et prénom, téléphone.
Normalisation avant rapprochement : casse, espaces, accents et ponctuation ignorés ; formes juridiques retirées du nom ; téléphones ramenés à leurs neuf derniers chiffres, quel que soit le format ; nom et prénom dans n'importe quel ordre.
L'analyse est en lecture seule. Les champs vides ne forment jamais de groupe.
Fusion des trois objets analysés. Celle des tiers passe par la méthode native de Dolibarr ; celle des contacts et des adhérents est écrite dans le module, le cœur de Dolibarr ne sachant fusionner que les tiers.
Fusion d'un tiers : devis, commandes, factures, contacts, catégories et documents joints sont reportés sur la fiche conservée, qui voit ses champs vides complétés, puis le doublon est supprimé.
Fusion d'un contact ou d'un adhérent : rôles sur les devis, commandes, factures et projets, rattachements aux tiers, catégories, événements d'agenda, notifications, cibles d'emailing, attributs supplémentaires, cotisations et partenariats, et le compte utilisateur éventuellement lié, sont reportés sur la fiche conservée. Ses champs vides sont complétés avec ceux du doublon et les notes sont mises bout à bout. Le tout dans une transaction : si une seule étape échoue, rien n'est appliqué.
Deux garde-fous : nombre maximum de fiches analysées (20 000 par défaut) et taille maximale d'un groupe (10 par défaut). Une valeur partagée par trop de fiches est signalée et écartée : c'est un standard téléphonique ou une adresse générique, pas un doublon.
Multi-société respecté, utilisateurs externes confinés à leur propre tiers, historique des fusions consultable, avec le type d'objet fusionné.

À qui ça sert

La même entreprise existe deux fois dans votre base, sous deux orthographes, et vous ne savez plus laquelle est à jour.

Au bout de quelques années, la même entreprise finit saisie deux fois. « Cabinet Vaillant » et « SARL Cabinet Vaillant », le même email écrit avec une majuscule, le même téléphone écrit avec des espaces. Les devis sont sur une fiche, les factures sur l’autre. Le chiffre d’affaires du client est faux, et personne ne sait plus laquelle des deux fiches est à jour.

Un tri par nom ne les fait pas apparaître côte à côte : la forme juridique, l’accent ou l’espace suffisent à les séparer dans la liste.

À qui ça sert : Les bases de plusieurs années, les fichiers importés depuis un tableur, les structures où plusieurs personnes créent des fiches sans se concerter.

Ce que le module ne fait pas

Ce bloc figure sur les six fiches, sans exception.

Le module détecte, il ne corrige pas tout seul : c'est vous qui choisissez la fiche à conserver, fusion par fusion.
Le rapprochement est exact après normalisation. Deux orthographes réellement différentes — une faute de frappe dans un nom, une lettre en trop dans un email — ne sont pas rapprochées.
Aucune détection sur les produits, les projets, les factures ou les documents.
Une fusion supprime définitivement la fiche fusionnée. Il n'y a pas de bouton pour revenir en arrière.
La fusion d'un contact ou d'un adhérent écrit directement en base : les déclencheurs de Dolibarr ne sont pas exécutés et aucun événement n'est créé dans l'agenda. La fusion d'un tiers, elle, passe par la méthode du cœur.
Si la fiche conservée porte déjà le même lien que le doublon — même catégorie, même rattachement à un tiers, cotisation de même date, partenariat de même type et de même date — la ligne redondante du doublon est écartée au lieu d'être reportée.
Les fichiers joints à la fiche d'un contact ou d'un adhérent fusionné ne suivent pas : ils restent dans le dossier de la fiche supprimée, sur le serveur. Pour les tiers, la fusion native de Dolibarr les déplace.

Comment ça marche

Le module compare vos fiches sur des critères que vous choisissez, et vous présente des groupes de fiches réellement identiques une fois la mise en forme retirée.

Ce qu’il sait analyser : les tiers, les contacts et les adresses, et — si le module Adhérents est activé — les adhérents.

Les critères :

Critère	Objets	Ce qui est ignoré
Même email	tiers, contacts, adhérents	casse et espaces
Même nom	tiers	accents, ponctuation, formes juridiques (SARL, SAS, EURL, GmbH, Ltd…)
Même nom et prénom	contacts, adhérents	accents, ponctuation, ordre du nom et du prénom
Même téléphone	tiers, contacts, adhérents	format : `01 23 45 67 89`, `+33 1 23 45 67 89`, `0033…` donnent la même clé
Même SIRET, SIREN ou n° de TVA	tiers	espaces, ponctuation, casse

Le rapprochement est une égalité stricte après normalisation, pas un score de ressemblance. Deux fiches ne sont groupées que si l’une de leurs valeurs est réellement identique. Il n’y a donc pas de « probabilité de doublon » à interpréter, et les champs vides ne forment jamais de groupe.

L’analyse est en lecture seule. Rien n’est modifié tant que vous n’avez pas choisi une fiche à conserver, coché une fiche à fusionner, cliqué et confirmé.

Le module trouve les vrais doublons et écarte les faux : un standard téléphonique partagé par douze agences n'est pas un doublon, et il est ignoré. — Le module trouve les vrais doublons et écarte les faux : un standard téléphonique partagé par douze agences n'est pas un doublon, et il est ignoré.

Réglages

Réglage	Défaut	Effet
Nombre maximum de fiches analysées	20 000	Au-delà, l’analyse est bloquée pour ne pas saturer le serveur.
Taille maximale d’un groupe	10	Une valeur partagée par plus de fiches que ce nombre est considérée comme un standard téléphonique ou une adresse générique : elle est écartée, et le nombre de valeurs écartées est affiché.
Conserver un historique des fusions	activé	Enregistre chaque fusion : date, utilisateur, type d’objet, fiche conservée, fiche supprimée.

Le second réglage est celui qui évite le faux groupe géant : sans lui, un standard 03 88 00 00 00 partagé par quarante fiches d’une même collectivité formerait un groupe de quarante « doublons ».

Les trois réglages, et l'historique des fusions : quelle fiche a été conservée, laquelle a été supprimée, par qui et quand. — Les trois réglages, et l'historique des fusions : quelle fiche a été conservée, laquelle a été supprimée, par qui et quand.

Sécurité et garde-fous

Analyse en lecture seule. Aucune écriture n’est possible depuis l’écran d’analyse sans passer par le bouton de fusion et sa confirmation.
Un droit dédié, « Utiliser la détection de doublons ».
Les droits standards de Dolibarr en plus : la fusion exige créer/modifier et supprimer sur l’objet. Sans le droit de suppression, l’analyse reste consultable et les boutons de fusion ne s’affichent pas ; un message l’explique.
Revérification côté serveur : les identifiants envoyés par le formulaire ne sont jamais crus sur parole, les deux fiches sont relues dans le périmètre autorisé.
Multi-société : analyse et fusion limitées aux entités autorisées.
Utilisateurs externes : un compte rattaché à un tiers ne voit que sa propre fiche ; les adhérents ne lui sont jamais visibles.
Chaque fusion est écrite dans les journaux de Dolibarr et dans l’historique du module.

Ce qui est livré

Ce que le module écrit dans votre installation
Tables créées en base	Une table : llx_dolixdoublons_log. Elle enregistre l'historique des fusions (date, utilisateur, type d'objet, fiche conservée, fiche fusionnée, noms des deux fiches, entité).
Permissions	Un droit : « Utiliser la détection de doublons ». La fusion exige en plus les droits standards de Dolibarr sur l'objet : créer/modifier ET supprimer. Sans le droit de suppression, l'analyse reste consultable mais les boutons de fusion ne s'affichent pas.
Désinstallation	Désactiver le module dans ConfigurationModules/Applications. Le menu disparaît. Les fusions déjà faites ne sont pas annulables : la fiche fusionnée a été supprimée. La table d'historique llx_dolixdoublons_log et les réglages du module ne sont pas supprimés.

Une table est ajoutée : llx_dolixdoublons_log. Elle ne contient que l’historique des fusions.
L’analyse ne lit qu’un jeu minimal de colonnes — nom, email, téléphones, identifiants, ville — et ne les écrit nulle part.
La seule écriture possible est la fusion que vous déclenchez.
Aucune connexion sortante : rien n’est envoyé nulle part.

Compatibilité

Le descripteur du module ne déclare qu’une version minimale. Aucune borne haute n’est inscrite dans le code : les versions ci-dessous sont celles sur lesquelles le module a réellement été exécuté.

Compatibilité du module Détection de doublons
Versions de Dolibarr	Dolibarr 19.0 minimum. Installé et exécuté sur 23.0.4 et 24.0.0.
PHP minimum	7.4
Modules Dolibarr à activer	Tiers
Licence	GPL v3 ou ultérieure, code source complet
Langues	Français, anglais
Menu	Menu Tiers« Doublons ».

Installation

Récupérer le module sur le DoliStore et télécharger le fichier zip.
Dans Dolibarr : AccueilConfigurationModules/Applicationsonglet « Déployer/installer un module externe », puis envoyer le zip. Sinon, décompresser le dossier dolixdoublons dans htdocs/custom/.
Activer « Détection de doublons » dans la liste des modules. La table d'historique est créée à ce moment-là.
Attribuer le droit « Utiliser la détection de doublons » aux utilisateurs concernés. Pour fusionner, ils doivent en plus avoir les droits Dolibarr de création et de suppression sur l'objet visé : tiers, contacts, ou adhérents.
Régler les deux plafonds et l'historique dans la page de configuration du module.

Le détail — droits du dossier custom, hébergement mutualisé, mise à jour, désinstallation — est sur la page Installation et mise à jour.

Questions fréquentes

Sur quelles versions de Dolibarr ce module fonctionne-t-il ?

Le descripteur exige Dolibarr 19.0 au minimum et PHP 7.4 au minimum. Le module a été installé et exécuté sur 23.0.4 et 24.0.0. Si vous êtes sur une version plus ancienne et que vous avez un doute, écrivez avant d'acheter.

L'analyse peut-elle modifier ma base ?

Non. L'analyse ne fait que lire et regrouper. Rien n'est écrit tant que vous n'avez pas choisi une fiche à conserver, coché une fiche à fusionner, cliqué sur le bouton et confirmé la fenêtre d'avertissement.

Que devient le contenu de la fiche supprimée lors d'une fusion de tiers ?

Il est reporté sur la fiche conservée par la méthode de fusion de Dolibarr lui-même : devis, commandes, factures, contacts, catégories. Les champs vides de la fiche conservée sont complétés avec ceux du doublon. Ensuite seulement, le doublon est supprimé. L'opération est irréversible : faites une sauvegarde avant une campagne de fusion.

Le module fusionne-t-il aussi les contacts et les adhérents ?

Oui, et c'est ce que Dolibarr ne sait pas faire : son cœur ne fusionne que les tiers. La fusion d'un contact ou d'un adhérent est écrite dans le module. Elle reporte sur la fiche conservée tout ce qui désignait la fiche supprimée : rôles sur les devis, commandes, factures et projets, rattachements aux tiers, catégories, événements d'agenda, notifications, cibles d'emailing, attributs supplémentaires, et pour un adhérent ses cotisations et ses partenariats. Le compte utilisateur éventuellement lié suit également. Les champs vides de la fiche conservée sont complétés avec ceux du doublon, les notes sont mises bout à bout, puis le doublon est supprimé. L'ensemble se fait dans une transaction : si une étape échoue, rien n'est appliqué.

Risque-t-il de me proposer de faux doublons ?

Le rapprochement est une égalité stricte après normalisation, pas un score de ressemblance : deux fiches ne sont groupées que si une de leurs valeurs est réellement identique une fois la mise en forme retirée. Les valeurs partagées par plus de fiches que le plafond de groupe — un standard téléphonique, une boîte générique — sont écartées et signalées.

Et si je désinstalle ?

Le menu disparaît. Les fusions déjà faites restent : ce sont des données de votre base. La table d'historique et les réglages restent également, vous pouvez les supprimer vous-même.

Qui répond au support, et comment se passent les mises à jour ?

Le support est assuré par la personne qui a écrit le module, à support@dolix.fr. La commande, le paiement, la facture et le téléchargement sont assurés par le DoliStore, où les nouvelles versions sont publiées.

Journal des versions

Repris du fichier ChangeLog.md du module : une seule source.

1.1.310 septembre 2026

Technique : la fonction de vérification du jeton anti-CSRF porte désormais un nom préfixé par le module, pour qu'une fonction du même nom ajoutée un jour dans Dolibarr ne puisse pas empêcher la page de s'ouvrir. Un jeton vide est refusé explicitement.

1.1.210 septembre 2026

Correctif important : le formulaire de fusion transmettait toujours le type d'objet « tiers », quel que soit le type analysé. Une fusion lancée depuis les contacts ou les adhérents était traitée comme une fusion de tiers. Le type réellement affiché est désormais transmis, et la fusion des contacts et des adhérents, écrite depuis la 1.1.0, est réellement accessible depuis l'écran. Correctif : l'écran de configuration renvoyait une erreur 500 à l'enregistrement, la fonction d'écriture des réglages de Dolibarr étant appelée sans que sa bibliothèque soit chargée. Les réglages s'enregistrent normalement.

1.1.110 septembre 2026

Correctif de compatibilité PostgreSQL : la détection des colonnes optionnelles passe désormais par l'abstraction de Dolibarr, une requête en erreur annulant sur PostgreSQL la transaction en cours. Aucune donnée n'était altérée.

1.1.010 septembre 2026

Fusion des contacts et fusion des adhérents, que Dolibarr ne propose pas nativement : tout ce qui désigne la fiche supprimée est reporté sur la fiche conservée — documents et éléments liés, rattachements, événements, catégories, notifications, cotisations, partenariats et compte utilisateur associé — dans une transaction. Détection des doublons d'adhérents, proposée quand le module Adhérents est activé. Gestion des conflits de clé unique lors d'une fusion. Compatibilité entre versions : les colonnes absentes selon la version de Dolibarr sont détectées et ignorées. L'historique distingue désormais le type d'objet fusionné.

1.0.09 septembre 2026

Première version : détection des doublons de tiers et de contacts sur quatre critères, normalisation avant rapprochement, analyse en lecture seule, fusion des tiers par la méthode native de Dolibarr, garde-fous, historique et page de configuration.