Déclaration de chaîne via web service
Le web service REST sécurisé Catena permet de soumettre, modifier, consulter et supprimer de nouvelles déclarations de chaîne, ainsi que de fournir toutes les informations concernant le chantier, le client et les éventuels sous-traitants. Ce web service permet également d'effectuer des recherches.
Les informations techniques figurant sur cette page sont destinées aux services informatiques et aux développeurs de logiciels.
Étapes préalables
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 :
- L’identification de votre entreprise comme employeur et la désignation d’un gestionnaire d’accès principal.
- La configuration du canal REST dans Chaman.
- L’obtention d’un jeton d’accès.
- L’utilisation du 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.
Fonctions du web service Catena
Grâce au web service REST de Catena, vous pouvez intégrer la gestion des déclarations de chaîne d'approvisionnement dans votre système existant. Le web service vous permet de :
- créer, consulter et supprimer des déclarations ;
- ajouter des contrats à des déclarations existantes, modifier, consulter et supprimer des contrats ;
- ajouter des sous-traitants à un contrat existant, modifier, consulter et supprimer des sous-traitants ;
- rechercher une liste de déclarations, de contrats ou de sous-traitants.
Informations techniques
- OpenAPI .zip - Nouvelle fenêtre
- Guide d’utilisation du web service REST (en anglais) .pdf - Nouvelle fenêtre
Versions du web service REST pour Catena
| Version 1 - Valide à partir du 01/04/2027 | |
|---|---|
Release note |
Première version du webservice REST |
| Déploiement en production | 01/04/2027 |
| Déploiement en simulation | 09/11/2026 |
| Décommissionnement | Pas d’application |
| Documentation | |
Environnement
| Environnement | Adresse |
|---|---|
| Simulation | https://services-sim.socialsecurity.be/REST/enterpriseWorkContractChain/v1 |
| Production |
Vos tests doivent être effectués dans l'environnement de simulation.
L'environnement de production ne doit contenir que des données relatives à des déclarations de chaîne réelles.
Attention
L’ONSS n’octroie pas de certification aux solutions de votre fournisseur de services, même si elles fonctionnent avec les services web que l’ONSS met à disposition. Il n’appartient pas à l’ONSS de le faire.
Retenez aussi que le recours à une solution software générée par un fournisseur ne vous exonère pas des responsabilités découlant de l’application de la Loi.