Checkinatwork API integratie Technische gids

Checkinatwork API: Intégration Technique

L'API Checkinatwork permet aux entreprises belges de déclarer facilement les présences dans les secteurs soumis à l'obligation Dimona. Ce guide technique vous accompagne dans l'intégration complète, étape par étape. Gagnez du temps et automatisez vos processus.

Commencer

Comment ca marche

1

Remplissez

Entrez les informations Checkinatwork API integratie Technische gids pour .

2

Verification

Notre systeme verifie la conformite avec les regles ONSS.

3

Declaration

Telechargez votre declaration prete a envoyer.

Details

L'intégration de l'API Checkinatwork nécessite une authentification via OAuth2. Les appels API doivent respecter les méthodes REST standard (POST pour déclarations, GET pour vérifications). Les données transmises, y compris le numéro de registre national et le NISS, doivent être cryptées en TLS 1.2 ou supérieur. Les réponses incluent des codes HTTP spécifiques pour signaler le statut des requêtes (200 pour succès, 400 pour erreur de syntaxe, 401 pour authentification échouée).

Questions frequentes

Quels sont les prérequis pour accéder à l'API Checkinatwork?
Vous devez disposer d'une clé API fournie par l'ONSS après l'inscription de votre entreprise. Un certificat SSL valide est également requis pour sécuriser vos échanges de données.
Comment gérer les erreurs lors des appels API?
En cas d'erreur, l'API retourne un code HTTP spécifique. Par exemple, un 400 signifie une requête mal formatée, tandis qu'un 401 indique un problème d'authentification. Consultez le corps de la réponse pour des détails supplémentaires.
Quels champs sont obligatoires dans une déclaration Checkinatwork?
Les champs obligatoires incluent le numéro d'entreprise (BCE), le NISS du travailleur, la date et l'heure de début de la présence, ainsi que le lieu de travail identifié par un code postal ou une adresse GPS.
L'API Checkinatwork est-elle compatible avec les applications mobiles?
Oui, tant que votre application respecte les standards REST et utilise des connexions sécurisées via TLS. Assurez-vous également de gérer correctement les jetons OAuth pour les sessions utilisateur.
Comment tester l'intégration avant le déploiement en production?
L'ONSS fournit un environnement de test (sandbox) pour valider vos appels API. Vous pouvez y soumettre des données fictives et vérifier les réponses sans impact sur les déclarations réelles.

Checkinatwork API integratie Technische gids

Commencer