Glossaire

Telebib2 mêle trois vocabulaires : celui d'EDIFACT, hérité de trente ans de pratique, celui de JSON Schema, et celui du secteur belge de l'assurance. Cette page rassemble les termes qui reviennent dans la documentation, avec ce qu'ils désignent concrètement dans le registre.

ADR — Architecture Decision Record

Note qui fige une décision d'architecture : le contexte, ce qui a été retenu, ce qui a été écarté et pourquoi. Les ADR sont numérotées et ne sont jamais réécrites ; une décision qui change donne lieu à une nouvelle ADR. C'est là qu'on trouve la réponse aux « pourquoi diable est-ce fait comme ça ».

amount

Type primitif des montants monétaires. Porté par une chaîne décimale ("1234.56") et non par un nombre JSON, pour préserver la précision exacte. Voir décimal.

anyOf, allOf, if / then

Mots-clés de composition de JSON Schema. Le routeur les utilise ensemble : un anyOf pour n'accepter que les couples MIG + version connus, une série de if / then pour aiguiller vers le bon schéma.

Cascade de validation

Enchaînement des schémas qui s'appellent les uns les autres pendant une validation : l'enveloppe appelle le datablock, qui appelle le routeur, qui désigne le schéma métier, lequel tire ses composants, ses listes et ses primitifs. On ne valide jamais qu'un seul point d'entrée : le reste se déroule seul.

Catalogue

Fichier catalog.json publié à la racine du registre. Manifeste lisible par une machine de tout ce que le registre contient : identifiant, chemin, MIG, release, empreinte, taille. Généré par la chaîne de publication, jamais édité à la main. Comme le listage des répertoires est désactivé, c'est par lui qu'on découvre ce qui existe.

Centre Telebib2

L'entité responsable de l'administration technique et opérationnelle de la norme : cycle de vie des messages, publication des releases, maintenance des référentiels, mise à disposition des outils et des plateformes de publication. C'est lui qui publie le registre.

Code list — liste de valeurs

Ensemble fermé des valeurs autorisées pour une donnée (types de véhicule, codes pays, qualifiants de document…). En JSON, chaque liste est un fichier de schéma à part. Le registre en publie près de trois cents, réparties entre listes Telebib et listes officielles — deux familles qui ne s'écrivent pas de la même façon, voir enum / oneOf.

Comité stratégique de la normalisation

L'instance sectorielle de pilotage, qui réunit les assureurs et les fédérations de courtiers. Elle assure la gouvernance globale, définit les orientations et les priorités de la normalisation et garantit l'équilibre des intérêts du secteur. Anciennement Commission Mixte de Suivi.

compatibility.json

Table qui associe chaque version de MIG à son fichier de schéma, à sa release EDIFACT et à sa fenêtre de validité. À la différence du routeur, elle conserve l'historique complet, y compris les versions retirées du service — pour l'audit et pour valider rétrospectivement un message ancien.

Composant partagé

Morceau de schéma réutilisé par plusieurs messages : une adresse, un nom, une référence, une garantie. Défini une fois, référencé partout, ce qui garantit qu'une adresse a la même forme dans un contrat et dans un sinistre. Le registre en publie près de quatre-vingt-dix.

content

Propriété d'un datablock qui porte le message métier. Tout ce qui relève de l'assurance vit là ; le reste du datablock ne fait que transporter.

CORS

Mécanisme qui autorise un navigateur à charger une ressource servie par un autre domaine. Le registre l'active en lecture seule, ce qui permet à un validateur tournant dans un navigateur de résoudre les références vers json.telebib2.org.

Datablock

Niveau intermédiaire d'un message : une unité d'échange complète et autonome, avec son type, son action, sa référence et son contenu métier. Une enveloppe peut en porter plusieurs — c'est ainsi qu'on envoie un lot.

Décimal (représentation)

