Microsoft Power BI + Ziggu

Microsoft Power BI lit les données de projet de Ziggu via l'API REST publique de Ziggu : les projets et tout ce qu'ils contiennent, les listes de réserves, les décisions, les tranches, les documents et les messages, actualisés selon votre propre rythme. Il n'existe pas de connecteur Power BI natif ni de fiche AppSource. Vous pointez le connecteur Web de Power BI vers api.ziggu.app/public avec un jeton d'intégration, et Ziggu reste le portail client dans lequel vos clients travaillent, tandis que Power BI devient l'endroit où votre équipe le lit.

L'essentiel

• Microsoft Power BI se connecte à Ziggu via l'API REST publique de Ziggu sur api.ziggu.app/public, pas via un connecteur natif ni une application AppSource.
• L'API de Ziggu expose 28 ressources, donc un seul tableau de bord couvre tout un portefeuille plutôt qu'un projet à la fois.
• L'API est limitée à 60 requêtes par minute tous endpoints confondus, et c'est ce qui détermine la façon de construire une actualisation à l'échelle du portefeuille.
• Les tâches et les jalons n'ont pas d'endpoint public : ces deux-là ne sont pas exploitables dans Power BI aujourd'hui.
• Le reporting lit depuis Ziggu. Rien de ce que vous construisez dans Power BI n'est réécrit.

Comment Ziggu structure un projet, et pourquoi votre modèle doit le savoir

Ziggu organise le travail en projets, et un projet peut contenir une unité ou des centaines. Une unité est la plus petite chose qu'un client possède : un appartement dans une promotion, une maison, un aménagement, une commande. Entre le projet et l'unité se trouvent des niveaux optionnels, phases, lots et bâtiments, que les grands projets utilisent et que les petits ne voient jamais.

Une agence ou un fabricant qui mène un chantier par client n'utilise aucun de ces niveaux : son projet et son unité sont la même fiche, et personne dans l'application ne voit jamais ce qu'il y a entre les deux. Un promoteur qui vend quatre-vingt-dix appartements les utilise tous.

Votre modèle Power BI doit gérer les deux, car la structure est portée par des clés étrangères et chaque niveau sauf projet et unité est optionnel. Une phase porte project_id. Un lot ajoute phase_id. Un bâtiment ajoute lot_id. Une unité porte les quatre et peut se rattacher directement à un projet avec les trois du milieu vides. Prévoyez des jointures souvent vides, et votre modèle fonctionne pour les deux types de clients.

Quelles données vous pouvez charger dans Power BI

Tout ce qui suit est lu depuis Ziggu. Rien n'est réécrit. La première colonne est le nom que votre équipe connaît dans l'application, la seconde est l'endpoint que votre développeur appelle.

‍

L'API de Ziggu accepte bel et bien l'écriture sur la plupart de ces ressources. Une connexion de reporting ne s'en sert simplement pas.

Comment connecter Microsoft Power BI à Ziggu ?

Avant de commencer : un jeton d'intégration de Ziggu, demandé via votre contact, et Power BI Desktop.

1. Demandez un jeton d'intégration à Ziggu. Les jetons sont émis par organisation, pas générés dans l'application.
2. Dans Power BI Desktop, choisissez Obtenir les données, puis Web, puis Avancé.
3. Saisissez l'endpoint voulu sous l'URL de base api.ziggu.app/public, par exemple /projects, et ajoutez l'en-tête de requête ziggu-integration-token. Le format exact figure dans la documentation de l'API Ziggu.
4. Dans Power Query, dépliez data puis attributes en colonnes et définissez les types. Les réponses suivent la spécification JSON:API, donc un import brut donne une seule colonne nommée data tant que vous ne la dépliez pas.
5. Répétez par endpoint, puis joignez les tables sur les champs id décrits plus haut.
6. Publiez vers le service Power BI et définissez un rythme d'actualisation. Lisez d'abord les limites ci-dessous.

Un premier modèle fonctionnel prend un après-midi à quelqu'un qui a déjà construit un modèle Power Query.

Où les équipes l'utilisent

Mesurer le délai de validation sur tous les projets

Les décisions et les options proposées vivent par projet dans Ziggu. Chargées dans Power BI, elles deviennent un chiffre par projet et une tendance par trimestre : combien de temps un client met à valider, et où un projet cale. C'est une vue sur tout le carnet que personne n'obtient dans l'application projet par projet. Voir Décisions et approbations.

Mesurer ce qui reste ouvert, et où

Les listes de réserves portent les points, leur catégorie et leur statut. Dans Power BI, cela devient un compte par projet, par phase et par partenaire, plus un rapport d'ancienneté sur ce qui reste ouvert après la réception. Voir Rapports.

Suivre ce qui a été facturé sur tout le portefeuille

Les tranches donnent ce qui a été facturé et, là où un projet contient de nombreuses unités, la part affectée à chacune. Combiné à la structure du projet, cela répond à quelles parties d'un portefeuille ont été facturées et lesquelles traînent, sans rien exporter.

Ce que Microsoft Power BI et Ziggu ne font pas

• Il n'existe pas de connecteur Power BI natif pour Ziggu ni de fiche dans Microsoft AppSource. Vous construisez la connexion dans Power Query contre l'API REST.
• Les tâches et les jalons n'ont pas d'endpoint public. Vous ne pouvez pas reporter sur l'avancement des tâches ni sur la chronologie des jalons via l'API aujourd'hui.
• L'API est limitée à 60 requêtes par minute tous endpoints confondus. Une actualisation à l'échelle du portefeuille doit être étalée et construite comme un chargement incrémental, pas comme un rechargement complet à chaque passage.
• Il n'y a pas de webhooks. Power BI interroge selon un rythme, Ziggu ne pousse pas de changement.
• L'actualisation planifiée dans le service Power BI contre une source Web avec un en-tête personnalisé exige de définir les identifiants dans les paramètres du jeu de données, et peut nécessiter une passerelle de données locale selon votre tenant. Testez l'actualisation avant de compter dessus.
• La connexion lit. Rien de ce qui est saisi dans Power BI n'atteint Ziggu.

Questions sur l'intégration Power BI

Ziggu a-t-il un connecteur Power BI ?

Non. Ziggu expose une API REST publique sur api.ziggu.app/public et Power BI la lit via le connecteur Web dans Power Query. Il n'y a ni connecteur certifié ni fiche AppSource.

Sur quelles données Ziggu puis-je reporter dans Power BI ?

Les projets et tout ce qu'ils contiennent, les clients et partenaires, les listes de réserves, les décisions, les tranches, les documents et les messages. Les tâches et les jalons ne sont pas disponibles.

Nous menons un projet par client, pas des projets à nombreuses unités. Cela s'applique-t-il quand même ?

Oui. Ziggu enregistre un projet et une unité pour chaque client. Si vous ne divisez jamais un projet, les deux sont la même fiche et les niveaux intermédiaires restent vides.

Faut-il un plan Ziggu particulier pour accéder à l'API ?

Non. Ziggu émet un jeton d'intégration par organisation, sur demande.

À quelle fréquence les données s'actualisent-elles ?

Aussi souvent que vous le planifiez dans Power BI, dans la limite de 60 requêtes par minute. Ziggu ne pousse pas, Power BI tire.

Puis-je combiner les données Ziggu avec notre CRM ou ERP dans un même rapport ?

Oui, et c'est généralement l'intérêt. Ziggu porte la face client du projet que Dynamics 365, Exact Online ou Salesforce n'ont pas.

Dernière vérification : 28 août 2026, contre la spécification de l'API publique de Ziggu.