Specifieker gemaakt wat we verwachten.

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

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