Enregistrement des présences via web service
Dans le cas où vous avez choisi le web service de l’ONSS comme canal de transmission, vos collaborateurs s’enregistrent avec un badge, un système de suivi et de traçabilité ou une autre application. Le web service vous permet également de consulter les enregistrements de présence de votre personnel et de vos sous-traitants.
Votre système existant communique avec le web service pour enregistrer les présences sur les lieux de travail. Vous pouvez l’intégrer à votre système de planification, de suivi et traçabilité ou d’enregistrement. Adressez-vous à votre fournisseur de logiciels pour installer le web service REST.
Étapes préalables à l’intégration du web service REST
Comme pour toute API REST (Representational State Transfer), l’intégration de ce web service REST dans votre système IT passe par plusieurs étapes préalables nécessaires :
- Enregistrez votre entreprise sur ce portail et désignez un Gestionnaire d’Accès Principal.
- Configurez le canal REST dans Chaman.
- Demandez un jeton d’accès.
- Utilisez un jeton d’accès pour les appels.
Consultez le site REST Documentation (en anglais) Nouvelle fenêtre qui rassemble les informations techniques pour accomplir ces étapes.
Web service REST pour Check in and out at work
Le web service REST de Check in and out at work facilite l'intégration de la gestion des présences dans votre système existant. Ses fonctionnalités comprennent :
- l’enregistrement des présences des travailleurs ;
- la consultation des enregistrements de présence des travailleurs ainsi que des remarques éventuelles.
À noter que l'enregistrement des présences doit s’effectuer immédiatement, sur place (en temps réel). Le système réalise ensuite un traitement asynchrone pour rechercher d'éventuelles remarques associées à ces enregistrements. Après quelques instants, les résultats du traitement sont disponibles pour consultation.
Versions du web service REST pour Check in and out at work
| Version 1.4.1 | |
|---|---|
| Documentation | OpenAPI 1.4.1 .zip - Nouvelle fenêtre |
| Manuel | Guide d'utilisateur du service web REST .pdf - Nouvelle fenêtre |
Environnements
L’ONSS met à disposition 2 environnements dont voici les endpoints :
| Environnement | Adresse |
|---|---|
| Simulation | https://services-sim.socialsecurity.be/REST/presenceRegistration/v1 |
| Production | https://services.socialsecurity.be/REST/presenceRegistration/v1 |
Vos tests doivent être réalisés dans l’environnement de simulation.
L’environnement de production ne doit contenir que des données réelles, provenant de personnes qui enregistrent effectivement leurs présences.
Attention
L’ONSS n’octroie pas de certification aux solutions de votre fournisseur de logiciels, même si elles fonctionnent avec les web services mis à disposition par l’ONSS. Cette tâche n’incombe pas à l’ONSS.
Retenez aussi que le recours à une solution/software gérée par un fournisseur ne vous dispence pas des responsabilités découlant de l'application de la loi.