Piloter le cycle complet de gérance par API et MCP

Du mandat confié au CRG, étape par étape : ce qu'un agent IA peut faire avec une simple clé API, ce qui exige d'être authentifié comme utilisateur d'une agence abonnée, et ce qui restera toujours un geste humain.

D'abord : il y a DEUX API, ne les confondez pas

Le cycle, étape par étape

Étape 0 — Vérifier que l'agence est prête

Ne lancez rien avant d'avoir lu l'état de préparation : la moitié des blocages du cycle viennent d'un paramétrage manquant.

GET /api/settings/health          (niveau 2)
→ une section par domaine — agence (dont ICS), plan comptable (comptes pivots,
  variables d'appel), programmation (appels de loyer, relances, CRG), demandes de
  mandats, vitrine biens, candidatures, modalités de paiement, barème d'honoraires,
  workflows factures et relevés, remises SEPA, audit comptable —
  avec status, score et l'action à mener.

Rôle de l'agent : lire cette réponse et dire à l'humain ce qui manque, dans l'ordre des dépendances. C'est le meilleur service qu'il rend ici.

Étape 1-2 — Le mandat arrive et s'instruit

GET  /api/mandate-requests                              (niveau 2) demandes reçues
GET  /api/mandate-requests/{id}                         détail
POST /api/mandate-requests/{id}/documents               téléverser une pièce
POST /api/mandate-requests/{id}/documents/{doc}/ocr     lire la pièce
POST /api/mandate-requests/{id}/verify                  recoupement pièces ↔ formulaire
GET  /api/mandate-requests/{id}/verifications           résultats du recoupement
GET  /api/mandate-requests/{id}/pre-validate-check      ce qui manque avant validation

Ce que l'agent apporte vraiment ici :

• Réglementation du type de bien — nu, meublé, bail mobilité, local commercial, parking : durée, préavis, dépôt de garantie, diagnostics, encadrement des loyers. À croiser avec le guide conformité.
• Fiscalité du propriétaire — micro-foncier ou réel (2044), LMNP micro-BIC ou réel, SCI IR/IS, 2072-S : ce que l'agence devra restituer en fin d'année (fiscalité gérance).
• Rédiger le mandat — POST /api/v1/documents/mandat-gerance (niveau 1, MCP mandat_gerance) rend un mandat loi Hoguet en PDF, mise en page enveloppe à fenêtre.
• Lister les pièces à demander et relancer le propriétaire tant qu'il en manque.

Étape 3 — Signature électronique

POST /api/signature/send/{doc_type}/{doc_id}            (niveau 2)
     doc_type ∈ mandat | bail | devis | contrat
     ex. POST /api/signature/send/mandat/42
→ envoie au signataire un lien personnel ; il consulte le document et l'accepte
  en ligne. Signature horodatée, PDF signé conservé au dossier.

Étape 4-5 — Validation, puis vie du mandat

PUT /api/mandate-requests/{id}/validate                 (niveau 2)
→ crée le PROPRIÉTAIRE (ou le rattache s'il existe déjà — fiche unique),
  le BIEN, ses LOTS, et le MANDAT actif.

GET  /api/mandates · GET /api/mandates/{id} · GET /api/mandates/{id}/pdf
POST /api/mandates/{id}/terminate                       résiliation
GET  /api/owners/{owner_id}/mandates                    mandats d'un propriétaire

Les corrections ultérieures passent par ces routes de gestion des mandats, pas par la demande d'origine.

Étape 6 — Mise en location : interne ou publique

POST /api/property-listings                             (niveau 2) créer l'annonce
PUT  /api/property-listings/{id}/publish-internal       locataire EN PLACE
PUT  /api/property-listings/{id}/publish                bien VACANT (vitrine publique)
GET  /api/property-listings/pending-review              annonces à relire
POST /api/property-listings/{id}/photos                 photos

Chemin « locataire en place » : publication interne, validation, puis reprise de bail — ni honoraires de location, ni état des lieux d'entrée.

Étape 7 — Candidatures

GET  /api/rental-applications                           (niveau 2) dossiers reçus
GET  /api/rental-applications/{id}
POST /api/rental-applications/{id}/documents            pièces du candidat
POST /api/rental-applications/{id}/documents/ocr        lecture des pièces
PUT  /api/rental-applications/{id}/documents/{d}/validate | /reject
POST /api/rental-applications/{id}/analyze              solvabilité, reste à vivre
GET  /api/rental-applications/{id}/gli-check            éligibilité GLI
POST /api/rental-applications/{id}/request-documents    demander les pièces manquantes
GET  /api/rental-applications/{id}/pre-accept-check     ce qui bloque l'acceptation
PUT  /api/rental-applications/{id}/reject | /reset-pending

Niveau 1 utile ici : POST /api/v1/documents/candidature (MCP dossier_candidature) met en forme un dossier de candidature en PDF.

Étape 8 — Accepter : le point de bascule

PUT /api/rental-applications/{id}/accept                (niveau 2)
→ crée d'un seul mouvement : le LOCATAIRE, le BAIL, le 1er APPEL DE LOYER
  (loyer + charges au prorata), les HONORAIRES DE LOCATION ALUR et le DÉPÔT DE
  GARANTIE appelés sur ce 1er loyer, et les honoraires de gestion du propriétaire.
  En REPRISE DE BAIL : dépôt de garantie et honoraires de location EXCLUS.

POST /api/leases/from-application                       variante explicite bail + 1er loyer

Étape 9 — Gestion courante : là où le niveau 1 brille

Ces calculs et documents sont stateless : un agent les produit avec sa seule clé, sans toucher à la base de l'agence.

Côté application, les mêmes opérations existent en transactionnel (émission réelle des appels, encaissements, relances liées aux baux), déclenchées aux dates de programmation de l'étape 0.

Étape 10 — Comptabilité et banque

Domaine du niveau 2, et le plus sensible :

• Factures fournisseurs — payées depuis l'application, ou saisies comme déjà payées pour figurer en comptabilité et alimenter les charges récupérables ;
• Relevés et rapprochement — import, affectation au bon compte locataire, auto-affectation des évidences ;
• Remises SEPA — prélèvements de loyers, virements aux propriétaires, et prélèvement du solde débiteur d'un CRG grâce à l'ICS ;
• Période de régularisation par immeuble — à renseigner, sinon les prorata de régularisation sont faux.

Le niveau 1 aide à préparer l'écriture : proposition_ecriture_paiement propose l'écriture d'un paiement, à relire avant saisie.

Étapes 11-12 — Extranets, interventions, e-facture

• Extranets propriétaire et locataire : solde, historique, quittances, CRG, documents, demandes d'intervention. Un agent peut expliquer et guider, pas se substituer au client.
• Interventions : intégrées au cycle — demande, devis, ordre de service, suivi, facture, puis charge récupérable ou non.
• E-facture : les factures Factur-X sont déjà produites côté partenaires ; la génération d'e-factures sur tout le cycle de gérance arrive prochainement.

La carte du cycle, en un coup d'œil

Et la vidéo de visite, sans compte ?

Le rendu 4K tourne sur le GPU d'un navigateur : c'est ce qui lui donne sa qualité, mais le moteur ne vivait que dans l'éditeur abonné. Un agent muni d'une simple clé restait donc bloqué au moment de produire la vidéo. Il existe désormais un studio public :

POST /api/v1/cao/visite/studio          (clé slk_ — niveau 1)
     body = scène CAO + duree_s / fps / resolution / objectif{} / cadence{}
            (+ plan_camera{} si vous avez déjà votre plan de tournage)
→ { "url_studio": "https://synergieloc.fr/cao/visite?t=…",
    "url_visite_virtuelle": "https://synergieloc.fr/cao/visite-xr?t=…",
    "objets": 143, "expire_dans_s": 7200, "plan_resume": "…", "alertes": [] }

Ouvrez url_studio dans N'IMPORTE QUEL navigateur : AUCUNE connexion, aucun cookie.
La page charge le moteur, rejoue le plan et télécharge le MP4 en 3840×2160.

Le jeton fait office d'identifiant : imprévisible, valable 2 h, et il ne donne accès qu'à la scène que vous venez de poster. Rien n'est conservé au-delà.

Et la Visite Virtuelle — casque VR, réalité augmentée ?

url_visite_virtuelle (même jeton que la vidéo, aucun appel séparé) ouvre une exploration en direct de la même scène — aucune vidéo ne s'enregistre. Mode classique immédiat (souris/tactile), bouton casque VR (Meta Quest, Pico, HTC Vive…) et bouton réalité augmentée (pose la maquette dans une pièce réelle par détection de surface, on marche autour EN VRAI). Une vraie scène 3D — le même moteur que la Visite 4K — plutôt que des photos panoramiques à 360° par pièce : vrai déplacement, vraie profondeur en casque. Les points d'intérêt affichent le nom de la pièce, sa surface et sa hauteur sous plafond — les seules données que le modèle de scène porte réellement.

Un bug, un doute ? Remontez-le

Canal gratuit, sans quota, toujours ouvert :

POST /api/v1/feedback
{"message":"…", "context":"…", "endpoint":"/api/…"}     (ou MCP envoyer_retour)

Pour aller plus loin

Le même cycle écran par écran · Calculs et documents par API/MCP · Cartographie de la gérance · Obtenir une clé.

Tous les guides sont lisibles par un client MCP : guides_liste puis guide_lire {slug} — gratuits, sans clé.