Aanwezigheidsregistratie via webservice
Als u de webservice van de RSZ als transmissiekanaal gebruikt, registreren uw medewerkers zich met een badge, track and trace, of een andere toepassing. U kunt met de webservice de aanwezigheidsregistraties van uw personeel en van uw onderaannemers raadplegen.
Uw bestaande systeem communiceert met de webservice om aanwezigheden op werkplaatsen te registreren. U kunt de webservice integreren in uw plannings-, track-and-trace- of registratiesysteem. Neem contact op met uw softwareleverancier om de REST-webservice te installeren.
Stappen voorafgaand aan de integratie van de REST-webservice
Zoals bij elke REST-API (Representational State Transfer API), moet u vóór de integratie van de REST-webservice in uw IT-systeem een aantal stappen doorlopen:
- Registreer uw onderneming op dit portaal en stel een Hoofdtoegangsbeheerder aan.
- Configureer het REST-kanaal in Chaman.
- Vraag een toegangstoken aan.
- Gebruik het toegangstoken voor de oproepen.
Raadpleeg de REST Documentation-website (in het Engels) Nieuw venster voor technische informatie over deze stappen.
REST-webservice van Check in and out at work
Met de REST-webservice van Check in and out at work integreert u het beheer van de aanwezigheden gemakkelijk in uw bestaande systeem. Met de REST-webservice kunt u:
- de aanwezigheid van werknemers registreren
- de aanwezigheden van werknemers en eventuele opmerkingen raadplegen
De aanwezigheden moeten onmiddellijk en ter plaatse (in ‘real time’) geregistreerd worden. Daarna voert het systeem een asynchrone verwerking uit om eventuele opmerkingen bij deze registraties op te zoeken. Na enkele ogenblikken zijn de resultaten van de verwerking beschikbaar voor raadpleging.
Versies van de REST-webservice voor Check in and out at work
| Versie 1.4.1 | |
|---|---|
| Documentatie | OpenAPI 1.4.1 .zip - Nieuw venster |
| Handleiding | |
Omgevingen
De RSZ biedt 2 omgevingen met de volgende endpoints:
| Omgeving | Adres |
|---|---|
| Simulatie | https://services-sim.socialsecurity.be/REST/presenceRegistration/v1 |
| Productie | https://services.socialsecurity.be/REST/presenceRegistration/v1 |
Uw tests moet u uitvoeren in de simulatieomgeving.
De productieomgeving mag alleen echte gegevens bevatten, van personen die daadwerkelijk hun aanwezigheid registreren.
Opgelet
De RSZ kent geen certificering toe aan de oplossingen van uw softwareleverancier, ook al functioneren ze met de webservices die de RSZ ter beschikking stelt. Dit is namelijk niet de taak van de RSZ.
Onthoud ook dat het feit dat u een beroep doet op een oplossing/software die door een leverancier beheerd wordt, u niet vrijstelt van de aansprakelijkheid die voortvloeit uit de toepassing van de wet.