Met à jour une vente existante en la ciblant par son identifiant, ce qui supprime tout risque de doublon.
POST /external-integration/sale retrouve la vente par contact + adresse : si l’adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape.
saleId accepte l’id (ObjectId) ou le customId de la vente, tous deux renvoyés en lecture. Si un customId correspond à plusieurs ventes de votre périmètre, la requête est refusée (400) plutôt que d’en modifier une au hasard : ciblez alors par id.
Seuls les champs listés dans UpdateSaleBody sont modifiables. contacts, customId, parsingCustomId, commission et state ne le sont pas.
Pour poser un rendez-vous d’estimation, utilisez appointment : il renseigne les dates officielles de la fiche et crée l’activité correspondante. Écrire timeline seul renseigne les dates sans créer d’activité.
En cas de modification concurrente : 409 avec le code TRANSACTION_EDIT_CONFLICT, rejouer la requête.
Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.
La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.
Paramètres de chemin
saleId
string
requis
id (ObjectId) ou customId de la vente.
Corps
application/json
Au moins un champ. contacts, customId, parsingCustomId, commission et state ne sont pas modifiables par cette route.
step
enum<string>
Nouvelle étape de la vente. Le changement produit les mêmes effets que depuis l'interface (activité de changement d'étape, stepUpdatedAt, commission, séquences paramétrées par l'agence). Vers une étape de QUL à DLV, les activités à faire de la fiche sont closes (rendez-vous compris, visites et offres exceptées). Une vente sans responsable ne sort de STK, TRN, PQUL, ARC, SLD ou TARC qu'avec owner dans la même requête : sinon l'étape reste inchangée, avec un 200. Passer en STK retire le responsable et supprime les activités non clôturées (visites et offres conservées).
Options disponibles:
STK,
TRN,
ARC,
PQUL,
QUL,
CNV,
RDV,
DLV,
MND,
TARC,
OFR,
AGT,
MTG,
SLD
stepUpdateReason
enum<string>
Motif accompagnant le changement d'étape. Vers ARC : fakePhone, unreachable, spam, noFollowUp ou lostMandate. Vers TARC : marketedElsewhere, soldByOtherAgency, soldByOwner, saleWithdrawn, lostMandate ou noFollowUp. Sinon 400 (Invalid stepUpdateReason for step ARC). fakePhone marque aussi les téléphones du contact comme invalides.
Options disponibles:
fakePhone,
unreachable,
spam,
noFollowUp,
lostMandate,
marketedElsewhere,
soldByOtherAgency,
soldByOwner,
saleWithdrawn
project
string
Projet du vendeur (S|S, S|L, S|O, APT, ...).
status
string
Statut, dépendant de l'étape courante.
fieldValue
object
Fourchette de valeurs.
Show child attributes
onlineValue
object
Fourchette de valeurs.
Show child attributes
timeline
object
Dates officielles du dossier. Ce sont les dates affichées sur la fiche : estimationDate est la date du rendez-vous d'estimation, pas la date d'une activité. Envoyer null sur une date l'efface.
Show child attributes
appointment
object
Raccourci : renseigne le créneau d'estimation (timeline.estimationDate / estimationStartAt / estimationEndAt) et crée l'activité « Rendez-vous estimation ». Sur POST /external-integration/sale, le même champ crée l'activité sans renseigner les dates de la fiche. Envoyé avec step, le rendez-vous est créé après le changement d'étape et reste ouvert. L'activité créée est renvoyée dans la réponse.
Show child attributes
property
object
Caractéristiques du bien. L'adresse ne s'écrit pas ici : utilisez le champ address.
Show child attributes
address
string
Adresse en texte libre, géocodée comme à la création. Remplace l'adresse enregistrée sur le bien. Si Google ne situe que la ville, la vente est enregistrée sans numéro ni rue : contrôlez property.addressData dans la réponse.
owner
string
Collaborateur responsable de la fiche. Doit appartenir aux agences de votre clé API, sinon la requête est refusée et rien n'est écrit.
Pattern: ^[a-fA-F0-9]{24}$
Exemple:
"618a35a36d932054e195ca0a"
tags
string[]
Liste complète des tags de la vente : les tags absents de la liste sont retirés. Chaque tag doit exister dans votre périmètre.
Identifiant Mongo (24 caractères hexadécimaux).
Pattern: ^[a-fA-F0-9]{24}$
mandate
object
Montants en euros. sellPrice est le net vendeur. Le prix affiché honoraires inclus (price) est calculé : net vendeur + honoraires. Pour saisir les honoraires en pourcentage, envoyez commissionType: percentage et commissionPercentage : le montant des honoraires est alors calculé.
Show child attributes
offer
object
Mêmes règles que le mandat : montants en euros, sellPrice net vendeur, honoraires en pourcentage avec commissionType: percentage (montants arrondis à l'euro, pourcentage inférieur à 100). L'offre n'est enregistrée que sur une vente à MND ou au-delà ; un changement d'étape vers une autre étape que OFR, AGT, MTG ou SLD l'efface.
Show child attributes
Réponse
Vente mise à jour.
success
boolean
sale
object
Vente en lecture. id, customId, agency, agencyGroup, step, createdAt, updatedAt, stepUpdatedAt, owner et mainContact sont toujours présents (si la vente existe). Les autres champs sont absents s'ils ne sont pas renseignés.
Show child attributes
activity
object
Activité « Rendez-vous estimation » créée. Présente uniquement si appointment était fourni.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Avest API","description":"Documentation de l'API d'intégration externe Avest","colors":{"primary":"#0D9488","light":"#2DD4BF","dark":"#0F766E"},"footer":{"socials":{"website":"https://avest.fr"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"fr","href":"introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"avest","hasAudioNarration":false,"actualSubdomain":"avest","customDomains":[],"gitSource":{"type":"github","owner":"avest-vap","repo":"avest-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6ae371367879ae8452f7e8ea"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aecda1cdf343a7ca61a6ddc","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"fr","tag":"Guides","count":35},{"language":"fr","tag":"Référence API","count":33},{"language":"fr","tag":"Endpoints","count":31},{"language":"fr","tag":"Transactions","count":15},{"language":"fr","tag":"Matches","count":9},{"language":"fr","tag":"Contacts","count":8},{"language":"fr","tag":"Match","count":6},{"language":"fr","tag":"Activités","count":4},{"language":"fr","tag":"Démarrage","count":4},{"language":"fr","tag":"Activities","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant","slug":"/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant","pageMetadata":{"title":"Mettre à jour une vente ciblée par identifiant","description":"Met à jour une vente existante en la **ciblant par son identifiant**, ce qui supprime tout risque de doublon.\n\n`POST /external-integration/sale` retrouve la vente par contact + adresse : si l'adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape.\n\n`saleId` accepte l'`id` (ObjectId) **ou** le `customId` de la vente, tous deux renvoyés en lecture. Si un `customId` correspond à plusieurs ventes de votre périmètre, la requête est refusée (`400`) plutôt que d'en modifier une au hasard : ciblez alors par `id`.\n\nSeuls les champs listés dans `UpdateSaleBody` sont modifiables. `contacts`, `customId`, `parsingCustomId`, `commission` et `state` ne le sont pas.\n\nPour poser un rendez-vous d'estimation, utilisez `appointment` : il renseigne les dates officielles de la fiche **et** crée l'activité correspondante. Écrire `timeline` seul renseigne les dates sans créer d'activité.\n\nEn cas de modification concurrente : `409` avec le code `TRANSACTION_EDIT_CONFLICT`, rejouer la requête.","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/sale/{saleId}","href":"/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Met à jour une vente existante en la \", _jsx(_components.strong, {\n children: \"ciblant par son identifiant\"\n }), \", ce qui supprime tout risque de doublon.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"POST /external-integration/sale\"\n }), \" retrouve la vente par contact + adresse : si l’adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.code, {\n children: \"saleId\"\n }), \" accepte l’\", _jsx(_components.code, {\n children: \"id\"\n }), \" (ObjectId) \", _jsx(_components.strong, {\n children: \"ou\"\n }), \" le \", _jsx(_components.code, {\n children: \"customId\"\n }), \" de la vente, tous deux renvoyés en lecture. Si un \", _jsx(_components.code, {\n children: \"customId\"\n }), \" correspond à plusieurs ventes de votre périmètre, la requête est refusée (\", _jsx(_components.code, {\n children: \"400\"\n }), \") plutôt que d’en modifier une au hasard : ciblez alors par \", _jsx(_components.code, {\n children: \"id\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Seuls les champs listés dans \", _jsx(_components.code, {\n children: \"UpdateSaleBody\"\n }), \" sont modifiables. \", _jsx(_components.code, {\n children: \"contacts\"\n }), \", \", _jsx(_components.code, {\n children: \"customId\"\n }), \", \", _jsx(_components.code, {\n children: \"parsingCustomId\"\n }), \", \", _jsx(_components.code, {\n children: \"commission\"\n }), \" et \", _jsx(_components.code, {\n children: \"state\"\n }), \" ne le sont pas.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Pour poser un rendez-vous d’estimation, utilisez \", _jsx(_components.code, {\n children: \"appointment\"\n }), \" : il renseigne les dates officielles de la fiche \", _jsx(_components.strong, {\n children: \"et\"\n }), \" crée l’activité correspondante. Écrire \", _jsx(_components.code, {\n children: \"timeline\"\n }), \" seul renseigne les dates sans créer d’activité.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"En cas de modification concurrente : \", _jsx(_components.code, {\n children: \"409\"\n }), \" avec le code \", _jsx(_components.code, {\n children: \"TRANSACTION_EDIT_CONFLICT\"\n }), \", rejouer la requête.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Mettre à jour une vente ciblée par identifiant","description":"Met à jour une vente existante en la **ciblant par son identifiant**, ce qui supprime tout risque de doublon.\n\n`POST /external-integration/sale` retrouve la vente par contact + adresse : si l'adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape.\n\n`saleId` accepte l'`id` (ObjectId) **ou** le `customId` de la vente, tous deux renvoyés en lecture. Si un `customId` correspond à plusieurs ventes de votre périmètre, la requête est refusée (`400`) plutôt que d'en modifier une au hasard : ciblez alors par `id`.\n\nSeuls les champs listés dans `UpdateSaleBody` sont modifiables. `contacts`, `customId`, `parsingCustomId`, `commission` et `state` ne le sont pas.\n\nPour poser un rendez-vous d'estimation, utilisez `appointment` : il renseigne les dates officielles de la fiche **et** crée l'activité correspondante. Écrire `timeline` seul renseigne les dates sans créer d'activité.\n\nEn cas de modification concurrente : `409` avec le code `TRANSACTION_EDIT_CONFLICT`, rejouer la requête.","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/sale/{saleId}","href":"/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Transactions"],"operationId":"updateSale","summary":"Mettre à jour une vente ciblée par identifiant","description":"Met à jour une vente existante en la **ciblant par son identifiant**, ce qui supprime tout risque de doublon.\n\n`POST /external-integration/sale` retrouve la vente par contact + adresse : si l'adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape.\n\n`saleId` accepte l'`id` (ObjectId) **ou** le `customId` de la vente, tous deux renvoyés en lecture. Si un `customId` correspond à plusieurs ventes de votre périmètre, la requête est refusée (`400`) plutôt que d'en modifier une au hasard : ciblez alors par `id`.\n\nSeuls les champs listés dans `UpdateSaleBody` sont modifiables. `contacts`, `customId`, `parsingCustomId`, `commission` et `state` ne le sont pas.\n\nPour poser un rendez-vous d'estimation, utilisez `appointment` : il renseigne les dates officielles de la fiche **et** crée l'activité correspondante. Écrire `timeline` seul renseigne les dates sans créer d'activité.\n\nEn cas de modification concurrente : `409` avec le code `TRANSACTION_EDIT_CONFLICT`, rejouer la requête.","parameters":["d0e56532-24b0-4d99-8089-30aac4e87e68"],"requestBody":"1d1cde66-3fdc-43b6-89b8-9315d6e7714c","responses":{"200":"ac17b718-c976-42df-922a-b8fa7298ea26","400":"1b3f6ce1-ad6b-422f-9538-2d0e70fe2e42","401":"ecc9aea6-8037-4f3c-8ed9-9750a8556010","403":"7da54867-cfc6-46c0-953e-412965971512","429":"0e90ba7c-a880-4d6c-9045-3f50a36b7d1c"},"method":"patch","type":"path","servers":["e15be152-2381-40d8-ad40-a5594816c16a"],"security":["4a97fb4f-cac0-4748-bb5e-5bf85887eb04"],"path":"/external-integration/sale/{saleId}","baseUrlOptions":["https://api.avest.fr/v1"],"title":"Mettre à jour une vente ciblée par identifiant","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d0e56532-24b0-4d99-8089-30aac4e87e68":{"name":"saleId","in":"path","required":true,"description":"`id` (ObjectId) ou `customId` de la vente.","schema":{"type":"string","isRequired":true,"description":"`id` (ObjectId) ou `customId` de la vente.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Au moins un champ. `contacts`, `customId`, `parsingCustomId`, `commission` et `state` ne sont pas modifiables par cette route.","properties":{"step":{"type":"string","description":"Nouvelle étape de la vente. Le changement produit les mêmes effets que depuis l'interface (activité de changement d'étape, `stepUpdatedAt`, commission, séquences paramétrées par l'agence). Vers une étape de `QUL` à `DLV`, les activités à faire de la fiche sont closes (rendez-vous compris, visites et offres exceptées). Une vente sans responsable ne sort de `STK`, `TRN`, `PQUL`, `ARC`, `SLD` ou `TARC` qu'avec `owner` dans la même requête : sinon l'étape reste inchangée, avec un `200`. Passer en `STK` retire le responsable et supprime les activités non clôturées (visites et offres conservées).","enum":["STK","TRN","ARC","PQUL","QUL","CNV","RDV","DLV","MND","TARC","OFR","AGT","MTG","SLD"],"uniqueKey":"step","typeLabel":"enum\u003cstring>"},"stepUpdateReason":{"type":"string","enum":["fakePhone","unreachable","spam","noFollowUp","lostMandate","marketedElsewhere","soldByOtherAgency","soldByOwner","saleWithdrawn"],"description":"Motif accompagnant le changement d'étape. Vers `ARC` : `fakePhone`, `unreachable`, `spam`, `noFollowUp` ou `lostMandate`. Vers `TARC` : `marketedElsewhere`, `soldByOtherAgency`, `soldByOwner`, `saleWithdrawn`, `lostMandate` ou `noFollowUp`. Sinon `400` (`Invalid stepUpdateReason for step ARC`). `fakePhone` marque aussi les téléphones du contact comme invalides.","uniqueKey":"stepUpdateReason","typeLabel":"enum\u003cstring>"},"project":{"type":"string","description":"Projet du vendeur (`S|S`, `S|L`, `S|O`, `APT`, ...).","uniqueKey":"project","typeLabel":"string"},"status":{"type":"string","description":"Statut, dépendant de l'étape courante.","uniqueKey":"status","typeLabel":"string"},"fieldValue":{"type":"object","description":"Fourchette de valeurs.","properties":{"low":{"type":"number","uniqueKey":"fieldValue.low","typeLabel":"number"},"high":{"type":"number","uniqueKey":"fieldValue.high","typeLabel":"number"}},"uniqueKey":"fieldValue","typeLabel":"object"},"onlineValue":{"type":"object","description":"Fourchette de valeurs.","properties":{"low":{"type":"number","uniqueKey":"onlineValue.low","typeLabel":"number"},"high":{"type":"number","uniqueKey":"onlineValue.high","typeLabel":"number"}},"uniqueKey":"onlineValue","typeLabel":"object"},"timeline":{"type":"object","description":"Dates officielles du dossier. Ce sont les dates affichées sur la fiche : `estimationDate` est la date du rendez-vous d'estimation, pas la date d'une activité. Envoyer `null` sur une date l'efface.","properties":{"estimationDate":{"type":"string","uniqueKey":"timeline.estimationDate","typeLabel":"string"},"estimationStartAt":{"type":"string","uniqueKey":"timeline.estimationStartAt","typeLabel":"string"},"estimationEndAt":{"type":"string","uniqueKey":"timeline.estimationEndAt","typeLabel":"string"},"offerDate":{"type":"string","uniqueKey":"timeline.offerDate","typeLabel":"string"},"agreementDate":{"type":"string","uniqueKey":"timeline.agreementDate","typeLabel":"string"},"mortgageDeadline":{"type":"string","uniqueKey":"timeline.mortgageDeadline","typeLabel":"string"},"closingDate":{"type":"string","uniqueKey":"timeline.closingDate","typeLabel":"string"},"mandateSignatureDate":{"type":"string","uniqueKey":"timeline.mandateSignatureDate","typeLabel":"string"},"agreementExpirationDate":{"type":"string","uniqueKey":"timeline.agreementExpirationDate","typeLabel":"string"}},"uniqueKey":"timeline","typeLabel":"object"},"appointment":{"type":"object","description":"Raccourci : renseigne le créneau d'estimation (`timeline.estimationDate` / `estimationStartAt` / `estimationEndAt`) **et** crée l'activité « Rendez-vous estimation ». Sur `POST /external-integration/sale`, le même champ crée l'activité sans renseigner les dates de la fiche. Envoyé avec `step`, le rendez-vous est créé après le changement d'étape et reste ouvert. L'activité créée est renvoyée dans la réponse.","required":["date"],"properties":{"date":{"type":"string","description":"Date ISO du rendez-vous d'estimation. Contrairement à la création, une date passée est acceptée : cette route sert aussi à rattraper un rendez-vous déjà tenu.","isRequired":true,"uniqueKey":"appointment.date","typeLabel":"string"},"startAt":{"type":"string","description":"Heure de début (ISO 8601).","uniqueKey":"appointment.startAt","typeLabel":"string"},"endAt":{"type":"string","description":"Heure de fin (ISO 8601).","uniqueKey":"appointment.endAt","typeLabel":"string"},"note":{"type":"string","description":"Note reportée dans le contenu de l'activité créée.","uniqueKey":"appointment.note","typeLabel":"string"}},"uniqueKey":"appointment","typeLabel":"object"},"property":{"type":"object","description":"Caractéristiques du bien. L'adresse ne s'écrit pas ici : utilisez le champ `address`.","properties":{"mainType":{"type":"string","enum":["house","apartment","building","field","parking","cellar","office","shop","industry","business_assets","lease_transfer"],"uniqueKey":"property.mainType","typeLabel":"enum\u003cstring>"},"developmentType":{"type":"string","enum":["old","new"],"uniqueKey":"property.developmentType","typeLabel":"enum\u003cstring>"},"generalCondition":{"type":"string","enum":["toRenovate","standard","renovated"],"uniqueKey":"property.generalCondition","typeLabel":"enum\u003cstring>"},"size":{"type":"number","uniqueKey":"property.size","typeLabel":"number"},"carrezSurface":{"type":"number","uniqueKey":"property.carrezSurface","typeLabel":"number"},"livingSurface":{"type":"number","uniqueKey":"property.livingSurface","typeLabel":"number"},"usefulSurface":{"type":"number","uniqueKey":"property.usefulSurface","typeLabel":"number"},"floorSurface":{"type":"number","uniqueKey":"property.floorSurface","typeLabel":"number"},"landSurface":{"type":"number","uniqueKey":"property.landSurface","typeLabel":"number"},"fieldSurface":{"type":"number","uniqueKey":"property.fieldSurface","typeLabel":"number"},"isSemiDetached":{"type":"boolean","uniqueKey":"property.isSemiDetached","typeLabel":"boolean"},"lotsNumbers":{"type":"string","uniqueKey":"property.lotsNumbers","typeLabel":"string"},"buildingYear":{"type":"integer","uniqueKey":"property.buildingYear","typeLabel":"integer"},"renovationYear":{"type":"integer","uniqueKey":"property.renovationYear","typeLabel":"integer"},"floor":{"type":"integer","uniqueKey":"property.floor","typeLabel":"integer"},"totalFloors":{"type":"integer","uniqueKey":"property.totalFloors","typeLabel":"integer"},"lastFloor":{"type":"integer","uniqueKey":"property.lastFloor","typeLabel":"integer"},"isConstructible":{"type":"boolean","uniqueKey":"property.isConstructible","typeLabel":"boolean"},"isServiced":{"type":"boolean","uniqueKey":"property.isServiced","typeLabel":"boolean"},"rooms":{"type":"integer","uniqueKey":"property.rooms","typeLabel":"integer"},"bedrooms":{"type":"integer","uniqueKey":"property.bedrooms","typeLabel":"integer"},"bathrooms":{"type":"integer","uniqueKey":"property.bathrooms","typeLabel":"integer"},"showerRooms":{"type":"integer","uniqueKey":"property.showerRooms","typeLabel":"integer"},"toilets":{"type":"integer","uniqueKey":"property.toilets","typeLabel":"integer"},"isToiletIndependent":{"type":"boolean","uniqueKey":"property.isToiletIndependent","typeLabel":"boolean"},"kitchenType":{"type":"string","enum":["open","independent"],"uniqueKey":"property.kitchenType","typeLabel":"enum\u003cstring>"},"isKitchenEquipped":{"type":"boolean","uniqueKey":"property.isKitchenEquipped","typeLabel":"boolean"},"balconyAmount":{"type":"integer","uniqueKey":"property.balconyAmount","typeLabel":"integer"},"balconySurface":{"type":"number","uniqueKey":"property.balconySurface","typeLabel":"number"},"loggiaAmount":{"type":"integer","minimum":0,"description":"Nombre de loggias.","uniqueKey":"property.loggiaAmount","typeLabel":"integer"},"loggiaSurface":{"type":"number","minimum":0,"description":"Surface des loggias, en m².","uniqueKey":"property.loggiaSurface","typeLabel":"number"},"terraceAmount":{"type":"integer","uniqueKey":"property.terraceAmount","typeLabel":"integer"},"terraceSurface":{"type":"number","uniqueKey":"property.terraceSurface","typeLabel":"number"},"gardenAmount":{"type":"integer","uniqueKey":"property.gardenAmount","typeLabel":"integer"},"gardenSurface":{"type":"number","uniqueKey":"property.gardenSurface","typeLabel":"number"},"cellarAmount":{"type":"integer","uniqueKey":"property.cellarAmount","typeLabel":"integer"},"cellarSurface":{"type":"number","uniqueKey":"property.cellarSurface","typeLabel":"number"},"atticAmount":{"type":"integer","uniqueKey":"property.atticAmount","typeLabel":"integer"},"atticSurface":{"type":"number","uniqueKey":"property.atticSurface","typeLabel":"number"},"parkingType":{"type":"string","enum":["outdoor","covered","garage"],"uniqueKey":"property.parkingType","typeLabel":"enum\u003cstring>"},"parkingAmount":{"type":"integer","uniqueKey":"property.parkingAmount","typeLabel":"integer"},"parkingSurface":{"type":"number","uniqueKey":"property.parkingSurface","typeLabel":"number"},"hasDisabledAccess":{"type":"boolean","uniqueKey":"property.hasDisabledAccess","typeLabel":"boolean"},"hasElevator":{"type":"boolean","uniqueKey":"property.hasElevator","typeLabel":"boolean"},"hasPool":{"type":"boolean","uniqueKey":"property.hasPool","typeLabel":"boolean"},"hasOpticalFiber":{"type":"boolean","uniqueKey":"property.hasOpticalFiber","typeLabel":"boolean"},"hasFireplace":{"type":"boolean","uniqueKey":"property.hasFireplace","typeLabel":"boolean"},"hasStove":{"type":"boolean","uniqueKey":"property.hasStove","typeLabel":"boolean"},"hasArmoredDoor":{"type":"boolean","uniqueKey":"property.hasArmoredDoor","typeLabel":"boolean"},"hasVMC":{"type":"boolean","uniqueKey":"property.hasVMC","typeLabel":"boolean"},"propertyTax":{"type":"number","uniqueKey":"property.propertyTax","typeLabel":"number"},"propertyTaxResponsibility":{"type":"string","enum":["owner","tenant"],"description":"Taxe foncière à la charge du bailleur (`owner`) ou du preneur (`tenant`). Bien professionnel.","uniqueKey":"property.propertyTaxResponsibility","typeLabel":"enum\u003cstring>"},"vatRegime":{"type":"string","enum":["subject","exempt"],"description":"Bien professionnel soumis (`subject`) ou non (`exempt`) à la TVA.","uniqueKey":"property.vatRegime","typeLabel":"enum\u003cstring>"},"isCollectiveOwnership":{"type":"boolean","uniqueKey":"property.isCollectiveOwnership","typeLabel":"boolean"},"collectiveMonthlyCost":{"type":"number","uniqueKey":"property.collectiveMonthlyCost","typeLabel":"number"},"numberOfLots":{"type":"integer","uniqueKey":"property.numberOfLots","typeLabel":"integer"},"isProcedure":{"type":"boolean","uniqueKey":"property.isProcedure","typeLabel":"boolean"},"hasBuildingManager":{"type":"boolean","uniqueKey":"property.hasBuildingManager","typeLabel":"boolean"},"managedResidenceType":{"type":"string","uniqueKey":"property.managedResidenceType","typeLabel":"string"},"heatingType":{"type":"string","enum":["individual","community"],"uniqueKey":"property.heatingType","typeLabel":"enum\u003cstring>"},"heatingEnergyType":{"type":"string","enum":["electric","gas","fuel","heat_pump","wood","pellets","air_conditioning","district_heating","solar","geothermal","other"],"uniqueKey":"property.heatingEnergyType","typeLabel":"enum\u003cstring>"},"waterDistributionType":{"type":"string","enum":["collective","individual_electric","individual_gas","individual_fuel","individual_solar","individual_heat_pump","individual_wood","individual_other"],"uniqueKey":"property.waterDistributionType","typeLabel":"enum\u003cstring>"},"isAirConditioning":{"type":"boolean","uniqueKey":"property.isAirConditioning","typeLabel":"boolean"},"glazingType":{"type":"string","enum":["simple","double","triple"],"uniqueKey":"property.glazingType","typeLabel":"enum\u003cstring>"},"DPENumber":{"type":"string","uniqueKey":"property.DPENumber","typeLabel":"string"},"DPEEnergyValue":{"type":"number","uniqueKey":"property.DPEEnergyValue","typeLabel":"number"},"DPEEnergyTag":{"type":"string","enum":["A","B","C","D","E","F","G"],"uniqueKey":"property.DPEEnergyTag","typeLabel":"enum\u003cstring>"},"DPEGESValue":{"type":"number","uniqueKey":"property.DPEGESValue","typeLabel":"number"},"DPEGESTag":{"type":"string","enum":["A","B","C","D","E","F","G"],"uniqueKey":"property.DPEGESTag","typeLabel":"enum\u003cstring>"},"DPEDate":{"type":"string","uniqueKey":"property.DPEDate","typeLabel":"string"},"DPEDate3Years":{"type":"array","items":{"type":"integer","uniqueKey":"property.DPEDate3Years.items.[INDEX]","typeLabel":"integer"},"uniqueKey":"property.DPEDate3Years","typeLabel":"integer[]"},"minimumEnergyCost":{"type":"number","uniqueKey":"property.minimumEnergyCost","typeLabel":"number"},"maximumEnergyCost":{"type":"number","uniqueKey":"property.maximumEnergyCost","typeLabel":"number"},"energyCostDate":{"type":"string","uniqueKey":"property.energyCostDate","typeLabel":"string"},"hasBeautifulView":{"type":"boolean","uniqueKey":"property.hasBeautifulView","typeLabel":"boolean"},"availabilityDate":{"type":"string","uniqueKey":"property.availabilityDate","typeLabel":"string"},"hasRoofTop":{"type":"boolean","uniqueKey":"property.hasRoofTop","typeLabel":"boolean"},"isDuplex":{"type":"boolean","uniqueKey":"property.isDuplex","typeLabel":"boolean"},"occupancyStatus":{"type":"string","enum":["free","rented"],"uniqueKey":"property.occupancyStatus","typeLabel":"enum\u003cstring>"},"sanitationType":{"type":"string","enum":["mainsDrainage","septicTankCompliant","septicTankNonCompliant"],"uniqueKey":"property.sanitationType","typeLabel":"enum\u003cstring>"},"isPoolBuildable":{"type":"boolean","uniqueKey":"property.isPoolBuildable","typeLabel":"boolean"},"roomDetails":{"type":"array","items":{"type":"object","additionalProperties":true,"uniqueKey":"property.roomDetails.items.[INDEX]","typeLabel":"object"},"uniqueKey":"property.roomDetails","typeLabel":"object[]"}},"additionalProperties":true,"uniqueKey":"property","typeLabel":"object"},"address":{"type":"string","description":"Adresse en texte libre, géocodée comme à la création. Remplace l'adresse enregistrée sur le bien. Si Google ne situe que la ville, la vente est enregistrée sans numéro ni rue : contrôlez `property.addressData` dans la réponse.","uniqueKey":"address","typeLabel":"string"},"owner":{"type":"string","description":"Collaborateur responsable de la fiche. Doit appartenir aux agences de votre clé API, sinon la requête est refusée et rien n'est écrit.","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"owner","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"tags.items.[INDEX]","typeLabel":"string"},"description":"Liste **complète** des tags de la vente : les tags absents de la liste sont retirés. Chaque tag doit exister dans votre périmètre.","uniqueKey":"tags","typeLabel":"string[]"},"mandate":{"type":"object","description":"Montants en euros. `sellPrice` est le net vendeur. Le prix affiché honoraires inclus (`price`) est calculé : net vendeur + honoraires. Pour saisir les honoraires en pourcentage, envoyez `commissionType: percentage` et `commissionPercentage` : le montant des honoraires est alors calculé.","properties":{"sellPrice":{"type":"number","description":"Net vendeur, en euros. N'envoyez pas le prix honoraires inclus : `price` est calculé et n'est pas modifiable.","uniqueKey":"mandate.sellPrice","typeLabel":"number"},"agencyCommission":{"type":"number","description":"Montant des honoraires, en euros (`12500` pour 12 500 €). En mode `percentage`, il est recalculé à partir de `commissionPercentage`.","uniqueKey":"mandate.agencyCommission","typeLabel":"number"},"commissionType":{"type":"string","enum":["value","percentage"],"description":"`value` : vous envoyez le montant (`agencyCommission`). `percentage` : vous envoyez le pourcentage (`commissionPercentage`). Sans `commissionType`, `agencyCommission` est lu comme un montant.","uniqueKey":"mandate.commissionType","typeLabel":"enum\u003cstring>"},"commissionPercentage":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"Pourcentage d'honoraires, lu quand `commissionType` vaut `percentage`. Sa base dépend de `feeResponsibility` : à charge vendeur, le prix honoraires inclus ; à charge acquéreur, le net vendeur. Sur PATCH Sale, hors du mode `value`, une valeur hors de cette plage est refusée (`400`), sauf à renvoyer la valeur déjà enregistrée. En mode `value`, elle est ignorée : Avest la calcule depuis les montants.","uniqueKey":"mandate.commissionPercentage","typeLabel":"number"},"type":{"type":"string","enum":["exclusive","semiExclusive","notExclusive"],"uniqueKey":"mandate.type","typeLabel":"enum\u003cstring>"},"expirationDate":{"type":"string","uniqueKey":"mandate.expirationDate","typeLabel":"string"},"mandateDuration":{"type":"integer","uniqueKey":"mandate.mandateDuration","typeLabel":"integer"},"maxMandateDuration":{"type":"integer","uniqueKey":"mandate.maxMandateDuration","typeLabel":"integer"},"referenceNumber":{"type":"string","uniqueKey":"mandate.referenceNumber","typeLabel":"string"},"feeResponsibility":{"type":"string","enum":["seller","buyer","both"],"uniqueKey":"mandate.feeResponsibility","typeLabel":"enum\u003cstring>"},"sellerAgencyCommission":{"type":"number","minimum":0,"description":"Part vendeur des honoraires, en charge `both` seulement. Négative, non numérique ou supérieure à `agencyCommission` : `400`.","uniqueKey":"mandate.sellerAgencyCommission","typeLabel":"number"},"sellerAgencyCommissionPercentage":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"Part vendeur en %, lue en mode `percentage`, en charge `both` seulement.","uniqueKey":"mandate.sellerAgencyCommissionPercentage","typeLabel":"number"}},"uniqueKey":"mandate","typeLabel":"object"},"offer":{"type":"object","description":"Mêmes règles que le mandat : montants en euros, `sellPrice` net vendeur, honoraires en pourcentage avec `commissionType: percentage` (montants arrondis à l'euro, pourcentage inférieur à 100). L'offre n'est enregistrée que sur une vente à `MND` ou au-delà ; un changement d'étape vers une autre étape que `OFR`, `AGT`, `MTG` ou `SLD` l'efface.","properties":{"sellPrice":{"type":"number","description":"Net vendeur de l'offre, en euros.","uniqueKey":"offer.sellPrice","typeLabel":"number"},"agencyCommission":{"type":"number","description":"Montant des honoraires, en euros. En mode `percentage`, il est recalculé à partir de `commissionPercentage`.","uniqueKey":"offer.agencyCommission","typeLabel":"number"},"commissionType":{"type":"string","enum":["value","percentage"],"description":"`value` : vous envoyez le montant. `percentage` : vous envoyez le pourcentage (`commissionPercentage`).","uniqueKey":"offer.commissionType","typeLabel":"enum\u003cstring>"},"commissionPercentage":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"Pourcentage d'honoraires, lu quand `commissionType` vaut `percentage`. Montants arrondis à l'euro.","uniqueKey":"offer.commissionPercentage","typeLabel":"number"},"feeResponsibility":{"type":"string","enum":["seller","buyer","both"],"uniqueKey":"offer.feeResponsibility","typeLabel":"enum\u003cstring>"},"sellerAgencyCommission":{"type":"number","minimum":0,"description":"Part vendeur des honoraires, en charge `both` seulement. Négative, non numérique ou supérieure à `agencyCommission` : `400`.","uniqueKey":"offer.sellerAgencyCommission","typeLabel":"number"},"sellerAgencyCommissionPercentage":{"type":"number","minimum":0,"exclusiveMaximum":100,"description":"Part vendeur en %, lue en mode `percentage`, en charge `both` seulement.","uniqueKey":"offer.sellerAgencyCommissionPercentage","typeLabel":"number"},"financing":{"type":"string","enum":["loan","cash"],"uniqueKey":"offer.financing","typeLabel":"enum\u003cstring>"}},"uniqueKey":"offer","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"step":{"title":"step","summary":"Faire avancer l'étape","value":{"step":"MND"}},"estimation":{"title":"estimation","summary":"Consigner une estimation terrain","value":{"fieldValue":{"low":285000,"high":310000}}},"appointment":{"title":"appointment","summary":"Poser le rendez-vous d'estimation et passer en RDV","value":{"step":"RDV","appointment":{"date":"2026-09-01T14:00:00.000Z","endAt":"2026-09-01T15:00:00.000Z","note":"Rendez-vous pris depuis notre outil."}}},"timeline":{"title":"timeline","summary":"Renseigner les dates du compromis","value":{"timeline":{"agreementDate":"2026-09-15T00:00:00.000Z","mortgageDeadline":"2026-10-30T00:00:00.000Z","closingDate":"2026-12-05T00:00:00.000Z"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ac17b718-c976-42df-922a-b8fa7298ea26":{"description":"Vente mise à jour.","headers":{"RateLimit-Limit":{"description":"Nombre de requêtes autorisées dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"sale":{"type":"object","description":"Vente en lecture. `id`, `customId`, `agency`, `agencyGroup`, `step`, `createdAt`, `updatedAt`, `stepUpdatedAt`, `owner` et `mainContact` sont toujours présents (si la vente existe). Les autres champs sont absents s'ils ne sont pas renseignés.","properties":{"id":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"sale.id","typeLabel":"string"},"customId":{"type":"string","uniqueKey":"sale.customId","typeLabel":"string"},"agency":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"sale.agency","typeLabel":"string"},"agencyGroup":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"sale.agencyGroup","typeLabel":"string"},"step":{"type":"string","description":"Étape courante (`QUL`, `CNV`, `RDV`, `MND`, `ARC`, etc.).","uniqueKey":"sale.step","typeLabel":"string"},"createdAt":{"type":"string","description":"Date de création (ISO 8601).","uniqueKey":"sale.createdAt","typeLabel":"string"},"updatedAt":{"type":"string","description":"Date de dernière modification (ISO 8601). Combiné à `sortField=updatedAt` sur `/search`, permet de ne resynchroniser que les ventes modifiées depuis votre dernier passage.","uniqueKey":"sale.updatedAt","typeLabel":"string"},"stepUpdatedAt":{"type":"string","description":"Date du dernier changement d'étape (ISO 8601).","uniqueKey":"sale.stepUpdatedAt","typeLabel":"string"},"owner":{"oneOf":[{"type":"object","description":"Utilisateur Avest responsable du dossier. `null` si non attribué.","properties":{"id":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"sale.owner.oneOf.0.id","typeLabel":"string"},"firstName":{"type":"string","uniqueKey":"sale.owner.oneOf.0.firstName","typeLabel":"string"},"lastName":{"type":"string","uniqueKey":"sale.owner.oneOf.0.lastName","typeLabel":"string"},"picture":{"type":"string","description":"URL de la photo (optionnelle).","uniqueKey":"sale.owner.oneOf.0.picture","typeLabel":"string"}},"uniqueKey":"sale.owner.oneOf.0","typeLabel":"object"},{"type":"null","description":"Utilisateur Avest responsable du dossier. `null` si non attribué.","properties":{"id":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a"},"firstName":{"type":"string"},"lastName":{"type":"string"},"picture":{"type":"string","description":"URL de la photo (optionnelle)."}},"uniqueKey":"sale.owner.oneOf.1","typeLabel":"null"}],"uniqueKey":"sale.owner","typeLabel":"object | null"},"mainContact":{"oneOf":[{"type":"string","description":"ObjectId du vendeur principal. `null` si aucun contact lié.","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"sale.mainContact.oneOf.0","typeLabel":"string"},{"type":"null","description":"ObjectId du vendeur principal. `null` si aucun contact lié.","uniqueKey":"sale.mainContact.oneOf.1","typeLabel":"null"}],"uniqueKey":"sale.mainContact","typeLabel":"string | null"},"status":{"type":"string","uniqueKey":"sale.status","typeLabel":"string"},"state":{"type":"string","uniqueKey":"sale.state","typeLabel":"string"},"project":{"type":"string","uniqueKey":"sale.project","typeLabel":"string"},"parsingCustomId":{"type":"string","uniqueKey":"sale.parsingCustomId","typeLabel":"string"},"property":{"type":"object","description":"Bien immobilier tel que retourné en lecture. Seuls les champs renseignés sont présents ; cette liste n'est pas exhaustive.","properties":{"mainType":{"type":"string","description":"Ex: `apartment`, `house`, `field`, `building`, `parking`, etc.","uniqueKey":"sale.property.mainType","typeLabel":"string"},"developmentType":{"type":"string","enum":["old","new"],"uniqueKey":"sale.property.developmentType","typeLabel":"enum\u003cstring>"},"size":{"type":"number","uniqueKey":"sale.property.size","typeLabel":"number"},"floor":{"type":"integer","uniqueKey":"sale.property.floor","typeLabel":"integer"},"lastFloor":{"type":"integer","uniqueKey":"sale.property.lastFloor","typeLabel":"integer"},"lotsNumbers":{"type":"string","uniqueKey":"sale.property.lotsNumbers","typeLabel":"string"},"rooms":{"type":"integer","uniqueKey":"sale.property.rooms","typeLabel":"integer"},"bedrooms":{"type":"integer","uniqueKey":"sale.property.bedrooms","typeLabel":"integer"},"bathrooms":{"type":"integer","uniqueKey":"sale.property.bathrooms","typeLabel":"integer"},"toilets":{"type":"integer","uniqueKey":"sale.property.toilets","typeLabel":"integer"},"kitchenType":{"type":"string","uniqueKey":"sale.property.kitchenType","typeLabel":"string"},"isCollectiveOwnership":{"type":"boolean","uniqueKey":"sale.property.isCollectiveOwnership","typeLabel":"boolean"},"collectiveMonthlyCost":{"type":"number","uniqueKey":"sale.property.collectiveMonthlyCost","typeLabel":"number"},"numberOfLots":{"type":"integer","uniqueKey":"sale.property.numberOfLots","typeLabel":"integer"},"heatingType":{"type":"string","uniqueKey":"sale.property.heatingType","typeLabel":"string"},"heatingEnergyType":{"type":"string","uniqueKey":"sale.property.heatingEnergyType","typeLabel":"string"},"DPENumber":{"type":"string","uniqueKey":"sale.property.DPENumber","typeLabel":"string"},"DPEEnergyValue":{"type":"number","uniqueKey":"sale.property.DPEEnergyValue","typeLabel":"number"},"DPEEnergyTag":{"type":"string","enum":["A","B","C","D","E","F","G"],"uniqueKey":"sale.property.DPEEnergyTag","typeLabel":"enum\u003cstring>"},"DPEGESValue":{"type":"number","uniqueKey":"sale.property.DPEGESValue","typeLabel":"number"},"DPEGESTag":{"type":"string","enum":["A","B","C","D","E","F","G"],"uniqueKey":"sale.property.DPEGESTag","typeLabel":"enum\u003cstring>"},"DPEDate":{"type":"string","uniqueKey":"sale.property.DPEDate","typeLabel":"string"},"availabilityDate":{"type":"string","uniqueKey":"sale.property.availabilityDate","typeLabel":"string"},"propertyTaxResponsibility":{"type":"string","enum":["owner","tenant"],"description":"Taxe foncière à la charge du bailleur (`owner`) ou du preneur (`tenant`). Bien professionnel.","uniqueKey":"sale.property.propertyTaxResponsibility","typeLabel":"enum\u003cstring>"},"vatRegime":{"type":"string","enum":["subject","exempt"],"description":"Bien professionnel soumis (`subject`) ou non (`exempt`) à la TVA.","uniqueKey":"sale.property.vatRegime","typeLabel":"enum\u003cstring>"},"addressData":{"type":"object","description":"Adresse splittée.","properties":{"streetNumber":{"type":"string","uniqueKey":"sale.property.addressData.streetNumber","typeLabel":"string"},"route":{"type":"string","uniqueKey":"sale.property.addressData.route","typeLabel":"string"},"city":{"type":"string","uniqueKey":"sale.property.addressData.city","typeLabel":"string"},"postalCode":{"type":"string","uniqueKey":"sale.property.addressData.postalCode","typeLabel":"string"},"country":{"type":"string","uniqueKey":"sale.property.addressData.country","typeLabel":"string"},"countryCode":{"type":"string","description":"Code pays ISO 3166-1 alpha-2.","uniqueKey":"sale.property.addressData.countryCode","typeLabel":"string"},"formattedAddress":{"type":"string","uniqueKey":"sale.property.addressData.formattedAddress","typeLabel":"string"},"department":{"type":"string","uniqueKey":"sale.property.addressData.department","typeLabel":"string"},"region":{"type":"string","uniqueKey":"sale.property.addressData.region","typeLabel":"string"}},"uniqueKey":"sale.property.addressData","typeLabel":"object"}},"additionalProperties":true,"uniqueKey":"sale.property","typeLabel":"object"},"mandate":{"type":"object","description":"Mandat de vente, renseigné à partir de l'étape `MND`. Avant, l'objet peut être présent avec seulement `mandateHistory`.","properties":{"price":{"type":"number","description":"Prix affiché honoraires inclus (HAI), calculé automatiquement.","uniqueKey":"sale.mandate.price","typeLabel":"number"},"sellPrice":{"type":"number","description":"Net vendeur.","uniqueKey":"sale.mandate.sellPrice","typeLabel":"number"},"agencyCommission":{"type":"number","description":"Montant des honoraires.","uniqueKey":"sale.mandate.agencyCommission","typeLabel":"number"},"feeResponsibility":{"type":"string","enum":["seller","buyer","both"],"uniqueKey":"sale.mandate.feeResponsibility","typeLabel":"enum\u003cstring>"},"commissionPercentage":{"type":"number","uniqueKey":"sale.mandate.commissionPercentage","typeLabel":"number"},"commissionType":{"type":"string","enum":["value","percentage"],"uniqueKey":"sale.mandate.commissionType","typeLabel":"enum\u003cstring>"},"sellerAgencyCommission":{"type":"number","description":"Part vendeur des honoraires, renseignée seulement en charge `both`. La part acquéreur vaut `agencyCommission` moins cette part.","uniqueKey":"sale.mandate.sellerAgencyCommission","typeLabel":"number"},"sellerAgencyCommissionPercentage":{"type":"number","description":"Part vendeur en %, sur la même base que `commissionPercentage`, renseignée seulement en charge `both`.","uniqueKey":"sale.mandate.sellerAgencyCommissionPercentage","typeLabel":"number"},"type":{"type":"string","enum":["exclusive","semiExclusive","notExclusive"],"uniqueKey":"sale.mandate.type","typeLabel":"enum\u003cstring>"},"referenceNumber":{"type":"string","uniqueKey":"sale.mandate.referenceNumber","typeLabel":"string"},"mandateDuration":{"type":"integer","uniqueKey":"sale.mandate.mandateDuration","typeLabel":"integer"},"maxMandateDuration":{"type":"integer","uniqueKey":"sale.mandate.maxMandateDuration","typeLabel":"integer"},"expirationDate":{"type":"string","uniqueKey":"sale.mandate.expirationDate","typeLabel":"string"},"mandateHistory":{"type":"array","description":"Historique des modifications du net vendeur, des honoraires et du type de mandat. Vide si le mandat n'a jamais été modifié.","items":{"type":"object","additionalProperties":true,"properties":{"date":{"type":"string","description":"Date de la modification (ISO 8601).","uniqueKey":"sale.mandate.mandateHistory.items.[INDEX].date","typeLabel":"string"},"changes":{"type":"array","items":{"type":"object","additionalProperties":true,"properties":{"field":{"type":"string","uniqueKey":"sale.mandate.mandateHistory.items.[INDEX].changes.items.[INDEX].field","typeLabel":"string"},"from":{"oneOf":[{}],"uniqueKey":"sale.mandate.mandateHistory.items.[INDEX].changes.items.[INDEX].from","typeLabel":"any"},"to":{"oneOf":[{}],"uniqueKey":"sale.mandate.mandateHistory.items.[INDEX].changes.items.[INDEX].to","typeLabel":"any"}},"uniqueKey":"sale.mandate.mandateHistory.items.[INDEX].changes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"sale.mandate.mandateHistory.items.[INDEX].changes","typeLabel":"object[]"}},"uniqueKey":"sale.mandate.mandateHistory.items.[INDEX]","typeLabel":"object"},"uniqueKey":"sale.mandate.mandateHistory","typeLabel":"object[]"}},"uniqueKey":"sale.mandate","typeLabel":"object"},"offer":{"type":"object","additionalProperties":true,"uniqueKey":"sale.offer","typeLabel":"object"},"timeline":{"type":"object","description":"Dates clés du dossier (uniquement les dates renseignées).","properties":{"mandateSignatureDate":{"type":"string","uniqueKey":"sale.timeline.mandateSignatureDate","typeLabel":"string"},"agreementDate":{"type":"string","uniqueKey":"sale.timeline.agreementDate","typeLabel":"string"},"agreementExpirationDate":{"type":"string","uniqueKey":"sale.timeline.agreementExpirationDate","typeLabel":"string"},"offerDate":{"type":"string","uniqueKey":"sale.timeline.offerDate","typeLabel":"string"},"mortgageDeadline":{"type":"string","uniqueKey":"sale.timeline.mortgageDeadline","typeLabel":"string"},"closingDate":{"type":"string","uniqueKey":"sale.timeline.closingDate","typeLabel":"string"},"estimationDate":{"type":"string","uniqueKey":"sale.timeline.estimationDate","typeLabel":"string"},"estimationStartAt":{"type":"string","uniqueKey":"sale.timeline.estimationStartAt","typeLabel":"string"},"estimationEndAt":{"type":"string","uniqueKey":"sale.timeline.estimationEndAt","typeLabel":"string"}},"uniqueKey":"sale.timeline","typeLabel":"object"},"fieldValue":{"type":"object","description":"Fourchette de valeurs.","properties":{"low":{"type":"number","uniqueKey":"sale.fieldValue.low","typeLabel":"number"},"high":{"type":"number","uniqueKey":"sale.fieldValue.high","typeLabel":"number"}},"uniqueKey":"sale.fieldValue","typeLabel":"object"},"onlineValue":{"type":"object","description":"Fourchette de valeurs.","properties":{"low":{"type":"number","uniqueKey":"sale.onlineValue.low","typeLabel":"number"},"high":{"type":"number","uniqueKey":"sale.onlineValue.high","typeLabel":"number"}},"uniqueKey":"sale.onlineValue","typeLabel":"object"},"contacts":{"type":"array","description":"Présent dans la réponse de recherche (`/search`). Le premier élément correspond au `mainContact`.","items":{"type":"object","description":"Contact. `firstName` / `lastName` si `isIndividual: true` ; `commercialName` / `corporateName` si entreprise (`isIndividual: false`).","properties":{"id":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"sale.contacts.items.[INDEX].id","typeLabel":"string"},"title":{"type":"string","enum":["mr","mme"],"uniqueKey":"sale.contacts.items.[INDEX].title","typeLabel":"enum\u003cstring>"},"firstName":{"type":"string","uniqueKey":"sale.contacts.items.[INDEX].firstName","typeLabel":"string"},"lastName":{"type":"string","uniqueKey":"sale.contacts.items.[INDEX].lastName","typeLabel":"string"},"commercialName":{"type":"string","uniqueKey":"sale.contacts.items.[INDEX].commercialName","typeLabel":"string"},"corporateName":{"type":"string","uniqueKey":"sale.contacts.items.[INDEX].corporateName","typeLabel":"string"},"isIndividual":{"type":"boolean","uniqueKey":"sale.contacts.items.[INDEX].isIndividual","typeLabel":"boolean"},"contactDetails":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["email","phone"],"isRequired":true,"uniqueKey":"sale.contacts.items.[INDEX].contactDetails.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"data":{"type":"string","isRequired":true,"uniqueKey":"sale.contacts.items.[INDEX].contactDetails.items.[INDEX].data","typeLabel":"string"}},"required":["type","data"],"uniqueKey":"sale.contacts.items.[INDEX].contactDetails.items.[INDEX]","typeLabel":"object"},"uniqueKey":"sale.contacts.items.[INDEX].contactDetails","typeLabel":"object[]"}},"uniqueKey":"sale.contacts.items.[INDEX]","typeLabel":"object"},"uniqueKey":"sale.contacts","typeLabel":"object[]"}},"uniqueKey":"sale","typeLabel":"object"},"activity":{"type":"object","description":"Activité « Rendez-vous estimation » créée. Présente uniquement si `appointment` était fourni.","properties":{"id":{"type":"string","description":"Identifiant Mongo (24 caractères hexadécimaux).","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"activity.id","typeLabel":"string"},"type":{"type":"string","description":"Type d'activité (`note`, `task`, `call`, `email`, `meeting`, `changeStep`, ...).","uniqueKey":"activity.type","typeLabel":"string"},"startAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"activity.startAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"activity.startAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.startAt","typeLabel":"string\u003cdate-time> | null"},"endAt":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"activity.endAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"activity.endAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.endAt","typeLabel":"string\u003cdate-time> | null"},"deadline":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"activity.deadline.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"activity.deadline.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.deadline","typeLabel":"string\u003cdate-time> | null"},"completionDate":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"activity.completionDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"activity.completionDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.completionDate","typeLabel":"string\u003cdate-time> | null"},"pinned":{"type":"boolean","uniqueKey":"activity.pinned","typeLabel":"boolean"},"owner":{"oneOf":[{"type":"string","description":"ObjectId de l'utilisateur auteur. `null` si non renseigné.","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"activity.owner.oneOf.0","typeLabel":"string"},{"type":"null","description":"ObjectId de l'utilisateur auteur. `null` si non renseigné.","uniqueKey":"activity.owner.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.owner","typeLabel":"string | null"},"linkedDocument":{"oneOf":[{"type":"string","description":"ObjectId du document lié. `null` si non renseigné.","pattern":"^[a-fA-F0-9]{24}$","example":"618a35a36d932054e195ca0a","uniqueKey":"activity.linkedDocument.oneOf.0","typeLabel":"string"},{"type":"null","description":"ObjectId du document lié. `null` si non renseigné.","uniqueKey":"activity.linkedDocument.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.linkedDocument","typeLabel":"string | null"},"linkedModel":{"type":"string","description":"Type du document lié.","uniqueKey":"activity.linkedModel","typeLabel":"string"},"data":{"oneOf":[{"type":"object","additionalProperties":true,"description":"Données propres à l'activité. La forme dépend du `type` de l'activité. `null` si absent. Les chemins sensibles peuvent être masqués. Pour `changeStep` : `from` et `to` ; sur une vente, `isAutomatic: true` quand Avest a changé l'étape seul (séquence de relance, par exemple).","uniqueKey":"activity.data.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"description":"Données propres à l'activité. La forme dépend du `type` de l'activité. `null` si absent. Les chemins sensibles peuvent être masqués. Pour `changeStep` : `from` et `to` ; sur une vente, `isAutomatic: true` quand Avest a changé l'étape seul (séquence de relance, par exemple).","uniqueKey":"activity.data.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.data","typeLabel":"object | null"},"file":{"oneOf":[{"type":"object","description":"Fichier attaché à une activité.","properties":{"name":{"type":"string","uniqueKey":"activity.file.oneOf.0.name","typeLabel":"string"},"mimetype":{"type":"string","uniqueKey":"activity.file.oneOf.0.mimetype","typeLabel":"string"},"size":{"type":"integer","uniqueKey":"activity.file.oneOf.0.size","typeLabel":"integer"},"url":{"oneOf":[{"type":"string","description":"URL S3 signée temporaire (privée), `null` si le lien n'a pas pu être généré.","uniqueKey":"activity.file.oneOf.0.url.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL S3 signée temporaire (privée), `null` si le lien n'a pas pu être généré.","uniqueKey":"activity.file.oneOf.0.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.file.oneOf.0.url","typeLabel":"string | null"}},"uniqueKey":"activity.file.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"activity.file.oneOf.1","typeLabel":"null"}],"uniqueKey":"activity.file","typeLabel":"object | null"},"driveLinks":{"type":"array","items":{"type":"string","uniqueKey":"activity.driveLinks.items.[INDEX]","typeLabel":"string"},"uniqueKey":"activity.driveLinks","typeLabel":"string[]"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"activity.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"activity.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"activity","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"sale":{"id":"618a35a36d932054e195ca0a","customId":"\u003cstring>","agency":"618a35a36d932054e195ca0a","agencyGroup":"618a35a36d932054e195ca0a","step":"\u003cstring>","createdAt":"\u003cstring>","updatedAt":"\u003cstring>","stepUpdatedAt":"\u003cstring>","owner":{"id":"618a35a36d932054e195ca0a","firstName":"\u003cstring>","lastName":"\u003cstring>","picture":"\u003cstring>"},"mainContact":"618a35a36d932054e195ca0a","status":"\u003cstring>","state":"\u003cstring>","project":"\u003cstring>","parsingCustomId":"\u003cstring>","property":{"mainType":"\u003cstring>","developmentType":"old","size":123,"floor":123,"lastFloor":123,"lotsNumbers":"\u003cstring>","rooms":123,"bedrooms":123,"bathrooms":123,"toilets":123,"kitchenType":"\u003cstring>","isCollectiveOwnership":true,"collectiveMonthlyCost":123,"numberOfLots":123,"heatingType":"\u003cstring>","heatingEnergyType":"\u003cstring>","DPENumber":"\u003cstring>","DPEEnergyValue":123,"DPEEnergyTag":"A","DPEGESValue":123,"DPEGESTag":"A","DPEDate":"\u003cstring>","availabilityDate":"\u003cstring>","propertyTaxResponsibility":"owner","vatRegime":"subject","addressData":{"streetNumber":"\u003cstring>","route":"\u003cstring>","city":"\u003cstring>","postalCode":"\u003cstring>","country":"\u003cstring>","countryCode":"\u003cstring>","formattedAddress":"\u003cstring>","department":"\u003cstring>","region":"\u003cstring>"}},"mandate":{"price":123,"sellPrice":123,"agencyCommission":123,"feeResponsibility":"seller","commissionPercentage":123,"commissionType":"value","sellerAgencyCommission":123,"sellerAgencyCommissionPercentage":123,"type":"exclusive","referenceNumber":"\u003cstring>","mandateDuration":123,"maxMandateDuration":123,"expirationDate":"\u003cstring>","mandateHistory":[{"date":"\u003cstring>","changes":[{"field":"\u003cstring>","from":"\u003cunknown>","to":"\u003cunknown>"}]}]},"offer":{},"timeline":{"mandateSignatureDate":"\u003cstring>","agreementDate":"\u003cstring>","agreementExpirationDate":"\u003cstring>","offerDate":"\u003cstring>","mortgageDeadline":"\u003cstring>","closingDate":"\u003cstring>","estimationDate":"\u003cstring>","estimationStartAt":"\u003cstring>","estimationEndAt":"\u003cstring>"},"fieldValue":{"low":123,"high":123},"onlineValue":{"low":123,"high":123},"contacts":[{"id":"618a35a36d932054e195ca0a","title":"mr","firstName":"\u003cstring>","lastName":"\u003cstring>","commercialName":"\u003cstring>","corporateName":"\u003cstring>","isIndividual":true,"contactDetails":[{"type":"email","data":"\u003cstring>"}]}]},"activity":{"id":"618a35a36d932054e195ca0a","type":"\u003cstring>","startAt":"2023-11-07T05:31:56Z","endAt":"2023-11-07T05:31:56Z","deadline":"2023-11-07T05:31:56Z","completionDate":"2023-11-07T05:31:56Z","pinned":true,"owner":"618a35a36d932054e195ca0a","linkedDocument":"618a35a36d932054e195ca0a","linkedModel":"\u003cstring>","data":{},"file":{"name":"\u003cstring>","mimetype":"\u003cstring>","size":123,"url":"\u003cstring>"},"driveLinks":["\u003cstring>"],"createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1b3f6ce1-ad6b-422f-9538-2d0e70fe2e42":{"description":"Requête invalide. Le champ `message` précise la cause (paramètre manquant, invalide, mutuellement exclusif, clé de query inconnue, `LinkedAPI agencyGroup is required`, etc.).\n\nLes exemples ci-dessous sont **illustratifs et non exhaustifs** : les messages réellement renvoyés dépendent de la route. En particulier, le rejet des clés de query inconnues n'est appliqué que par `/contact`, `/contacts`, `/user`, `/users` et `/{transaction}/search`.\n\nLa plupart des messages de validation sont préfixés par le contexte qui les émet, sous la forme `\"\u003cContexte> : \u003cmessage>\"`. **Ne faites jamais de correspondance exacte sur `message`** : basez-vous sur le code HTTP et traitez `message` comme du texte destiné au diagnostic.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errorCode":{"type":"string","description":"Code stable, présent sur certaines erreurs seulement (par exemple `VISIT_DATE_REQUIRED`, `CONTACT_DELETED`). À préférer à `message` pour reconnaître une erreur.","uniqueKey":"errorCode","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"unParametreRequis":{"title":"unParametreRequis","value":{"success":false,"message":"One of phone, email, or search is required"}},"exclusif":{"title":"exclusif","value":{"success":false,"message":"Provide exactly one of phone, email, or search"}},"queryInconnue":{"title":"queryInconnue","value":{"success":false,"message":"Unsupported query parameter: foo"}},"telephoneInvalide":{"title":"telephoneInvalide","value":{"success":false,"message":"Invalid phone number"}},"emailInvalide":{"title":"emailInvalide","value":{"success":false,"message":"Invalid email"}},"searchTropCourt":{"title":"searchTropCourt","value":{"success":false,"message":"search must be at least 3 characters"}},"pageHorsLimites":{"title":"pageHorsLimites","value":{"success":false,"message":"page must be \u003c= 100"}},"agencyGroupManquant":{"title":"agencyGroupManquant","value":{"success":false,"message":"LinkedAPI agencyGroup is required"}}},"exampleType":"examples"}},"exampleType":"examples"},"ecc9aea6-8037-4f3c-8ed9-9750a8556010":{"description":"Token invalide. Renvoyé quand le header `Authorization: Bearer` est présent mais que sa valeur n'est pas un token exploitable (malformé, signature invalide, valeur vide) — `message` vaut alors `Invalid bearer token`.\n\nUn token bien formé mais qui ne correspond plus à aucune clé (révoquée ou régénérée) donne aussi un `401`, avec le message `Not authorized to access this resource`.\n\nL'absence du header, une clé en lecture seule et une IP non autorisée renvoient un `403`, pas un `401`.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errorCode":{"type":"string","description":"Code stable, présent sur certaines erreurs seulement (par exemple `VISIT_DATE_REQUIRED`, `CONTACT_DELETED`). À préférer à `message` pour reconnaître une erreur.","uniqueKey":"errorCode","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"tokenInvalide":{"title":"tokenInvalide","value":{"success":false,"message":"Invalid bearer token"}},"cleInconnue":{"title":"cleInconnue","value":{"success":false,"message":"Not authorized to access this resource"}}},"exampleType":"examples"}},"exampleType":"examples"},"7da54867-cfc6-46c0-953e-412965971512":{"description":"Accès refusé. Trois causes donnent **exactement la même réponse** (même code, même `message`) :\n\n1. le header `Authorization` est absent ;\n2. la clé est en **lecture seule** et la requête est un `POST` ou un `PATCH` (voir le guide Authentification) ;\n3. la clé est en mode **sécurisé** et l'IP d'appel, lue dans `X-Real-IP`, n'est pas celle autorisée.\n\nSur les routes d'écriture, un document lié hors du périmètre de la clé renvoie également ce `403`.\n\nUn `403` sur vos seules écritures alors que vos lectures passent = clé en lecture seule.","content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errorCode":{"type":"string","description":"Code stable, présent sur certaines erreurs seulement (par exemple `VISIT_DATE_REQUIRED`, `CONTACT_DELETED`). À préférer à `message` pour reconnaître une erreur.","uniqueKey":"errorCode","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Not authorized to access this resource"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Not authorized to access this resource"}}},"exampleType":"examples"}},"exampleType":"examples"},"0e90ba7c-a880-4d6c-9045-3f50a36b7d1c":{"description":"Limite de débit dépassée : limite de la route (par groupe d'agences et par chemin) ou limite globale (200 requêtes / 10 s par clé, `message` `Too many requests, please try again later`).","headers":{"Retry-After":{"description":"Secondes à attendre avant de réessayer (présent sur les réponses `429`).","schema":{"type":"integer"}},"RateLimit-Limit":{"description":"Nombre de requêtes autorisées dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Remaining":{"description":"Requêtes restantes dans la fenêtre courante.","schema":{"type":"integer"}},"RateLimit-Reset":{"description":"Secondes avant la réinitialisation de la fenêtre.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["success","message"],"properties":{"success":{"type":"boolean","const":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","example":"Rate limit exceeded","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"retryAfter":{"type":"integer","description":"Secondes avant de pouvoir réessayer.","uniqueKey":"retryAfter","typeLabel":"integer"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":false,"message":"Rate limit exceeded","retryAfter":27},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Rate limit exceeded","retryAfter":27}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4a97fb4f-cac0-4748-bb5e-5bf85887eb04":{"linkedApiToken":{"type":"http","scheme":"bearer","description":"Token LinkedAPI avec scope `externalIntegration`. La clé doit avoir un `agencyGroup` configuré (sinon `400 LinkedAPI agencyGroup is required`). Fourni via l'en-tête `Authorization: Bearer {linkedAPI_token}`. Si la clé a `secure === true`, l'IP appelante doit être whitelistée (en-tête `X-Real-IP`), sinon `403 Not authorized to access this resource`.\n\nLa clé porte aussi un **niveau d'accès** : en lecture seule, elle n'autorise que les `GET` ; un `POST` ou un `PATCH` renvoie alors `403 Not authorized to access this resource`, soit la même réponse qu'une requête sans en-tête `Authorization`. Voir le guide Authentification.","scopes":[],"schemeName":"linkedApiToken"}}},"servers":{"e15be152-2381-40d8-ad40-a5594816c16a":{"url":"https://api.avest.fr/v1","description":"API de production Avest"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Token LinkedAPI avec scope `externalIntegration`. La clé doit avoir un `agencyGroup` configuré (sinon `400 LinkedAPI agencyGroup is required`). Fourni via l'en-tête `Authorization: Bearer {linkedAPI_token}`. Si la clé a `secure === true`, l'IP appelante doit être whitelistée (en-tête `X-Real-IP`), sinon `403 Not authorized to access this resource`.\n\nLa clé porte aussi un **niveau d'accès** : en lecture seule, elle n'autorise que les `GET` ; un `POST` ou un `PATCH` renvoie alors `403 Not authorized to access this resource`, soit la même réponse qu'une requête sans en-tête `Authorization`. Voir le guide Authentification.","scopes":[],"schemeName":"linkedApiToken"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Token LinkedAPI avec scope `externalIntegration`. La clé doit avoir un `agencyGroup` configuré (sinon `400 LinkedAPI agencyGroup is required`). Fourni via l'en-tête `Authorization: Bearer {linkedAPI_token}`. Si la clé a `secure === true`, l'IP appelante doit être whitelistée (en-tête `X-Real-IP`), sinon `403 Not authorized to access this resource`.\n\nLa clé porte aussi un **niveau d'accès** : en lecture seule, elle n'autorise que les `GET` ; un `POST` ou un `PATCH` renvoie alors `403 Not authorized to access this resource`, soit la même réponse qu'une requête sans en-tête `Authorization`. Voir le guide Authentification.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"linkedApiToken","name":"Authorization"}],"title":"linkedApiToken"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"avest","siteName":"Avest API","title":"Mettre à jour une vente ciblée par identifiant - Avest API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"fr":{"href":"/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant","matchLevel":0}}},"lastModified":"2026-11-05T19:33:53.930Z","originalFileLocation":"api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant.mdx","locale":"fr"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Met à jour une vente existante en la ciblant par son identifiant, ce qui supprime tout risque de doublon. POST /external-integration/sale retrouve la vente par contact + adresse : si l\u0026#x27;adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape. saleId accepte l\u0026#x27;id (ObjectId) ou le customId de la vente, tous deux renvoyés en lecture. Si un customId correspond à plusieurs ventes de votre périmètre, la requête est refusée (400) plutôt que d\u0026#x27;en modifier une au hasard : ciblez alors par id. Seuls les champs listés dans UpdateSaleBody sont modifiables. contacts, customId, parsingCustomId, commission et state ne le sont pas. Pour poser un rendez-vous d\u0026#x27;estimation, utilisez appointment : il renseigne les dates officielles de la fiche et crée l\u0026#x27;activité correspondante. Écrire timeline seul renseigne les dates sans créer d\u0026#x27;activité. En cas de modification concurrente : 409 avec le code TRANSACTION_EDIT_CONFLICT, rejouer la requête.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Avest API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Mettre à jour une vente ciblée par identifiant - Avest API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Met à jour une vente existante en la ciblant par son identifiant, ce qui supprime tout risque de doublon. POST /external-integration/sale retrouve la vente par contact + adresse : si l\u0026#x27;adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape. saleId accepte l\u0026#x27;id (ObjectId) ou le customId de la vente, tous deux renvoyés en lecture. Si un customId correspond à plusieurs ventes de votre périmètre, la requête est refusée (400) plutôt que d\u0026#x27;en modifier une au hasard : ciblez alors par id. Seuls les champs listés dans UpdateSaleBody sont modifiables. contacts, customId, parsingCustomId, commission et state ne le sont pas. Pour poser un rendez-vous d\u0026#x27;estimation, utilisez appointment : il renseigne les dates officielles de la fiche et crée l\u0026#x27;activité correspondante. Écrire timeline seul renseigne les dates sans créer d\u0026#x27;activité. En cas de modification concurrente : 409 avec le code TRANSACTION_EDIT_CONFLICT, rejouer la requête.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Avest API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://avest.mintlify.app/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://avest.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Mettre+%C3%A0+jour+une+vente+cibl%C3%A9e+par+identifiant\u0026amp;description=Met+%C3%A0+jour+une+vente+existante+en+la+**ciblant+par+son+identifiant**%2C+ce+qui+supprime+tout+risque+de+doublon.%0A%0A%60POST+%2Fexternal-integration%2Fsale%60+retrouve+la+ven\u0026amp;theme=bb9c368e6952746f0f50bcde\u0026amp;signature=b2342289ec91e4d1f1079b703b7541aec96fb0145a39410cdc2cfeb27c1ff235\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Mettre à jour une vente ciblée par identifiant - Avest API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Met à jour une vente existante en la ciblant par son identifiant, ce qui supprime tout risque de doublon. POST /external-integration/sale retrouve la vente par contact + adresse : si l\u0026#x27;adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape. saleId accepte l\u0026#x27;id (ObjectId) ou le customId de la vente, tous deux renvoyés en lecture. Si un customId correspond à plusieurs ventes de votre périmètre, la requête est refusée (400) plutôt que d\u0026#x27;en modifier une au hasard : ciblez alors par id. Seuls les champs listés dans UpdateSaleBody sont modifiables. contacts, customId, parsingCustomId, commission et state ne le sont pas. Pour poser un rendez-vous d\u0026#x27;estimation, utilisez appointment : il renseigne les dates officielles de la fiche et crée l\u0026#x27;activité correspondante. Écrire timeline seul renseigne les dates sans créer d\u0026#x27;activité. En cas de modification concurrente : 409 avec le code TRANSACTION_EDIT_CONFLICT, rejouer la requête.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://avest.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Mettre+%C3%A0+jour+une+vente+cibl%C3%A9e+par+identifiant\u0026amp;description=Met+%C3%A0+jour+une+vente+existante+en+la+**ciblant+par+son+identifiant**%2C+ce+qui+supprime+tout+risque+de+doublon.%0A%0A%60POST+%2Fexternal-integration%2Fsale%60+retrouve+la+ven\u0026amp;theme=bb9c368e6952746f0f50bcde\u0026amp;signature=b2342289ec91e4d1f1079b703b7541aec96fb0145a39410cdc2cfeb27c1ff235\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/avest/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Avest API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9488\">\u003clink data-mint-head rel=\"canonical\" href=\"https://avest.mintlify.app/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://avest.mintlify.app/#organization\",\"name\":\"Avest API\",\"url\":\"https://avest.mintlify.app\"},{\"@type\":\"WebSite\",\"@id\":\"https://avest.mintlify.app#website\",\"name\":\"Avest API\",\"url\":\"https://avest.mintlify.app\",\"publisher\":{\"@id\":\"https://avest.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant#webpage\",\"url\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant\",\"name\":\"Mettre à jour une vente ciblée par identifiant\",\"description\":\"Met à jour une vente existante en la ciblant par son identifiant, ce qui supprime tout risque de doublon. POST /external-integration/sale retrouve la vente par contact + adresse : si l'adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape. saleId accepte l'id (ObjectId) ou le customId de la vente, tous deux renvoyés en lecture. Si un customId correspond à plusieurs ventes de votre périmètre, la requête est refusée (400) plutôt que d'en modifier une au hasard : ciblez alors par id. Seuls les champs listés dans UpdateSaleBody sont modifiables. contacts, customId, parsingCustomId, commission et state ne le sont pas. Pour poser un rendez-vous d'estimation, utilisez appointment : il renseigne les dates officielles de la fiche et crée l'activité correspondante. Écrire timeline seul renseigne les dates sans créer d'activité. En cas de modification concurrente : 409 avec le code TRANSACTION_EDIT_CONFLICT, rejouer la requête.\",\"dateModified\":\"2026-11-05T19:33:53.930Z\",\"isPartOf\":{\"@id\":\"https://avest.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://avest.mintlify.app/api-reference/transactions/rechercher-des-transactions-pagin%C3%A9\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mettre à jour une vente ciblée par identifiant\",\"item\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant#apireference\",\"headline\":\"Mettre à jour une vente ciblée par identifiant\",\"name\":\"Mettre à jour une vente ciblée par identifiant\",\"description\":\"Met à jour une vente existante en la ciblant par son identifiant, ce qui supprime tout risque de doublon. POST /external-integration/sale retrouve la vente par contact + adresse : si l'adresse envoyée ne correspond pas exactement à celle enregistrée, une seconde vente est créée. Utilisez cette route dès que vous connaissez déjà la vente — typiquement pour faire avancer son étape. saleId accepte l'id (ObjectId) ou le customId de la vente, tous deux renvoyés en lecture. Si un customId correspond à plusieurs ventes de votre périmètre, la requête est refusée (400) plutôt que d'en modifier une au hasard : ciblez alors par id. Seuls les champs listés dans UpdateSaleBody sont modifiables. contacts, customId, parsingCustomId, commission et state ne le sont pas. Pour poser un rendez-vous d'estimation, utilisez appointment : il renseigne les dates officielles de la fiche et crée l'activité correspondante. Écrire timeline seul renseigne les dates sans créer d'activité. En cas de modification concurrente : 409 avec le code TRANSACTION_EDIT_CONFLICT, rejouer la requête.\",\"url\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant\",\"mainEntityOfPage\":{\"@id\":\"https://avest.mintlify.app/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant#webpage\"},\"dateModified\":\"2026-11-05T19:33:53.930Z\",\"publisher\":{\"@id\":\"https://avest.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://avest.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Avest API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Avest API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/transactions/mettre-%C3%A0-jour-une-vente-cibl%C3%A9e-par-identifiant.md","siteName":"Avest API","nav":{"global":null,"languages":[{"language":"fr","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"Référence API","groups":[{"group":"Contacts","pages":[{"title":"Récupérer un contact et ses transactions","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/contact","href":"/api-reference/contacts/récupérer-un-contact-et-ses-transactions"},{"title":"Créer un contact seul","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/contact","href":"/api-reference/contacts/créer-un-contact-seul"},{"title":"Lister des contacts (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/contacts","href":"/api-reference/contacts/lister-des-contacts-paginé"},{"title":"Mettre à jour un contact","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/contact/{contactId}","href":"/api-reference/contacts/mettre-à-jour-un-contact"}]},{"group":"Key","pages":[{"title":"Connaître le type de sa clé","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/key","href":"/api-reference/key/connaître-le-type-de-sa-clé"}]},{"group":"Agencies","pages":[{"title":"Lister les agences accessibles","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/agencies","href":"/api-reference/agencies/lister-les-agences-accessibles"}]},{"group":"Users","pages":[{"title":"Récupérer un collaborateur par identifiant","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/user","href":"/api-reference/users/récupérer-un-collaborateur-par-identifiant"},{"title":"Lister les collaborateurs (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/users","href":"/api-reference/users/lister-les-collaborateurs-paginé"}]},{"group":"Shift planning","pages":[{"title":"Relire le planning de permanence d'une semaine","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/agency/{agencyId}/shift-planning/{transaction}","href":"/api-reference/shift-planning/relire-le-planning-de-permanence-dune-semaine"},{"title":"Alimenter le planning de permanence d'une semaine","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/agency/{agencyId}/shift-planning/{transaction}","href":"/api-reference/shift-planning/alimenter-le-planning-de-permanence-dune-semaine"}]},{"group":"Transactions","pages":[{"title":"Rechercher des transactions (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/{transaction}/search","href":"/api-reference/transactions/rechercher-des-transactions-paginé"},{"title":"Récupérer une transaction par id ou customId","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/{transaction}","href":"/api-reference/transactions/récupérer-une-transaction-par-id-ou-customid"},{"title":"Mettre à jour les critères d'une acquisition","description":"Corrige les critères de recherche d'une fiche acquéreur existante sans repasser par le pipeline leadgen.\n\n`step` n'est pas modifiable ici (voir `/qualify`), pas plus que `customId`, `parsingCustomId`, `mandate`, `owner` et `agency`. Les zones de recherche (`areas`) ne sont pas modifiables non plus.\n\nEn cas de modification concurrente : `409` avec le code `TRANSACTION_EDIT_CONFLICT`, rejouer la requête.","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/acquisition/{acquisitionId}","href":"/api-reference/transactions/mettre-à-jour-les-critères-dune-acquisition"},{"title":"Mettre à jour une vente ciblée par identifiant","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/sale/{saleId}","href":"/api-reference/transactions/mettre-à-jour-une-vente-ciblée-par-identifiant"},{"title":"Qualifier un prospect acquéreur","description":"Sort une fiche de l'étape « à qualifier » (`AQUL`) vers `ASRC` (en recherche) ou `AARC` (archivée).\n\n**Effets de bord** : la séquence de relance de qualification est close, et `originMatch` peut faire évoluer la mise en relation à l'origine de la demande. Une fiche déjà en négociation / offre / achat signé est refusée (`409`).\n\nViser `MVST` dans `originMatch` exige `originMatch.visitStartAt` : sinon `400` avec `errorCode: VISIT_DATE_REQUIRED`, et rien n'est écrit.","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/acquisition/{acquisitionId}/qualify","href":"/api-reference/transactions/qualifier-un-prospect-acquéreur"}]},{"group":"Lead generation","pages":[{"title":"Créer ou mettre à jour une vente","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/sale","href":"/api-reference/lead-generation/créer-ou-mettre-à-jour-une-vente"},{"title":"Créer ou mettre à jour une acquisition","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/acquisition","href":"/api-reference/lead-generation/créer-ou-mettre-à-jour-une-acquisition"},{"title":"Créer ou mettre à jour une location","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/rental","href":"/api-reference/lead-generation/créer-ou-mettre-à-jour-une-location"}]},{"group":"Matches","pages":[{"title":"Récupérer un rapprochement par id ou customId","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match","href":"/api-reference/matches/récupérer-un-rapprochement-par-id-ou-customid"},{"title":"Rechercher des rapprochements","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match/search","href":"/api-reference/matches/rechercher-des-rapprochements"},{"title":"Faire avancer l'étape d'une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/match/{matchId}","href":"/api-reference/matches/faire-avancer-létape-dune-mise-en-relation"},{"title":"Lister les visites d'une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match/{matchId}/visits","href":"/api-reference/matches/lister-les-visites-dune-mise-en-relation"},{"title":"Créer une visite sur une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/match/{matchId}/visit","href":"/api-reference/matches/créer-une-visite-sur-une-mise-en-relation"},{"title":"Modifier ou annuler une visite","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/match/{matchId}/visit/{activityId}","href":"/api-reference/matches/modifier-ou-annuler-une-visite"},{"title":"Lister les offres d'une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/match/{matchId}/offers","href":"/api-reference/matches/lister-les-offres-dune-mise-en-relation"},{"title":"Créer une offre sur une mise en relation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/match/{matchId}/offer","href":"/api-reference/matches/créer-une-offre-sur-une-mise-en-relation"},{"title":"Faire évoluer une offre","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/match/{matchId}/offer/{activityId}","href":"/api-reference/matches/faire-évoluer-une-offre"}]},{"group":"Activities","pages":[{"title":"Lister les activités d'un document (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/activities","href":"/api-reference/activities/lister-les-activités-dun-document-paginé"},{"title":"Créer une activité sur un document","deprecated":null,"version":null,"openapi":"/openapi.yaml post /external-integration/activity","href":"/api-reference/activities/créer-une-activité-sur-un-document"},{"title":"Supprimer une note","deprecated":null,"version":null,"openapi":"/openapi.yaml delete /external-integration/activity/{activityId}","href":"/api-reference/activities/supprimer-une-note"},{"title":"Clôturer, rouvrir une activité ou corriger une note","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /external-integration/activity/{activityId}","href":"/api-reference/activities/clôturer-rouvrir-une-activité-ou-corriger-une-note"}]},{"group":"Ads","pages":[{"title":"Récupérer une annonce par id ou référence","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/ad","href":"/api-reference/ads/récupérer-une-annonce-par-id-ou-référence"},{"title":"Rechercher des annonces (paginé)","deprecated":null,"version":null,"openapi":"/openapi.yaml get /external-integration/ad/search","href":"/api-reference/ads/rechercher-des-annonces-paginé"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]}]},"basePath":"","title":"Mettre à jour une vente ciblée par identifiant - Avest API","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}