Les faits livrés

Ce canal est sortant : la plateforme appelle, le Teneur de Compte reçoit. Il n’existe pas de canal entrant ; ce qu’un TCC demande, il le demande par L’API.

Sans ce canal, un portail interrogerait la situation d’un épargnant en boucle pour découvrir qu’elle n’a pas changé.

Comment la livraison se fait

C’est le TCC qui héberge le point de réception. La livraison est une requête POST sortante vers l’URL qu’il a enregistrée. Cette URL, le secret qui signe les envois et les canaux souscrits sont attachés à son client d’accès et se déclarent à la souscription, hors du contrat.

Les messages sont au format CloudEvents, en JSON. Chaque événement porte un subject : l’identifiant publié de l’entité concernée. Comme partout dans Diapason, cet identifiant désigne la ressource ; il n’autorise rien.

Le TCC n’est pas nommé dans les messages : un déploiement ne sert qu’un tenant, et le destinataire sait qui il est.

Les garanties sont celles de toute la plateforme — livraison au moins une fois, ordre garanti par producteur seulement, tolérance aux champs inconnus. Elles sont détaillées dans S’intégrer à la plateforme, et elles imposent au consommateur d’être idempotent.

Deux canaux, souscrits séparément

Les faits qui concernent un épargnant

Canal souscrit par le portail des épargnants.

Fait publié	Ce qu’il annonce
versement exécuté	un versement est allé au bout, et les avoirs en tiennent compte
arbitrage exécuté	un transfert entre supports a été exécuté
opération refusée	une opération demandée n’aura pas lieu, avec son motif
avoirs devenus disponibles	une part des avoirs a franchi son échéance d’indisponibilité
document mis à disposition	une pièce nouvelle est consultable

Les faits qui concernent une entreprise

Canal souscrit par le portail des correspondants.

Fait publié	Ce qu’il annonce
opération collective déclinée	une opération déclarée par l’entreprise a été répartie entre les bénéficiaires
opération collective exécutée	cette opération est allée au bout
transmission de population traitée	une mise à jour de la population des salariés a été contrôlée et prise en compte
restitution mise à disposition	un reporting attendu — campagne, encours, frais — est consultable

Ce que ces faits ne portent jamais

Comme les interfaces synchrones de Diapason, ces événements ne transportent que des identifiants publiés et des valeurs décidées. Jamais une échéance de lot, un identifiant de mesure de conformité ou un paramètre de règle : ce sont les ingrédients d’une décision, et ils restent chez le domaine qui l’a prise.

Le détail de chaque message se lit sur la page du contrat.