Démarrage

Cette section détaille les étapes techniques pour activer le partage de données et commencer à les explorer. Déjà connecté ? Jetez un œil aux données disponibles.

Sommaire

Scopes
Authentification
Disponibilité des données
Options de Connexion
Quotas
Schemas
Performances des requêtes

Scopes

Avertissement

À compter de janvier 2024, les accès en tant qu’utilisateur “cabinet comptable” ou “entreprise” sont obsolètes. Ils ont été remplacés par des permissions plus granulaires liées aux permissions de l’utilisateur sur Pennylane.

Tout nouvel accès créé depuis janvier 2024 obéit à ce nouveau modèle. Si vous utilisiez un accès cabinet ou entreprise jusqu’à présent, vous pouvez simplement réactiver le partage des données via vos paramètres de connectivité, et remplacer les anciens identifiants par les nouveaux dans les outils que vous utilisez. Sans aucune interruption de service ou perte de données, vos nouveaux identifiants vous donneront accès à l’ensemble des entreprises sur lesquelles vous avez suffisamment de droits dans Pennylane.

En d’autres termes, vous ne pourrez plus accéder aux données pour lesquelles vous n’avez pas les permissions nécessaires dans Pennylane.

Les identifiants permettant de se connecter au partage de données reflètent les permissions de l’utilisateur sur Pennylane.

Ces accès se traduisent à deux niveaux :

les utilisateurs comptables et dirigeants ont des accès différents aux schemas de données, ces accès sont documentés sur la page dédiée à chaque schema;
pour chaque requête, bien que la structure de la réponse soit la même, les données renvoyées varieront en fonction des permissions de l’utilisateur dans Pennylane :
- un administrateur ou comptable interne d’une ou plusieurs entreprises peut accéder à l’ensemble des données de ces entreprises,
- un administrateur d’un ou plusieurs cabinets peut accéder à l’ensemble des données de ces cabinets,
- un utilisateur comptable d’une ou plusieurs entreprises peut accéder à l’ensemble des données de ces entreprises.

Important

Le partage de données est une intégration avancée disponible uniquement avec certains de nos plans. En savoir plus sur les plans ici.

Authentification

Indépendamment de votre scope et de la façon dont vous prévoyez de vous connecter, la première étape consiste à activer le partage de données sur Pennylane:

en tant qu’utilisateur dirigeant, allez dans les paramètres de connectivité, sous l’onglet partage de données;
en tant qu’utilisateur comptable, allez dans les paramètres de votre cabinet, sous l’onglet partage de données.

Lors de l’activation, vous recevrez les informations suivantes, qui seront nécessaires pour vous connecter :

Serveur: L'URL du serveur
Port: Combiné à l'URL, il permet d'atteindre le serveur
Base de données: Emplacement des données à l'intérieur du data warehouse
Nom d'utilisateur: Identifiant unique de l'utilisateur; votre scope et vos permissions y sont liés
Mot de passe: Mot de passe généré aléatoirement nécessaire à l'authentification de l'utilisateur

Ne partagez pas ces informations sensibles avec qui que ce soit. Vous avez le moindre doute ? N’hésitez pas à réinitialiser votre mot de passe depuis la même page : cela rendra l’ancien mot de passe obsolète et empêchera toute connexion via celui-ci.

Dans la plupart des cas, une seule connexion suffit : elle renvoie toutes les entreprises auxquelles vous avez accès dans Pennylane et qui se trouvent sur cet entrepôt. Certaines entreprises — notamment celles gérées avec BDO — sont hébergées sur un entrepôt dédié, avec une URL de serveur différente. Une connexion ne renvoie jamais les entreprises de l’autre entrepôt. Si vous avez besoin des deux, configurez deux connexions dans votre outil de BI ou d’ETL (même identifiant, serveur différent). Voir la FAQ.

🔒 Des mots de passe forts, uniques et aléatoires sont générés automatiquement pour protéger vos données. Nous ne les stockons pas et nous ne les affichons qu’une seule fois, au moment de leur création.

