Inhoudingsplicht via webservice
Een nieuwe versie van de billRetainment-webservice die het mogelijk maakt om de beslissingen te bekijken over de toepassing van de inhoudingsplicht op facturen voor sociale schulden gaat in productie. Merk op dat de oude SOAP al vervangen is door de nieuwe REST-service, maar dat de inproductiestelling voorzien is op 12/06/2024. Tijdens de migratie zult u de oude webservice niet meer kunnen raadplegen, en de nieuwe versie nog niet kunnen gebruiken. Daarom raden wij u aan om te wachten tot 13/06/2024 om de nieuwe versie van billRetainment te raadplegen.
Opmerking: wanneer de nieuwe versie live gaat, zal de oude versie van billRetainment niet langer toegankelijk zijn.
De RSZ heeft een beveiligde REST-webservice billRetainment ontwikkeld, waarmee u kunt nagaan of de inhoudingsplicht geldt voor een lijst van ondernemingen. Met die webservice kunt u ook betalingen aan de RSZ voorbereiden. 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:
- De registratie van het toegangsbeheer van uw onderneming.
- De configuratie van het REST-kanaal in Chaman.
- Het verkrijgen van een toegangstoken.
- Het gebruik van het toegangstoken voor contact per telefoon.
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 buitenlandse officiële identificatie.
De toevoeging van die laatste twee nieuwe identificatiegegevens maakt deel uit van het Eerlijke Mededingingsplan. Ze versterkt zo de strijd tegen sociale fraude, zowel voor Belgische als buitenlandse werkgevers. Al deze identificatiegegevens worden gecontroleerd door de RSZ.
De webservice biedt u:
- retainmentObligations/search: de beslissingen raadplegen om een inhouding op facturen voor socialezekerheidsschulden te doen voor een lijst van ondernemingen die onder het toepassingsgebied van artikel 30bis ter van de wet van 27/06/1969 vallen, en
- paymentPreparations: betalingen voorbereiden van het bedrag van inhoudingsplicht op facturen. Gebruik bij de betaling aan de RSZ de gestructureerde mededeling die automatisch gegenereerd wordt.