{"openapi":"3.1.0","info":{"title":"REPERES — API de contexte ESSMS","version":"1.0.0","description":"Contexte expert ESSMS sourcé (droit, doctrine, actualité, statistiques), information ponctuelle vérifiée et réponse rédigée. Mêmes droits, débit, comptage, franchise mensuelle et crédits que le connecteur MCP : `context` et `precision` pour tout compte identifié, `answer` avec l'option génération ou en crédits. Barème : page des tarifs. Ne transmettez ni données de santé ni données identifiantes de personnes accompagnées."},"servers":[{"url":"https://mcp.reperes.bmse.fr"}],"security":[{"bearer":[]}],"paths":{"/api/v1/context":{"post":{"operationId":"context","summary":"Contexte expert, sans rédaction","description":"Doctrine, actualité, preuves documentaires, statistiques et Qualiscope selon le besoin. L'appelant rédige. Compté comme une opération Contexte.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextRequest"}}}},"responses":{"200":{"description":"Contexte livré.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextDelivery"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/precision":{"post":{"operationId":"precision","summary":"Information ponctuelle et sa citation vérifiée, ou un statut","description":"`answered` avec une ou deux sources citées, sinon `not_found`, `depends` ou `out_of_scope` et une redirection vers `context`. Compté comme une opération Contexte, sauf panne.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}}},"responses":{"200":{"description":"Statut métier livré.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrecisionDelivery"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Panne réessayable (`status: error`, `error.code`) ; non comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrecisionDelivery"}}}}}}},"/api/v1/answer":{"post":{"operationId":"answer","summary":"Réponse rédigée par REPERES","description":"Réponse experte autonome en Markdown et sources. Compté comme une opération Génération.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRequest"}}}},"responses":{"200":{"description":"Réponse livrée.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerDelivery"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/valeurs":{"get":{"operationId":"valeurs","summary":"Recherche (`q`), résolution (`q` + `resoudre`) ou catalogue (`famille`) des valeurs de référence","description":"Paramètres d'Étalon (SMIC, plafonds, minima, tarifs, taux, points, indices), sans valeur. Compté comme une opération Contexte.","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Valeur cherchée, en français."},{"name":"famille","in":"query","schema":{"type":"string"},"description":"Famille de paramètres."},{"name":"n","in":"query","schema":{"type":"integer","minimum":1,"maximum":50},"description":"Nombre de candidats (recherche)."},{"name":"resoudre","in":"query","schema":{"type":"boolean"},"description":"Avec `q` : lit la valeur du paramètre retenu (résultat `etalon.result.v1`, `ambiguous` si plusieurs répondent)."},{"name":"date","in":"query","schema":{"type":"string","format":"date"},"description":"Date de lecture (défaut : aujourd'hui)."},{"name":"territoire","in":"query","schema":{"type":"string"},"description":"nat_FR (défaut), dep_976, dep_2A…"}],"responses":{"200":{"description":"`parametres[]` : id, libellé, famille, classe, score.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"400":{"description":"Paramètre de requête invalide (date, territoire, coordonnée, identifiant).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/valeurs/{id}":{"get":{"operationId":"valeur","summary":"Valeur de référence applicable, datée et sourcée","description":"Résultat `etalon.result.v1` : valeur décimale exacte, date d'effet, source primaire et passage cité ; `depends` si une coordonnée manque, `not_found` sans valeur publiée à la date. Toute autre clé de requête est une coordonnée du paramètre (ex. `gir=1`, `part=employeur`). Compté comme une opération Contexte.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Identifiant du paramètre (ex. `smic.horaire`)."},{"name":"date","in":"query","schema":{"type":"string","format":"date"},"description":"Date de lecture (défaut : aujourd'hui)."},{"name":"territoire","in":"query","schema":{"type":"string"},"description":"nat_FR (défaut), dep_976, dep_2A…"}],"responses":{"200":{"description":"Résultat `etalon.result.v1`.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"https://mcp.reperes.bmse.fr/api/v1/schemas/etalon.result.v1.json"}}}},"400":{"description":"Paramètre de requête invalide (date, territoire, coordonnée, identifiant).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/valeurs/{id}/historique":{"get":{"operationId":"valeur_historique","summary":"Valeurs successives d'un paramètre","description":"Toutes les valeurs publiées, par territoire et coordonnées (`territoire=*` : tous les territoires). Toute autre clé de requête est une coordonnée du paramètre (ex. `gir=1`, `part=employeur`).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Identifiant du paramètre (ex. `smic.horaire`)."},{"name":"territoire","in":"query","schema":{"type":"string"},"description":"nat_FR (défaut), dep_976, dep_2A…"}],"responses":{"200":{"description":"Résultat `etalon.result.v1`.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"https://mcp.reperes.bmse.fr/api/v1/schemas/etalon.result.v1.json"}}}},"400":{"description":"Paramètre de requête invalide (date, territoire, coordonnée, identifiant).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calcul/remuneration":{"post":{"operationId":"calcul_remuneration","summary":"Simulation de rémunération conventionnelle (CCN 66, CCN 51)","description":"Brut conventionnel, net salarié et coût employeur d'un emploi à une date, chaque ligne avec sa base, son taux, sa source et son hypothèse (résultat `calcul.remuneration.v1`) ; questions, éléments non simulés et signalements à restituer. Net et coût depuis le 1er janvier 2026. Emplois et types d'établissement : `GET /api/v1/calcul/modeles`. Profil non couvert : 422 avec `message`, non compté. Compté comme une opération Contexte.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilRemuneration"}}}},"responses":{"200":{"description":"Résultat `calcul.remuneration.v1`.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"https://mcp.reperes.bmse.fr/api/v1/schemas/calcul.remuneration.v1.json"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Profil non couvert (convention, emploi ou date).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calcul/esat":{"post":{"operationId":"calcul_esat","summary":"Rémunération garantie d'un travailleur d'ESAT : part de l'ESAT et aide au poste","description":"Demande `{date?, temps_travail?, part_esat: {pct_smic} | {mensuelle}, effectif?, couverture?}` : part financée par l'ESAT, aide au poste de l'État (dégressive au-delà de 20 % du SMIC), rémunération garantie, bornes de 55,7 % et 110,7 % du SMIC, plafond annuel de l'intéressement, contrôles (CASF R. 243-5, R. 243-6) ; résultat `calcul.esat.v1`. `effectif` et `couverture` facultatifs ; depuis 2026, cotisations sans chômage ni réduction générale, net du travailleur, compensation par l'État (R. 243-9) et coût pour l'ESAT. Demande non couverte : 422 avec `message`, non comptée. Compté comme une opération Contexte (droit `reperes_calcul`).","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemandeEsat"}}}},"responses":{"200":{"description":"Résultat `calcul.esat.v1`.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"https://mcp.reperes.bmse.fr/api/v1/schemas/calcul.esat.v1.json"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Demande non couverte (date sans valeurs, part ambiguë).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calcul/trajectoire":{"post":{"operationId":"calcul_trajectoire","summary":"Trajectoire d'une rémunération conventionnelle en euros courants et constants","description":"Demande `{profil, debut?, fin?, lecture?, reference?}` : brut conventionnel mensuel moyen de chaque année depuis 2014 (défaut), en euros courants et en euros constants d'un mois de référence (IPC hors tabac de l'INSEE), rapport au SMIC, effets de chaque année sur la précédente (ancienneté, grille, mesures nationales, point ; inflation et gain réel), cumul (résultat `calcul.trajectoire.v1`). Profil comme `POST /api/v1/calcul/remuneration`, sans date. Demande non couverte : 422 avec `message`, non compté. Compté comme une opération Contexte.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemandeTrajectoire"}}}},"responses":{"200":{"description":"Résultat `calcul.trajectoire.v1`.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"https://mcp.reperes.bmse.fr/api/v1/schemas/calcul.trajectoire.v1.json"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Demande non couverte (convention, emploi, période, mois de référence).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calcul/autonomie":{"post":{"operationId":"calcul_autonomie","summary":"Démonstrateur APA à domicile : plan d'aide et reste à charge d'un mois","description":"Scénario `calcul.autonomie.v1` (faits avec leur provenance : notification et facture transcrites, déclaration, hypothèse) : plafond du GIR à part du plan, taux de participation (notifié ou calculé selon CASF R. 232-11), décomposition du mois, écarts d'heures, informations manquantes ordonnées ; montant inconnu à null avec son motif. Simulation non opposable : aucun GIR ni volume d'heures déduit, aucun montant PCH. Ne transmettre aucune donnée identifiante. Scénario rejeté par le moteur : 422, non compté. Compté comme une opération Contexte.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScenarioAutonomie"}}}},"responses":{"200":{"description":"Résultat `calcul.autonomie.v1`.","headers":{"X-Reperes-Operation-Id":{"description":"Identifiant de l'opération comptée, à communiquer au support.","schema":{"type":"string","format":"uuid"}},"X-Reperes-Credits-Charged":{"description":"Crédits débités, quand l'opération dépasse la franchise mensuelle.","schema":{"type":"integer"}},"X-Reperes-Credits-Remaining":{"description":"Solde de crédits après débit.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"https://mcp.reperes.bmse.fr/api/v1/schemas/calcul.autonomie.v1.json"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Scénario rejeté (date, GIR, taux supérieur à 90 %…).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/calcul/modeles":{"get":{"operationId":"calcul_modeles","summary":"Conventions, emplois, éléments variables et types d'établissement du simulateur","description":"Catalogue `calcul.modeles.v1` : identifiants à donner dans le profil de `POST /api/v1/calcul/remuneration`. Non compté.","responses":{"200":{"description":"Catalogue `calcul.modeles.v1`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"400":{"description":"Corps invalide : JSON non objet, `query` absente ou vide, champ mal typé.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Clé ou jeton absent, invalide ou révoqué.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Franchise mensuelle ou usage de l'option Génération atteint, crédits insuffisants (`credits_exhausted`, `upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Opération non couverte par le droit du compte (`upgrade_url`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Corps supérieur à 16 Ko.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Débit dépassé (`Retry-After`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/schemas":{"get":{"operationId":"schemas_index","summary":"Contrats publiés","description":"Liste des contrats de réponse versionnés (nom, titre, description, adresse du schéma). Public, non compté.","security":[],"responses":{"200":{"description":"Index des contrats.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/schemas/{contrat}.json":{"get":{"operationId":"schema_contrat","summary":"Schéma JSON d'un contrat","description":"Schéma JSON (draft 2020-12) d'une réponse versionnée, généré depuis les types du moteur : `etalon.result.v1`, `calcul.remuneration.v1`… Public, non compté.","security":[],"parameters":[{"name":"contrat","in":"path","required":true,"schema":{"type":"string"},"description":"Nom du contrat, ex. `calcul.esat.v1`."}],"responses":{"200":{"description":"Schéma JSON.","content":{"application/schema+json":{"schema":{"type":"object"}}}},"404":{"description":"Contrat inconnu.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Moteur indisponible ; l'opération n'est pas comptée.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sources/{id}":{"get":{"operationId":"source","summary":"Passeport de preuve d'un document (public)","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"`sources[].id`."}],"responses":{"200":{"description":"Titre, type, éditeur, date, lien d'origine et extrait.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"description":"Document inconnu.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Source indisponible.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sources/{id}/content":{"get":{"operationId":"source_content","summary":"Texte d'un document et ses métadonnées (public)","security":[],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"`sources[].id`."}],"responses":{"200":{"description":"Texte reconstitué ; `file_url` temporaire quand l'original est disponible.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Object"}}}},"404":{"description":"Document inconnu.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Source indisponible.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Clé `rpr_sk_…` créée sur la page de connexion MCP de REPERES (même clé pour MCP et API), ou jeton OAuth du connecteur."}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"upgrade_url":{"type":"string","description":"Page des tarifs (402, 403)."},"detail":{"type":"string"},"credits_required":{"type":"integer","description":"Crédits nécessaires à l'opération (402)."},"credits_balance":{"type":"integer","description":"Solde de crédits du compte (402)."},"retry_after_seconds":{"type":"integer","description":"Attente avant nouvel essai (429)."}}},"Object":{"type":"object","additionalProperties":true},"ProfilRemuneration":{"type":"object","required":["convention","emploi"],"properties":{"convention":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Convention collective : `ccn66`, `ccn51`."},"emploi":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Emploi du catalogue `GET /api/v1/calcul/modeles`."},"date":{"type":"string","format":"date","description":"Date de calcul AAAA-MM-JJ (défaut : aujourd'hui)."},"anciennete_ans":{"description":"Ancienneté en années (défaut 0). Nombre positif, au plus 60 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":60},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"experience_cadre_ans":{"description":"Années d'expérience de cadre. Nombre positif, au plus 60 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":60},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"temps_travail":{"description":"Part d'un temps plein, de 0 (exclu) à 1 (défaut 1). Nombre positif, au plus 1 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"type_etablissement":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Type d'établissement du catalogue (ex. `mecs`, `ehpad`)."},"classement":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Classement de l'emploi quand la convention en prévoit plusieurs."},"territoire":{"type":"string","pattern":"^(nat|reg|dep)_[A-Za-z0-9]{1,10}$","description":"`nat_FR` (défaut), `dep_971`…"},"reponses":{"type":"object","maxProperties":60,"propertyNames":{"pattern":"^[a-z0-9_.]{1,80}$"},"additionalProperties":{"type":"boolean"},"description":"Réponses aux questions du résultat précédent : `{ \"surclassement_internat\": true }`."},"quantites":{"type":"object","additionalProperties":{"description":"Quantité du mois. Nombre positif, au plus 1000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"description":"Éléments variables du mois : `{ \"heures_dimanche_ferie\": 14 }`."},"saisies":{"type":"object","additionalProperties":{"description":"Montant saisi. Nombre positif, au plus 10000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":10000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"description":"Montants saisis par l'utilisateur."},"employeur":{"type":"object","description":"Paramètres de l'employeur (facultatifs ; repère sectoriel signalé à défaut).","properties":{"effectif":{"type":"integer","minimum":0,"maximum":1000000},"taux_atmp":{"description":"Taux AT/MP en %. Nombre positif, au plus 30 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":30},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"code_risque":{"type":"string","pattern":"^[0-9]{2}\\.[0-9A-Z]{3}$","description":"Code risque AT/MP (ex. `85.3AC`)."},"versement_mobilite":{"description":"Taux du versement mobilité en %. Nombre positif, au plus 5 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":5},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"mutuelle_employeur":{"description":"Part employeur de la mutuelle, euros par mois. Nombre positif, au plus 2000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":2000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"mutuelle_salarie":{"description":"Part salariale de la mutuelle, euros par mois. Nombre positif, au plus 2000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":2000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"taxe_salaires":{"type":"boolean"},"taxe_apprentissage":{"type":"boolean"}}}},"example":{"convention":"ccn66","emploi":"educateur_specialise","anciennete_ans":10,"type_etablissement":"mecs","reponses":{"surclassement_internat":true}}},"DemandeEsat":{"type":"object","required":["part_esat"],"properties":{"date":{"type":"string","format":"date","description":"Date de calcul AAAA-MM-JJ (défaut : aujourd'hui)."},"temps_travail":{"description":"Part d'un temps plein, de 0 (exclu) à 1 (défaut 1). Nombre positif, au plus 1 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"part_esat":{"type":"object","description":"Part financée par l'ESAT : en pourcentage du SMIC ou en euros par mois, l'un des deux.","properties":{"pct_smic":{"description":"Pourcentage du SMIC. Nombre positif, au plus 200 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":200},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"mensuelle":{"description":"Euros par mois. Nombre positif, au plus 10000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":10000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]}}},"effectif":{"type":"integer","minimum":1,"maximum":100000,"description":"Effectif de l'ESAT (seuils du FNAL)."},"couverture":{"type":"object","description":"Complémentaire santé et prévoyance, euros par mois.","properties":{"sante_esat":{"description":"Part de l'ESAT. Nombre positif, au plus 1000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"sante_travailleur":{"description":"Part du travailleur. Nombre positif, au plus 1000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"prevoyance_esat":{"description":"Prévoyance à la charge de l'ESAT. Nombre positif, au plus 1000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]}}}},"example":{"part_esat":{"pct_smic":35},"effectif":30,"couverture":{"sante_esat":20,"sante_travailleur":20,"prevoyance_esat":15}}},"DemandeTrajectoire":{"type":"object","required":["profil"],"properties":{"profil":{"type":"object","required":["convention","emploi"],"properties":{"convention":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Convention collective : `ccn66`, `ccn51`."},"emploi":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Emploi du catalogue `GET /api/v1/calcul/modeles`."},"date":{"type":"string","format":"date","description":"Date de calcul AAAA-MM-JJ (défaut : aujourd'hui)."},"anciennete_ans":{"description":"Ancienneté en années (défaut 0). Nombre positif, au plus 60 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":60},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"experience_cadre_ans":{"description":"Années d'expérience de cadre. Nombre positif, au plus 60 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":60},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"temps_travail":{"description":"Part d'un temps plein, de 0 (exclu) à 1 (défaut 1). Nombre positif, au plus 1 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"type_etablissement":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Type d'établissement du catalogue (ex. `mecs`, `ehpad`)."},"classement":{"type":"string","pattern":"^[a-z0-9_]{1,80}$","description":"Classement de l'emploi quand la convention en prévoit plusieurs."},"territoire":{"type":"string","pattern":"^(nat|reg|dep)_[A-Za-z0-9]{1,10}$","description":"`nat_FR` (défaut), `dep_971`…"},"reponses":{"type":"object","maxProperties":60,"propertyNames":{"pattern":"^[a-z0-9_.]{1,80}$"},"additionalProperties":{"type":"boolean"},"description":"Réponses aux questions du résultat précédent : `{ \"surclassement_internat\": true }`."},"quantites":{"type":"object","additionalProperties":{"description":"Quantité du mois. Nombre positif, au plus 1000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":1000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"description":"Éléments variables du mois : `{ \"heures_dimanche_ferie\": 14 }`."},"saisies":{"type":"object","additionalProperties":{"description":"Montant saisi. Nombre positif, au plus 10000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":10000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"description":"Montants saisis par l'utilisateur."},"employeur":{"type":"object","description":"Paramètres de l'employeur (facultatifs ; repère sectoriel signalé à défaut).","properties":{"effectif":{"type":"integer","minimum":0,"maximum":1000000},"taux_atmp":{"description":"Taux AT/MP en %. Nombre positif, au plus 30 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":30},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"code_risque":{"type":"string","pattern":"^[0-9]{2}\\.[0-9A-Z]{3}$","description":"Code risque AT/MP (ex. `85.3AC`)."},"versement_mobilite":{"description":"Taux du versement mobilité en %. Nombre positif, au plus 5 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":5},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"mutuelle_employeur":{"description":"Part employeur de la mutuelle, euros par mois. Nombre positif, au plus 2000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":2000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"mutuelle_salarie":{"description":"Part salariale de la mutuelle, euros par mois. Nombre positif, au plus 2000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":2000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"taxe_salaires":{"type":"boolean"},"taxe_apprentissage":{"type":"boolean"}}}},"example":{"convention":"ccn66","emploi":"educateur_specialise","anciennete_ans":10,"type_etablissement":"mecs","reponses":{"surclassement_internat":true}},"description":"Profil du simulateur de rémunération (la date est fixée par la période)."},"debut":{"type":"integer","minimum":2000,"maximum":2100,"description":"Première année."},"fin":{"type":"integer","minimum":2000,"maximum":2100,"description":"Dernière année."},"lecture":{"type":"string","enum":["poste_constant","carriere"],"description":"Même ancienneté chaque année, ou ancienneté qui progresse."},"reference":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Mois de référence des euros constants (AAAA-MM)."}},"example":{"profil":{"convention":"ccn66","emploi":"moniteur_educateur","type_etablissement":"ime"},"lecture":"carriere","debut":2016,"reference":"2024-06"}},"ScenarioAutonomie":{"type":"object","description":"Faits du mois avec leur provenance ; aucun récit ni donnée identifiante.","properties":{"date":{"type":"string","format":"date","description":"Date de calcul AAAA-MM-JJ (défaut : aujourd'hui)."},"periode":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Mois du plan (AAAA-MM)."},"personne":{"type":"object","properties":{"age":{"type":"integer","minimum":0,"maximum":130},"gir":{"type":"integer","minimum":1,"maximum":6},"domicile":{"type":"boolean"},"pch_accordee":{"type":"boolean"},"provenance":{"type":"string","enum":["declaration","notification","facture","hypothese"],"description":"D'où vient le fait : déclaration, notification ou facture transcrite, hypothèse."}}},"plan":{"type":"object","properties":{"statut":{"type":"string","enum":["notifie","propose","envisage"]},"aide_humaine":{"type":"object","properties":{"heures":{"description":"Heures par mois. Nombre positif, au plus 744 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":744},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"tarif":{"description":"Tarif horaire retenu par le département, euros. Nombre positif, au plus 500 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":500},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]}}},"autres_postes":{"type":"array","maxItems":10,"items":{"type":"object","required":["libelle"],"properties":{"libelle":{"type":"string","maxLength":80},"montant":{"description":"Euros par mois. Nombre positif, au plus 10000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":10000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]}}}},"taux_participation":{"description":"Taux de participation notifié, en %. Nombre positif, au plus 90 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":90},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"forfait":{"type":"boolean","description":"Plan forfaitaire."},"provenance":{"type":"string","enum":["declaration","notification","facture","hypothese"],"description":"D'où vient le fait : déclaration, notification ou facture transcrite, hypothèse."}}},"ressources":{"type":"object","properties":{"mensuelles":{"description":"Ressources mensuelles, euros. Nombre positif, au plus 100000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":100000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"couple":{"type":"boolean"},"provenance":{"type":"string","enum":["declaration","notification","facture","hypothese"],"description":"D'où vient le fait : déclaration, notification ou facture transcrite, hypothèse."}}},"realise":{"type":"object","properties":{"heures_dans_plan":{"description":"Heures réalisées dans le plan. Nombre positif, au plus 744 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":744},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"heures_hors_plan":{"description":"Heures réalisées au-delà du plan. Nombre positif, au plus 744 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":744},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"prix_horaire":{"description":"Prix horaire facturé, euros. Nombre positif, au plus 500 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":500},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"facture_nette_apa":{"type":"boolean","description":"Facture déjà nette de l'APA."},"provenance":{"type":"string","enum":["declaration","notification","facture","hypothese"],"description":"D'où vient le fait : déclaration, notification ou facture transcrite, hypothèse."}}},"besoin":{"type":"object","properties":{"heures_estimees":{"description":"Besoin estimé en heures. Nombre positif, au plus 744 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":744},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]},"provenance":{"type":"string","enum":["declaration","notification","facture","hypothese"],"description":"D'où vient le fait : déclaration, notification ou facture transcrite, hypothèse."}}},"fiscal":{"type":"object","properties":{"eligible":{"type":"boolean"},"plafond_disponible":{"description":"Plafond de crédit d'impôt restant, euros. Nombre positif, au plus 20000 ; nombre ou texte (« 0,8 » accepté).","oneOf":[{"type":"number","minimum":0,"maximum":20000},{"type":"string","pattern":"^\\s*\\d{1,6}([.,]\\d{1,4})?\\s*$"}]}}}},"example":{"periode":"2026-01","personne":{"gir":2,"domicile":true,"provenance":"notification"},"plan":{"statut":"notifie","aide_humaine":{"heures":40,"tarif":24.5},"provenance":"notification"},"ressources":{"mensuelles":1800,"provenance":"declaration"},"realise":{"heures_dans_plan":38,"prix_horaire":29,"provenance":"facture"}}},"QueryRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":8000,"description":"Question ou besoin ESSMS."}}},"ContextRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":1,"maxLength":8000},"exploration":{"type":"boolean","default":false,"description":"Force le balayage documentaire élargi (plus de candidats et de preuves). Absent ou faux, REPERES le déclenche de lui-même pour une demande de panorama."}}},"Provenance":{"type":"object","properties":{"content_provider":{"const":"REPERES"},"final_text_by":{"enum":["host","reperes"]},"knowledge_updated_at":{"type":["string","null"],"description":"Dernière ingestion du corpus (AAAA-MM-JJ), null si inconnue. Ne date pas chaque source."}}},"Source":{"type":"object","required":["id","title","url","source_type"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string","description":"Passeport de preuve public (`/sources/{id}`)."},"source_type":{"type":"string"},"section_path":{"type":"string"},"snippet":{"type":"string"},"score":{"type":"number"}}},"Evidence":{"type":"object","required":["id","chunk_id","content","truncated"],"properties":{"id":{"type":"string","description":"Document (`sources[].id`)."},"chunk_id":{"type":"string","description":"Passage."},"title":{"type":"string"},"source_type":{"type":"string"},"section_path":{"type":["string","null"]},"date":{"type":["string","null"]},"status":{"type":["string","null"],"description":"Statut de vigueur."},"score":{"type":"number"},"content":{"type":"string"},"truncated":{"type":"boolean","description":"Passage réduit par le budget à la fenêtre qui répond le mieux à la question (« … » aux coupures). Les textes normatifs sont toujours entiers."}}},"DeliveryCoverage":{"type":"object","description":"Livraison du lot de preuves sélectionné ; ne mesure jamais l'exhaustivité du sujet.","properties":{"scope":{"const":"selected_evidence_delivery"},"selected_passages":{"type":"integer"},"delivered_passages":{"type":"integer"},"truncated_passages":{"type":"integer"},"omitted_chunk_ids":{"type":"array","items":{"type":"string"}},"budget_chars":{"type":"integer"},"complete":{"type":"boolean","description":"Tout le lot sélectionné est livré, sans troncature."},"exhaustive":{"const":false}}},"ContextDelivery":{"type":"object","required":["delivery","provenance","context","sources","metadata"],"properties":{"delivery":{"const":"context"},"provenance":{"$ref":"#/components/schemas/Provenance"},"context":{"type":"object","properties":{"editorial_guidance":{"type":"array","items":{"type":"string"}},"key_points":{"type":"array","items":{"type":"string"}},"vigilance_points":{"type":"array","items":{"type":"string"}},"thematic_contexts":{"type":"array","items":{"type":"object"}},"sector_contexts":{"type":"array","items":{"type":"object"}},"actuality":{"type":"array","items":{"type":"object"}},"reference_date":{"type":"string"},"evidence":{"type":"array","items":{"$ref":"#/components/schemas/Evidence"}},"coverage":{"$ref":"#/components/schemas/DeliveryCoverage"}}},"statistics":{"type":["object","null"]},"qualiscope":{"type":["object","null"]},"valeurs":{"type":["object","null"],"description":"Valeurs de référence d'Étalon quand la question en demande une : `projection` (texte), `ambigu`, `resultats` (`etalon.result.v1`)."},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"metadata":{"type":"object","properties":{"retrieval":{"type":"object","properties":{"mode":{"enum":["standard","exploration"]},"status":{"enum":["ok","empty","unavailable","not_requested"],"description":"`empty` : aucune preuve documentaire retenue, ce qui ne prouve pas l'absence de règle ; `unavailable` : recherche en panne, contexte dégradé ; `not_requested` : question hors champ."},"reranked":{"type":["boolean","null"]},"candidate_count":{"type":["integer","null"]}}},"doctrine":{"type":"object","description":"Poids de la doctrine livrée.","properties":{"sections":{"type":"integer"},"chars":{"type":"integer"},"chars_by_reason":{"type":"object","additionalProperties":{"type":"integer"}}}},"intent":{"type":"string"},"themes":{"type":"array","items":{"type":"string"}},"sectors":{"type":"array","items":{"type":"string"}}}}}},"PrecisionDelivery":{"type":"object","required":["delivery","status"],"properties":{"delivery":{"const":"precision"},"provenance":{"$ref":"#/components/schemas/Provenance"},"status":{"enum":["answered","not_found","depends","out_of_scope","error"]},"answer":{"type":"string"},"condition":{"type":["string","null"]},"sources":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"source_type":{"type":"string"},"quote":{"type":"string","description":"Passage cité, vérifié dans la source."}}}},"redirect":{"type":["object","null"],"properties":{"tool":{"type":"string"},"reason":{"type":"string"}}},"error":{"type":["object","null"],"properties":{"code":{"type":"string"},"retryable":{"type":"boolean"}}}}},"AnswerDelivery":{"type":"object","required":["delivery","answer","sources"],"properties":{"delivery":{"const":"answer"},"provenance":{"$ref":"#/components/schemas/Provenance"},"answer":{"type":"string","description":"Markdown."},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"meta":{"type":"object"}}}}}}