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

# Visites & offres

> Lire les visites et les offres d'une mise en relation (match) via les activités.

Depuis la refonte du parcours acquéreur, une **visite** et une **offre** ne sont
plus des dates posées sur la mise en relation : ce sont des **activités datées,
rattachées au match**. Elles sont lisibles dès aujourd'hui, sans endpoint
dédié.

> [!NOTE]
>
> `GET /external-integration/match` ne renvoie **pas** ces objets. Le match
> expose son étape courante (`MVST` = étape visite atteinte), pas les dates.
> Voir [GET Match](https://developers.avest.fr/endpoints/get-match.md).

## Comment les lire

```bash theme={null}
GET /external-integration/activities?document={matchId}&documentType=match
Authorization: Bearer your-linked-api-token
```

Les identifiants de match s'obtiennent via
[GET Match Search](https://developers.avest.fr/endpoints/get-match-search.md) (par `sale` et/ou
`acquisition`), puis se réutilisent tels quels comme `document`.

La réponse est la liste paginée standard de
[GET Activities](https://developers.avest.fr/endpoints/get-activities.md) : 20 par page, triée par
`createdAt` décroissant.

## Types renvoyés

| `type` | Sens |
| - | - |
| `visit` | Une visite : planifiée, réalisée, ou annulée (`data.isCancelled`). |
| `offer` | Une offre, avec son statut et son historique. |
| `visitChangeLog` | Journal des modifications d'une visite. |
| `offerChangeLog` | Journal des modifications d'une offre. |

> [!WARNING]
>
> **Il n'existe pas de filtre par `type`.** La requête ci-dessus renvoie *toutes*
> les activités du match — notes, emails, changements d'étape compris. Filtrez
> côté client. Les `visitChangeLog` sont nettement plus nombreux que les
> `visit` : ignorez-les si vous ne suivez que les visites.

> [!WARNING]
>
> **Le tri est `createdAt`, pas la date de visite.** Une visite saisie
> aujourd'hui pour une date passée remonte avant une visite saisie hier pour
> demain. Pour « la dernière visite », triez côté client sur `data.visitStartAt`
> — ne prenez pas le premier élément de la liste.

## `data` d'une activité `visit`

```json theme={null}
{
  "id": "6a04a0aed4948142783f8ce1",
  "type": "visit",
  "linkedDocument": "6a04a0aed4948142783f8cdf",
  "linkedModel": "match",
  "data": {
    "visitStartAt": "2026-06-12T14:00:00.000Z",
    "visitEndAt": "2026-06-12T15:00:00.000Z",
    "isCancelled": false,
    "title": "Visite T3 Bordeaux Chartrons",
    "content": "Visite avec les deux acquéreurs."
  },
  "createdAt": "2026-06-05T09:12:31.004Z"
}
```

| Champ | Type | Description |
| - | - | - |
| `visitStartAt` | ISO 8601 | **Date/heure de la visite.** Champ de référence. |
| `visitEndAt` | ISO 8601 | Fin de la visite, si renseignée. |
| `isCancelled` | Boolean | `true` si la visite a été annulée. L'activité **reste présente**. |
| `title` | String | Intitulé. |
| `content` | String | Compte-rendu / commentaire. |
| `visitDate` | ISO 8601 | Ancien champ de date, conservé sur les visites historiques. **Déprécié de fait** : utilisez `visitStartAt`. |
| `sale` | Object | Instantané de la vente concernée au moment de la visite. |
| `acquisition` | Object | Instantané de l'acquisition concernée au moment de la visite. |

> [!WARNING]
>
> Une visite annulée n'est **pas supprimée** : elle reste dans la liste avec
> `isCancelled: true`. Filtrez explicitement si vous ne voulez que les visites
> actives.

## `data` d'une activité `offer`

```json theme={null}
{
  "id": "6a04a0aed4948142783f8ce2",
  "type": "offer",
  "linkedDocument": "6a04a0aed4948142783f8cdf",
  "linkedModel": "match",
  "data": {
    "offerDate": "2026-06-18T10:30:00.000Z",
    "status": "transmitted",
    "amount": 285000,
    "sellPrice": 299000,
    "acceptanceDate": null
  },
  "createdAt": "2026-06-18T10:31:02.771Z"
}
```

| Champ | Type | Description |
| - | - | - |
| `offerDate` | ISO 8601 | **Date de l'offre.** Champ de référence. |
| `status` | String | Statut courant : `transmitted`, `received`, `accepted`, `rejected`, `rejected_counter_offer`, `withdrawn`, `cancelled`. |
| `statusHistory` | Array | Historique des changements de statut. |
| `amount` | Number | Montant proposé. |
| `sellPrice` | Number | Prix de vente affiché au moment de l'offre. |
| `counterOfferAmount` | Number | Montant de la contre-proposition, le cas échéant. |
| `acceptanceDate` | ISO 8601 | Date d'acceptation, si l'offre a été acceptée. |
| `agencyCommission` | Number | Commission d'agence. |
| `commissionCharge` | String | Qui supporte la commission. |
| `feeResponsibility` | String | Répartition des frais. |
| `financing` | String | Mode de financement annoncé. |
| `deposit` | Number | Dépôt de garantie. |
| `content` | String | Commentaire libre. |
| `sale` / `acquisition` | Object | Instantanés de la vente et de l'acquisition concernées. |

## `data` d'un `visitChangeLog` / `offerChangeLog`

Journal de modification. `action` décrit l'opération, et `visitActivityId`
(respectivement `offerActivityId`) pointe l'activité `visit` / `offer`
concernée.

> [!WARNING]
>
> **`data` est un objet ouvert.** Les tableaux ci-dessus listent les champs
> connus et stables, mais des champs supplémentaires peuvent être présents et
> la liste peut évoluer sans préavis. Ne validez pas `data` en mode strict.

> [!WARNING]
>
> **Données personnelles.** Sur une activité `visit` ou `offer`, `data.sale` et
> `data.acquisition` contiennent des instantanés pouvant inclure des
> **coordonnées de contact** (nom, email, téléphone). Ces données sont soumises
> au RGPD au même titre que celles de
> [GET Contact](https://developers.avest.fr/endpoints/get-contact.md) : limitez leur stockage et leur
> diffusion à ce qui est nécessaire.

## Écrire une visite ou une offre

`POST /external-integration/activity` n'accepte toujours que les types `note`,
`task`, `call`, `message`, `email`, `meeting`, `appointment`, et son
`documentType` reste limité à `acquisition`, `sale`, `rental`, `contact` : on ne
crée pas une visite par cette route.

Les visites et les offres ont leurs **routes dédiées**, qui appliquent les règles
métier (mise à jour de l'étape du match, dates, statuts) :

* [Visites d'un match](https://developers.avest.fr/endpoints/match-visits.md) — lister, créer, déplacer, annuler
* [Offres d'un match](https://developers.avest.fr/endpoints/match-offers.md) — lister, créer, faire évoluer

> [!NOTE]
>
> Pour **lire**, ces routes dédiées sont préférables à cette page : elles
> filtrent déjà sur le bon type, trient par date métier et ajoutent le
> `derivedStatus` des visites.

## Lien avec l'étape du match

L'étape `MVST` signale que la mise en relation a atteint le stade « visite ».
Elle ne porte pas la date : croisez-la avec les activités ci-dessus. Un match
ne peut être passé en `MVST` via l'API que s'il porte une visite active (voir
[PATCH Match](https://developers.avest.fr/endpoints/patch-match.md)). Le détail
des étapes est documenté dans [GET Match](https://developers.avest.fr/endpoints/get-match.md).


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