P PowerLabExact → workflow → AI → conceptjaarrekening
Oefening 6 · Integratie

Gebruik bulk en sync voor grote datasets

Kies bewust tussen standaard, bulk en sync en verwerk grote transactiedatasets voor verschillende klant-jaarcombinaties.

Open workflow-editor Open relevante data
Waarom dit nodig is

De Exact-documentatie adviseert sync waar mogelijk. Sync en bulk gebruiken grotere pagina's en sync ondersteunt efficiënte vervolgverwerking.

Plaats in de eindoplossing

Wat draagt deze oefening bij?

Een jaarrekeningflow moet schaalbaar blijven wanneer een klant veel boekingen heeft. Noordzee Handel 2025 bevat bewust meer dan 1000 regels.

Wat gebeurt er technisch?

  • Bulk en sync hebben in het lab een pagina van 1000.
  • TransactionLines voor division 101001 en 2025 vereist twee sync-pagina's.
  • Timestamp is beschikbaar als concept voor incrementele synchronisatie.
Doen én begrijpen

Bouwstappen met uitleg

Open workflow-editor
1

Kies eerst zelf een normale targetDivision/financialYear en haal sync/Financial/TransactionLines op.

Waarom?
De workflow moet de parameters uit de runcontext gebruiken, niet één vaste demo.
Wat moet dit opleveren?
Transacties voor de gekozen klant en het gekozen jaar.
2

Volg __next tot de dataset compleet is.

Waarom?
Ook sync kan boven 1000 records pagineren.
Wat moet dit opleveren?
recordCount en pageCount van de complete dataset.
3

Bewaar de hoogste Timestamp pas na succesvolle verwerking.

Waarom?
Een checkpoint mag niet vooruitlopen op onvolledige verwerking.
Wat moet dit opleveren?
Een syncCheckpoint dat pas aan het eind wordt bijgewerkt.
4

Gebruik daarna 101001/2025 als stresstest.

Waarom?
Deze combinatie is expres groot genoeg om de tweede sync-pagina te forceren.
Wat moet dit opleveren?
Je ziet het verschil tussen een kleine en een grote run zonder andere workflowlogica.
5

Vergelijk standaard GLAccounts met bulk/sync en beschrijf wanneer je welke route zou kiezen.

Waarom?
De keuze is een ontwerpbeslissing, niet alleen een opdracht uit het stappenplan.
Wat moet dit opleveren?
Een korte notitie bij je workflow met het argument.

Wat gaat er mis als je dit overslaat?

De flow wordt traag, raakt rate limits of mist alle records na nummer 1000.

GET

PowerLab-endpoint

Test met credential in n8n

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/v1/101001/sync/Financial/TransactionLines?year=2025&page=1
Authenticatie

Kies in de HTTP Request-node de opgeslagen Header Auth-credential PowerLab API. De sleutel hoeft je broertje niet te zien of in de workflow te plakken.

Extra endpoints en scenario’s

  • https://powerlab.rmeijer.eu/api/v1/101001/sync/Financial/TransactionLines?year=2025&page=2
  • https://powerlab.rmeijer.eu/api/v1/101001/bulk/Financial/GLAccounts?page=1
  • https://powerlab.rmeijer.eu/api/v1/101001/sync/Financial/GLAccounts?page=1
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.

  • Start met 101002/2024.
  • Gebruik daarna 101001/2025 om >1000 regels af te dwingen.
  • Vergelijk recordCount en pageCount.
Vrije uitdaging

Bouw één subworkflow “Fetch all pages” die je later zowel voor standaard als sync-responses kunt hergebruiken.

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. Wanneer kies je sync boven een gewone GET-resource?
  2. Waarom is een checkpoint pas na volledige verwerking veilig?
  3. Wat gebeurt er als pagina 2 faalt maar je checkpoint al is bijgewerkt?

Klaar wanneer

De flow werkt met kleine én grote datasets, volgt sync-paginering en kan uitleggen waarom een sync/bulk-resource passend is.