We gebruiken cookies gebruiksvriendelijker te maken.

entityRole

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

  • Service & API
  • Gebruikers- en toegangsbeheer
  • RSZ

Functionele beschrijving

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.

Contact: ReuseOperational@smals.be

Documentatie

Sommige van de onderstaande links werken mogelijk niet omwille van beveiligingsbeperkingen.

Wenst u deze informatie te verkrijgen, neem dan contact op met het verantwoordelijke team via het e-mailadres hierboven vermeld in de paragraaf Integratievoorwaarden.

Hoe neem jij deel aan ons project?

Vul de catalogus aan

Heb je een herbruikbare component die voor een andere instelling van pas kan komen?

Leg hem aan ons voor!

Ontdek onze getuigenissen

Neem deel aan onze evenementen

Ideeën uitwisselen over hergebruik? Dat kan op onze evenementen. We organiseren er regelmatig!

Schrijf je zeker in!

Abonneer je op de nieuwsbrief

Schrijf je in op onze nieuwsbrief en blijf op de hoogte van de laatste ontwikkelingen in hergebruik.

Abonneer je

Deel je ervaringen

Is jouw project een succes geworden dankzij een hergebruikte component?

Laat het ons weten! 

Ontdek onze getuigenissen

Naar boven