Passer au contenu principal
Les endpoints de création (POST /external-integration/sale, /acquisition, /rental) appliquent automatiquement une logique de déduplication et d’allocation.

1. Déduplication du contact

  • Recherche d’un contact existant par téléphone ou email dans le groupe d’agences.
  • Si trouvé : mise à jour des informations du contact.
  • Sinon : création d’un nouveau contact.

2. Déduplication de la transaction

Si un contact existant est trouvé, recherche d’une fiche de ce contact à rapprocher :
  • Vente : vente active à la même adresse pour ce contact.
  • Location : la location la plus récente de ce contact à la même adresse, quelle que soit son étape. Une location archivée (RARC) est rouverte à l’étape calculée (ou à settings.step).
  • Acquisition : une acquisition du contact, quelle que soit son étape (une acquisition n’a pas d’adresse : ce sont des critères de recherche). Si le contact en a plusieurs, la priorité suit l’étape : ANGT, ASRC, AQUL, ACLS, AOFR, puis AARC. Une fiche archivée n’est reprise que si le contact n’en a pas d’autre.
Si une correspondance est trouvée, la fiche existante est mise à jour (les champs envoyés sont appliqués, les autres sont conservés) et son étape ne change pas, sauf la réouverture d’une location archivée. Sinon une nouvelle transaction est créée.
parsingCustomId est enregistré sur la fiche mais n’intervient pas dans la déduplication : seuls le téléphone, l’email et l’adresse servent au rapprochement. Deux envois avec le même parsingCustomId et deux adresses différentes créent deux ventes. Une fois la fiche connue, ciblez-la par son identifiant avec PATCH Sale.
La déduplication peut être désactivée par requête via settings.allocation.disableDeduplication: true.

3. Allocation

  • Attribution automatique d’une agence et d’un utilisateur selon les règles configurées.
  • Vous pouvez forcer l’attribution via settings.allocation :
    • agencyId : force l’agence, qui doit figurer dans GET Agencies
    • userId : force l’utilisateur (nécessite agencyId)

4. Étape (routing)

  • L’étape d’une nouvelle transaction est calculée automatiquement selon le projet et la configuration de l’agence, ou forcée via settings.step.
  • Sur une transaction retrouvée par la déduplication, settings.step est ignoré, sauf pour rouvrir une location archivée. Changez l’étape d’une vente avec PATCH Sale, celle d’une acquisition avec Qualifier un acquéreur.

Alertes

Par défaut, un email d’alerte « nouveau lead » est envoyé à l’utilisateur attribué. Désactivez-le par requête avec settings.disableAlerts: true. Ce réglage ne coupe que cet email : les autres notifications de l’agence, comme le message Slack « nouveau lead » d’une vente, partent quand même.