Overzicht
Service om signaletiekgegevens te versturen betreffende een werkgever, een derde betaler of een fonds voor de sluiting van een onderneming, zoals gekend in het werkgeversrepertorium van de RSZ.
Kerndiensten van de instellingen
SubdomeinLevenscyclus van een onderneming
TypologieService & API
Service ownerRSZ
2018
Hergebruik46
Integration effortWaarvoor dient het?
Moet je als developper toepassingen ontwikkelen waarbij de gebruiker toegang dient te hebben tot gegevens van werkgevers zoals gekend bij de RSZ? Dankzij de service ‘employer/identification’ kan je je gebruikers toegang geven tot bepaalde van die gegevens.
Functionele beschrijving
De REST-service employer/identification biedt volgende functionaliteiten:
- Opzoeken van alle gegevens van de werkgever op basis van zijn RSZ-nummer
- Opzoeken van alle gegevens van de werkgever op basis van zijn ondernemingsnummer
- Alfabetisch opzoeken van gegevens, in de vorm van een samenvatting, van de werkgevers op basis van hun adres (straat, postcode, stad en land), van hun benaming, deel van hun RSZ-nummer of deel van hun ondernemingsnummer
- Opzoeken van verschillende codes met betrekking tot de werkgever om details te verkrijgen (categorieën, belangrijkheidscode, overdrachtstype...)
Technische beschrijving
Beveiligde REST-service die OAuth 2.0/OpenId-authenticatie vereist, geïmplementeerd op de API Gateway SocSec van de sociale zekerheid.
Doelpubliek
Het doelpubliek van de REST-service zijn de toepassingen of services die willen beschikken over de gegevens van een werkgever zoals gekend bij de RSZ.
Afhankelijk van het profiel van de aanvrager zullen bepaalde gegevens al dan niet verstuurd worden.
Integratievoorwaarden
Om toegang te krijgen tot de openbare gegevens van het bedrijf, gelden er geen integratievoorwaarden.
Om echter alle gegevens van het bedrijf te kunnen raadplegen, inclusief die met betrekking tot personen die aan het bedrijf verbonden zijn (adressen van fysieke personen, werkgeverscategorieën, enz.), moet je:
- de onboarding doorlopen met het team dat verantwoordelijk is voor het toegangsbeheer
- de URN van uw toepassing laten opnemen in de lijst van URN's die toegang hebben tot de service
Documentatie
Andere interessante componenten
Contact
Contact: ReuseOperational@smals.be
