Ketenaangifte via webservice

De beveiligde REST-webservice Catena  laat toe om nieuwe ketenaangiftes in te dienen, te bewerken, te consulteren en te verwijderen en alle inlichtingen betreffende de werkplaats, de klant en de eventuele onderaannemers te verstrekken. Ook kunnen via de webservice opzoekingen uitgevoerd worden.

De technische informatie op deze pagina is bedoeld voor IT-afdelingen en softwareontwikkelaars.

Voorafgaande stappen

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:

1. Uw onderneming als werkgever identificeren en een hoofdtoegangsbeheerder aanstellen.
2. Het REST-kanaal in Chaman configureren.
3. Een toegangstoken krijgen.
4. Het toegangstoken gebruiken voor de oproepen.

Raadpleeg de REST Documentation-website (in het Engels) Nieuw venster voor technische informatie over deze stappen.

Functies van de Catena-webservice

Met de REST-webservice van Catena integreert u het beheer van de ketenaangifte in uw bestaande systeem. Met de REST-webservice kunt u:

• aangiftes aanmaken, consulteren en verwijderen;
• contracten toevoegen aan bestaande aangiftes, contracten bewerken, consulteren en verwijderen;
• onderaannemers toevoegen aan een bestaand contract, onderaannemers bewerken, consulteren en verwijderen;
• een lijst van aangiftes, contracten of onderaannemers opzoeken

Technische informatie

• OpenAPI .zip - Nieuw venster
• Gebruikershandleiding REST-webservice (in het Engels) .pdf - Nieuw venster

Versies van de REST-webservice voor Catena

Omgeving

Uw testen dienen uitgevoerd te worden in de simulatieomgeving.

De productieomgeving mag enkel gegevens bevatten met betrekking tot daadwerkelijke ketenaangiftes.

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.