technicalAccount

Aperçu

Service qui permet la consultation des comptes techniques des entreprises, liés à un rôle métier, afin de communiquer via différents canaux.

En tant que secrétariat social, vous prenez en charge les déclarations DmfA, Dimona… pour plusieurs entreprises affiliées. Dans ce cadre, votre client vous a mandaté pour utiliser un canal FTP ou sFTP qu’il a lui-même configuré, afin de transmettre ses déclarations. Grâce aux informations transmises par le service technicalAccount, les applications réceptrices pourront vérifier la conformité du canal utilisé ainsi que la validité du certificat de signature.

En tant qu’entreprise, vous utilisez un logiciel moderne reposant sur un self-service REST pour communiquer avec les applications disponibles dans le portail de la sécurité sociale. Grâce au service technicalAccount, ces applications pourront  valider votre certificat d’authentification ainsi que votre identifiant unique lié au canal de communication.

Description fonctionnelle

Le service REST technicalAccount permet la consultation des comptes techniques des entreprises, qui sont les Expéditeurs. Chaque compte technique est lié à un rôle métier et donne la possibilité

• d'échanger des messages structurés via les canaux FTP (File Transfer Protocol) et sFTP (secure File Transfer Protocol)
• de communiquer avec les services SOAP et REST disponibles pour les applications connues dans le portail de la Sécurité Sociale

Les comptes techniques sont subdivisées en plusieurs comptes canaux, c’est-à-dire FTP, sFTP, SOAP ou REST.

Le service REST technicalAccount offre les fonctionnalités suivantes:

• Consulter les comptes canaux d’un Expéditeur sur base d’un numéro d’Expéditeur
• Consulter les comptes canaux d’un Expéditeur sur base du numéro d’entreprise et d’un rôle métier
• Consulter un compte canal spécifique (FTP/sFTP/SOAP ou REST) d’un Expéditeur

Description technique

Service REST sécurisé nécessitant une authentification OAuth 2.0/OpenId, déployé sur l’API Gateway SocSec de la sécurité sociale.

Public cible

Toutes les institutions de la sécurité sociale qui ont en charge des applications qui :

• Communiquent avec les applications du portail de la sécurité sociale
• Contrôlent la validité des comptes canaux
• Vérifient les certificats des entreprises transmettant des déclarations liées aux domaines de l’ONSS

Conditions d'intégration

Une demande d’intégration devra être soumise et analysée. Si l’intégration est jugée possible, un processus d’onboarding sera alors réalisé.
Un certificat d’accès et une URN de l’application seront nécessaires afin d’intégrer le service technicalAccount.

Documentation

• Documentation technique
• Documentation de l’API

Autres composants intéressants

Contact

Contact: ReuseOperational@smals.be