Dans Telebib2 JSON, toute valeur à virgule est portée par une chaîne : "1234.56", jamais 1234.56. Le flottant IEEE 754 ne représente pas exactement les fractions décimales, et aucun mot-clé de JSON Schema n'impose de façon fiable un nombre fixe de décimales. Seuls les comptages entiers restent des nombres JSON.

description_i18n

Mot-clé maison qui accompagne chaque description d'une traduction française et néerlandaise. Inconnu de JSON Schema, il est donc ignoré par les validateurs : il documente sans contraindre. Voir aussi x-enum-labels.

Domaine

Deux sens à ne pas confondre. Le domaine fonctionnel range les schémas dans le registre : contrat, sinistre, échange financier, communauté. La propriété domain d'un message, elle, désigne la branche d'assurance concernée — "motor", par exemple.

draft 2020-12

Version de la spécification JSON Schema sur laquelle s'aligne le registre. C'est elle qui apporte unevaluatedProperties, essentiel à la fermeture des schémas. Un validateur configuré sur une version antérieure ignore ce mot-clé sans prévenir, et accepte alors des messages invalides.

EDIFACT

Norme internationale d'échange de données structurées (UN/EDIFACT) sur laquelle Telebib2 s'appuie depuis l'origine. Un message y est une suite de segments identifiés par un tag de trois lettres. La norme JSON en est la transposition, pas le remplacement : les deux coexistent.

Empreinte (hash)

Somme de contrôle publiée dans le catalogue pour chaque fichier. Elle permet de vérifier qu'un schéma miroité localement est bien celui que le registre publie, sans avoir à le rapatrier.

enum / oneOf

Les deux façons d'écrire une liste de valeurs en JSON Schema — et le registre utilise les deux. Les listes Telebib déclarent un enum de valeurs lisibles, accompagné de x-enum-labels. Les listes officielles utilisent oneOf, avec un const et un titre par valeur, en conservant les codes d'origine. Un générateur de code doit savoir traiter les deux formes.

Enveloppe

Niveau le plus externe d'un message JSON. Elle identifie l'émetteur et le destinataire et porte le tableau des datablocks. Elle ne contient aucune donnée métier. Une enveloppe vaut pour un seul couple émetteur / destinataire.

État d'un schéma

Position d'un schéma dans son cycle de vie, portée par le catalogue : en développement, gelée, active, supportée, retirée. À ne pas confondre avec le statut du registre lui-même, qui vaut pre-release ou published.

Go-live

Le 1^er janvier 2027, date d'entrée en service de la norme JSON. Techniquement, le seul changement est le passage du statut du registre de pre-release à published : ni les identifiants, ni les noms de fichiers, ni la numérotation ne bougent.

GTN — Groupes de travail de la normalisation

Le cœur opérationnel de la norme. Ils analysent les besoins du secteur, définissent et font évoluer les structures de données, les MCI et les messages, et recherchent le consensus sectoriel. Le groupe dit « classique » se réunit un jour par mois ; des groupes spécifiques se constituent selon les besoins.

$id

Identifiant absolu d'un schéma, sous la forme d'une URL. Dans ce registre l'$id est aussi l'adresse réelle du fichier : le coller dans un navigateur ou dans un validateur donne le schéma. Identité et localisation confondues, volontairement.

IEEE 754

La norme de représentation des nombres à virgule flottante des processeurs. Elle ne peut pas représenter exactement la plupart des fractions décimales : 0.035 y est stocké comme 0.034999999999999998…. C'est la raison pour laquelle Telebib2 transporte les valeurs à virgule en chaînes.

Immuabilité

Règle fondatrice du registre : un fichier publié n'est jamais modifié. Une évolution donne un nouveau fichier, jamais une réécriture. Conséquence pratique : un message validé aujourd'hui le restera dans dix ans, avec le même schéma, octet pour octet. Deux fichiers y échappent délibérément — le routeur et la table de compatibilité.

JSIfact

Format d'émission historique, transposition littérale d'EDIFACT en JSON. À ne pas confondre avec la norme JSON Telebib2, qui est un modèle à part entière. Les deux se distinguent par la propriété exchangeUnitIssuingFormat du datablock.

