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

# POST Sale

> Crée ou met à jour une vente avec déduplication automatique du contact et de la transaction.

Crée ou met à jour une vente (estimation/mandat vendeur) avec déduplication automatique du contact et de la transaction.

## Endpoint

**URL** : `/external-integration/sale`
**Méthode** : `POST`
**Authentification** : Requiert un token LinkedAPI.
**Clé requise** : lecture-écriture. Une clé en lecture seule reçoit `403`. Voir [Types de clé](https://avest.mintlify.site/guides/authentification.md).

## Headers

```
Content-Type: application/json
Authorization: Bearer {token}
```

## Logique de fonctionnement

### 1. Déduplication Contact

* Recherche d'un contact existant par téléphone ou email dans le groupe d'agences
* Si trouvé : mise à jour des informations
* Si non trouvé : création d'un nouveau contact

### 2. Déduplication Transaction

* Si contact existant, recherche d'une vente active à la même adresse
* Si trouvée : mise à jour de la vente existante
* Si non trouvée : création d'une nouvelle vente

### 3. Allocation

* Attribution automatique d'un utilisateur et d'une agence selon les règles configurées
* Possibilité de forcer l'allocation via `settings.allocation`

### 4. Routing Step

* Calcul automatique de l'étape selon le projet et la configuration de l'agence
* Possibilité de forcer l'étape d'une nouvelle vente via `settings.step`. Sur une vente retrouvée par la déduplication, l'étape ne change pas : passez par [PATCH Sale](https://avest.mintlify.site/endpoints/patch-sale.md)

## Body Parameters

### Structure complète

```typescript theme={null}
{
    settings: {
        allocation: {
            agencyGroupId: string;           // Required - Groupe d'agences de votre clé (GET Agencies)
            agencyId?: string;               // Optional - Force l'agence (une agence de GET Agencies)
            userId?: string;                 // Optional - Force l'utilisateur (requiert agencyId)
            disableDeduplication?: boolean;  // Optional - Désactive la déduplication (défaut: false)
        };
        step?: string;                       // Optional - Force l'étape
        disableAlerts?: boolean;             // Optional - Désactive l'envoi de l'email d'alerte nouveau lead (défaut: false)
    };
    appointment?: {                          // Optional - vente et location - Crée un RDV
        date: string;                        // Required - Date ISO du RDV (ne peut pas être dans le passé)
        startAt?: string;                    // Optional - Heure de début ISO
        endAt?: string;                      // Optional - Heure de fin ISO
        note?: string;                       // Optional - Note du RDV
    };
    note?: {                                 // Optional - Crée une note
        title: string;                       // Required si note - Titre
        content?: string;                    // Optional - Contenu
    };
    transactionType: "sale";                 // Required
    contact?: {
        firstName?: string;
        lastName?: string;
        email?: string;
        isEmailVerified?: boolean;
        phone?: string;
        isPhoneVerified?: boolean;
    };
    address: string;                         // Required - Adresse complète du bien
    transaction: TransactionSale;            // Required - Données de la vente (property requis, objet vide accepté)
}
```

## Détail des paramètres

### settings.allocation

| Champ | Type | Requis | Description |
| - | - | - | - |
| `agencyGroupId` | ObjectId | ✅ | Groupe d'agences **de votre clé** : `agencyGroup.id` de [GET Agencies](https://avest.mintlify.site/endpoints/get-agencies.md). Un autre groupe est refusé (`400`). |
| `agencyId` | ObjectId | ❌ | Agence à qui attribuer le lead (force l'allocation). Doit figurer dans les `agencies` de [GET Agencies](https://avest.mintlify.site/endpoints/get-agencies.md) : une agence que votre clé ne couvre pas, ou désactivée, est refusée (`400`). |
| `userId` | ObjectId | ❌ | ID de l'utilisateur (force l'allocation, requiert agencyId) |
| `disableDeduplication` | Boolean | ❌ | Désactive la déduplication de transaction (défaut: false) |

Sans `agencyId`, l'attribution est automatique, parmi les agences du groupe.

### settings.disableAlerts

| Type | Requis | Description |
| - | - | - |
| Boolean | ❌ | Si `true`, l'email d'alerte « nouveau lead vendeur » n'est pas envoyé (défaut: `false`). Seul cet email est coupé : la notification Slack « nouveau lead » de l'agence part quand même. |

### settings.step

#### Étapes prospects vendeurs

| Valeur | Description |
| - | - |
| `PQUL` | Préqualification |
| `QUL` | Nouveau |
| `CNV` | Relance |
| `RDV` | Estimation (R1) |
| `DLV` | Remise (R2) |
| `MND` | Mandat signé |
| `ARC` | Archive |
| `STK` | Pioche |
| `TRN` | Prospection terrain |

#### Étapes mandats de vente (après signature mandat)

| Valeur | Description |
| - | - |
| `OFR` | Offre acceptée |
| `AGT` | Promesse signée |
| `MTG` | Clauses levées |
| `SLD` | Vente signée |
| `TARC` | Archive (transaction) |

### appointment (ventes et locations)

Crée une activité de type "meeting" liée à la transaction.

| Champ | Type | Requis | Description |
| - | - | - | - |
| `date` | Date ISO | ✅ | Date du rendez-vous (ne peut pas être dans le passé) |
| `startAt` | Date ISO | ❌ | Heure de début |
| `endAt` | Date ISO | ❌ | Heure de fin |
| `note` | String | ❌ | Note associée au rendez-vous |

À la création, `appointment` crée l'activité « Rendez-vous estimation » mais ne renseigne pas les dates d'estimation de la fiche (`timeline`).

### Créer la vente à l'étape rendez-vous

Si le rendez-vous d'estimation est déjà pris, envoyez dans la même requête `settings.step: "RDV"` et `appointment` : la vente est créée à l'étape RDV, avec son rendez-vous à venir.

```json theme={null}
{
  "settings": { "allocation": { "agencyGroupId": "66cc8a8e75c9fac35c6ecd73" }, "step": "RDV" },
  "appointment": { "date": "2026-11-05T00:00:00.000Z", "startAt": "2026-11-05T14:00:00.000Z", "endAt": "2026-11-05T15:00:00.000Z" },
  "transactionType": "sale",
  "address": "11 rue de Paris, 75001 Paris, France",
  "transaction": { "project": "S|S", "property": { "mainType": "apartment" } }
}
```

> [!WARNING]
>
> Ne créez pas la vente pour la passer ensuite à `RDV` avec
> [PATCH Sale](https://avest.mintlify.site/endpoints/patch-sale.md) sans `appointment` : le changement
> d'étape clôt les activités à faire de la fiche, dont le rendez-vous créé avec
> la vente. Si la vente est retrouvée par le dédoublonnage, `settings.step` ne
> s'applique pas : passez alors par PATCH Sale avec `step` et `appointment`
> dans la même requête.

### note

Crée une activité de type "note" liée à la transaction.

| Champ | Type | Requis | Description |
| - | - | - | - |
| `title` | String | ✅ (si note) | Titre de la note |
| `content` | String | ❌ | Contenu de la note |

### contact

| Champ | Type | Description |
| - | - | - |
| `firstName` | String | Prénom du contact |
| `lastName` | String | Nom du contact |
| `email` | String | Email du contact |
| `isEmailVerified` | Boolean | Email vérifié |
| `phone` | String | Téléphone au format international |
| `isPhoneVerified` | Boolean | Téléphone vérifié |

### address

| Type | Description |
| - | - |
| String | Adresse complète du bien (ex: "11 rue de Paris, 75001 Paris, France") |

> [!WARNING]
>
> L'adresse est située par Google. Si Google ne situe que la ville, la vente
> est enregistrée avec la ville seule, sans numéro ni rue, et la réponse reste
> un succès. Contrôlez `transaction.property.addressData` dans la réponse, ou
> relisez la vente avec [GET Sale](https://avest.mintlify.site/endpoints/get-sale.md) : si
> `property.addressData` n'a ni `streetNumber` ni `route`, corrigez l'adresse
> avec `address` dans [PATCH Sale](https://avest.mintlify.site/endpoints/patch-sale.md), écrite autrement
> (sans complément, sans lieu-dit). `property.addressData` n'est pas
> modifiable. Une adresse réduite à la ville peut aussi rattacher la demande à
> une autre vente du même contact dans la même ville.

## transaction (TransactionSale)

### Projet et identifiant

| Champ | Type | Description |
| - | - | - |
| `project` | String | Type de projet (voir valeurs ci-dessous) |
| `parsingCustomId` | String | Identifiant personnalisé externe |

| Valeur | Description |
| - | - |
| `B` | Acheteur (buyer) |
| `B&S` | Pas encore propriétaire vendeur |
| `S&B` | Vendeur acheteur |
| `O!S` | Pas vendeur |
| `S\|L` | Vendeur long terme |
| `S\|O` | En vente |
| `S\|S` | Vendeur court terme |
| `APT` | Demande de rendez-vous |

### Propriété (transaction.property)

`transaction.property` est **requis**, même vide : envoyez au moins `"property": {}`. Sans lui, la requête est refusée (`400`).

```typescript theme={null}
{
    mainType?: "house" | "apartment" | "building" | "field" | "parking" | "cellar" | "office" | "shop" | "industry" | "business_assets" | "lease_transfer";
    developmentType?: "old" | "new";
    generalCondition?: "toRenovate" | "standard" | "renovated";
    size?: number;                    // Surface en m²
    carrezSurface?: number;           // Surface Carrez en m²
    livingSurface?: number;           // Surface habitable en m²
    usefulSurface?: number;           // Surface utile en m²
    floorSurface?: number;            // Surface au sol en m²
    landSurface?: number;             // Surface du terrain en m²
    fieldSurface?: number;            // Surface du terrain en m²
    isSemiDetached?: boolean;         // Maison mitoyenne
    lotsNumbers?: string;             // Numéros de lots
    buildingYear?: number;            // Année de construction
    renovationYear?: number;          // Année de rénovation
    floor?: number;                   // Étage
    totalFloors?: number;             // Nombre total d'étages
    lastFloor?: number;               // Dernier étage
    isConstructible?: boolean;        // Terrain constructible
    isServiced?: boolean;             // Terrain viabilisé
    rooms?: number;                   // Nombre de pièces
    bedrooms?: number;                // Nombre de chambres
    bathrooms?: number;               // Nombre de salles de bain
    showerRooms?: number;             // Nombre de salles d'eau
    toilets?: number;                 // Nombre de WC
    isToiletIndependent?: boolean;    // WC indépendants
    kitchenType?: "open" | "independent";
    isKitchenEquipped?: boolean;      // Cuisine équipée
    balconyAmount?: number;           // Nombre de balcons
    balconySurface?: number;          // Surface balcons en m²
    loggiaAmount?: number;            // Nombre de loggias
    loggiaSurface?: number;           // Surface loggias en m²
    terraceAmount?: number;           // Nombre de terrasses
    terraceSurface?: number;          // Surface terrasses en m²
    gardenAmount?: number;            // Nombre de jardins
    gardenSurface?: number;           // Surface jardin en m²
    cellarAmount?: number;            // Nombre de caves
    cellarSurface?: number;           // Surface caves en m²
    atticAmount?: number;             // Nombre de greniers
    atticSurface?: number;            // Surface greniers en m²
    parkingType?: "outdoor" | "covered" | "garage";
    parkingAmount?: number;           // Nombre de places
    parkingSurface?: number;          // Surface parking en m²
    hasDisabledAccess?: boolean;      // Accès PMR
    hasElevator?: boolean;            // Ascenseur
    hasPool?: boolean;                // Piscine
    hasOpticalFiber?: boolean;        // Fibre optique
    hasFireplace?: boolean;           // Cheminée
    hasStove?: boolean;               // Poêle
    hasArmoredDoor?: boolean;         // Porte blindée
    hasVMC?: boolean;                 // VMC
    propertyTax?: number;             // Taxe foncière annuelle
    propertyTaxResponsibility?: "owner" | "tenant"; // Taxe foncière à la charge du bailleur ou du preneur (bien professionnel)
    vatRegime?: "subject" | "exempt";               // Bien professionnel soumis ou non à la TVA
    isCollectiveOwnership?: boolean;  // Copropriété
    collectiveMonthlyCost?: number;   // Charges mensuelles copropriété
    numberOfLots?: number;            // Nombre de lots
    isProcedure?: boolean;            // Procédure en cours
    hasBuildingManager?: boolean;     // Gardien/Syndic
    managedResidenceType?: string;    // Type résidence gérée
    heatingType?: "individual" | "community";
    heatingEnergyType?: "electric" | "gas" | "fuel" | "heat_pump" | "wood" | "pellets" | "air_conditioning" | "district_heating" | "solar" | "geothermal" | "other";
    waterDistributionType?: "collective" | "individual_electric" | "individual_gas" | "individual_fuel" | "individual_solar" | "individual_heat_pump" | "individual_wood" | "individual_other";
    isAirConditioning?: boolean;      // Climatisation
    glazingType?: "simple" | "double" | "triple";
    DPENumber?: string;               // Numéro DPE
    DPEEnergyValue?: number;          // Valeur énergie DPE
    DPEEnergyTag?: "A" | "B" | "C" | "D" | "E" | "F" | "G";
    DPEGESValue?: number;             // Valeur GES
    DPEGESTag?: "A" | "B" | "C" | "D" | "E" | "F" | "G";
    DPEDate?: string;                 // Date du DPE (ISO 8601)
    DPEDate3Years?: number[];         // Années des 3 derniers DPE
    minimumEnergyCost?: number;       // Coût énergie minimum
    maximumEnergyCost?: number;       // Coût énergie maximum
    energyCostDate?: string;          // Date estimation coûts (ISO 8601)
    hasBeautifulView?: boolean;       // Belle vue
    availabilityDate?: string;        // Date disponibilité (ISO 8601)
    hasRoofTop?: boolean;             // Toit-terrasse
    isDuplex?: boolean;               // Duplex
    occupancyStatus?: "free" | "rented";
    sanitationType?: "mainsDrainage" | "septicTankCompliant" | "septicTankNonCompliant";
    isPoolBuildable?: boolean;        // Piscine constructible
    roomDetails?: RoomDetail[];       // Détails des pièces
}
```

> [!NOTE]
>
> **DPE d'un bien professionnel** (`mainType` `office`, `shop`, `industry`,
> `business_assets` ou `lease_transfer`) : `DPEEnergyTag` et `DPEGESTag` sont
> enregistrés tels que vous les transmettez. Avest ne les calcule pas depuis
> `DPEEnergyValue`, `DPEGESValue` et la surface, dont les seuils sont ceux du
> logement : transmettez les étiquettes.

### Estimations (transaction.fieldValue, transaction.onlineValue)

```typescript theme={null}
{
    fieldValue?: {
        low?: number;     // Estimation basse terrain
        high?: number;    // Estimation haute terrain
    };
    onlineValue?: {
        low?: number;     // Estimation basse en ligne
        high?: number;    // Estimation haute en ligne
    };
}
```

### Mandat (transaction.mandate)

```typescript theme={null}
{
    mandate?: {
        sellPrice?: number;              // Net vendeur
        agencyCommission?: number;       // Montant des honoraires
        commissionType?: "value" | "percentage";
        commissionPercentage?: number;   // % d'honoraires, lu en mode "percentage"
        type?: "exclusive" | "semiExclusive" | "notExclusive";
        expirationDate?: string;         // Date expiration (ISO 8601)
        mandateDuration?: number;        // Durée mandat (mois)
        maxMandateDuration?: number;     // Durée max mandat (mois)
        referenceNumber?: string;        // Numéro de référence
        feeResponsibility?: "seller" | "buyer" | "both";
        sellerAgencyCommission?: number;           // Part vendeur, charge "both" seulement
        sellerAgencyCommissionPercentage?: number; // [0;100[, part vendeur en %, lue en mode "percentage"
    };
}
```

**Honoraires.** `agencyCommission` est un montant en euros, jamais un pourcentage : `5` donne 5 € d'honoraires. Pour saisir un pourcentage, envoyez `commissionType: "percentage"`, `commissionPercentage` et `sellPrice` : le montant des honoraires est alors calculé. À charge vendeur, le pourcentage porte sur le prix honoraires inclus ; à charge acquéreur, sur le net vendeur. Exemple : `{ "sellPrice": 505440, "commissionType": "percentage", "commissionPercentage": 2.8, "feeResponsibility": "seller" }` donne 14 560 € d'honoraires et un prix affiché de 520 000 €. Sans `commissionType`, `agencyCommission` est lu comme un montant et aucun pourcentage n'est calculé.

`sellPrice` est le net vendeur. Le prix affiché (`price`) se calcule seul : net vendeur + honoraires. N'envoyez pas le prix honoraires inclus dans `sellPrice`, et n'envoyez pas `price` : il n'est pas modifiable.

### Offre (transaction.offer)

```typescript theme={null}
{
    offer?: {
        sellPrice?: number;              // Net vendeur de l'offre
        agencyCommission?: number;       // Montant des honoraires
        commissionType?: "value" | "percentage";
        commissionPercentage?: number;   // % d'honoraires, lu en mode "percentage"
        feeResponsibility?: "seller" | "buyer" | "both";
        financing?: "loan" | "cash";     // Financement
        sellerAgencyCommission?: number;           // Part vendeur, charge "both" seulement
        sellerAgencyCommissionPercentage?: number; // [0;100[, part vendeur en %, lue en mode "percentage"
    };
}
```

L'offre n'est enregistrée que sur une vente à `MND` ou au-delà (`MND`, `OFR`, `AGT`, `MTG`, `SLD`, `TARC`) : sur une vente créée à une étape antérieure, elle est ignorée, et la réponse reste un succès.

Les honoraires de l'offre suivent la même règle que ceux du mandat : `agencyCommission` est un montant, `commissionType: "percentage"` le fait calculer depuis `commissionPercentage` (inférieur à 100, montants arrondis à l'euro).

**Part vendeur (`mandate` et `offer`)** : une part vendeur négative, non numérique ou supérieure à `agencyCommission` est refusée (`400`). Sans elle, un nouveau total garde la proportion de la part déjà enregistrée. Elle est vidée dès que la charge n'est plus `both`.

### Timeline (transaction.timeline)

```typescript theme={null}
{
    timeline?: {
        estimationDate?: string;           // Date estimation (ISO 8601)
        estimationStartAt?: string;        // Début estimation (ISO 8601)
        estimationEndAt?: string;          // Fin estimation (ISO 8601)
        offerDate?: string;                // Date offre (ISO 8601)
        agreementDate?: string;            // Date compromis (ISO 8601)
        mortgageDeadline?: string;         // Date limite prêt (ISO 8601)
        closingDate?: string;              // Date acte (ISO 8601)
        mandateSignatureDate?: string;     // Date signature mandat (ISO 8601)
        agreementExpirationDate?: string;  // Date expiration compromis (ISO 8601)
    };
}
```

## Exemple complet

```json theme={null}
{
  "settings": {
    "allocation": {
      "agencyGroupId": "66cc8a8e75c9fac35c6ecd73",
      "agencyId": "66cc91d475c9fac35c86ed80",
      "userId": "66cc91f05f84c9b212d9ec24",
      "disableDeduplication": false
    },
    "step": "QUL"
  },
  "appointment": {
    "date": "2025-01-20T00:00:00.000Z",
    "startAt": "2025-01-20T10:00:00.000Z",
    "endAt": "2025-01-20T11:00:00.000Z",
    "note": "Rendez-vous estimation"
  },
  "note": {
    "title": "Rappel client",
    "content": "Client très intéressé"
  },
  "transactionType": "sale",
  "contact": {
    "firstName": "Jean",
    "lastName": "Dupont",
    "email": "jean.dupont@email.com",
    "phone": "+33612345678"
  },
  "address": "11 rue de Paris, 75001 Paris, France",
  "transaction": {
    "project": "B",
    "property": {
      "mainType": "apartment",
      "size": 85,
      "rooms": 4,
      "bedrooms": 3,
      "hasElevator": true,
      "floor": 3,
      "DPEEnergyTag": "D",
      "DPEGESTag": "C"
    },
    "fieldValue": {
      "low": 220000,
      "high": 260000
    },
    "mandate": {
      "sellPrice": 250000,
      "agencyCommission": 12500,
      "feeResponsibility": "buyer",
      "type": "exclusive"
    },
    "parsingCustomId": "EXT-2025-001"
  }
}
```

Les `agencyGroupId` et `agencyId` de l'exemple sont ceux de l'exemple de [GET Agencies](https://avest.mintlify.site/endpoints/get-agencies.md) : remplacez-les par ceux que GET Agencies renvoie pour votre clé, et `userId` par un collaborateur de cette agence ([GET Users](https://avest.mintlify.site/endpoints/get-users.md) liste ceux du groupe).

## Réponse de succès

**Code** : `200`

```json theme={null}
{
  "success": true,
  "avestId": "V-2025-001",
  "user": {
    "id": "66cc91f05f84c9b212d9ec24",
    "firstName": "Marie",
    "lastName": "Martin",
    "jobTitle": "Agent immobilier",
    "email": "marie.martin@agence.com",
    "phone": "+33601020304"
  },
  "contact": {
    "id": "618a35a36d932054e195ca0a",
    "firstName": "Jean",
    "lastName": "Dupont"
  },
  "transaction": {
    "id": "619b46b47e043165f206db1b",
    "customId": "V-2025-001",
    "step": "QUL",
    "project": "B",
    "property": {
      "addressData": {
        "streetNumber": "11",
        "route": "Rue de Paris",
        "postalCode": "75001",
        "city": "Paris",
        "country": "France",
        "countryCode": "FR",
        "formattedAddress": "11 Rue de Paris, 75001 Paris, France"
      },
      "addresses": [
        {
          "streetNumber": "11",
          "route": "Rue de Paris",
          "postalCode": "75001",
          "city": "Paris",
          "country": "France",
          "countryCode": "FR",
          "formattedAddress": "11 Rue de Paris, 75001 Paris, France"
        }
      ]
    }
  }
}
```

`transaction.property.addressData` est l'adresse reconnue et enregistrée sur le bien, au format de [GET Sale](https://avest.mintlify.site/endpoints/get-sale.md) ; `transaction.property.addresses` la contient aussi. Comparez-la à l'`address` envoyée pour repérer une adresse mal reconnue. Elle n'est pas renvoyée si la fiche est attribuée à une agence que votre clé ne couvre pas, comme sur GET.

## Réponses d'erreur

* **Settings manquants** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Settings is required"
}
```

* **Allocation manquante** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Settings allocation is required"
}
```

* **AgencyGroupId manquant** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Agency group ID is required"
}
```

* **Groupe d'agences hors du périmètre de votre clé** : `400 Bad Request`, aucun lead créé

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Agency group is not in the authorized scope of this LinkedAPI"
}
```

* **Agence de votre groupe que votre clé ne couvre pas, ou désactivée** : `400 Bad Request`, aucun lead créé (une agence d'un autre groupe reçoit, avec le même préfixe, `Agency group ID is not the same as the agency group ID`)

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Agency is not in the authorized scope of this LinkedAPI"
}
```

* **`transaction.property` manquant** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Invalid transaction : property required"
}
```

* **Adresse manquante** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : Invalid body : address required"
}
```

* **Date de rendez-vous dans le passé** : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : appointment.date cannot be in the past"
}
```

