Einbehaltungspflicht über Webservice
Die neue Version der technischen Dokumentation für den REST-Webservice billRetainment liegt nun vor. Sie finden sie am Ende der Seite.
Das LSS hat den gesicherten Webservice billRetainment entwickelt, mit dem Sie die Einbehaltungspflicht für eine Reihe von Unternehmen überprüfen können. Mit diesem Webservice können Sie auch Zahlungen an das LSS vorbereiten
Die technischen Informationen auf dieser Seite sind für IT-Abteilungen und Softwareentwickler bestimmt. Für weitere Informationen kontaktieren Sie uns bitte über billretainment30bis@onss.fgov.be.
Schritte vor der Integration des REST-Webservice
Wie bei jeder Rest-API (Representational State Transfer) muss die Integration dieses REST-Webservice in Ihr IT-System mehrere notwendige Vorstufen durchlaufen:
- Die Registrierung und Verwaltung der Zugänge Ihres Unternehmens.
- Die Konfiguration des REST-Kanals in Chaman.
- Das Beziehen eines Zugangs-Tokens.
- Die Verwendung des Zugangs-Tokens für Anrufe.
Auf der Website REST Documentation (auf Englisch) Neues Fenster sind die technischen Informationen zur Durchführung dieser Schritte gesammelt.
Funktionen des REST-Webservice
Mit dem REST-Webservice billRetainment können Sie überprüfen, ob die Einbehaltungspflicht für eine Reihe von Unternehmen gilt.
Sie führen Ihre Suche auf der Grundlage der folgenden Kriterien durch:
- einer Unternehmensnummer,
- einer innergemeinschaftlichen Umsatzsteuer-Identifikationsnummer, oder
- einer anderen offiziellen ausländischen Identifikation.
Die Einführung dieser beiden neuen Identifikationsdaten ist Teil des Plans für fairen Wettbewerb und verstärkt den Kampf gegen Sozialbetrug, sowohl für belgische als auch für ausländische Arbeitgeber.
Diese Identifikationsdaten werden vom LSS überprüft.
Der Webservice bietet Ihnen:
- retainmentObligations/search: Abfrage der Entscheidungen zur Einbehaltungspflicht von Rechnungen für Sozialschulden für eine Reihe von Unternehmen, die in den Anwendungsbereich von Artikel 30bis ter des Gesetzes vom 27.06.1969 fallen, und
- paymentPreparations: Vorbereitung der Zahlungen des Lohnsteuervorabzugs auf Rechnungen. Verwenden Sie bei der Zahlung an das LSS die automatisch erzeugte strukturierte Mitteilung.
Technische Informationen
Version 1.0
Version 2.0
- OpenAPI (Version vom 02.03.2026) Neues Fenster
- Endpoints
- Service Endpoint für Produktion (Version vom 06.03.2026) Neues Fenster
- Service Endpoint für Simulation (Version vom 03.03.2026) – nicht mehr verfügbar; wurde durch Endpoint Version 2.1 ersetzt
Version 2.1
- OpenAPI (Version vom 02.03.2026) – idem Version 2.0 Neues Fenster
- Testszenarien (auf Französisch) .pdf - Neues Fenster
- Endpoints
- Service Endpoint für Produktion – verfügbar Ende April 2026
- Service Endpoint für Simulation (Version vom 16.03.2026) Neues Fenster