JSON Pointer

Notation qui désigne un emplacement précis dans un document JSON, sous forme de chemin : /dataBlocks/0/content/domain. C'est ainsi que les validateurs indiquent où se situe une erreur.

JSON Schema

Langage de description et de validation de documents JSON. Un schéma dit quelles propriétés existent, lesquelles sont obligatoires, quelles valeurs sont admises — et un validateur répond par oui ou non, avec le détail des écarts.

Liste officielle

Liste de valeurs dont Telebib2 n'est pas propriétaire : elle est maintenue par un organisme externe (FSMA, DIV, NACE, police…) et reprise telle quelle, codes d'origine compris. Un code pays y vaut "B", pas "BE". Par opposition aux listes Telebib, arbitrées par les GTN.

MCI — Message Content Inventory

Inventaire du contenu d'un message : la liste des données qu'il peut transporter, avec leurs conditions d'usage. Le MCI est agnostique de l'implémentation : c'est la définition « business » du message, la même quel que soit le langage qui le représente — EDIFACT, JSON, XML ou tout autre. Une sorte de pseudo-code du message, que chaque représentation traduit ensuite dans sa propre syntaxe. C'est le pivot dont dérivent aussi bien la documentation EDIFACT que les schémas JSON — et ce qui garantit que les deux décrivent le même message.

MIG — Message Implementation Guide

Guide d'implémentation d'un message, identifié par un code de la forme M0151, M0202, M0304. C'est l'unité de travail de la norme : on publie, on versionne et on route des MIG. Chaque MIG a sa propre suite de versions, indépendante des autres.

Miroir local

Copie locale du registre, enregistrée par $id dans le validateur avant la première validation. Pratique recommandée : elle évite de dépendre du réseau pour valider un message, et les centaines d'allers-retours qu'une résolution à la volée implique.

multipleOf

Mot-clé de JSON Schema exprimant « valeur multiple de N ». Façon apparemment naturelle d'imposer un nombre de décimales — et piège avéré : en arithmétique IEEE 754, il rejette la majorité des montants légitimes. Il n'est plus utilisé nulle part dans le registre.

Payload

Un message concret, par opposition au schéma qui le décrit. Le registre publie deux payloads de référence par message : la variante min, réduite aux propriétés obligatoires, et la variante full, qui exerce toutes les propriétés du schéma.

pre-release / published

Statut de publication du registre, porté par la table de compatibilité. pre-release signifie que les schémas sont publiés, stables et validés, mais que la norme n'est pas encore officiellement en service. Le passage à published a lieu au go-live.

Primitif — type primitif

Brique de base d'une valeur : montant, pourcentage, mesure, comptage, durée, date. Les primitifs fixent la forme (motif, bornes, précision) indépendamment du sens métier, porté lui par le nom de la propriété. C'est pourquoi un primitif de mesure n'a pas d'unité.

Qualifier — qualifiant

En EDIFACT, code qui précise le rôle d'un segment : DTM+008 désigne une date d'effet, DTM+009 une autre date. Les qualifiants se reconnaissent à leur nomenclature, un X suivi de trois chiffres. En JSON, la plupart ont disparu au profit de noms de propriétés explicites.

$ref

Référence d'un schéma vers un autre. C'est le mécanisme qui permet de définir une adresse une seule fois et de la réutiliser partout. Dans ce registre, les $ref sont des URL absolues qui se résolvent directement sur json.telebib2.org.

Registre

L'ensemble des schémas publiés, distribués en fichiers statiques sur json.telebib2.org. Ce n'est pas une API : on n'y interroge rien, on y télécharge des fichiers dont l'adresse est connue à l'avance.

registryVersion / dbVersion

Version du registre lui-même, alignée sur la version de la base Telebib2 dont les schémas dérivent, suivie d'un numéro de correctif propre au JSON. À ne pas confondre avec la release : la version dit d'où vient le contenu, la release dit à quelle période il s'applique. Ce n'est pas du versionnage sémantique.

