Oefening 13 · Capstone

Eindopdracht: verwerk meerdere klanten en jaren

Bouw één herbruikbare workflow die meerdere division-boekjaarcombinaties verwerkt en fouten per klant isoleert.

Waarom dit nodig is

Een accountantspraktijk wil niet voor iedere klant een losse flow onderhouden. Tegelijk mag één foutcase de rapporten van alle andere klanten niet blokkeren.

Plaats in de eindoplossing

Wat draagt deze oefening bij?

Dit benadert de echte eindoplossing: Exact Online-data ophalen, controleren, AI-toelichting maken, conceptdocument genereren en een batchsamenvatting opleveren.

Wat gebeurt er technisch?

  • De invoer is een lijst van division-boekjaarcombinaties.
  • Iedere combinatie doorloopt dezelfde subworkflow.
  • Resultaten krijgen status completed, review_required of failed.
  • Idempotency voorkomt dubbele documenten voor dezelfde runKey.
Doen én begrijpen

Bouwstappen met uitleg

Open workflow-editor
1

Maak zelf een batchlijst met normale én foutcases; gebruik niet alleen het voorbeeld uit de hints.

Waarom?
De eindopdracht moet laten zien dat jij de workflow begrijpt en zelf testdekking kunt bedenken.
Wat moet dit opleveren?
Minimaal zes targetDivision/financialYear-items met variatie in klant en jaar.
2

Roep per item dezelfde herbruikbare jaarrekening-subworkflow aan.

Waarom?
Één generieke implementatie is het schaalbare doel.
Wat moet dit opleveren?
Geen aparte flow per klant.
3

Vang fouten per item af en ga met de rest verder.

Waarom?
Een probleem bij één klant mag een hele batch niet onnodig blokkeren.
Wat moet dit opleveren?
Per item status success/review/failed plus reason.
4

Maak een batchsamenvatting met klantnaam, jaar, status en documentlink.

Waarom?
Operations moeten kunnen zien wat wel en niet gelukt is.
Wat moet dit opleveren?
Een overzicht van alle batchitems.
5

Draai de batch opnieuw en ontwerp idempotency.

Waarom?
Productieruns worden opnieuw gestart na fouten of door gebruikers; dubbele documenten zijn dan een reëel risico.
Wat moet dit opleveren?
Geen ongewenste duplicaten voor dezelfde runKey/bronversie.

Wat gaat er mis als je dit overslaat?

Gekopieerde klantflows lopen uiteen, fouten stoppen de hele batch en herstarts maken dubbele of tegenstrijdige rapporten.

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.

  • Maak een batch met 101002/2022, 101003/2024, 101004/2025, 101005/2023, 109901/2025 en 109902/2025.
  • Maak daarna zelf een tweede batch met andere jaren.
  • Voeg 109903/2025 toe en bepaal op basis van allowOpenYear of dat review of fail wordt.
Vrije uitdaging

Bouw een “random audit run”: kies drie geldige combinaties uit je beschikbare divisions/jaren en laat dezelfde subworkflow ze verwerken.

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. Welke delen horen in een subworkflow?
  2. Wanneer moet een fout de hele batch stoppen?
  3. Hoe definieer je idempotency voor een nieuwe rapportversie?
  4. Welke controles blijven altijd menselijk?

Klaar wanneer

Je eigen batch met meerdere klanten en jaren levert succesvolle concepten én geïsoleerde fout-/reviewstatussen op zonder klant-specifieke flows.