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.

ChampTypeDescription
schema_versionrequistexteVersion du contrat : etalon.result.v1.
statusrequistexteStatut de la lecture ; seul ok (ou revalorisation_attendue) affirme une valeur.
  • ok : Valeur(s) applicable(s) trouvée(s) pour la date, le territoire et les coordonnées.
  • depends : La valeur dépend d'une coordonnée non précisée (GIR, tranche, part…) : toutes les valeurs applicables sont rendues, avec la dimension à trancher.
  • ambiguous : Plusieurs paramètres répondent à la question : candidats rendus, aucun choisi.
  • not_found : Paramètre inconnu, ou aucune valeur publiée à la date demandée.
  • revalorisation_attendue : Valeur rendue, mais une revalorisation attendue n'est pas encore publiée.
  • technical_error : Panne technique (base, délai) : rien n'est affirmé.
a_preciserliste de texteDimensions non précisées dont dépend la valeur (depends).
candidatsliste de objetParamètres candidats d'une recherche ou d'une question ambiguë, du plus au moins pertinent.
classerequistexteNature de la valeur (montant, taux…).
famillerequistexteFamille du catalogue.
idrequistexteIdentifiant du paramètre candidat.
libellerequistexteLibellé du paramètre.
scorerequisnombreScore de classement de la recherche (plus élevé = plus pertinent) ; sert à ordonner, pas à comparer entre requêtes.
similaritenombre | nullSimilarité sémantique avec la question (0 à 1) ; absente pour une recherche plein texte seule.
connue_letexte | nullDate de connaissance (audit) : état d'Étalon à cette date.
datetexte | nullDate de lecture (validité).
fraicheurobjet | nullFraîcheur du paramètre au regard de ses échéances de révision ; absente sinon.
etatrequistextea_jour, revalorisation_attendue, non_suivi, sans_valeur, sans_echeance.
derniere_echeancetexte | nullDernière date habituelle de revalorisation passée (AAAA-MM-JJ) ; absente si le paramètre n'a pas d'échéance.
prochaine_echeancetexte | nullProchaine date habituelle de revalorisation (AAAA-MM-JJ) ; absente si le paramètre n'a pas d'échéance.
messagetexte | nullExplication courte, en français, du statut.
parametreobjet | nullDescription du paramètre lu ; absente pour une recherche ou un paramètre inconnu.
classerequistexteNature de la valeur : montant, taux, coefficient, plafond, seuil, point ou indice.
famillerequistexteFamille du catalogue (rémunérations, prestations, cotisations…).
idrequistexteIdentifiant du paramètre (ex. smic.horaire), stable.
libellerequistexteLibellé du paramètre.
suivirequistexteactif ou non_suivi (paramètre historique).
uniterequistexteUnité de la valeur (euros, %, points…).
dimensionsobjetCoordonnées possibles du paramètre et leurs valeurs (GIR, part, tranche…) ; absentes s'il n'en a pas.
fondementliste de texteTextes qui fondent le paramètre.
notetexte | nullPrécision de lecture ; absente sinon.
periodicitetexte | nullPériode à laquelle se rapporte la valeur (montant horaire, mensuel, annuel…), ou rythme de publication d'un indice : heure, jour, mois, trimestre, an ; absente sinon.
synonymesliste de texteAutres noms usuels du paramètre, pour la recherche.
territoiresliste de texteTerritoires couverts quand le paramètre n'est pas seulement national.
territoiretexte | nullTerritoire lu (nat_FR, dep_976…).
valeursliste de objetValeurs applicables (lecture) ou successives (historique) ; vide si rien n'est trouvé.
enregistree_lerequistexteDate à laquelle la valeur est entrée dans Étalon (temps de connaissance).
moderequistextesource, fixe, derive, revalorisation.
territoirerequistexteTerritoire de la valeur : nat_FR, dep_976…
valeurrequistexteValeur, décimal exact en texte, dans l'unité du paramètre (parametre.unite).
validationrequistexteautomatique_b (double concordance) ou porteur.
valide_durequistexteDate d'effet, incluse (AAAA-MM-JJ).
conditionsvaleurConditions d'application de la valeur, telles que le texte les pose ; absentes sinon.
coordonneesobjetCoordonnées de la valeur (GIR, part, tranche…) ; absentes si le paramètre n'en a pas.
operandesliste de objetValeur calculée : opérandes lus.
parametrerequistexteParamètre d'Étalon dont la valeur a servi au calcul.
valeurrequistexteValeur lue, décimal exact en texte.
coordonneesobjetCoordonnées de la valeur lue ; absentes si le paramètre n'en a pas.
date_referencetexte | nullDate 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).
passagetexte | nullPassage cité de la source, mot pour mot.
remplacee_letexte | nullDate à laquelle la valeur a été remplacée dans Étalon (correction) ; absente tant qu'elle fait foi.
sourceobjet | nullSource primaire de la valeur ; absente si la valeur n'en porte pas.
autoriterequistexteAutorité qui publie la valeur (Légifrance, Cnav, DSS…) ; « Veille BMSE » pour une valeur relevée par la veille.
naturerequistexteNature de la source (texte pour un texte officiel, publication pour un barème ou une note publiés…).
titrerequistexteTitre du texte ou de la publication.
publie_letexte | nullDate de publication de la source (AAAA-MM-JJ) ; absente si inconnue.
publiquebooléenSource nommable sur une page publique (autorité officielle, reperes-etalon/diffusion.yaml) ; une attribution à la veille l'est aussi.
referencetexte | nullArticle ou référence précise ; absente sinon.
urltexte | nullLien vers la source quand elle est accessible en ligne ; absent sinon.
valide_autexte | nullFin effective, exclusive ; absente tant que la valeur court.