Overzicht
Service om de technische accounts van ondernemingen, gekoppeld aan een businessrol, te raadplegen zodoende via verschillende kanalen te kunnen communiceren.
Externe communicatie
SubdomeinVeiligheid
TypologieService & API
Service ownerRSZ
2026
Integration effortWaarvoor dient het?
Als sociaal secretariaat neem je de DmfA-, Dimona-aangiften... voor verschillende aangesloten ondernemingen voor je rekening. In dat kader vraagt een klant om een FTP- of sFTP-kanaal te gebruiken dat hij zelf heeft geconfigureerd om zijn aangiften door te geven. Dankzij de informatie, doorgegeven door de service technicalAccount, kunnen de ontvangende toepassingen de conformiteit van het gebruikte kanaal en de geldigheid van het handtekeningcertificaat controleren.
Als onderneming gebruik je moderne software gebaseerd op een REST-selfservice om te communiceren met de toepassingen die beschikbaar zijn in het portaal van de sociale zekerheid. Dankzij de service technicalAccount kunnen deze toepassingen je authenticatiecertificaat en je unieke identificatiecode voor het communicatiekanaal valideren.
Functionele beschrijving
Met de REST-service technicalAccount kunnen de technische accounts van ondernemingen, die de Verzenders zijn, worden geraadpleegd. Elke technische account is gekoppeld aan een businessrol en biedt de mogelijkheid om
- gestructureerde berichten uit te wisselen via FTP- (File Transfer Protocol) en sFTP-kanalen (secure File Transfer Protocol)
- te communiceren met de SOAP- en REST-services die beschikbaar zijn voor de gekende toepassingen in het portaal van de sociale zekerheid
De technische accounts zijn onderverdeeld in verschillende kanaalaccounts, namelijk FTP, sFTP, SOAP of REST.
De REST-service technicalAccount biedt volgende functionaliteiten:
- Raadplegen van de kanaalaccounts van een Verzender op basis van een verzendernummer
- Raadplegen van de kanaalaccounts van een Verzender op basis van het ondernemingsnummer en een businessrol
Raadplegen van een specifieke kanaalaccount (FTP/sFTP/SOAP of REST) van een Verzender
Technische beschrijving
Beveiligde REST-service die OAuth 2.0/OpenId-authenticatie vereist, geïmplementeerd op de API Gateway SocSec van de sociale zekerheid.
Doelpubliek
Alle instellingen van de sociale zekerheid die verantwoordelijk zijn voor toepassingen die:
- Communiceren met de toepassingen van het portaal van de sociale zekerheid
- De geldigheid van de kanaalaccounts controleren
- De certificaten controleren van ondernemingen die aangiften indienen met betrekking tot de domeinen van de RSZ
Integratievoorwaarden
Er moet een integratieaanvraag ingediend worden. Indien de analyse de integratie mogelijk acht, volgt een onboardingproces.
Een toegangsbewijs en een URN van de toepassing zijn vereist om de service technicalAccount te integreren.
Documentatie
Andere interessante componenten
Contact
Contact: ReuseOperational@smals.be
