Comment utiliser l’API Papers avec Power BI pour automatiser la récupération des données financières et juridiques des entreprises

(écrit par un humain)

Dans cet article, nous allons voir pas à pas comment connecter l’API de Pappers à Power BI pour collecter automatiquement des informations financières et juridiques sur les entreprises françaises.

L’objectif : éviter les exports manuels et gagner du temps dans la mise à jour de vos tableaux de bord. Nous aborderons les concepts essentiels, le vocabulaire technique, les prérequis et un tutoriel pour mettre ce flux de données en place.

Qu’est-ce qu’une API et pourquoi l’utiliser ?

Une API (Application Programming Interface) est une interface qui permet à différentes applications de communiquer entre elles. En résumé c’est un pont entre deux applications. Elle permet à vos outils (ici Power BI) d’interroger directement une base de données externe (comme celle de Pappers) et d’en récupérer les informations de manière automatique.

Autrement dit, plus besoin de télécharger un fichier à la main à chaque mise à jour :  l’API fait le lien pour vous.

Quelques notions à connaître avant de commencer

Pour comprendre le fonctionnement de l’API Pappers, il est important de connaître quelques termes essentiels :

• Jeton : C’est un droit d’accès à l’API. Chaque action ou récupération de données peut consommer un jeton selon votre abonnement. Si vous avez plusieurs jetons, vous pouvez effectuer plusieurs requêtes ; sinon, l’accès sera limité.
• Token : Il s’agit de votre clé secrète pour authentifier les requêtes vers l’API. Il ne doit pas être partagé publiquement, surtout si les données sont sensibles.
• JSON : Format standard de sortie des données lorsqu’une requête API est exécutée.
• Swagger : Documentation technique officielle qui permet de comprendre comment effectuer les appels API.
• Call API : Une requête envoyée à l’API pour récupérer des données. Chaque call peut consommer un jeton selon la structure de votre abonnement.

Qu’est-ce que Pappers?

Pappers est une plateforme web qui centralise les données juridiques et financières sur les entreprises françaises, un peu comme Société.com. Ces données proviennent principalement du greffe des tribunaux de commerce (via Infogreffe). On peut y retrouver :

• L’adresse, la date de création de l’entreprise et la forme juridique
• Les informations financières telles que chiffre d’affaires, marge brute, valeur ajoutée, et excédent brut d’exploitation
• La possibilité de consulter certains bilans comptables sur plusieurs années, selon la publication par l’entreprise

Certaines sociétés choisissent de ne pas rendre leurs comptes publics – il est donc normal que certaines années soient absentes.

Pré-requis pour utiliser l’API Pappers avec Power BI

Pour exploiter pleinement l’API Papers, plusieurs prérequis sont nécessaires :

1. Connexion Internet fiable
2. Compte Papers actif : La création du compte est gratuite et inclut généralement un quota de 50 jetons mensuels pour accéder aux données.
3. Compétences sur Power BI, notamment sur Power Query, la gestion des paramètres et l’utilisation de fonctions personnalisées pour automatiser la récupération de données.

Comprendre la requête API Pappers

Une requête API sur Pappers ressemble à une URL structurée. Par exemple :

https://api.pappers.fr/v1/entreprise?token=VOTRE_TOKEN&siren=123456789

L’URL se compose de plusieurs parties :

1. URL racine : La base de l’API (https://apipapers.fr/v1)
2. Endpoint : La requête spécifique (/entreprise)
3. Token : Clé d’accès individuelle
4. Siren : Identifiant unique de l’entreprise

Pour automatiser votre flux, il est important que ces deux paramètres (token et siren) soient variables. Ainsi, vous pouvez interroger plusieurs entreprises à partir d’un simple tableau Excel ou d’une liste, tout en changeant facilement de jeton si nécessaire.

Intégration dans Power BI : pas à pas

1. Obtenir l’URL de requête depuis la documentation ou la console Papers.

     2. Créer des paramètres dans Power Query :

• token : valeur correspondant à votre clé secrète
• siren : identifiant de l’entreprise

    3. Découper l’URL dans Power Query pour séparer les parties fixes et variables (token, siren).

    4. Récupérer les données depuis le web en utilisant le connecteur Power BI "Nouvelle source > Web" et en mode avancé.

    5. Convertir la liste JSON en table pour exploiter facilement les données dans Power BI.

    6. Renommer et nettoyer la requête pour constituer un modèle de base de données d’entreprise.

Création d’une fonction personnalisée

Pour automatiser la collecte sur plusieurs entreprises :

1. Créer une fonction Power Query à partir du modèle d’entreprise.

      2. Appeler cette fonction sur un fichier Excel contenant les sirens des entreprises à analyser.

      3. Variabiliser les paramètres pour récupérer automatiquement les bilans financiers et autres informations pour l’ensemble des entreprises listées.

      4. Limiter le nombre d’entreprises si nécessaire, avec un paramètre NB_entreprises pour sélectionner les premières lignes du fichier source.

Exemple d’application

• Un fichier Excel contient 300 entreprises du secteur de la formation.
• Un paramètre NB_entreprises est défini à 50.
• La fonction personnalisée get_entreprise applique le modèle sur les 50 premières entreprises, récupérant pour chacune : chiffre d’affaires, marge brute, excédent brut d’exploitation, etc.

• La base de données finale est ensuite chargée dans Power BI pour créer des visualisations dynamiques et interactives.

Attention : Chaque chargement ou actualisation de la base de données consomme des jetons selon le nombre d’entreprises interrogées. Par exemple, si vous récupérez les bilans de 10 entreprises, 10 jetons sont consommés.

Avantages de cette approche

• Automatisation complète : plus besoin de téléchargements manuels.
• Scalabilité : possibilité de traiter des centaines d’entreprises avec un seul modèle.
• Flexibilité : modification facile des tokens et des identifiants d’entreprise.
• Compatibilité Power BI : toutes les données sont immédiatement prêtes à l’analyse et aux visualisations.

Conclusion

En liant l’API de Pappers à Power BI, vous créez un système de veille automatisée simple à maintenir. Cette méthode vous permet d’obtenir un suivi actualisé de la situation financière et juridique de vos entreprises cibles, tout en alimentant vos rapports Power BI de manière fluide et dynamique. Si vous souhaitez en apprendre plus sur l’API de Pappers et son utilisation (https://www.youtube.com/watch?v=lcZru5vNBlk) n’hésitez pas à nous contacter.