# 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 49,99 €/149,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_…)
- [Descripteur MCP](https://synergieloc.fr/.well-known/mcp.json): transport, authentification et surfaces gratuites en JSON — le fichier à lire pour se connecter sans lire cette page (aussi /.well-known/ai-plugin.json, format plugin)
- [Brancher un agent](https://synergieloc.fr/agents): configuration MCP à coller, prompt système, premier appel gratuit
- [Sandbox visuelle MCP](https://synergieloc.fr/mcp/sandbox): simulateur interactif (tools/list, tools/call, /usage) pour tests d'intégration
- GET /api/v1/cao/demo : scène complète DÉJÀ VÉRIFIÉE (maison | appartement | extension) — gratuit, sans clé. Premier appel CAO. MCP : `cao_demo`
- POST /api/v1/signup (ou outil MCP `obtenir_cle_api`) : clé API GRATUITE en un appel, aucun email requis — 30 jours illimité puis 240 min/jour (4 h)
- [Tarifs lisibles par une machine](https://synergieloc.fr/api/v1/tarifs): coût par appel, plans, et la frontière gratuit/payant de la CAO avec sa date de bascule — sans clé
- [Documentation complète](https://synergieloc.fr/llms-full.txt): schémas d'entrée/sortie et exemples

## Endpoints (X-API-Key)
- GET /api/v1/usage : consommation réelle (minutes plan eval / unités + journal) — 0 unité
- GET /api/v1/me : résumé clé + liens usage/sandbox
- 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 (2 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é)
- GET /api/v1/cao/demo : scène prête (maison / appartement / extension), zéro alerte — gratuit, sans clé (MCP : cao_demo). Appeler AVANT de composer
- 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, 2 unités) ; bandeau d'alertes si problèmes ; format=json → {html, alertes}
- POST /api/v1/cao/programme : du programme au plan — {chambres, cuisine, surface_m2…} → maison de plain-pied complète aux cotes françaises (murs, portes, fenêtres, pièces, toiture), vérifiée à zéro alerte, en deux typologies (aile, bandes) ; GET décrit les champs (MCP : cao_programme)
- POST /api/v1/cao/devis : quantitatif par lots (trame de DPGF) — chaque ouvrage mesuré sur la scène (gros œuvre, couverture, menuiseries, plâtrerie, électricité, plomberie, chauffage-ventilation, sols, peinture), chiffré avec body.prix, jamais avec des prix inventés (MCP : cao_devis)
- POST /api/v1/cao/re2020 : pré-étude RE 2020 — H_T, U moyen, compacité, ventilation, vitrages orientés (nord_deg), leviers ; seuils RE 2020 des maisons rappelés, jamais de Bbio inventé (MCP : cao_re2020)
- POST /api/v1/cao/nomenclatures : nomenclatures — menuiseries par type (repères P1/F1, quantités par niveau) et baie par baie avec les pièces desservies, pièces et surfaces habitable/Carrez avec totaux, équipements par niveau ; JSON, CSV Excel, HTML ou PDF, mêmes chiffres que l'IFC (MCP : cao_nomenclatures)
- POST /api/v1/cao/carnet : carnet de plans — feuilles A3/A1 numérotées (garde, masse, plans par niveau, façades, coupe, réseaux, nomenclatures) à l'échelle vraie, cartouche, révisions, empreinte de la maquette ; PDF, HTML ou JSON (MCP : cao_carnet)
- POST /api/v1/cao/versions/comparer : {avant, apres} → ce qui a changé entre deux versions (ajouts, suppressions, modifications champ par champ, éléments reconnus par leur géométrie) et l'écart du quantitatif — la base d'un avenant (MCP : cao_comparer_versions)
- POST /api/v1/cao/ferraillage : descente de charges (G, Q, ELS, ELU, contrainte au sol par mur porteur) et ferraillage simplifié Eurocode 2 des semelles, linteaux et dalles, en barres et en kg ; prédimensionnement à faire valider par un bureau d'études (MCP : cao_ferraillage)
- POST /api/v1/cao/familles/essayer : familles paramétriques définies en données, comme les familles Revit — paramètres bornés, formules, contraintes, solides en expressions — évaluées sans scène ; dans une scène, `familles` + `instances` deviennent volumes, métrés et objets IFC typés (MCP : cao_famille_essayer)
- POST /api/v1/cao/4d : vue 4D — la maquette telle qu'elle est construite à la fin de chaque lot du planning (axonométrie et plan du niveau bas), et l'état du chantier à une date (MCP : cao_4d)
- POST /api/v1/cao/soleil : soleil et ombres portées — aux 21 juin, 21 mars et 21 décembre : lever, coucher, hauteur maximale, ombre du bâtiment à midi (m² et contours) et, pour chaque baie, ses heures de soleil avec la première et la dernière ; masques du bâtiment et masques déclarés compris (MCP : cao_soleil)
- POST /api/v1/cao/energie : ce que la maison consommera — besoin de chauffage par les degrés-jours (apports solaires corrigés des masques mesurés sur la scène), eau chaude, consommation selon le générateur, Ic construction estimé avec vos facteurs carbone, et confort d'été comparé à ce qu'une nuit de ventilation évacue ; ni DPE ni calcul réglementaire, et les données climatiques viennent de vous (MCP : cao_energie)
- POST /api/v1/cao/urbanisme : le règlement appliqué à la scène — emprise au sol et %, hauteurs, recul de chaque limite avec la hauteur en vis-à-vis, prospect H/2, pentes, stationnement, espaces libres ; les règles sont CELLES QUE VOUS DONNEZ (le règlement de la zone), aucune valeur de PLU n'est devinée (MCP : cao_urbanisme)
- POST /api/v1/cao/plan/partager : le plan envoyé au client — un lien (/plan/{jeton}) qu'il ouvre sans compte ni logiciel pour punaiser ses remarques sur le plan ; elles reviennent par l'API et s'exportent en sujets BCF. Lire et commenter sont libres, créer le lien est une production
- POST /api/v1/cao/permis : dossier de permis de construire d'une maison (Cerfa 13406, brouillon) — surface de plancher R111-22, emprise au sol R420-1, hauteurs, PCMI2 plan de masse, PCMI3 coupe, PCMI4 notice, PCMI5 façades ; PCMI1/6/7/8 listés « à fournir » ; format=json|html|pdf (2 unités, MCP : cao_permis)

## 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)
- [Campagnes CAO Make + n8n](https://synergieloc.fr/guides/campagne-cao-make-n8n): faire connaître le moteur CAO (IFC, DXF, visite 4K) à grande échelle
- [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