Détection de doublons

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 :

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 fusionne les trois objets qu’il analyse. Le chemin n’est pas le même pour les tiers et pour les deux autres.

Les tiers

Pour un tiers, le module s’appuie sur la fusion native de Dolibarr. Les devis, commandes, factures, contacts, catégories et documents joints du doublon sont reportés sur la fiche que vous conservez, dont les champs vides sont complétés avec ceux du doublon. Le doublon est ensuite supprimé.

Les contacts et les adhérents

Dolibarr ne sait pas les fusionner. Son cœur ne propose la fusion que pour les tiers : deux contacts en double se recopient et se suppriment à la main, en espérant n’avoir rien oublié. Le module écrit cette fusion lui-même.

Tout ce qui désignait la fiche supprimée est reporté sur la fiche conservée :

Les champs vides de la fiche conservée — adresse, téléphones, fonction, date de naissance, réseaux sociaux — sont complétés avec ceux du doublon, et les deux notes sont mises bout à bout. La fiche conservée garde son propre rattachement : fusionner deux contacts portés par deux tiers différents ne touche pas aux tiers.

L’opération se fait dans une transaction. Si une seule étape échoue, rien n’est appliqué : les deux fiches restent en place et un message le dit.

Quand la fiche conservée porte déjà le même lien que le doublon — la même catégorie, le même rattachement à un tiers, une cotisation de même date — la ligne redondante du doublon est écartée plutôt que de faire échouer l’opération.

Dans les deux cas

C’est une opération irréversible. Le module demande une confirmation explicite qui le dit, exige les droits Dolibarr de création et de suppression sur l’objet visé en plus de son propre droit, et revérifie les deux fiches côté serveur avant d’écrire quoi que ce soit.

L’écran tient en une page, sous TiersDoublons.

En haut, l’objet à analyser et les cases des critères. Le bouton Analyser affiche un bandeau du type « 3 groupe(s) de doublons trouvé(s), soit 6 fiche(s) concernée(s) sur 14 analysée(s). », puis un tableau par groupe.

Chaque groupe indique en titre les critères qui ont rapproché ces fiches, et liste les fiches avec leur nom cliquable, leur email, leur téléphone, leurs identifiants et leur ville. Une colonne « Conserver » et une colonne « Fusionner » vous laissent désigner la fiche maîtresse.

Sur la capture, le groupe 1 rapproche « Cabinet Vaillant » et « SARL Cabinet Vaillant » sur les quatre critères à la fois, alors que leurs emails ne s’écrivent pas avec la même casse et que leurs téléphones ne sont pas saisis dans le même format.

Le choix de l’objet change la liste analysée et les critères proposés. Sur Contacts / adresses, chaque groupe rapproche la même personne saisie plusieurs fois — souvent sur deux tiers différents — et porte le même bouton de fusion.

La page de configuration regroupe les deux garde-fous, l’historique et le tableau des fusions déjà effectuées.

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 ».

• 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.

• 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.