Se connecter aux interfaces de déclaration réglementaire : mappage, signature, accusés et renvoi
EN BREF : La difficulté de la déclaration réglementaire n’est pas d’envoyer une requête, mais trois autres choses : chaque régulateur a son propre format de message, qui évolue ; les accusés sont souvent asynchrones ; une déclaration manquée comme une déclaration erronée a des conséquences. Nous répartissons le travail en trois couches. Les données sources sont d’abord converties en objets standard internes, puis rendues dans le message de chaque régulateur pour une version donnée de la spécification. Une couche d’envoi commune gère signature, chiffrement, relances et accusés. Chaque déclaration et chaque accusé sont conservés comme trace d’audit, avec des procédures de renvoi et de rapprochement définies.
1.0 Séparer le format de l’envoi
Le schéma hérité habituel, c’est un service par région, avec mappage des champs, signature et envoi codés en dur. Chaque changement de spécification impose une mise en production, les services régionaux divergent et le même défaut de signature doit être corrigé plusieurs fois.
Une structure plus robuste découpe le travail selon la fréquence des changements :
| Couche | Responsabilité | Évolue avec |
|---|---|---|
| Collecter | Extraire les données des systèmes de l’entreprise et les convertir en objets standard internes | Les systèmes de l’entreprise |
| Mapper | Des objets standard au message d’un régulateur et d’une version de spécification | Les versions de spécification |
| Envoyer | Authentification, signature, chiffrement, transport, accusés, relances | Rarement |
Les mappages se gèrent par régulateur et par version de spécification. Quand une nouvelle version entre en service, l’ancienne reste disponible ; la bascule a lieu à la date d’entrée en vigueur, et revenir en arrière revient à changer la date.
2.0 Le mappage en configuration, avec des tests
Les règles de mappage sont de la configuration : correspondance des champs, conversion des tables de codes, conversion d’unités et contrôle des champs obligatoires. Les consultants de déploiement les maintiennent dans une interface, pas dans le code. La configuration peut être fausse elle aussi, donc :
- Chaque mappage dispose de données d’exemple et de messages attendus, comparés automatiquement après chaque modification.
- Les tables de codes, comme les codes d’activité ou les découpages administratifs, sont versionnées séparément et référencées avec leur version.
- Les changements de configuration passent par une validation et sont journalisés : on sait qui a changé quoi, et quand.
Certains cas n’entreront jamais dans la configuration. Donnez à ces exceptions une interface de plugins stable plutôt que de laisser le langage de configuration grossir jusqu’à devenir un langage de programmation que les consultants ne savent pas maintenir et que les développeurs préfèrent éviter.
3.0 La couche d’envoi
- Certificats et clés sont montés en lecture seule, jamais stockés en base ni affichés dans l’interface de configuration, et leur rotation suit une procédure écrite.
- Un seul environnement d’exécution gère les transports exigés par les régulateurs, HTTP, connexions TCP persistantes ou file de messages, au lieu d’une pile de relance et de journalisation distincte pour chacun.
- Chaque déclaration porte un numéro de séquence métier unique, réutilisé en cas de renvoi pour que le régulateur puisse dédupliquer. S’il ne déduplique pas, un état local « confirmé » est vérifié avant tout renvoi.
- Un accusé synchrone signifie en général seulement « reçu ». Le résultat du traitement arrive sous forme d’accusé asynchrone ou doit être interrogé, et il faut gérer les deux voies.
4.0 Relances, renvoi et rapprochement
| Situation | Traitement |
|---|---|
| Panne réseau ou timeout | Temporisation exponentielle plafonnée ; au-delà du plafond, file manuelle |
| Rejet par le contrôle du régulateur | Pas de relance automatique ; le motif part au responsable des données et la déclaration corrigée est renvoyée |
| Déclarations manquées pendant une interruption | Renvoi par fenêtre de temps, motif consigné |
| Périodiquement | Rapprocher avec les confirmations du régulateur et lister les éléments non confirmés ou discordants |
Relancer une erreur de contrôle ne produit qu’une série d’erreurs identiques et peut déclencher les limites de débit du régulateur.
5.0 Audit
Pour chaque déclaration, on conserve l’instantané des données sources, le message généré, l’empreinte de la signature, l’heure d’envoi et l’accusé. En cas de litige, il faut pouvoir montrer ce qui a été déclaré à un instant donné et ce qui est revenu. La durée de conservation suit les exigences du régulateur et les règles de conformité de l’entreprise.
Si vous remplacez un service de déclaration hérité codé en dur ou vous raccordez à un nouveau régulateur, voir Web, cloud et gestion des équipements, ou parlez-nous de votre projet.
Références
- Enterprise Integration Patterns, Guaranteed Delivery : https://www.enterpriseintegrationpatterns.com/patterns/messaging/GuaranteedMessaging.html
Questions fréquentes
Les spécifications régionales changent souvent. La configuration peut-elle vraiment suivre ?
La plupart des changements ajoutent des champs, mettent à jour des tables de codes ou ajustent des contrôles, et la configuration couvre cela. Quand la structure du message ou le transport changent aussi, il faut modifier le modèle de mappage, voire la couche d'envoi. C'est pourquoi les mappages sont versionnés par spécification : ancienne et nouvelle version coexistent un temps et la bascule se fait à la date d'entrée en vigueur.
L'environnement de test du régulateur ne se comporte pas comme la production. Et alors ?
C'est fréquent. Nous conservons, anonymisé, chaque accusé réel obtenu en test d'intégration comme échantillon de succès, d'erreur de contrôle et de chaque code d'erreur, et nous rapprochons plus souvent après la mise en production pour repérer ce que l'environnement de test n'a jamais montré.
Peut-on commencer par une seule région ?
Commencer par une région est raisonnable, à condition de concevoir la structure pour plusieurs régulateurs : objets standard, couche de mappage et couche d'envoi séparés. La deuxième région n'ajoute alors qu'un mappage au lieu de copier un service entier.
Nos consultants de déploiement ne codent pas. Peuvent-ils maintenir les mappages ?
Les correspondances de champs et les tables de codes du quotidien se maintiennent dans l'interface, et chaque modification est comparée automatiquement à des données d'exemple, si bien qu'une erreur apparaît aussitôt sous forme d'écart. Les exceptions que la configuration ne sait pas exprimer sont développées via une interface de plugins.