Inhoudingsplicht via webservice
De beveiligde REST-webservice BillRetainment maakt het mogelijk om voor een lijst van ondernemingen na te gaan of er een verplichting tot inhouding op factuur voor sociale en/of fiscale schulden geldt. Met die webservice kunt u eveneens betalingen voor het sociale luik voorbereiden met gestructureerde mededeling. Neem voor meer informatie contact op met billretainment30bis@rsz.fgov.be.
De technische informatie op deze pagina is bedoeld voor IT-diensten en softwareontwikkelaars.
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:
- Uw onderneming als werkgever identificeren en een Hoofdtoegangsbeheerder aanstellen
- Het REST-kanaal in Chaman configureren
- Een toegangstoken krijgen
- 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 REST-webservice
Met de REST-webservice BillRetainment kunt u voor een lijst van bedrijven de beslissingen controleren om de inhoudingsplicht voor socialezekerheidsschulden toe te passen.
U doet uw opzoekingen op basis van:
- een ondernemingsnummer,
- een intracommunautair btw-nummer of
- een andere officiële buitenlandse identificatie.
De webservice biedt u:
- retainmentObligations/search: het raadplegen van beslissingen inzake de verplichting tot inhouding op factuur voor sociale en fiscale schulden voor een lijst van ondernemingen die vallen onder het toepassingsgebied van de artikelen 30bis en 30ter van de wet van 27 juni 1969 tot herziening van de besluitwet van 28 december 1944 betreffende de maatschappelijke zekerheid der arbeiders, artikel 15/1 van het koninklijk besluit nr. 38 van 27 juli 1967 houdende inrichting van het sociaal statuut der zelfstandigen, en de artikelen 53 t.e.m. 59 van het WMGI met inbegrip van de koninklijke besluiten ter uitvoering van deze bepalingen, en
- paymentPreparations: het voorbereiden van de betaling van het bedrag van de inhouding op factuur voor sociale schulden. Gebruik bij de betaling van de sociale inhouding op de rekening ‘Retenue Sociale Inhoudingen’ (IBAN: BE76 6790 0001 9295; BIC: GEBABEBB) de gestructureerde mededeling die automatisch gegenereerd wordt.
Technische info
Versie 1.0
Versie 2.0
- OpenAPI (versie van 02/03/2026) Nieuw venster
- Endpoints
- Service endpoint voor productie (versie van 06/03/2026) Nieuw venster
- Service endpoint voor simulatie (versie van 03/03/2026) – niet langer beschikbaar; is vervangen door endpoint versie 2.1
Versie 2.1
- OpenAPI (versie van 02/03/2026) – idem versie 2.0 Nieuw venster
- Testscenario’s .pdf - Nieuw venster
- Endpoints
- Service endpoint voor productie – beschikbaar eind april 2026
- Service endpoint voor simulatie (versie van 16/03/2026) Nieuw venster