Passer au contenu principal
Fait progresser une mise en relation existante dans l’entonnoir commercial. C’est la route à utiliser quand votre outil sait qu’un acquéreur a été relancé, s’est déplacé, ou s’est désisté.

Endpoint

URL : /external-integration/match/{matchId} Méthode : PATCH Authentification : token LinkedAPI avec scope externalIntegration en écriture. Clé requise : lecture-écriture. Une clé en lecture seule reçoit 403. Voir Types de clé.
Seule l’étape est modifiable. Les autres champs du match (rapprochement, contacts, tags) ne sont pas éditables via l’API.

Path Parameters

Body Parameters

Règles de transition

L’entonnoir est à sens unique. Trois règles :
  1. On peut monter. Toute étape de poids supérieur à l’étape courante est acceptée (MSND → MCNV, MRQT → MNGT…). Les sauts d’étape sont permis. Seule exception : MVST exige une visite active (voir ci-dessous).
  2. On peut classer sans suite, sur place. Depuis MVST, seule MVST_NF est acceptée — et stepUpdateReason devient obligatoire. On ne peut pas classer sans suite à un stade que la mise en relation n’a jamais atteint.
  3. On ne redescend jamais. Une régression est refusée, et une étape _NF est terminale : un match classé sans suite ne peut pas être rouvert via l’API (rouvrir ressusciterait ses offres retirées côté Avest).
MOFA et MOFA_NF ne sont pas accessibles via l’API. Passer une mise en relation en « offre acceptée » écrit sur la vente, la fait basculer à l’étape OFR et classe sans suite toutes les autres mises en relation du bien. Cette action reste dans l’application Avest, au même titre que le statut d’offre accepted.

MVST exige une visite

Un match ne passe en MVST (« Visite planifiée ») que s’il porte au moins une visite active (ni annulée ni supprimée). Sans visite, la requête est refusée en 400 et l’étape ne change pas :
Ce message n’est pas préfixé par ExternalIntegrationUpdateMatchStep. Pour planifier une visite, créez-la avec POST une visite : la date est enregistrée et le match passe en MVST. Le détail des 14 étapes est documenté dans GET Match.

Exemple

Pour déclarer une visite, utilisez POST une visite : le match passe automatiquement en MVST et la date est enregistrée. Cette route ne pose que l’étape, et refuse MVST sans visite active.

Réponses d’erreur

Rate limits

100 req / minute par groupe d’agences (bucket d’écriture).