entityRole

Overzicht

Service om toepassingen van de sociale zekerheid businessrollen te raadplegen die toegewezen zijn aan een entiteit van het type onderneming ingeschreven bij de Kruispuntbank van Ondernemingen

De REST-service entityRole beoogt volgende voordelen:

• Aanbieden van een standaard en herbruikbare interface
• Normaliseren van de rollen van de entiteiten zodoende te beschikken over een uniforme nomenclatuur voor alle toepassingen van de sociale zekerheid
• Centraliseren van de oproepen via één kanaal, die de verschillende authentieke bronnen integreert
• Reduceren van de aanpassingen bij klanten in geval van wijziging of evolutie in de authentieke bronnen.

De service entityRole biedt volgende functionaliteiten:

• Raadplegen van de businessrollen voor een lijst met entiteiten. Elke entiteit wordt geïdentificeerd door het ondernemingsnummer toegekend door de KBO (Kruispuntbank van Ondernemingen) en de weergegeven businessrollen zijn afkomstig uit de authentieke bronnen RSZ-werkgeversrepertorium, mandatarissenrepertorium of Kruispuntbank van Ondernemingen (kopie).

• Raadplegen van de lijst van de ondersteunde rollen, inclusief hun definitie en vertaling, momenteel als volgt geïdentificeerd:
  • KBO-entiteit geïdentificeerd door een KBO-ondernemingsnummer
  • RSZ-werkgever geïdentificeerd door een definitief RSZ-nummer
  • RSZ-werkgever geïdentificeerd door een voorlopig RSZ-nummer
  • PPO-werkgever (Provinciale en Plaatselijke Overheidsdiensten) geïdentificeerd door een PPL-nummer (Plaatselijke en Provinciale/Provincial et Local)
  • Erkend sociaal secretariaat geïdentificeerd door een sociaal secretariaatsnummer
  • RSZ-dienstverrichter gemandateerd door een RSZ-werkgever en geïdentificeerd door een ondernemingsnummer
  • PPO-dienstverrichter gemandateerd door een PPO-werkgever en geïdentificeerd door een ondernemingsnummer

Doelpubliek

Alle toepassingen van het portaal van de sociale zekerheid kunnen integreren met de REST-service entityRole.

Integratievoorwaarden

De REST-service entityRole vereist veilige authenticatie via  socsec Oauth2/OpenId.

Om de REST-service entityRole te gebruiken zal een integratieaanvraag moeten worden ingediend zodat het IAM-supportteam deze kan analyseren.

Documentatie

• Algemeenheden over de API
• Functionele architectuur van de webservice
• Technische architectuur van de webservice
• Definitie en vertaling van de businessrollen geleverd door de webservice
• Aanvraagformulier voor integratie met de REST-service entityRole

Contact

Contact: ReuseOperational@smals.be