entityRole

Aperçu

Service permettant aux applications de la Sécurité Sociale de consulter les rôles métiers attribués à une entité de type entreprise inscrite à la Banque Carrefour des Entreprises

Le service REST entityRole vise à apporter les avantages suivants :

• Offrir une interface standard et réutilisable
• Normaliser les rôles des entités afin de disposer d'une nomenclature unifiée pour toutes les applications de la Sécurité Sociale
• Centraliser les appels via un seul et même canal qui intègre les différentes sources authentiques
• Réduire les adaptations chez les clients dans le cas d’une modification ou d’une évolution dans les sources authentiques

Le service entityRole offre les fonctionnalités suivantes :

• Consulter les rôles métiers pour une liste d’entités. Chaque entité est identifiée par son numéro d’entreprise attribué par la BCE (Banque Carrefour des Entreprises) et les rôles métiers retournés sont issus des sources authentiques répertoire des employeurs ONSS, répertoire des mandataires ou banque carrefour des entreprises (copie)
• Consulter la liste des rôles supportés avec leur définition et leur traduction. Les rôles identifiés actuellement sont :
  • Entité BCE identifiée par un numéro d’entreprise de la BCE
  • Employeur ONSS identifié par un numéro ONSS définitif
  • Employeur ONSS identifié par un numéro ONSS provisoire
  • Employeur APL (Administration Provinciale et Locale) identifié par un numéro PPL (Plaatselijke en Provinciale/Provincial et Local)
  • Secrétariat social agréé identifié par un numéro de secrétariat social
  • Prestataire de service ONSS mandaté par un employeur ONSS et identifié par un numéro d’entreprise
  • Prestataire de service APL mandaté par un employeur APL et identifié par un numéro d’entreprise

Public cible

Toutes les applications du portail de la sécurité sociale peuvent s'intégrer au service REST entityRole.

Conditions d'intégration

Le service REST entityRole nécessite une authentification sécurisée par socsec Oauth2/OpenId.

Afin de pourvoir utiliser le service REST entityRole, une demande d'intégration devra être soumise afin que l’équipe IAM-support puisse l’analyser.

Documentation

• Architecture fonctionnelle du service web
• Architecture technique du service web
• Définition et traduction des rôles métiers fournis par le service web
• Formulaire de demande d'intégration au service REST entityRole
• Généralités sur l'API

Contact

Contact : ReuseOperational@smals.be