Disponibilité des données

Après avoir activé le partage de données, veuillez noter qu’il peut y avoir un délai de quelques heures avant que vos données ne deviennent accessibles. Ce délai est normal et se produit parce que vos identifiants doivent être propagés dans nos systèmes.

Options de Connexion

Techniquement, le partage de données est alimenté par un data warehouse auquel les utilisateurs se connectent et effectuent des requêtes. Les data warehouses sont une technologie robuste et répandue, soutenue par un écosystème actif d’outils qui rendent la connexion simple. Nous avons listé ci-dessous certaines des options les plus courantes.

Outils de Business Intelligence

Les outils de Business Intelligence (BI) sont probablement le moyen le plus rapide de se connecter et d’exploiter vos données, et ne nécessitent généralement aucune configuration technique avancée.

Si vous ne savez pas par où commencer, vous pouvez trouver une liste non exhaustive d’outils sur notre site web. Nous vous proposons également un processus détaillé pour se connecter avec Power BI, cette vidéo va même au-delà en construisant un tableau de bord de reporting à partir de zéro.

Outils ETL

Vous voudrez peut-être importer des données dans votre propre système, par exemple pour les joindre à d’autres sources ou pour effectuer des analyses plus complexes. Nous vous recommandons de vous appuyer sur des outils ETL (Extract-Transform-Load) lorsque cela est possible pour faciliter ce processus. Quelques exemples :

Hevo

Drivers ODBC/JDBC

Il est possible de se connecter directement au data warehouse en utilisant un driver ODBC ou JDBC. Cela peut être utile si vous souhaitez utiliser un outil qui ne prend pas en charge les options ci-dessus.

⚠️ Attention

Pour une expérience optimale, nous ne recommandons pas cette option de plus bas niveau, voir quotas ci-dessous.

Quotas

Afin de garantir des performances stables et prévisibles, nous imposons quelques limitations lorsque les utilisateurs se connectent et récupèrent des données :

le nombre de connexions parallèles est limité,
les sessions inactives sont terminées après un certain temps,
des contraintes de ressources sont appliquées pour les requêtes extrêmement lourdes ou lentes.

☝️ Un mot de l’équipe juridique

Plus généralement, le client s’engage à faire une utilisation raisonnable de l’entrepôt de données, conformément à ses besoins et pour les seules finalités du contrat. Il s’interdit toute utilisation anormale, abusive ou frauduleuse, ainsi que, de manière générale, toute utilisation qui serait en conflit avec les lois et règlements en vigueur.

Schemas

Les jeux de données disponibles sont regroupés en schemas cohérents, et les permissions d’accès sont définies au niveau du schema. En d’autres termes, si vous avez accès à un schema donné, vous serez autorisé à interroger n’importe quel table sous ce schema.

La documentation des schemas et des tables disponibles sur ce site web est générée automatiquement. Toute mise à jour de la documentation sera suivie ou précédée de modifications correspondantes dans les données elles-mêmes.

Performances des requêtes

Chaque requête sur une table qui a company_id doit filtrer company_id. C’est la première colonne de la clé de tri. Sans ce filtre, ClickHouse lit la table entière.

Une flotte d’entreprises se lit une société à la fois, ou par paquets de company_id. Pas en une seule requête sans filtre.

SELECT id, date, debit, credit
FROM pennylane.general_ledger
WHERE company_id = 123456
  AND date >= '2026-01-01'

SELECT id, date, debit, credit
FROM pennylane.analytical_ledger
WHERE company_id IN (123456, 123457, 123458)
  AND date >= '2026-01-01'

La page de chaque table donne la clé de tri, dans l’ordre, et l’index secondaire quand il existe. L’index sur date du grand livre aide un peu après company_id. Il ne le remplace pas.

Sur companies et companies_identification, la clé est id.

Ne faites pas SELECT *. Listez les colonnes utiles.