P PowerLabExact → workflow → AI → conceptjaarrekening
Exact-integratie · oefening 3 van 10

Boekhoudgegevens ophalen en pagineren

Haal de proefbalans en alle grootboekrekeningen van het gekozen boekjaar op, inclusief paginering.

Waarom dit nodig is

Zakelijke API's geven grote datasets vaak in pagina's terug. Een flow die alleen pagina 1 verwerkt, kan een onvolledige jaarrekening maken.

Plaats in de eindoplossing

Wat draagt deze oefening bij?

Een jaarrekening kan alleen kloppen wanneer alle relevante brongegevens zijn opgehaald. Deze oefening leert waarom zakelijke API's data opdelen en hoe je voorkomt dat alleen de eerste pagina wordt verwerkt.

Wat gebeurt er technisch?

  • Queryparameters geven administrationId, jaar, pagina en paginagrootte door.
  • De proefbalans bevat samengevatte saldi; grootboekrekeningen geven de onderliggende structuur.
  • nextPage vertelt of een volgende API-aanroep nodig is.
  • De lus voegt pagina's samen tot één complete dataset.
Doen én begrijpen

Bouwstappen met uitleg

Open workflow-editor
1

Vraag de proefbalans op.

Waarom?
De proefbalans is de financiële momentopname waarop balans en winst-en-verliesrekening worden gebaseerd.
Wat moet dit opleveren?
Je ontvangt rekeningen met debet- en creditsaldi voor het gekozen boekjaar.
2

Vraag pagina 1 van de grootboekrekeningen op.

Waarom?
API's begrenzen responses om prestaties en belasting beheersbaar te houden.
Wat moet dit opleveren?
Je ontvangt een deel van de rekeningen plus metadata zoals totalItems en nextPage.
3

Herhaal zolang nextPage niet leeg is.

Waarom?
De API bepaalt wanneer de dataset compleet is; je mag niet aannemen dat één response alles bevat.
Wat moet dit opleveren?
Iedere volgende pagina wordt precies eenmaal opgehaald.
4

Voeg alle pagina-items samen.

Waarom?
Rubricering en controles moeten over de volledige administratie lopen, niet over losse deelsets.
Wat moet dit opleveren?
generalLedgerAccounts bevat alle rekeningen.
5

Vergelijk de lengte met totalItems.

Waarom?
Dit is een volledigheidscontrole: een succesvolle HTTP-status bewijst niet dat je alle pagina's hebt verwerkt.
Wat moet dit opleveren?
De telling sluit aan; anders stopt de workflow.

Wat gaat er mis als je dit overslaat?

Een flow die pagina 2 en verder vergeet kan gewoon een document produceren, maar met ontbrekende schulden, kosten of omzet. Dat is een gevaarlijke stille fout.

GET

PowerLab-endpoint

Dit endpoint bootst het deel na dat later door Exact Online, een AI-provider of de documentservice wordt geleverd. Test het eerst los, zodat je begrijpt welke invoer en uitvoer de workflow verwerkt.

https://powerlab.rmeijer.eu/api/exact/administrations/demo-bv/general-ledger-accounts?year=2025&page=1&page_size=4

Extra endpoints en scenario’s

  • https://powerlab.rmeijer.eu/api/exact/administrations/demo-bv/trial-balance?year=2025
  • https://powerlab.rmeijer.eu/api/exact/administrations/demo-bv/general-ledger-accounts?year=2025&page=2&page_size=4

Kun je uitleggen waarom?

Beantwoord deze vragen in je eigen woorden voordat je de oefening afrondt. Het doel is niet alleen de juiste nodes plaatsen, maar de ontwerpkeuzes kunnen verdedigen.

  1. Waarom is HTTP 200 geen bewijs dat de dataset compleet is?
  2. Wat gebeurt er wanneer tijdens het pagineren één call mislukt?
  3. Welke metadata zou je loggen om later aan te tonen dat alle pagina's zijn opgehaald?

Klaar wanneer

De workflow heeft één complete proefbalans én alle grootboekrekeningen, niet alleen de eerste pagina.