Release

Groupe de schémas valides pour une période donnée du cycle annuel, désigné par un code AAAANN — 202701 pour la release du 1^er janvier 2027. Le registre héberge neuf releases de messages en même temps : un message ancien reste validable pendant que le nouveau arrive.

releaseTarget

Champ de la table de compatibilité qui indique la release visée par les travaux en cours. C'est une information sur l'activité du moment, pas une propriété du registre : il changera quand la release suivante sera en préparation, sans que la précédente disparaisse.

schemaRouter.json

Aiguillage du registre. Il lit le code et la version du MIG annoncés dans le contenu, rejette les couples qu'il ne connaît pas, et désigne le schéma qui doit valider le reste. C'est, avec la table de compatibilité, la seule pièce délibérément mutable : elle change à chaque mise en service, sans changer de nom.

Segment

Unité élémentaire d'un message EDIFACT, identifiée par un tag de trois lettres. En JSON, le segment devient une propriété nommée et le tag disparaît de la surface.

SemVer — versionnage sémantique

Convention où le numéro de version annonce la compatibilité. Le registre ne l'utilise pas : sa version suit celle de la base dont il dérive, et un incrément mineur peut parfaitement être cassant — une version de base retire régulièrement des valeurs de liste. C'est la liste des changements qui fait foi, jamais le numéro.

Tag

En EDIFACT, le code de trois lettres qui ouvre un segment et annonce la nature de la donnée : MOA pour un montant, DTM pour une date, RFF pour une référence. Combiné à un qualifiant, il produit le sens précis. En JSON, les deux sont résolus en un nom de propriété.

Telebib2

La norme belge d'échange de données du secteur de l'assurance. Elle couvre les contrats, les sinistres, les échanges financiers et les parties prenantes, et est maintenue par le secteur au travers du Comité stratégique, des GTN et du Centre Telebib2.

unevaluatedProperties

Mot-clé de JSON Schema qui rejette toute propriété non prévue par le schéma. Les schémas Telebib2 sont fermés de cette façon : une propriété inconnue provoque une erreur au lieu d'être ignorée silencieusement. Une faute de frappe est ainsi détectée à la validation plutôt qu'au support. Il exige un validateur en draft 2020-12.

Unité d'échange

Nom métier de ce qu'un datablock transporte. Son type dit à quelle famille elle appartient (contrat, sinistre, quittance…), son action dit ce qu'elle demande ou notifie au sein de cette famille.

Validateur

Bibliothèque qui confronte un message à un schéma et rend un verdict motivé, en localisant chaque écart par un JSON Pointer. Le registre est vérifié sur deux moteurs indépendants — voir validation croisée.

Validation croisée

Pratique consistant à rejouer le même contrôle sur deux implémentations indépendantes et à comparer les verdicts. Le registre valide ses payloads de référence sur un moteur Python et un moteur .NET : un désaccord révèle un schéma ambigu ou un bug de bibliothèque — dans les deux cas, quelque chose sur quoi il ne faut pas construire.

x-enum-labels

Annotation maison qui accompagne un enum des libellés français et néerlandais de chaque valeur. Comme description_i18n, elle est inconnue de JSON Schema et donc ignorée par les validateurs : elle documente sans contraindre. Attention toutefois aux validateurs en mode strict, qui refusent les mots-clés qu'ils ne connaissent pas.

X940

Élément de donnée qui porte le format d'émission du message. Il distingue un message EDIFACT, un message JSIfact et un message de la norme JSON.

X943 / X944

Le couple qui identifie un message et sa version : X943 nomme le MIG, X944 donne son numéro de version. Les deux sont indispensables — X944 est relatif à chaque MIG, la version 3 de M0151 n'ayant aucun rapport avec la version 3 de M0103. En JSON, ce sont les propriétés exchangeUnitBusinessContentDescription et exchangeUnitBusinessContentDescriptionVersion.