* **`appointment` sur un type non supporté** (acquisition) : `400 Bad Request`

```json theme={null}
{
  "success": false,
  "message": "LeadGenerationExternalSale : appointment is only available for sales and rentals"
}
```

## Notes importantes

1. **Déduplication** : Par défaut, si un contact existe avec le même téléphone/email, la vente existante à la même adresse sera mise à jour plutôt que d'en créer une nouvelle.

2. **Allocation automatique** : Sans `agencyId`/`userId`, le système alloue automatiquement selon les règles configurées (zones, shifts, priorité contact, etc.)

3. **Activités** : `appointment` et `note` créent des activités séparées liées à la transaction. En cas d'erreur sur ces créations, la transaction est quand même créée (notification Slack envoyée).

4. **Steps** : Si `settings.step` n'est pas fourni, l'étape est calculée automatiquement selon le `project` et la configuration de l'agence.

5. **Identifiant externe** : `parsingCustomId` est enregistré sur la fiche et renvoyé en lecture, mais il ne sert pas au dédoublonnage. Deux envois avec le même `parsingCustomId` peuvent créer deux ventes. Pour mettre à jour une vente déjà créée, conservez l'`id` renvoyé à la création et passez par [PATCH Sale](https://avest.mintlify.site/endpoints/patch-sale.md).

## Rate limits

Cette route est limitée à **100 req / minute par groupe d'agences** (bucket dédié, indépendant des autres routes).

* Headers présents sur **toutes** les réponses : `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (secondes avant reset).
* Dépassement → `429 Too Many Requests` avec header `Retry-After` (secondes) :

```json theme={null}
{
  "success": false,
  "message": "Rate limit exceeded",
  "retryAfter": 27
}
```

* Si vous atteignez régulièrement la limite, contactez le support pour évaluer un relèvement sur votre token.


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