Contrats · etalon.result.v1
Valeur de référence
Lecture d'Étalon : valeur applicable à une date, un territoire et des coordonnées, avec sa source, sa date d'effet et sa fraîcheur ; historique, recherche ou résolution d'une question selon le mode.
Schéma JSON (draft 2020-12) : https://mcp.reperes.bmse.fr/api/v1/schemas/etalon.result.v1.json. Les champs sont listés à plat : lignes[].source désigne la source de chaque ligne.
| Champ | Type | Description |
|---|---|---|
schema_versionrequis | texte | Version du contrat : etalon.result.v1. |
statusrequis | texte | Statut de la lecture ; seul ok (ou revalorisation_attendue) affirme une valeur.
|
a_preciser | liste de texte | Dimensions non précisées dont dépend la valeur (depends). |
candidats | liste de objet | Paramètres candidats d'une recherche ou d'une question ambiguë, du plus au moins pertinent. |
classerequis | texte | Nature de la valeur (montant, taux…). |
famillerequis | texte | Famille du catalogue. |
idrequis | texte | Identifiant du paramètre candidat. |
libellerequis | texte | Libellé du paramètre. |
scorerequis | nombre | Score de classement de la recherche (plus élevé = plus pertinent) ; sert à ordonner, pas à comparer entre requêtes. |
similarite | nombre | null | Similarité sémantique avec la question (0 à 1) ; absente pour une recherche plein texte seule. |
connue_le | texte | null | Date de connaissance (audit) : état d'Étalon à cette date. |
date | texte | null | Date de lecture (validité). |
fraicheur | objet | null | Fraîcheur du paramètre au regard de ses échéances de révision ; absente sinon. |
etatrequis | texte | a_jour, revalorisation_attendue, non_suivi, sans_valeur, sans_echeance. |
derniere_echeance | texte | null | Dernière date habituelle de revalorisation passée (AAAA-MM-JJ) ; absente si le paramètre n'a pas d'échéance. |
prochaine_echeance | texte | null | Prochaine date habituelle de revalorisation (AAAA-MM-JJ) ; absente si le paramètre n'a pas d'échéance. |
message | texte | null | Explication courte, en français, du statut. |
parametre | objet | null | Description du paramètre lu ; absente pour une recherche ou un paramètre inconnu. |
classerequis | texte | Nature de la valeur : montant, taux, coefficient, plafond, seuil, point ou indice. |
famillerequis | texte | Famille du catalogue (rémunérations, prestations, cotisations…). |
idrequis | texte | Identifiant du paramètre (ex. smic.horaire), stable. |
libellerequis | texte | Libellé du paramètre. |
suivirequis | texte | actif ou non_suivi (paramètre historique). |
uniterequis | texte | Unité de la valeur (euros, %, points…). |
dimensions | objet | Coordonnées possibles du paramètre et leurs valeurs (GIR, part, tranche…) ; absentes s'il n'en a pas. |
fondement | liste de texte | Textes qui fondent le paramètre. |
note | texte | null | Précision de lecture ; absente sinon. |
periodicite | texte | null | Période à laquelle se rapporte la valeur (montant horaire, mensuel, annuel…), ou rythme de publication d'un indice : heure, jour, mois, trimestre, an ; absente sinon. |
synonymes | liste de texte | Autres noms usuels du paramètre, pour la recherche. |
territoires | liste de texte | Territoires couverts quand le paramètre n'est pas seulement national. |
territoire | texte | null | Territoire lu (nat_FR, dep_976…). |
valeurs | liste de objet | Valeurs applicables (lecture) ou successives (historique) ; vide si rien n'est trouvé. |
enregistree_lerequis | texte | Date à laquelle la valeur est entrée dans Étalon (temps de connaissance). |
moderequis | texte | source, fixe, derive, revalorisation. |
territoirerequis | texte | Territoire de la valeur : nat_FR, dep_976… |
valeurrequis | texte | Valeur, décimal exact en texte, dans l'unité du paramètre (parametre.unite). |
validationrequis | texte | automatique_b (double concordance) ou porteur. |
valide_durequis | texte | Date d'effet, incluse (AAAA-MM-JJ). |
conditions | valeur | Conditions d'application de la valeur, telles que le texte les pose ; absentes sinon. |
coordonnees | objet | Coordonnées de la valeur (GIR, part, tranche…) ; absentes si le paramètre n'en a pas. |
operandes | liste de objet | Valeur calculée : opérandes lus. |
parametrerequis | texte | Paramètre d'Étalon dont la valeur a servi au calcul. |
valeurrequis | texte | Valeur lue, décimal exact en texte. |
coordonnees | objet | Coordonnées de la valeur lue ; absentes si le paramètre n'en a pas. |
date_reference | texte | null | Date de référence de l'opérande : sa date d'effet, ou la date que fixe la règle de calcul (par exemple le début de l'année). |
passage | texte | null | Passage cité de la source, mot pour mot. |
remplacee_le | texte | null | Date à laquelle la valeur a été remplacée dans Étalon (correction) ; absente tant qu'elle fait foi. |
source | objet | null | Source primaire de la valeur ; absente si la valeur n'en porte pas. |
autoriterequis | texte | Autorité qui publie la valeur (Légifrance, Cnav, DSS…) ; « Veille BMSE » pour une valeur relevée par la veille. |
naturerequis | texte | Nature de la source (texte pour un texte officiel, publication pour un barème ou une note publiés…). |
titrerequis | texte | Titre du texte ou de la publication. |
publie_le | texte | null | Date de publication de la source (AAAA-MM-JJ) ; absente si inconnue. |
publique | booléen | Source nommable sur une page publique (autorité officielle, reperes-etalon/diffusion.yaml) ;
une attribution à la veille l'est aussi. |
reference | texte | null | Article ou référence précise ; absente sinon. |
url | texte | null | Lien vers la source quand elle est accessible en ligne ; absent sinon. |
valide_au | texte | null | Fin effective, exclusive ; absente tant que la valeur court. |