Webservices
Über Webservices können professionelle Nutzer auf Daten aus den hinterlegten Jahresabschlüssen zugreifen. Insgesamt haben sie die Wahl zwischen fünf Arten von Webservices. Bei der Anmeldung gibt der Nutzer an, welche Art von Webservice er wählt.
Fünf Arten von Webservices
Die fünf Arten von Webservices sind:
- Authentic data query / Abfrage von authentischen Daten
Das Produkt ermöglicht den Abruf aktueller und historischer Daten auf der Grundlage der ZDU-Nummer einer bestimmten juristischen Person (Unternehmen) oder des Aktenzeichens der Hinterlegung.
- Authentic data daily extract / Täglicher Auszug authentischer Daten
Das Produkt ermöglicht es, für einen begrenzten Zeitraum alle Referenzdaten und Dokumente der von der Nationalbank angenommenen und veröffentlichten Jahresabschlüsse für einen bestimmten Tag in Form von Datensätzen (ZIP-Dateien) zu erhalten.
- Improved data / Verbesserte Daten
Das Produkt ermöglicht es, alle verbesserten Informationen der Nationalbank in Form von Datensätzen (ZIP-Datei) auf Tagesbasis für einen begrenzten Zeitraum abzurufen. Außerdem ermöglicht es das Produkt, die Liste der Referenzen der verbesserten Hinterlegungen nach ZDU-Nummer abzurufen und die damit verbundenen JSON-Dokumente zu erhalten.
- Authentic data archive / Historische authentische Daten
Mit diesem Produkt können Sie zu einem bestimmten Datum die Referenzen und Dokumente der von der Nationalbank angenommenen und veröffentlichten Hinterlegungen der letzten drei Jahre abrufen.
- Improved data archive / Verbesserte historische Daten
Das Produkt ermöglicht es, alle Referenzen und Dokumente von Hinterlegungen zu erhalten, bei denen die Nationalbank in den letzten drei Jahren Verbesserungen vorgenommen hat.
Einschränkungen
Die Webservices haben einige Einschränkungen:
- Die Nutzer können nur auf Referenzen und Dokumente von Hinterlegungen zugreifen, die zur Veröffentlichung zugelassen sind. Hinterlegungen von gesonderten Sozialbilanzen von Unternehmen, die keinen Jahresabschluss hinterlegen müssen, sind daher nicht über die Webservices verfügbar.
- XBRL-Dokumente wurden erst später als PDF eingeführt und sind daher nicht für alle älteren Hinterlegungen verfügbar.
- JSON-Dokumente auf der Grundlage von XBRL-Anmeldungen wurden am 4. April 2022 eingeführt und sind daher für ältere Hinterlegungen nicht verfügbar.
- Das Archiv der JSON-Dateien für „Authentic Data“ und „Improved Data“ wird seit dem 4. April 2022 aufgebaut und wird letztendlich nur die Daten der letzten drei Jahre enthalten.
Weitere Informationen
Weitere Informationen zu den Webservices finden Sie weiterhin unter:
- Abonnementbedingungen (verfügbar in Niederländisch und Französisch)
- technischer Leitfaden (nur in englischer Sprache verfügbar)
- PowerPoint-Präsentation (nur in englischer Sprache verfügbar)
- „Webservices in Testumgebung“, wo Sie die Produkte entdecken können. Für „Improved Data“ haben wir in der Testumgebung einen kostenlosen Datensatz für den Monat Dezember 2022 bereitgestellt.
Zugangsverfahren
Um Zugang zu den Webservices zu erhalten, müssen neue Nutzer eine Reihe von Schritten durchführen:
- Administrative Anmeldung: Ausfüllen eines Bestellformulars (verfügbar in Niederländisch und Französisch) oder eines Webformulars.
- Neue Nutzer erhalten eine CLIENT_ID, die sie an den technischen Nutzer weitergeben müssen.
- Der technische Nutzer muss ein Profil auf dem Entwicklerportal https://developer.cbso.nbb.be
- Nach der Überprüfung genehmigt das Technical Support Team der Belgischen Nationalbank die Anträge und identifiziert die Produkte anhand der Verwaltungsunterlagen und der CLIENT_ID. Der technische Nutzer findet die CLIENT_ID in den Abonnementdetails. Bei kostenpflichtigen Produkten (Improved Data/Improved Archived Data) erfolgt dies erst nach Zahlungseingang.
Technische und praktische Dokumentation
Technische Dokumentation
Nachfolgend finden Sie nützliche Dokumente, um die technischen Zugänge zu den Webservices zu erhalten und eine Client-Anwendung zu konfigurieren.
Ein Überblick:
- Technischer Leitfaden (EN): Beschreibung des Verfahrens für den Zugriff auf die Webservices und der Parameter, die für die Interaktion mit den Webservices zu verwenden sind.
- Entwicklerportal: Portal für Nutzer der Webservices, um technische Schlüssel für den Zugang und die Beschreibung der Webservice-Operationen (API) in verschiedenen Formaten (openAPI, Swagger usw.) zu erhalten.
Portal für die Testumgebung: https://developer.uat2.cbso.nbb.be/ - Technische Beschreibung der von operations/accountingData zurückgegebenen Datenansichten
- Codelisten
Infografik Webservices – Stand 1. April 2023
