Passer au contenu principal
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é.
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.

Comment les lire

Les identifiants de match s’obtiennent via GET Match Search (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 : 20 par page, triée par createdAt décroissant.

Types renvoyés

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

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

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.
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.
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 : 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) :
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). Le détail des étapes est documenté dans GET Match.