Oefening 8 · Analyse

Vergelijk meerdere boekjaren

Haal twee boekjaren op en bereken absolute en procentuele verschillen.

Waarom dit nodig is

Een jaarrekening en toelichting krijgen betekenis door vergelijking. Een omzetstijging van EUR 50.000 kan groot of klein zijn afhankelijk van het vorige jaar.

Plaats in de eindoplossing

Wat draagt deze oefening bij?

De AI krijgt later alleen gecontroleerde vergelijkingscijfers, zodat hij trends kan toelichten zonder zelf bedragen te verzinnen.

Wat gebeurt er technisch?

  • Dezelfde division wordt tweemaal opgevraagd met verschillende jaren.
  • Data wordt samengevoegd op een stabiele rubrieksleutel.
  • Procentuele verandering vereist aparte behandeling wanneer de vorige waarde nul is.
Doen én begrijpen

Bouwstappen met uitleg

Open workflow-editor
1

Bepaal previousYear uit AvailableYears in plaats van 2024 vast in te typen.

Waarom?
Als financialYear 2024 is, moet de vergelijking automatisch 2023 kunnen pakken.
Wat moet dit opleveren?
Een previousYear dat dynamisch van klant en gekozen jaar afhangt.
2

Haal ReportingBalance voor previousYear en financialYear op met targetDivision.

Waarom?
Beide datasets moeten exact dezelfde klantcontext gebruiken.
Wat moet dit opleveren?
Twee bronsets met dezelfde targetDivision.
3

Rubriceer beide jaren identiek en bereken variance en variancePercent.

Waarom?
Een vergelijking is alleen betrouwbaar als dezelfde definities aan beide kanten gelden.
Wat moet dit opleveren?
Een vergelijkbare tabel per rubriek.
4

Test dezelfde flow met minimaal drie klant-jaarcombinaties.

Waarom?
Hiermee bewijs je dat de vergelijking niet op 2024/2025 is vastgebakken.
Wat moet dit opleveren?
Verschillende previousYear/currentYear-paren zonder nodewijzigingen.

Wat gaat er mis als je dit overslaat?

De AI kan een verandering verkeerd kwalificeren of cijfers uit verschillende rubriceringen vergelijken.

GET

PowerLab-endpoint

Dit endpoint bootst het relevante deel van Exact Online, de AI-provider of de documentservice na. De /api/v1-routes gebruiken de Division-parameter en Exact-achtige paginering, maar PowerLab is geen volledige Exact-emulator.

https://powerlab.rmeijer.eu/api/data/table?division=101001&year=2025&dataset=year-comparison

Extra endpoints en scenario’s

  • https://powerlab.rmeijer.eu/api/data/table?division=101003&year=2025&dataset=year-comparison
  • https://powerlab.rmeijer.eu/api/data/table?division=101004&year=2025&dataset=year-comparison
Speel ermee

Varianten om zelf te proberen

Open vrije speeltuin

De bouwstappen hierboven zijn één mogelijke route, geen verplichte oplossing. Als jouw workflow hetzelfde resultaat veilig bereikt, is dat prima.

  • 101001/2025 vergelijkt met 2024.
  • 101001/2024 vergelijkt met 2023.
  • 101003/2024 vergelijkt met 2023.
Vrije uitdaging

Bepaal wat je flow moet doen wanneer het gekozen financialYear het eerste beschikbare jaar van een klant is en er dus geen previousYear bestaat.

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 dezelfde mapping voor beide jaren nodig?
  2. Wat doe je wanneer het vorige jaar nul is?
  3. Welke verschillen verdienen menselijke toelichting?

Klaar wanneer

previousYear wordt dynamisch gekozen en dezelfde vergelijking werkt voor minimaal drie verschillende klant-jaarcombinaties.