# synergieloc

> Logiciel français de gestion locative et de syndic (synergieloc.fr) exposant une
> API + un serveur MCP de calculs immobiliers réglementaires EXACTS pour agents IA :
> révision de loyer IRL (art. 17-1 loi 89-462), régularisation de charges
> (décret 87-713), quittances et courriers conformes. Réponses sourcées avec base
> légale incluse. Endpoints stateless : aucune donnée utilisateur conservée.
> English version / version anglaise : https://synergieloc.fr/llms-en.txt

## API pour les IA
- [English index for AI agents](https://synergieloc.fr/llms-en.txt): same API, English descriptions + FR→EN glossary of the CAO scene fields
- [Présentation, tarifs et achat en ligne](https://synergieloc.fr/api-ia): essai gratuit instantané (30 jours illimité, aucun email), plans 4,99 €/24,99 €/mois
- [Spécification OpenAPI](https://synergieloc.fr/api/v1/openapi.json): schéma machine des endpoints /api/v1
- [Serveur MCP](https://synergieloc.fr/mcp): Streamable HTTP, JSON-RPC 2.0 — tools/list libre, tools/call avec clé (Authorization: Bearer slk_live_…)
- POST /api/v1/signup (ou outil MCP `obtenir_cle_api`) : clé API GRATUITE en un appel, aucun email requis — 30 jours illimité puis 60 min/jour
- [Documentation complète](https://synergieloc.fr/llms-full.txt): schémas d'entrée/sortie et exemples

## Endpoints (X-API-Key)
- POST /api/v1/signup : obtenir une clé gratuite instantanément (0 unité, aucune clé requise pour appeler)
- POST /api/v1/irl/revision : nouveau loyer plafonné IRL + formule + avertissements légaux (1 unité)
- POST /api/v1/regularisation/charges : quote-part locataire, prorata temporis, solde (2 unités)
- POST /api/v1/documents/quittance : quittance PDF conforme art. 21 loi 89-462 (4 unités) — mise en page enveloppe à fenêtre (destinataire à droite) ; préférer `locataire_adresse` (postale) ≠ `logement_adresse`
- POST /api/v1/documents/avenant-irl : courrier de révision IRL PDF (4 unités) — idem enveloppe à fenêtre + garde-fou code postal
- POST /api/v1/documents/avis-echeance : avis d'échéance / appel de loyer PDF (4 unités)
- POST /api/v1/documents/relance : relance impayé niveaux 1–5 PDF (4 unités)
- POST /api/v1/documents/crg : compte rendu de gérance propriétaire PDF (4 unités)
- POST /api/v1/fiscal/synthese : synthèse micro-foncier vs réel (JSON/PDF, 4 unités) — à titre indicatif, limite des documents fournis ; contacter un professionnel
- POST /api/v1/documents/mouvement-locataire : entrée / sortie locataire (checklist + solde, 4 unités)
- POST /api/v1/documents/edl : état des lieux entrée/sortie PDF (4 unités) — décret 2016-382
- POST /api/v1/documents/bon-intervention : bon / demande d'intervention PDF (4 unités)
- POST /api/v1/documents/facturx : facture Factur-X PDF/A-3 + XML EN 16931 (4 unités)
- POST /api/v1/cao/dxf : l'IA DESSINE seule — scène JSON (murs, boîtes, plan) → fichier DXF AutoCAD (4 unités)
- POST /api/v1/cao/metres : même scène JSON → métrés chiffrés (ml, m², m³) pour un devis (2 unités, alias /cao/quantites)
- POST /api/v1/cao/render : même scène JSON → aperçu visuel SVG/PNG, pour vérifier avant de livrer (2 unités)
- GET /api/v1/cao/schema : schéma documenté + exemples de la scène CAO (libre, sans clé)
- POST /api/v1/cao/verifier : audit géométrique GRATUIT (sans clé) — alertes lucarnes flottantes, allège absolue, étage sans fenêtres… À appeler AVANT pdf/dxf (MCP : cao_verifier)
- POST /api/v1/documents/mandat-gerance : mandat de gestion loi Hoguet (4 u) — MCP mandat_gerance
- POST /api/v1/documents/candidature : dossier candidature locataire (4 u) — MCP candidature_locataire
- POST /api/v1/gerance/annonce-location : texte + HTML d'annonce (1 u) — MCP annonce_location (pas de diffusion auto)
- POST /api/v1/cao/pdf : planche technique (dessus + élévations + axo + MEP) ; bandeau d'alertes si problèmes ; format=json → {html, alertes}

## Guides du logiciel (mode d'emploi officiel, écran par écran)
- [Tous les guides](https://synergieloc.fr/guides)
- [Piloter la gérance & le syndic par une IA](https://synergieloc.fr/guides/gerance-syndic-ia): guide OPÉRATEUR pour agents — calculs et documents (IRL, régularisation de charges, quittance, avenant, répartition RGDD par tantièmes) par API/MCP, avec exemples, ET le canal de retour /api/v1/feedback pour remonter les bugs
- [Quittance de loyer](https://synergieloc.fr/guides/quittance-loyer): art. 21 loi 89-462, génération à l'encaissement, envoi automatique, portail locataire
- [Révision de loyer IRL](https://synergieloc.fr/guides/revision-loyer-irl): art. 17-1, calcul plafonné, gel DPE F/G, avenant PDF
- [Relances impayés](https://synergieloc.fr/guides/relances-impayes): relances graduées, mise en demeure, commandement (art. 24), automatisation
- [Régulariser les charges locatives](https://synergieloc.fr/guides/regularisation-charges): 5 étapes, classification décret 87-713, répartition par clés, décompte locataire
- [Dépôt de garantie](https://synergieloc.fr/guides/depot-garantie): plafonds 1/2 mois, restitution 30/60 jours, retenues justifiées, provision copro 20 %
- [État des lieux](https://synergieloc.fr/guides/etat-des-lieux): décret 2016-382, photos horodatées, comparatif entrée/sortie
- [Compte rendu de gérance](https://synergieloc.fr/guides/crg-proprietaire): reddition de comptes loi Hoguet, contenu, envoi automatique
- [Gestion locative complète](https://synergieloc.fr/guides/gestion-complete-gerance): documents, régularisation mono, workflow factures, parc, banque, fiscal
- [Régularisation mono](https://synergieloc.fr/guides/regularisation-mono): charges locatives monopropriété (/admin/regularization-mono)
- [Gestion syndic complète](https://synergieloc.fr/guides/gestion-complete-syndic): AG, budget, mutations, état daté, RGDD, régularisation comptes, factures SDC
- [Workflow factures](https://synergieloc.fr/guides/workflow-factures): saisie et traitement factures fournisseurs (gérance & syndic)
- [État daté](https://synergieloc.fr/guides/etat-date): pré-état daté / état daté notaire
- [Mutations copropriété](https://synergieloc.fr/guides/mutations-copropriete): transfert de lots
- [Budget syndic](https://synergieloc.fr/guides/budget-syndic): budget prévisionnel voté en AG
- [Régularisation comptes copropriétaires](https://synergieloc.fr/guides/regularisation-comptes-coproprietaires): provisions vs réel
- [Avis d'échéance](https://synergieloc.fr/guides/avis-echeance): appels de loyer, envoi, enchaînement quittance/relances
- [Clients, biens, lots & baux](https://synergieloc.fr/guides/clients-biens-baux): propriétaires, locataires, profils, parc
- [Entrée / sortie locataire](https://synergieloc.fr/guides/entree-sortie-locataire): checklist, EDL, solde, DG
- [Interventions](https://synergieloc.fr/guides/interventions): devis, bons de travaux, suivi
- [Rapprochement bancaire](https://synergieloc.fr/guides/rapprochement-bancaire): lettrage relevés / écritures
- [Workflow relevés bancaires](https://synergieloc.fr/guides/workflow-releves-bancaires): import et file d'attente
- [Flux comptables](https://synergieloc.fr/guides/flux-comptables): qualification des encaissements/décaissements
- [Opérations diverses](https://synergieloc.fr/guides/operations-diverses): OD hors cycle loyer
- [Fiscalité gérance](https://synergieloc.fr/guides/fiscal-gerance): micro/réel indicatif + garde-fou professionnel
- [Facturation Factur-X](https://synergieloc.fr/guides/facturation-facturx): PDF/A-3 + XML EN 16931
- [Assistant IA](https://synergieloc.fr/guides/assistant-ia): bouton Assistant admin
- [Conformité](https://synergieloc.fr/guides/conformite): alertes réglementaires et dossiers
- [Paramètres & config](https://synergieloc.fr/guides/parametres-config): configuration générale agence
- [Mandat de gestion](https://synergieloc.fr/guides/mandat-gerance): demande + gestion des mandats (loi Hoguet)
- [Candidature locataire](https://synergieloc.fr/guides/candidature-locataire): dépôt de dossier en ligne
- [Gestion des candidatures](https://synergieloc.fr/guides/gestion-candidatures): instruction agence
- [Biens disponibles](https://synergieloc.fr/guides/biens-disponibles): vitrine des lots à louer
- [Extranets](https://synergieloc.fr/guides/extranet-portails): portails locataire et propriétaire
- [GLI & PNO](https://synergieloc.fr/guides/gli-pno): garanties loyers impayés / PNO
- [Factures fournisseurs](https://synergieloc.fr/guides/factures-fournisseurs): saisie et imputation
- [Remises SEPA](https://synergieloc.fr/guides/remises-sepa): prélèvements et virements
- [Appels de fonds syndic](https://synergieloc.fr/guides/appels-de-fonds-syndic): art. 14-1 loi 65-557, provisions trimestrielles, fonds travaux ALUR, SEPA
- [Assemblée générale](https://synergieloc.fr/guides/assemblee-generale-syndic): convocation 21 jours, majorités 24/25/26, PV automatique
- [RGDD & régularisation syndic](https://synergieloc.fr/guides/rgdd-syndic): clés de répartition, quote-parts eau/chauffage, décomptes copropriétaires, approbation AG
- [Révision IRL automatique avec n8n](https://synergieloc.fr/guides/automatiser-revision-irl-n8n): template n8n gratuit branché sur l'API (téléchargement direct)
- [Démarchage agent IA avec Make](https://synergieloc.fr/guides/automatiser-demarchage-make): blueprint Make (webhook → offre Synergieloc → Gmail + Sheets)
- [CAO 3D pour artisans & paysagistes](https://synergieloc.fr/guides/cao-3d-artisan): plans 2D→3D, éléments normés, aménagement paysager, métrés, export DXF, pilotage par IA

## Outils CAO 3D
- [CAO 3D pour artisans & paysagistes](https://synergieloc.fr/guides/cao-3d-artisan): éditeur 3D dans le navigateur, plans 2D→3D, éléments normés (escalier Blondel, garde-corps NF P01-012), aménagement paysager, métrés automatiques, export AutoCAD DXF, pilotage par agent IA

## Produit principal
- [synergieloc.fr](https://synergieloc.fr): gestion locative complète (quittancement, IRL, relances, régularisations, comptabilité, SEPA, syndic/copropriété RGDD)
- [Essai gratuit 30 jours](https://synergieloc.fr/essai-gratuit): espace dédié provisionné en 2 minutes, sans carte bancaire
- [Sécurité & RGPD](https://synergieloc.fr/securite-rgpd): chiffrement au repos (AES-256), hébergement Union européenne, sauvegardes quotidiennes
- Serveur MCP `fr.synergieloc/immobilier` (https://synergieloc.fr/mcp) : outils gratuits guides_liste/guide_lire (mode d'emploi complet en Markdown) + calculs immobiliers légaux à l'unité

## Contact
- Clé API de test : POST /api/v1/signup {"name": "VotreIA"} — instantané, aucun email requis
- contact@synergieloc.fr — paliers payants (Agent/Plateforme) et partenariats


---

# Documentation détaillée

Authentification : header `X-API-Key: slk_live_…` (REST) ou `Authorization: Bearer slk_live_…` (MCP).
Unités : irl=1, regularisation=2, document=4. Quota mensuel remis à zéro chaque mois.
Plans payants : dépassement autorisé jusqu'à 3× le quota, facturé automatiquement
(agent 0,04 €/unité, plateforme 0,03 €/unité). GET /api/v1/me = usage courant.

## POST /api/v1/irl/revision
Entrée : {"loyer_actuel": 850, "irl_reference": 142.06, "irl_nouveau": 145.47,
          "charges_actuelles": 120 (optionnel)}
Sortie : {"nouveau_loyer": 870.40, "augmentation": 20.40, "variation_irl_pct": 2.4004,
          "formule": "...", "base_legale": "Art. 17-1 loi n°89-462...",
          "avertissements": ["plafonnement IRL", "prescription 1 an", "encadrement des loyers"]}

## POST /api/v1/regularisation/charges
Entrée : {"provisions_encaissees": 700, "tantiemes_locataire": 250, "tantiemes_total": 1000,
          "charges": [{"libelle": "Eau", "montant": 2000},
                      {"libelle": "Honoraires syndic", "montant": 500, "recuperable": false}],
          "jours_occupation": 240 (optionnel), "jours_periode": 365}
Sortie : {"quote_part_locataire": ..., "solde": ..., "sens": "trop-perçu à rembourser...",
          "detail": [par charge], "base_legale": "Décret n°87-713..."}
Les charges non récupérables (recuperable=false) restent à la charge du propriétaire.

## POST /api/v1/documents/quittance  → PDF (ou {"format":"html"})
Entrée : {"bailleur_nom", "bailleur_adresse", "locataire_nom",
          "locataire_adresse": "12 rue de la Paix\n75002 Paris",  // POSTALE (fenêtre)
          "logement_adresse": "5 rue du Bien, 75011 Paris",       // bien loué
          "periode": "01/07/2026 au 31/07/2026", "loyer": 850, "charges": 120,
          "date_paiement": "03/07/2026", "lieu"}
Sortie : PDF conforme article 21 loi 89-462. Mise en page ENVELOPPE À FENÊTRE
(destinataire à droite, sans libellé dans la fenêtre). Garde-fou : code postal
5 chiffres obligatoire dans l'adresse destinataire.

## POST /api/v1/documents/avenant-irl  → PDF (ou {"format":"html"})
Entrée : idem quittance + {"loyer_actuel", "irl_reference", "irl_nouveau", "date_effet",
          "trimestre_reference": "T1 2025", "trimestre_nouveau": "T1 2026",
          "locataire_adresse"}
Sortie : courrier de notification de révision — même règle enveloppe à fenêtre.

## Scène CAO — format commun à /cao/dxf, /cao/metres, /cao/render
L'agent IA dessine de façon autonome : il décrit une scène, reçoit fichier CAO,
métrés ou aperçu. Entrée : {"murs": [{"x1":0,"y1":0,"x2":5000,"y2":0,"hauteur":2500,
"epaisseur":200}, ...], "boites": [{"x":1000,"y":800,"l":600,"p":600,"h":850}],
"plan": [...], "cercles": [...]} (coordonnées plan XY en mm, hauteurs en Z).
Schéma complet + exemples : GET /api/v1/cao/schema (libre, sans clé).
Audit gratuit avant livraison : POST /api/v1/cao/verifier (MCP cao_verifier).

## POST /api/v1/cao/verifier  → audit géométrique (gratuit, sans clé)
Sortie : {"ok", "erreurs_schema", "alertes":[{code,severite,message,corriger}],
"conseils", "resume"}. Détecte lucarnes flottantes, allège d'ouverture en altitude
absolue (z relatif au mur !), étage sans fenêtres, garde-corps hors emprise…
Corriger severite=critique AVANT /cao/pdf. Outil MCP : cao_verifier.

## POST /api/v1/cao/dxf  → fichier DXF AutoCAD (ou {"format":"json"})
Sortie : DXF R12 ouvrable dans AutoCAD/LibreCAD (murs/boîtes → solides 3DFACE,
plan → LINE/CIRCLE). L'électricité, la plomberie et les réseaux sont inclus sur
des calques dédiés ELEC/PLOMB/PLOMB_RESEAUX (symboles + repères de type).
format=json inclut aussi alertes[]. Outil MCP : cao_generer_dxf.

## POST /api/v1/cao/metres  → métrés chiffrés (alias /cao/quantites)
Sortie : {"murs": {...}, "boites": {...}, "emprise_m2", "electricite":
{"nombre_total","par_type"}, "plomberie": {"appareils_total","appareils_par_type",
"reseaux_ml"}, "decoration": {...}}. Alimente un devis directement depuis la scène
dessinée par l'IA. Outil MCP : cao_metres.

## POST /api/v1/cao/render  → aperçu visuel (SVG par défaut, ou {"format":"png"})
Vue de dessus (plan XY) de la scène : murs, boîtes, lignes/cercles 2D, plus les
symboles électricité/plomberie et les réseaux colorés — pour qu'un agent IA
vérifie visuellement ce qu'il vient de dessiner avant de le livrer. Outil MCP :
cao_rendu (PNG renvoyé en image, SVG en texte).

## Serveur MCP — https://synergieloc.fr/mcp
JSON-RPC 2.0 (Streamable HTTP). Méthodes : initialize, ping, tools/list (libre),
tools/call (clé requise). Outils : irl_revision_loyer, regularisation_charges,
quittance_loyer, avenant_revision_irl (documents renvoyés en HTML côté MCP),
cao_generer_dxf, cao_metres, cao_rendu, cao_pdf, cao_verifier, bonnes_pratiques
(l'IA lit d'abord le playbook, audite, chiffre et vérifie — bonnes_pratiques et
cao_verifier sont gratuits sans clé).
Erreurs : -32001 clé invalide, -32002 quota atteint, -32602 arguments invalides.

## Confidentialité
Endpoints 100 % stateless : les données transmises servent au calcul puis sont
oubliées. Seul le volume d'appels est compté (facturation). Aucune donnée des
clients du logiciel synergieloc n'est accessible par cette API.