Webservices

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 :

Procédure d’accès

Pour pouvoir accéder aux Webservices, les nouveaux utilisateurs doivent suivre plusieurs étapes :

  1. Inscription administrative : bon de commande ou formulaire en ligne à compléter.
  2. Les nouveaux utilisateurs reçoivent un identifiant (CLIENT_ID), qu’ils doivent transmettre à l’utilisateur technique.
  3. L’utilisateur technique doit créer un profil sur le portail des développeurs https://developer.cbso.nbb.be
  4. 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

webservices

Salut, je m’appelle Cybo, comment puis-je vous aider aujourd’hui?

Cybo