Microsoft Power BI + Ziggu

Microsoft Power BI leest projectdata uit Ziggu via de publieke REST API van Ziggu: projecten en alles wat erin zit, puntenlijsten, beslissingen, schijven, documenten en berichten, ververst op je eigen schema. Er is geen native Power BI-connector en geen AppSource-listing. Je richt de Web-connector van Power BI op api.ziggu.app/public met een integratietoken, en Ziggu blijft het klantportaal waar je klanten in werken terwijl Power BI de plek wordt waar je team het leest.

In het kort

• Microsoft Power BI koppelt aan Ziggu via de publieke REST API van Ziggu op api.ziggu.app/public, niet via een native connector of een AppSource-app.
• De Ziggu-API stelt 28 resources beschikbaar, dus één dashboard dekt een hele portefeuille in plaats van één project per keer.
• De API is beperkt tot 60 requests per minuut over alle endpoints samen, en dat bepaalt hoe een verversing over de hele portefeuille gebouwd moet worden.
• Taken en mijlpalen hebben geen publiek endpoint, dus die twee zijn vandaag niet rapporteerbaar in Power BI.
• Rapporteren leest uit Ziggu. Wat je in Power BI bouwt, schrijft niets terug.

Hoe Ziggu een project structureert, en waarom je model dat moet weten

Ziggu organiseert werk in projecten, en een project kan één unit bevatten of honderden. Een unit is het kleinste ding dat één klant heeft: één appartement in een ontwikkeling, één woning, één inrichting, één order. Tussen project en unit zitten optionele niveaus, fases en loten en gebouwen, die grote projecten gebruiken en kleine nooit te zien krijgen.

Een bureau of een producent met één opdracht per klant gebruikt geen van die niveaus: hun project en hun unit zijn hetzelfde record, en niemand in de app ziet ooit wat ertussen zit. Een projectontwikkelaar die negentig appartementen verkoopt, gebruikt ze allemaal.

Je Power BI-model moet allebei aankunnen, want de structuur wordt gedragen door foreign keys en elk niveau behalve project en unit is optioneel. Een fase draagt project_id. Een lot voegt phase_id toe. Een gebouw voegt lot_id toe. Een unit draagt alle vier en kan rechtstreeks aan een project hangen met de middelste drie leeg. Reken op joins die vaak leeg zijn, en je model werkt voor allebei de soorten klanten.

Welke data je in Power BI kan binnenhalen

Alles hieronder wordt uit Ziggu gelezen. Er wordt niets teruggeschreven. De eerste kolom is de naam die je team uit de app kent, de tweede is het endpoint dat je ontwikkelaar effectief aanroept.

‍

De Ziggu-API aanvaardt op de meeste hiervan wel degelijk schrijfacties. Een rapporteringskoppeling gebruikt die eenvoudigweg niet.

Hoe koppel je Microsoft Power BI aan Ziggu?

Voor je begint: een integratietoken van Ziggu, aangevraagd via je accountcontact, en Power BI Desktop.

1. Vraag een integratietoken aan bij Ziggu. Tokens worden per organisatie uitgegeven, niet in de app gegenereerd.
2. Kies in Power BI Desktop voor Gegevens ophalen, dan Web, dan Geavanceerd.
3. Vul het endpoint in dat je wil, onder de basis-URL api.ziggu.app/public, bijvoorbeeld /projects, en voeg de request header ziggu-integration-token toe. Het exacte formaat staat in de Ziggu API-documentatie.
4. Klap in Power Query data en dan attributes uit naar kolommen en stel de datatypes in. Antwoorden volgen de JSON:API-specificatie, dus een platte import geeft je één kolom die data heet tot je ze uitklapt.
5. Herhaal per endpoint en join de tabellen daarna op de id-velden die hierboven beschreven staan.
6. Publiceer naar de Power BI Service en stel een verversingsschema in. Lees eerst de beperkingen hieronder.

Een eerste werkend model kost een namiddag voor iemand die al eens een Power Query-model gebouwd heeft.

Waar teams het voor gebruiken

Rapporteren over doorlooptijd van goedkeuringen, over alle projecten heen

Beslissingen en de opties die ertegenover stonden, zitten per project in Ziggu. In Power BI worden ze één cijfer per project en één trend per kwartaal: hoe lang een klant erover doet om te tekenen, en waar een project stilvalt. Dat is een zicht over je hele orderboek dat niemand krijgt door in de app project per project te kijken. Zie Beslissingen en goedkeuringen.

Meten hoeveel punten er nog openstaan, en waar

Puntenlijsten dragen de punten, hun categorie en hun status. In Power BI wordt dat een telling per project, per fase en per partner, plus een ouderdomsrapport van wat na oplevering nog openstaat. Zie Verslagen.

Volgen wat er over de hele portefeuille gefactureerd is

Schijven geven wat er gefactureerd is, en waar één project veel units bevat, het aandeel dat aan elke unit toegewezen is. Gecombineerd met de projectstructuur beantwoordt dat welke delen van een portefeuille gefactureerd zijn en welke achterlopen, zonder iets te exporteren.

Wat Microsoft Power BI en Ziggu niet doen

• Er is geen native Power BI-connector voor Ziggu en geen listing in Microsoft AppSource. Je bouwt de koppeling in Power Query tegen de REST API.
• Taken en mijlpalen hebben geen publiek endpoint. Je kan vandaag niet rapporteren over afgewerkte taken of de mijlpaaltijdlijn via de API.
• De API is beperkt tot 60 requests per minuut over alle endpoints samen. Een verversing over de hele portefeuille moet gedoseerd worden en als incrementele lading gebouwd, niet als een volledige ophaling bij elk schema.
• Er zijn geen webhooks. Power BI pollt op een schema, Ziggu duwt geen wijziging.
• Geplande verversing in de Power BI Service tegen een Web-bron met een custom request header vraagt dat de credentials in de datasetinstellingen gezet worden, en kan afhankelijk van je tenant een on-premises data gateway vragen. Test de verversing voor je erop rekent.
• De koppeling leest. Wat in Power BI ingevoerd wordt, bereikt Ziggu niet.

Vragen over de Power BI-integratie

Heeft Ziggu een Power BI-connector?

Nee. Ziggu stelt een publieke REST API beschikbaar op api.ziggu.app/public en Power BI leest die via de Web-connector in Power Query. Er is geen gecertificeerde connector en geen AppSource-listing.

Over welke Ziggu-data kan ik rapporteren in Power BI?

Projecten en alles wat erin zit, klanten en partners, puntenlijsten, beslissingen, schijven, documenten en berichten. Taken en mijlpalen zijn niet beschikbaar.

Wij draaien één project per klant, geen projecten met veel units. Geldt dit dan ook?

Ja. Ziggu registreert voor elke klant een project en een unit. Splits je een project nooit op, dan zijn die twee hetzelfde record en blijven de tussenniveaus leeg.

Heb ik een specifiek Ziggu-plan nodig voor API-toegang?

Nee. Ziggu geeft op aanvraag een integratietoken uit per organisatie.

Hoe vaak ververst de data?

Zo vaak als je het in Power BI inplant, binnen de limiet van 60 requests per minuut. Ziggu duwt niet, Power BI haalt op.

Kan ik Ziggu-data met ons CRM of ERP in één rapport combineren?

Ja, en dat is meestal net het punt. Ziggu bevat de klantgerichte kant van het project die Dynamics 365, Exact Online of Salesforce niet hebben.

Laatst nagekeken: 28 augustus 2026, tegen de publieke API-specificatie van Ziggu.