Essayer synergieloc

Piloter la gérance locative et le syndic par une IA

Un agent IA peut produire, en autonomie et par API/MCP, les calculs et documents réglementaires de la gestion locative (révision IRL, régularisation de charges, quittance, avenant) et de la copropriété (répartition RGDD par tantièmes) — chaque réponse inclut sa base légale. Et si quelque chose cloche, l'IA nous remonte le bug en un appel.

Démarrage : obtenez une clé gratuite en un appel — POST /api/v1/signup {"name":"VotreIA"} (sans email) ou l'outil MCP obtenir_cle_api. Puis en-tête X-API-Key: slk_live_… (REST) ou Authorization: Bearer (MCP). Serveur MCP : https://synergieloc.fr/mcp. Endpoints stateless : aucune donnée client conservée (les entrées viennent de l'appelant).

Ce qu'une IA peut faire (gérance)

Endpoint (outil MCP)Rôle
POST /api/v1/irl/revision (irl_revision_loyer)Nouveau loyer révisé plafonné IRL + formule + avertissements (art. 17-1 loi 89-462)
POST /api/v1/regularisation/charges (regularisation_charges)Quote-part locataire, prorata temporis, solde (décret 87-713)
POST /api/v1/documents/quittance (quittance_loyer)Quittance PDF conforme (art. 21 loi 89-462), loyer/charges distingués
POST /api/v1/documents/avenant-irl (avenant_revision_irl)Courrier d'avenant de révision IRL (PDF/HTML)

Révision de loyer IRL

L'appelant fournit les indices INSEE (IRL de référence du bail et nouvel IRL).

POST /api/v1/irl/revision
{"loyer_actuel": 850, "irl_reference": 141.03, "irl_nouveau": 145.17, "charges_actuelles": 60}
→ { "nouveau_loyer": 874.96, "augmentation": 24.96, "variation_irl_pct": 2.9356,
    "formule": "loyer × (IRL_nouveau / IRL_référence)",
    "base_legale": "Art. 17-1 loi 89-462 — plafonné à la variation de l'IRL",
    "avertissements": [ "…demande dans l'année suivant la date d'effet", "…encadrement des loyers" ] }

Régularisation des charges (gérance)

POST /api/v1/regularisation/charges
{"provisions_encaissees": 600, "tantiemes_locataire": 1, "tantiemes_total": 1,
 "charges": [ {"libelle":"Eau","montant":420,"recuperable":true},
              {"libelle":"Ascenseur","montant":300,"recuperable":true},
              {"libelle":"Honoraires syndic","montant":180,"recuperable":false} ],
 "jours_occupation": 365, "jours_periode": 365}
→ { "quote_part_locataire": 720.0, "provisions_encaissees": 600.0, "solde": -120.0,
    "sens": "complément à réclamer au locataire", "detail": [ … ],
    "base_legale": "Décret 87-713 ; régularisation annuelle art. 23 loi 89-462" }

Quittance de loyer (PDF)

POST /api/v1/documents/quittance
{"bailleur_nom":"SCI Dupont","bailleur_adresse":"1 rue A
75001 Paris",
 "locataire_nom":"M. Martin",
 "locataire_adresse":"12 rue de la Paix
75002 Paris",
 "logement_adresse":"5 rue B, 75002 Paris",
 "periode":"juillet 2026","loyer":850,"charges":60,"date_paiement":"2026-07-05",
 "lieu":"Paris","date_emission":"2026-07-06"}
→ PDF (WeasyPrint) ; repli HTML avec {"format":"html"}. Distingue loyer et charges (art. 21).
Mise en page enveloppe à fenêtre (destinataire à droite). Préférer
locataire_adresse (postale) distincte de logement_adresse (bien).
Garde-fou : refus sans code postal 5 chiffres.

Syndic / copropriété (RGDD)

La répartition des charges de copropriété par tantièmes (décompte par copropriétaire, style RGDD) se calcule avec le MÊME endpoint /regularisation/charges : mettez les tantièmes du lot dans tantiemes_locataire et le total des tantièmes de la clé dans tantiemes_total.

POST /api/v1/regularisation/charges
{"provisions_encaissees": 1200, "tantiemes_locataire": 350, "tantiemes_total": 10000,
 "charges": [ {"libelle":"Chauffage collectif","montant":18000},
              {"libelle":"Entretien parties communes","montant":9000} ]}
→ quote-part du lot = (montant × 350/10000), solde vs provisions appelées.
Frontière honnête : les calculs (répartition, régularisation, IRL, quittance, avenant) sont exposés en API. En revanche les workflows transactionnels — appels de fonds trimestriels, tenue d'AG, états datés, encaissement/relances liés à une base de baux — sont des fonctions de l'application (compte abonné), pas encore des endpoints publics. Ils sont documentés écran par écran dans les guides ci-dessous ; une IA peut s'y appuyer pour guider un utilisateur, mais pas orchestrer le cycle complet par API pour l'instant.

⚠️ Un bug, un doute, une amélioration ? Remonte-le

Le canal de retour est gratuit et toujours ouvert (0 unité, jamais bloqué même hors quota). Si une réponse te semble fausse, incomplète, ou si un endpoint plante : dis-le-nous, ça sert directement à corriger.

POST /api/v1/feedback
{"message":"Le calcul IRL n'applique pas le gel DPE F/G attendu",
 "context":"loyer_actuel=850, passoire thermique", "endpoint":"/api/v1/irl/revision"}
→ {"ok": true, "message": "Merci pour votre retour — il aidera à améliorer l'app."}

Ou l'outil MCP envoyer_retour (même canal). Champs : message (requis), context et endpoint (facultatifs, aident à reproduire le bug).

Guides détaillés (écran par écran)

Gérance : quittance · révision IRL · relances impayés · régularisation charges · dépôt de garantie · état des lieux · compte rendu de gérance.

Syndic / copropriété : appels de fonds · assemblée générale · RGDD & régularisation syndic.

Tous ces guides sont aussi lisibles en Markdown par un client MCP (guides_liste puis guide_lire {slug}, gratuits).

Questions fréquentes

Une IA peut-elle produire une quittance ou un avenant conformes ?

Oui : /documents/quittance (art. 21 loi 89-462) et /documents/avenant-irl (art. 17-1) renvoient un PDF prêt à envoyer, avec les mentions légales et la base juridique.

Le même calcul sert-il à la gérance ET au syndic ?

Oui pour la répartition de charges : /regularisation/charges fonctionne par tantièmes — tantièmes du locataire (gérance) ou tantièmes du lot dans une clé de copropriété (syndic/RGDD).

Comment signaler un bug rencontré par l'agent ?

Via POST /api/v1/feedback {"message":"…"} (ou l'outil MCP envoyer_retour) : gratuit, sans quota, toujours accessible. Ajoutez endpoint et context pour qu'on reproduise vite.