CRM — Détection de doublon SIRET à la création d'un client

Objectif

Éviter la création accidentelle de fiches clients en double dans le CRM d'un même tenant, en s'appuyant sur le SIRET comme clé d'identification.

À la création d'un client CRM, si le SIRET saisi existe déjà sur une fiche active du même tenant, la création est bloquée et les fiches concernées sont affichées avec un lien direct. L'utilisateur peut lever le blocage via une dérogation explicite lorsqu'il s'agit légitimement d'un établissement distinct.

Comportement utilisateur

1. L'utilisateur remplit le formulaire de création d'un client et saisit un SIRET.
2. Dès que le SIRET est complet (14 chiffres), s'il correspond déjà à une ou plusieurs fiches du CRM, un avertissement orange apparaît listant ces fiches (nom + département) avec un lien « ouvrir la fiche » (nouvel onglet).
3. Tant que le doublon n'est pas levé, la création est bloquée : cliquer sur « Ajouter » réaffiche l'avertissement sans créer la fiche.
4. Si l'utilisateur estime qu'il s'agit d'un établissement distinct (antenne, délégation, service partageant le SIRET du siège), il coche « Il s'agit d'un établissement distinct — créer quand même », puis « Ajouter » : la fiche est alors créée.
5. Modifier le SIRET réinitialise automatiquement la dérogation.

Pourquoi une dérogation plutôt qu'un blocage strict ?

En droit, un SIRET identifie un établissement unique. Mais dans les données CRM réelles, un même SIRET est fréquemment partagé entre plusieurs fiches légitimes : antennes et délégations d'associations, établissements d'un groupe, services rattachés à une même structure (le SIRET du siège est réutilisé). Un blocage strict empêcherait ces créations légitimes. La dérogation offre le garde-fou (on alerte, on montre les fiches existantes) sans bloquer les cas valides.

Périmètre

• Concerne : la création manuelle d'un client via l'interface (CRM Light et formulaire CRM classique).
• Ne concerne pas : la modification d'une fiche existante, l'API, et les imports Excel (ces derniers créent volontairement des antennes en masse partageant un SIRET).
• Clé de détection : SIRET seul, normalisé en 14 chiffres, limité au tenant courant et aux fiches non supprimées.

Cas particuliers

• Un SIRET incomplet ou vide ne déclenche aucun contrôle.
• Le contrôle est propre à chaque tenant : le SIRET d'un autre tenant n'est jamais remonté.
• Les fiches supprimées (archivées) ne comptent pas comme doublon.

Voir aussi

• Documentation technique : .claude/technical-docs/crm/crm-siret-duplicate.md