Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.
Qualifie un prospect acquéreur. C’est l’action que réalise un agent depuis l’inbox « Prospect acquéreur » : la fiche sort de l’étape AQUL (à qualifier) pour passer en recherche ou être archivée.
Endpoint
URL : /external-integration/acquisition/{acquisitionId}/qualifyMéthode : POSTAuthentification : token LinkedAPI avec scope externalIntegration en écriture.
Clé requise : lecture-écriture. Une clé en lecture seule reçoit 403. Voir Types de clé.
Cette action a des effets métier : elle clôt la séquence de relance de
qualification de la fiche, et peut faire évoluer la mise en relation
d’origine. Un traitement en masse éteint donc des relances automatiques
côté agents.
Path Parameters
Paramètre
Type
Requis
Description
acquisitionId
ObjectId
✅
ObjectId de l’acquisition.
Body Parameters
Champ
Type
Requis
Description
acquisitionStep
String
✅
ASRC (en recherche) ou AARC (archivée). Aucune autre valeur.
stepUpdateReason
String
Raison d’archivage. Requis pour AARC : noFollowUp ou unreachable.
activityId
ObjectId
Tâche de qualification que l’action vient clore.
originMatch
Object
{ matchId, step, visitStartAt?, visitEndAt? }, mise en relation à l’origine de la demande.
originMatch
Permet de faire évoluer en même temps la mise en relation qui a généré la demande. matchId doit appartenir à l’acquisition qualifiée, et la mise en relation doit être à l’étape MRQT (demande). Déjà à l’étape visée, elle reste inchangée.
Champ
Type
Requis
Description
matchId
ObjectId
✅
Mise en relation à faire évoluer.
step
String
✅
Étape cible : MCNV, MVST, MNGT, MOFF, MOFA ou MRQT_NF.
visitStartAt
ISO 8601
⚠️
Obligatoire si step vaut MVST. Début de la visite : Avest crée la visite sur la mise en relation, attribuée à son responsable, comme POST une visite.
visitEndAt
ISO 8601
❌
Fin de la visite.
Changement du 21 octobre 2026. Viser MVST sans visitStartAt est
refusé (400) et rien n’est écrit : ni la mise en relation, ni la
qualification de la fiche. Une mise en relation déjà en MVST reste
inchangée, même sans date.
ExternalIntegrationQualifyAcquisition : Unable to find acquisition
Fiche inexistante ou hors périmètre.
Invalid acquisition step
acquisitionStep autre que ASRC / AARC.
Invalid stepUpdateReason
Raison d’archivage inconnue.
Acquisition step too advanced to qualify
La fiche est déjà en négociation / offre / achat signé (409).
Match does not belong to acquisition
originMatch.matchId n’appartient pas à cette fiche.
Visit date required to plan a visit
originMatch.step vaut MVST sans originMatch.visitStartAt valide (400, errorCode: VISIT_DATE_REQUIRED).
Invalid origin match step
originMatch.step hors de la liste (400).
Le statut de cette demande a changé entre-temps, rafraîchissez la fiche.
La mise en relation n’est plus à l’étape MRQT (409).
Rate limits
100 req / minute par groupe d’agences (bucket d’écriture).
{"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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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":"endpoints/post-acquisition-qualify","slug":"/endpoints/post-acquisition-qualify","pageMetadata":{"title":"Qualifier un acquéreur","description":"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.","href":"/endpoints/post-acquisition-qualify"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Qualifie un `,_jsx(_components.strong,{children:`prospect acquéreur`}),`. C’est l’action que réalise un agent depuis l’inbox « Prospect acquéreur » : la fiche sort de l’étape `,_jsx(_components.code,{children:`AQUL`}),` (à qualifier) pour passer en recherche ou être archivée.`]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`URL`}),` : `,_jsx(_components.code,{children:`/external-integration/acquisition/{acquisitionId}/qualify`}),`\n`,_jsx(_components.strong,{children:`Méthode`}),` : `,_jsx(_components.code,{children:`POST`}),`\n`,_jsx(_components.strong,{children:`Authentification`}),` : token LinkedAPI avec scope `,_jsx(_components.code,{children:`externalIntegration`}),` en écriture.\n`,_jsx(_components.strong,{children:`Clé requise`}),` : lecture-écriture. Une clé en lecture seule reçoit `,_jsx(_components.code,{children:`403`}),`. Voir `,_jsx(_components.a,{href:`/guides/authentification`,children:`Types de clé`}),`.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Cette action a des effets métier : elle `,_jsx(_components.strong,{children:`clôt la séquence de relance de\nqualification`}),` de la fiche, et peut faire évoluer la mise en relation\nd’origine. Un traitement en masse éteint donc des relances automatiques\ncôté agents.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Paramètre`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Requis`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`acquisitionId`})}),_jsx(_components.td,{children:`ObjectId`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`ObjectId de l’acquisition.`})]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`body-parameters`,children:`Body Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Requis`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`acquisitionStep`})}),_jsx(_components.td,{children:`String`}),_jsx(_components.td,{children:`✅`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`ASRC`}),` (en recherche) ou `,_jsx(_components.code,{children:`AARC`}),` (archivée). Aucune autre valeur.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`stepUpdateReason`})}),_jsx(_components.td,{children:`String`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[`Raison d’archivage. Requis pour `,_jsx(_components.code,{children:`AARC`}),` : `,_jsx(_components.code,{children:`noFollowUp`}),` ou `,_jsx(_components.code,{children:`unreachable`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`activityId`})}),_jsx(_components.td,{children:`ObjectId`}),_jsx(_components.td,{}),_jsx(_components.td,{children:`Tâche de qualification que l’action vient clore.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`originMatch`})}),_jsx(_components.td,{children:`Object`}),_jsx(_components.td,{}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`{ matchId, step, visitStartAt?, visitEndAt? }`}),`, mise en relation à l’origine de la demande.`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`originmatch`,children:_jsx(_components.code,{children:`originMatch`})}),`\n`,_jsxs(_components.p,{children:[`Permet de faire évoluer en même temps la mise en relation qui a généré la demande. `,_jsx(_components.code,{children:`matchId`}),` doit appartenir à l’acquisition qualifiée, et la mise en relation doit être à l’étape `,_jsx(_components.code,{children:`MRQT`}),` (demande). Déjà à l’étape visée, elle reste inchangée.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Champ`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Requis`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`matchId`})}),_jsx(_components.td,{children:`ObjectId`}),_jsx(_components.td,{children:`✅`}),_jsx(_components.td,{children:`Mise en relation à faire évoluer.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`step`})}),_jsx(_components.td,{children:`String`}),_jsx(_components.td,{children:`✅`}),_jsxs(_components.td,{children:[`Étape cible : `,_jsx(_components.code,{children:`MCNV`}),`, `,_jsx(_components.code,{children:`MVST`}),`, `,_jsx(_components.code,{children:`MNGT`}),`, `,_jsx(_components.code,{children:`MOFF`}),`, `,_jsx(_components.code,{children:`MOFA`}),` ou `,_jsx(_components.code,{children:`MRQT_NF`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitStartAt`})}),_jsx(_components.td,{children:`ISO 8601`}),_jsx(_components.td,{children:`⚠️`}),_jsxs(_components.td,{children:[_jsxs(_components.strong,{children:[`Obligatoire si `,_jsx(_components.code,{children:`step`}),` vaut `,_jsx(_components.code,{children:`MVST`}),`.`]}),` Début de la visite : Avest crée la visite sur la mise en relation, attribuée à son responsable, comme `,_jsx(_components.a,{href:`/endpoints/match-visits`,children:`POST une visite`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`visitEndAt`})}),_jsx(_components.td,{children:`ISO 8601`}),_jsx(_components.td,{children:`❌`}),_jsx(_components.td,{children:`Fin de la visite.`})]})]})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Changement du 21 octobre 2026.`}),` Viser `,_jsx(_components.code,{children:`MVST`}),` sans `,_jsx(_components.code,{children:`visitStartAt`}),` est\nrefusé (`,_jsx(_components.code,{children:`400`}),`) et rien n’est écrit : ni la mise en relation, ni la\nqualification de la fiche. Une mise en relation déjà en `,_jsx(_components.code,{children:`MVST`}),` reste\ninchangée, même sans date.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`exemple`,children:`Exemple`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.avest.fr/v1/external-integration/acquisition/619b46b47e043165f206db1c/qualify\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer {token}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"acquisitionStep\": \"ASRC\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"originMatch\": { \"matchId\": \"619b46b47e043165f206db1e\", \"step\": \"MCNV\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Qualifier la fiche et planifier la visite de la mise en relation d’origine :`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`7`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.avest.fr/v1/external-integration/acquisition/619b46b47e043165f206db1c/qualify\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer {token}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"acquisitionStep\": \"ASRC\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"originMatch\": { \"matchId\": \"619b46b47e043165f206db1e\", \"step\": \"MVST\", \"visitStartAt\": \"2026-10-24T14:00:00.000Z\" }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Archiver une fiche injoignable :`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.avest.fr/v1/external-integration/acquisition/619b46b47e043165f206db1c/qualify\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer {token}\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{ \"acquisitionStep\": \"AARC\", \"stepUpdateReason\": \"unreachable\" }'`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`La réponse renvoie l’acquisition au format public, identique à `,_jsx(_components.a,{href:`/endpoints/get-acquisition`,children:`GET Acquisition`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`réponses-d’erreur`,children:`Réponses d’erreur`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Message`}),_jsx(_components.th,{children:`Cause`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ExternalIntegrationQualifyAcquisition : acquisitionStep is required`})}),_jsx(_components.td,{children:`Champ absent.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ExternalIntegrationQualifyAcquisition : originMatch must be an object`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`originMatch`}),` mal formé (`,_jsx(_components.code,{children:`null`}),`, tableau, chaîne).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ExternalIntegrationQualifyAcquisition : Invalid originMatch.matchId`})}),_jsx(_components.td,{children:`ObjectId invalide.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`ExternalIntegrationQualifyAcquisition : Unable to find acquisition`})}),_jsx(_components.td,{children:`Fiche inexistante ou hors périmètre.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Invalid acquisition step`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`acquisitionStep`}),` autre que `,_jsx(_components.code,{children:`ASRC`}),` / `,_jsx(_components.code,{children:`AARC`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Invalid stepUpdateReason`})}),_jsx(_components.td,{children:`Raison d’archivage inconnue.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Acquisition step too advanced to qualify`})}),_jsxs(_components.td,{children:[`La fiche est déjà en négociation / offre / achat signé (`,_jsx(_components.code,{children:`409`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Match does not belong to acquisition`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`originMatch.matchId`}),` n’appartient pas à cette fiche.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Visit date required to plan a visit`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`originMatch.step`}),` vaut `,_jsx(_components.code,{children:`MVST`}),` sans `,_jsx(_components.code,{children:`originMatch.visitStartAt`}),` valide (`,_jsx(_components.code,{children:`400`}),`, `,_jsx(_components.code,{children:`errorCode: VISIT_DATE_REQUIRED`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Invalid origin match step`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`originMatch.step`}),` hors de la liste (`,_jsx(_components.code,{children:`400`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`Le statut de cette demande a changé entre-temps, rafraîchissez la fiche.`})}),_jsxs(_components.td,{children:[`La mise en relation n’est plus à l’étape `,_jsx(_components.code,{children:`MRQT`}),` (`,_jsx(_components.code,{children:`409`}),`).`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`rate-limits`,children:`Rate limits`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`100 req / minute par groupe d’agences`}),` (bucket d’écriture).`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Qualifier un acquéreur","description":"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.","href":"/endpoints/post-acquisition-qualify"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Path Parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Body Parameters","slug":"body-parameters","depth":2,"children":[{"title":"originMatch","slug":"originmatch","depth":3,"children":[]}]},{"title":"Exemple","slug":"exemple","depth":2,"children":[]},{"title":"Réponses d’erreur","slug":"réponses-d’erreur","depth":2,"children":[]},{"title":"Rate limits","slug":"rate-limits","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"avest","siteName":"Avest API","title":"Qualifier un acquéreur - Avest API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"fr":{"href":"/endpoints/post-acquisition-qualify","matchLevel":0}}},"lastModified":"2026-10-29T16:15:58.146Z","originalFileLocation":"endpoints/post-acquisition-qualify.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=\"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.\">\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=\"Qualifier un acquéreur - Avest API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Avest API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://avest.mintlify.app/endpoints/post-acquisition-qualify\">\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=Qualifier+un+acqu%C3%A9reur\u0026amp;description=Fait+sortir+une+fiche+acqu%C3%A9reur+de+%C2%AB+%C3%A0+qualifier+%C2%BB+%3A+en+recherche%2C+ou+archiv%C3%A9e.\u0026amp;theme=bb9c368e6952746f0f50bcde\u0026amp;signature=9b9bd68ba6fccc3a92e784a7b41ad82050dad0a2d4d6d6292f01f43777dbc5a7\">\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=\"Qualifier un acquéreur - Avest API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://avest.mintlify.site/_mintlify/api/og/v2?division=Transactions\u0026amp;title=Qualifier+un+acqu%C3%A9reur\u0026amp;description=Fait+sortir+une+fiche+acqu%C3%A9reur+de+%C2%AB+%C3%A0+qualifier+%C2%BB+%3A+en+recherche%2C+ou+archiv%C3%A9e.\u0026amp;theme=bb9c368e6952746f0f50bcde\u0026amp;signature=9b9bd68ba6fccc3a92e784a7b41ad82050dad0a2d4d6d6292f01f43777dbc5a7\">\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/endpoints/post-acquisition-qualify\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/endpoints/post-acquisition-qualify.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/endpoints/post-acquisition-qualify#webpage\",\"url\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify\",\"name\":\"Qualifier un acquéreur\",\"description\":\"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.\",\"dateModified\":\"2026-10-29T16:15:58.146Z\",\"isPartOf\":{\"@id\":\"https://avest.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://avest.mintlify.app/endpoints/get-contact\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transactions\",\"item\":\"https://avest.mintlify.app/endpoints/get-transaction-search\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Qualifier un acquéreur\",\"item\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify#article\",\"headline\":\"Qualifier un acquéreur\",\"name\":\"Qualifier un acquéreur\",\"description\":\"Fait sortir une fiche acquéreur de « à qualifier » : en recherche, ou archivée.\",\"url\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify\",\"mainEntityOfPage\":{\"@id\":\"https://avest.mintlify.app/endpoints/post-acquisition-qualify#webpage\"},\"dateModified\":\"2026-10-29T16:15:58.146Z\",\"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":"/endpoints/post-acquisition-qualify.md","siteName":"Avest API","nav":{"global":null,"languages":[{"language":"fr","tabs":[{"tab":"Guides","groups":[{"group":"Démarrage","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Authentification","href":"/guides/authentification"},{"title":"Déduplication \u0026 allocation","href":"/guides/deduplication"},{"title":"Consentement à la prospection","href":"/guides/consentement"}]},{"group":"Endpoints","pages":[{"group":"Contacts","pages":[{"title":"GET Contact","href":"/endpoints/get-contact"},{"title":"GET Contacts","href":"/endpoints/get-contacts"},{"title":"POST Contact","href":"/endpoints/post-contact"},{"title":"PATCH Contact","href":"/endpoints/patch-contact"}]},{"group":"Clé API","pages":[{"title":"GET Key","href":"/endpoints/get-key"}]},{"group":"Agences","pages":[{"title":"GET Agencies","href":"/endpoints/get-agencies"}]},{"group":"Utilisateurs","pages":[{"title":"GET User","href":"/endpoints/get-user"},{"title":"GET Users","href":"/endpoints/get-users"}]},{"group":"Planning de permanence","pages":[{"title":"Planning de permanence","href":"/endpoints/shift-planning"}]},{"group":"Transactions","pages":[{"title":"GET Transaction Search","href":"/endpoints/get-transaction-search"},{"title":"GET Sale","href":"/endpoints/get-sale"},{"title":"GET Acquisition","href":"/endpoints/get-acquisition"},{"title":"GET Rental","href":"/endpoints/get-rental"},{"title":"POST Sale","href":"/endpoints/post-sale"},{"title":"POST Acquisition","href":"/endpoints/post-acquisition"},{"title":"POST Rental","href":"/endpoints/post-rental"},{"title":"PATCH Sale","href":"/endpoints/patch-sale"},{"title":"PATCH Acquisition","description":"Corrige les critères de recherche d'une fiche acquéreur existante.","href":"/endpoints/patch-acquisition"},{"title":"Qualifier un acquéreur","href":"/endpoints/post-acquisition-qualify"}]},{"group":"Match","pages":[{"title":"GET Match","description":"Récupère un match (rapprochement acquisition / vente) par son id ou son customId.","href":"/endpoints/get-match"},{"title":"GET Match Search","href":"/endpoints/get-match-search"},{"title":"PATCH Match","href":"/endpoints/patch-match"},{"title":"Visites \u0026 offres","href":"/endpoints/visits-offers"},{"title":"Visites d'un match","href":"/endpoints/match-visits"},{"title":"Offres d'un match","href":"/endpoints/match-offers"}]},{"group":"Activités","pages":[{"title":"GET Activities","href":"/endpoints/get-activities"},{"title":"POST Activity","href":"/endpoints/post-activity"},{"title":"PATCH Activity","href":"/endpoints/patch-activity"},{"title":"DELETE Activity","href":"/endpoints/delete-activity"}]},{"group":"Annonces","pages":[{"title":"GET Ad","href":"/endpoints/get-ad"},{"title":"GET Ad Search","href":"/endpoints/get-ad-search"}]}]}]},{"tab":"Référence API","pages":[{"title":"Référence API","href":"/api-reference/contacts/récupérer-un-contact-et-ses-transactions"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]}]},"basePath":"","title":"Qualifier un acquéreur - Avest API","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}