Webservices
Les Webservices permettent aux utilisateurs professionnels d’accéder aux données des comptes annuels déposés. Ces Webservices sont au nombre de cinq. Au moment de son enregistrement, l’utilisateur indique le type de service en ligne pour lequel il opte.
Cinq types de Webservices
Les cinq types de Webservices sont les suivants :
1. Query authentic data/ Sélection de données authentiques
Le produit permet de demander des données actuelles et historiques basées sur le numéro d’entreprise d’une personne juridique (entreprise) spécifique ou sur le numéro de référence du dépôt.
2. Daily extract authentic data/ Extraction quotidienne de données authentiques
Ce produit permet d’obtenir, sur une base quotidienne et pour une période limitée, toutes les références et tous les documents des dépôts acceptés et publiés par la BNB pour un jour précis sous la forme de jeux de données (fichiers zip).
3. Improved data/ Données améliorées
Ce produit permet de récupérer, sur une base quotidienne et pour une période limitée, toutes les informations améliorées par la BNB sous la forme de jeux de données (fichier zip). Il permet également de demander la liste des références des dépôts améliorés par numéro BCE et d’obtenir les documents JSON associés.
4. Authentic Archive Data/ Données authentiques historiques
Ce produit permet d’obtenir les références et documents des dépôts acceptés et publiés par la BNB à une date donnée pour les trois dernières années.
5. Improved Archive Data/ Données améliorées historiques
Ce produit permet d’obtenir toutes les références et les documents des dépôts dans lesquels la BNB a apporté des améliorations au cours des trois dernières années.
Restrictions
Les restrictions suivantes s’appliquent aux Webservices.
- Les utilisateurs n’ont accès qu’aux références et documents des dépôts éligibles pour la publication. Les Webservices ne donnent donc pas accès aux dépôts des bilans sociaux isolés d’entreprises qui ne sont pas tenues de déposer des comptes annuels.
- Les documents XBRL ont été introduits plus tard que les PDF et ne sont donc pas disponibles pour tous les anciens dépôts.
- Les documents JSON basés sur des dépôts XBRL n’ont été introduits que le 4 avril 2022 et ne sont donc pas disponibles pour les dépôts antérieurs à cette date.
- L’archive des fichiers JSON pour les données authentiques (Authentic Data) et les données améliorées (Improved Data) est constituée depuis le 4 avril 2022 et ne contient que les données des trois dernières années.
Plus d’informations
Vous trouverez de plus amples informations sur les Webservices en suivant les liens ci-dessous :
- Les conditions d’abonnement
- La documentation technique (disponible uniquement en anglais)
- Une présentation PowerPoint
- Les 'Webservices en environnement de test', où vous pouvez explorer les produits. Pour 'Improved Data', nous avons fourni un ensemble de données gratuites dans l’environnement de test pour le mois de décembre 2022.
Procédure d’accès
Pour pouvoir accéder aux Webservices, les nouveaux utilisateurs doivent suivre plusieurs étapes :
- Inscription administrative : bon de commande ou formulaire en ligne à compléter.
- Les nouveaux utilisateurs reçoivent un identifiant (CLIENT_ID), qu’ils doivent transmettre à l’utilisateur technique.
- L’utilisateur technique doit créer un profil sur le portail des développeurs https://developer.cbso.nbb.be
- Après vérification du CLIENT_ID, l’équipe du support technique de la Banque nationale de Belgique approuvera les demandes et identifiera les produits sur la base de l’enregistrement administratif et du CLIENT_ID. L’utilisateur technique trouvera le CLIENT_ID dans les détails de l’abonnement. Pour les produits payants (Improved Data/Improved Archived Data), cela ne se fera qu’après réception du paiement.
Documentation technique et pratique
Documentation technique
Vous trouverez ci-dessous les documents utiles pour pouvoir obtenir les accès techniques aux Webservices et pour paramétrer une application cliente.
Aperçu :
- Technical guide (EN) : description de la procédure d’accès aux webservices et des paramètres à utiliser pour interagir avec les Webservices.
- Developer portal : portail des utilisateurs des Webservices pour l’obtention des clés techniques d’accès et la description des opérations des Webservices (API) dans différents formats (openAPI, Swagger, etc.).
Portail pour l’environnement de test : https://developer.uat2.cbso.nbb.be/ - Description technique des représentations de données retournées par les opérations/accountingData
- Listes des codes
Infographie Webservices – situation 1 avril 2023
