> ## Documentation Index
> Fetch the complete documentation index at: https://developers.avest.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# Déduplication & allocation

> Comment les endpoints de création dédupliquent contacts et transactions, et attribuent agence et utilisateur.

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.

> [!NOTE]
>
> `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](https://developers.avest.fr/endpoints/patch-sale.md).

> [!NOTE]
>
> 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](https://developers.avest.fr/endpoints/get-agencies.md)
  * `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](https://developers.avest.fr/endpoints/patch-sale.md), celle d'une acquisition avec [Qualifier un acquéreur](https://developers.avest.fr/endpoints/post-acquisition-qualify.md).

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.