P PowerLabExact → workflow → AI → conceptjaarrekening
Exact-basis · oefening 2 van 10

Administraties uit nep-Exact ophalen

Haal administraties via HTTP op en selecteer de administratie uit oefening 1 op basis van een stabiele ID.

Waarom dit nodig is

Exact Online-koppelingen werken met technische identifiers. De zichtbare administratienaam alleen is niet betrouwbaar genoeg.

Plaats in de eindoplossing

Wat draagt deze oefening bij?

Nu leert de workflow niet langer uit een handmatig ingevulde naam welke administratie bedoeld is, maar controleert hij die keuze tegen een bron die Exact Online nabootst.

Wat gebeurt er technisch?

  • HTTP GET vraagt gegevens op zonder ze te wijzigen.
  • De API retourneert JSON met meerdere administraties.
  • Split Out verandert een lijst in losse workflow-items.
  • Filter houdt alleen het item met de gekozen technische ID over.
Doen én begrijpen

Bouwstappen met uitleg

Open workflow-editor
1

Roep GET /api/exact/administrations aan.

Waarom?
Een integratie moet eerst weten welke administraties beschikbaar zijn en welke technische ID bij welke naam hoort.
Wat moet dit opleveren?
Je ontvangt een JSON-object met een items-lijst.
2

Splits de items-lijst uit.

Waarom?
Veel workflow-nodes werken overzichtelijker wanneer iedere administratie een afzonderlijk item is in plaats van één grote array.
Wat moet dit opleveren?
Er loopt één item per administratie door de volgende node.
3

Filter op administrationId.

Waarom?
Je verbindt de keuze uit oefening 1 met de actuele gegevens uit de bron-API.
Wat moet dit opleveren?
Alleen demo-bv blijft over.
4

Maak selectedAdministration.

Waarom?
Je bewaart alleen de velden die de rest van de keten nodig heeft. Dat maakt de workflow voorspelbaar en voorkomt onnodige data.
Wat moet dit opleveren?
De output bevat id, name, currency en country.
5

Test een onbekende ID.

Waarom?
Een productieflow moet ook correct reageren wanneer een administratie is verwijderd, verkeerd ingevoerd of niet toegankelijk is.
Wat moet dit opleveren?
De flow stopt met een begrijpelijke fout in plaats van leeg verder te lopen.

Wat gaat er mis als je dit overslaat?

Wanneer je alleen op naam selecteert of een lege selectie niet controleert, kan de flow de verkeerde administratie gebruiken of later met onbegrijpelijke null-fouten stoppen.

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

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. Wat is het verschil tussen een zichtbaar label en een technische identifier?
  2. Waarom is een lege filteruitkomst een fout en geen geldige lege administratie?
  3. Welke informatie uit de API-response heb je werkelijk nodig in de rest van de workflow?

Klaar wanneer

De workflow vindt demo-bv op ID en levert één geselecteerde administratie terug.