Passer au contenu principal
Comme les visites, une offre est un objet daté rattaché au match. Ces routes permettent de la lire et de l’écrire directement.

Endpoints

Authentification : token LinkedAPI avec scope externalIntegration. POST et PATCH exigent l’autorisation en écriture. Clé requise : GET avec toutes les clés ; POST et PATCH en lecture-écriture (une clé en lecture seule reçoit 403). Voir Types de clé.
Le statut accepted n’est pas accepté par l’API externe. Accepter une offre écrit sur la vente (prix, honoraires, financement), la fait passer à l’étape OFR et classe sans suite toutes les autres mises en relation du bien — y compris des acquéreurs hors de votre périmètre. Cette action reste volontairement dans l’application Avest.
Créer une offre promeut automatiquement le match à l’étape MOFF s’il était à une étape antérieure. Un statut terminal (rejected, withdrawn, cancelled) peut à l’inverse classer le match « sans suite ».

Headers

GET — lister les offres

Les offres sont triées par data.offerDate décroissant. En charge partagée (feeResponsibility: both), une offre saisie dans Avest peut porter la part vendeur des honoraires : data.sellerAgencyCommission, et data.sellerAgencyCommissionPercentage en mode pourcentage. Ces champs ne s’écrivent pas par l’API.

POST — créer une offre

Body Parameters

offerDate est requis, ainsi qu’au moins un de sellPrice / agencyCommission.

Statuts d’offre

Exemple

PATCH — faire évoluer une offre

Mêmes champs que le POST (tous optionnels, au moins un requis), plus les path parameters matchId et activityId. accepted y est refusé de la même manière. En charge partagée, des honoraires (agencyCommission) inférieurs à la part vendeur enregistrée sont refusés (400) et l’offre n’est pas modifiée. Passer feeResponsibility à seller ou buyer efface la part vendeur.

Réponses d’erreur

Rate limits

GET : 500 req / minute. POST et PATCH : 100 req / minute.