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 :- 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 :MVSTexige une visite active (voir ci-dessous). - On peut classer sans suite, sur place. Depuis
MVST, seuleMVST_NFest acceptée — etstepUpdateReasondevient obligatoire. On ne peut pas classer sans suite à un stade que la mise en relation n’a jamais atteint. - On ne redescend jamais. Une régression est refusée, et une étape
_NFest terminale : un match classé sans suite ne peut pas être rouvert via l’API (rouvrir ressusciterait ses offres retirées côté Avest).
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 :
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.