Einbehaltungspflicht über Webservice
Es wird ein neuer Webservice billRetainment eingeführt, der die Einsichtnahme über die Anwendung der Einbehaltungspflicht von Rechnungen für Sozialschulden ermöglicht. Bitte beachten Sie, dass das alte SOAP bereits durch den neuen REST-Webservice ersetzt wurde. Das Datum der Einführung ist jedoch für den 12.06.2024 vorgesehen. Während der Migration können Sie den alten Webservice nicht mehr aufrufen und Sie können noch nicht auf die neue Version zugreifen. Wir empfehlen Ihnen daher, bis zum 13.06.2024 zu warten, um Abfragen über die neue Version billRetainment durchzuführen.
Hinweis: Wenn die neue Version online geht, wird die alte Version von billRetainment nicht mehr zugänglich sein.
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.
Benutzen Sie den REST-Webservice der sozialen Sicherheit noch nicht?
Bevor Sie den REST-Webservice der sozialen Sicherheit nutzen können, müssen Sie ein Benutzerkonto für sich oder Ihren Kunden erstellen und sich um dessen Sicherheit kümmern.
Eine Person zum technischen Verwalter ernennen
Sie können die Verwaltung Ihrer Kanäle über Chaman an Ihre IT-Abteilung delegieren. Dazu müssen Sie in den Onlinedienst Zugangsverwaltung gehen und den betreffenden Personen die Zugriffsberechtigung für den Onlinedienst Chaman erteilen.
Aktivierung und Konfiguration des REST-Kanals in Chaman
Der Onlinedienst Chaman (Channel Management) ermöglicht es Ihnen, die verschiedenen Kommunikationskanäle, die mit den Diensten der Sozialen Sicherheit verbunden sind, zu konfigurieren. Die Aktivierung des REST-Kanals für Ihr Unternehmen erfordert das Hochladen eines X.509-Zertifikats zur Identifikation Ihres Unternehmens oder Ihrer Client-Anwendung. Vor der Konfiguration von Chaman benötigen Sie dieses Zertifikat.
Ein Zertifikat zur Authentifizierung für Ihr Unternehmen erhalten
Um die Aufrufe durch Ihre Anwendung über REST APIs zu sichern, benötigen Sie ein Authentifizierungszertifikat auf den Namen Ihres Unternehmens. Sie haben mehrere Möglichkeiten:
- Sie können das Zertifikat bei einer anerkannten Zertifizierungsstelle bestellen. Hier ist eine Liste der derzeit unterstützten Zertifizierungsstellen:
Zertifizierungs-stelle Zertifikatstyp Link GlobalSign PersonalSign 3 Pro https://shop.globalsign.com/de-de
- Sie können ein selbstsigniertes Zertifikat auf den Namen Ihres Unternehmens verwenden.
Das Verfahren zur Erstellung eines solchen Zertifikats wird hier derzeit nicht beschrieben. Normalerweise wird die Erstellung eines solchen Zertifikats von der IT-Abteilung Ihres Unternehmens durch die Verwendung eines Tools wie OpenSSL unterstützt. Bitte beachten Sie die folgenden Einschränkungen bei der Erstellung Ihres selbstsignierten Zertifikats:Zu respektierende Kriterien Zulässige Werte Algorithmus zur Erzeugung des Schlüsselpaares RSA oder EC Schlüsselgröße (Bits) Für RSA : 2048, 3072 oder 4096
Für EC : P-384 oder P-521Digest-Algorithmus, der mit der Signatur des Zertifikats verbunden ist SHA-256, SHA-384 oder SHA-512 Key Usage des Zertifikats Digital Signature
Konfiguration des REST-Kanals in Chaman
Um den REST-Kanal zu aktivieren und Ihr Authentifizierungszertifikat zu konfigurieren, loggen Sie sich in den Onlinedienst von Chaman ein.
Wenn beim Zugriff auf Chaman die Kontaktdaten des technischen Zugangsverwalters Ihres Unternehmens nicht verfügbar sind, müssen Sie diese ergänzen (und registrieren), bevor Sie die folgenden Aktionen durchführen können.
Klicken Sie in Chaman in dem Abschnitt, der mit den Webservicekanälen verbunden ist, auf „Webservicekonto hinzufügen“. Füllen Sie dann das unten sichtbare Formular wie folgt aus:
- Wählen Sie den Typ REST. Nach der Auswahl wird die Liste der zugehörigen Felder angezeigt.
- Geben Sie den Namen ein, den Sie Ihrem REST-Konto geben möchten.
- Wählen Sie die Berechtigung(en), die Sie diesem Konto zuweisen möchten.
- Laden Sie das Authentifizierungszertifikat, das von Ihrem REST-Client verwendet wird. Sie müssen einen Namen für das Zertifikat angeben.
- Klicken Sie auf die Schaltfläche „Bestätigen“, um die Erstellung des REST-Kontos zu bestätigen.
Am Ende dieses Schrittes wird die OAuth Client ID angezeigt, die mit diesem Konto verbunden ist. Diese Client ID hat die Form "self_service_expeditor_X" (wobei X die Ihnen zugewiesene Absendernummer ist).
Bitte bewahren Sie diese Client ID auf, da sie bei der Beantragung Ihres OAuth Access-Token verwendet wird.
Der REST-Webservice für Einbehaltungspflicht
Mit dem REST-Webservice Billeretainment 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.
Alle 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/1096 fallen, und
- paymentPreparations: Vorbereitung der Zahlungen des Lohnsteuervorabzugs auf Rechnungen. Verwenden Sie bei der Zahlung an das LSS die automatisch erzeugte Strukturierte Mitteilung.