# 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.

## API pour les IA
- [Présentation, tarifs et achat en ligne](https://synergieloc.fr/api-ia): essai gratuit 100 unités/mois, plans 49 €/249 €/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_…)
- [Documentation complète](https://synergieloc.fr/llms-full.txt): schémas d'entrée/sortie et exemples

## Endpoints (X-API-Key)
- 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)
- POST /api/v1/documents/avenant-irl : courrier de révision IRL PDF (4 unités)

## Guides du logiciel (mode d'emploi officiel, écran par écran)
- [Tous les guides](https://synergieloc.fr/guides)
- [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
- [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

## Produit principal
- [synergieloc.fr](https://synergieloc.fr): gestion locative complète (quittancement, IRL, relances, régularisations, comptabilité, SEPA, syndic/copropriété RGDD)
- [Sécurité & RGPD](https://synergieloc.fr/securite-rgpd): chiffrement au repos, hébergement France

## Contact
- contact@synergieloc.fr — clé API de test sous 24 h


---

# 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", "logement_adresse",
          "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 (détail loyer/charges, gratuité, mentions).

## POST /api/v1/documents/avenant-irl  → PDF (ou {"format":"html"})
Entrée : quittance + {"loyer_actuel", "irl_reference", "irl_nouveau", "date_effet",
          "trimestre_reference": "T1 2025", "trimestre_nouveau": "T1 2026"}
Sortie : courrier de notification de révision au locataire, calcul détaillé inclus.

## 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).
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.