Le domaine en bref

La tenue de compte est le cœur comptable de la plateforme : elle transforme les faits survenus ailleurs en écritures, tient les positions de chaque épargnant, et sait les justifier et les servir aux autres domaines.

Ce que le domaine fait

Il comptabilise des comptes rendus d’événement. L’unité d’entrée est le CRE (compte rendu d’événement) : le message par lequel un domaine annonce un fait accompli — des parts créées par une exécution d’ordre, de l’argent constaté par un encaissement. La tenue de compte interprète chaque CRE selon un schéma comptable paramétré (propre au teneur de compte) et produit une pièce d’écritures équilibrée : en comptabilité en partie double, chaque mouvement a sa contrepartie, et l’équilibre se vérifie instrument par instrument. Un CRE est comptabilisé exactement une fois : le même message livré deux fois ne produit pas deux pièces.

Il tient les positions, finement ventilées. La position est le terme comptable pour les avoirs d’un compte, et elle ne dit pas seulement « 12 parts de tel fonds » : elle se détaille par date de disponibilité (à partir de quand l’épargnant peut disposer de ces parts — l’épargne salariale est indisponible cinq ans sur un plan d’épargne d’entreprise, jusqu’à la retraite sur un plan d’épargne retraite, sauf cas de déblocage anticipé) et par origine d’avoir (d’où vient l’argent : participation, intéressement, abondement, versement volontaire — la provenance conditionne la durée d’indisponibilité et le régime fiscal). L’histoire des positions est conservée : la position « au 12 mars » reste consultable, même longtemps après — certains déblocages anticipés s’apprécient précisément sur les avoirs détenus à la date de l’événement qui y ouvre droit.

Il ne réécrit jamais rien. Le journal des écritures ne se modifie pas : une erreur se corrige par un mouvement contraire (une extourne ou une contrepassation), tracé et relié à l’écriture qu’il corrige. C’est ce qui rend chaque solde explicable de bout en bout.

Ce que le domaine expose

La consultation des positions — une interface synchrone : pour un compte, la position courante ou à une date donnée, en deux vues. La vue ventilée détaille la position par échéance et origine ; la vue consommable dit ce qu’un rachat peut effectivement mobiliser à cette date, tout écrêtement fait (l’indisponible, le gelé et les contraintes sont déjà retranchés — le consommateur n’applique aucune règle de disponibilité lui-même).

Les événements du cycle de vie — chaque changement d’état d’un CRE ou d’un compte publie son fait, exactement une fois : le producteur d’origine sait ce qu’est devenu son message, et tout abonné peut suivre la vie du domaine sans l’interroger.

Chaque interface est portée par un contrat publié et versionné — le recensement est en bas de cette page.

Pour aller plus loin

Le détail de chaque interface synchrone — chemins, paramètres, réponses — se parcourt dans L’API (le menu de ce chapitre) ; le cycle de vie de chaque entité qui publie des événements, avec son diagramme d’état et ses faits, se lit dans Les événements : le CRE et le compte.

Les contrats publiés

Le nom renvoie à la spécification ; un contrat en version 0.x est une proposition, en convergence avec ses premiers consommateurs.

Contrat	Version	Statut
administration-des-comptes	0.2.0	proposition
consultation-des-entites	0.2.0	convergé
consultation-des-positions	0.3.0	convergé
cre-enveloppe	0.x	la spécification sera publiée à sa convergence
evenements-du-compte	0.1.0	proposition
evenements-du-cre	0.3.0	convergé
nomenclature-ventilation	0.x	la spécification sera publiée à sa convergence