From 6f5851bdcd5edc7d8d9525777fa40c63df113fc3 Mon Sep 17 00:00:00 2001 From: Tom Klute Date: Tue, 27 Jan 2026 09:25:13 +0100 Subject: [PATCH] Specifieker gemaakt wat we verwachten. --- .../profit/en/partner-certification-steps.md | 20 +++++++++---------- .../profit/nl/partner-certification-steps.md | 19 +++++++++--------- 2 files changed, 20 insertions(+), 19 deletions(-) diff --git a/markdownpages/profit/en/partner-certification-steps.md b/markdownpages/profit/en/partner-certification-steps.md index fe20d8a..4dde8af 100644 --- a/markdownpages/profit/en/partner-certification-steps.md +++ b/markdownpages/profit/en/partner-certification-steps.md @@ -113,6 +113,16 @@ Ensure that our mutual customers use the checked GetConnectors. For example, mak --- +### Provide a data flow diagram of the API integration + +A data flow diagram of an API integration shows how data moves between systems. The diagram does not focus on the internal workings of the systems, but on what data is exchanged (e.g. employee data or leave bookings), in which direction, via which API calls and by which event or schedule this process is initiated. + +This provides insight into which endpoints are used, who the source is, who the recipient is, and under what circumstances the data exchange takes place. + +We therefore request a single high-level data flow diagram of the API integration, created in a free tool such as draw.io and delivered as a PDF or PNG. The diagram shows in broad terms which systems are involved, which endpoints are used, and how the data flow runs through our platform. It is not a deeply technical document, but it is sufficient to test the functional connection. + +--- + ### Supply the implementation document Did you land a new customer? Congratulations! @@ -155,16 +165,6 @@ An integration without customers is not an integration. To give our mutual custo Proud of your customers? Then submit references from customers where the integration runs to their satisfaction. You can do this at https://partner.afas.nl/aanmaken-aanvraag-partnerportal/referentie. - ---- - -### Provide a data flow diagram of the API integration - -A data flow diagram of an API integration shows how data moves between systems. It does not focus on the internal workings of the systems, but rather on what data is exchanged (for example, employee data or leave bookings), in which direction, via which API calls, and what event or schedule triggers this exchange. This makes it clear which endpoints are used, who the source is, who the recipient is, and under what circumstances the exchange takes place. - -This is important because it prevents misunderstandings about who supplies and receives what data, and because it helps developers and administrators design, build, and maintain the integration properly. The diagram makes impact analyses of changes easier, as you can directly see which flows are affected, and it serves as clear, lasting documentation for management and future expansions. Additionally, it provides a concrete tool to optimize the integration, for example by removing redundant data flows or choosing more efficient exchange moments. - - --- ## Contact diff --git a/markdownpages/profit/nl/partner-certification-steps.md b/markdownpages/profit/nl/partner-certification-steps.md index 7f90609..4c1abdb 100644 --- a/markdownpages/profit/nl/partner-certification-steps.md +++ b/markdownpages/profit/nl/partner-certification-steps.md @@ -119,6 +119,16 @@ Zorg ervoor dat onze gezamenlijke klanten gebruikmaken van de gecontroleerde Get --- +### Datastroomdiagram van de API-integratie aanleveren + +Een datastroomdiagram van een API-integratie laat zien hoe gegevens tussen systemen bewegen. Het diagram richt zich niet op de interne werking van de systemen, maar op welke data wordt uitgewisseld (bijvoorbeeld medewerkergegevens of verlofboekingen), in welke richting, via welke API-aanroepen en door welke gebeurtenis of planning dit proces wordt gestart. + +Hiermee wordt inzichtelijk welke endpoints worden gebruikt, wie de bron is, wie de ontvanger is en onder welke omstandigheden de gegevensuitwisseling plaatsvindt. + +We vragen daarom om één high-level data flow diagram van de API-integratie, gemaakt in een gratis tool zoals draw.io en aangeleverd als PDF of PNG. Het diagram laat op hoofdlijnen zien welke systemen betrokken zijn, welke endpoints worden gebruikt en hoe de datastroom door ons platform loopt. Het is geen diep technisch document, maar wel voldoende om de functionele aansluiting te toetsen. + +--- + ### Implementatiedocument aanleveren Scoor je een nieuwe klant? Gefeliciteerd! @@ -162,15 +172,6 @@ Een koppeling zonder klanten is geen koppeling. Om onze gezamenlijke klanten zek Ben je trots op je klanten? Stuur dan referenties in van de klanten waar de koppeling naar tevredenheid loopt. Dat doe je op https://partner.afas.nl/aanmaken-aanvraag-partnerportal/referentie. ---- - -### Datastroomdiagram van de API-integratie aanleveren - -Een datastroomdiagram van een API‑integratie laat zien hoe gegevens tussen systemen bewegen. Het richt zich niet op de interne werking van de systemen, maar op welke data wordt uitgewisseld (bijvoorbeeld medewerkergegevens of verlofboekingen), in welke richting, via welke API‑aanroepen en door welke gebeurtenis of planning dit wordt gestart. Zo wordt helder welke endpoints gebruikt worden, wie de bron is, wie de ontvanger is en onder welke omstandigheden de uitwisseling plaatsvindt. - -Dit is belangrijk omdat het misverstanden voorkomt over wie welke data levert en ontvangt, en omdat het ontwikkelaars en beheerders helpt de integratie goed te ontwerpen, bouwen en beheren. Het diagram maakt impactanalyses bij wijzigingen eenvoudiger, omdat je direct ziet welke stromen geraakt worden, en het fungeert als duidelijke, blijvende documentatie voor beheer en toekomstige uitbreidingen. Bovendien biedt het een concreet hulpmiddel om de koppeling te optimaliseren, bijvoorbeeld door overbodige datastromen te schrappen of efficiëntere uitwisselmomenten te kiezen. - - --- ## Contact