Doel & introductie

EKP (Eduarte Koppeling Provisioning) is de provisioning- en basisdatakoppeling van Connect. Het doel is om het systeemlandschap van de school te voorzien van actuele basisgegevens uit Eduarte — studenten, verbintenissen, groepen, groepsdeelnames en medewerkers — zodat andere systemen binnen de school hiermee gevoed en synchroon gehouden worden.

EKP wijkt bewust af van de domeinspecifieke partnerkoppelingen. De primaire afnemer is de school zelf: via de eigen ESB (enterprise service bus) of via één integratiepartner verdeelt de school deze basisgegevens vervolgens over alle andere onderwijssystemen. Per school gebruikt dus in de regel maar één partij EKP; het is geen koppeling die je aan meerdere partners tegelijk uitgeeft.

Domein & context

EKP valt binnen het domein Provisioning van Eduarte Connect en is een E-koppeling (Eduarte-specifiek, Nederlandstalig). Binnen de Connect-koppelvormen is dit de generieke basisdata-/ESB-koppeling, in tegenstelling tot de domeinspecifieke partnerkoppelingen (zoals EKB).

Verhouding tot EKS — Stamdata: EKS levert algemene referentiegegevens (zoals fases, periodes en organisatie-eenheden), terwijl EKP de feitelijke basisgegevens over personen en hun plaatsing levert (studenten, verbintenissen, medewerkers, groepen en groepsdeelnames).

Doelgroep & use cases

EKP is bedoeld voor de school en de partij die namens de school de distributie verzorgt (de eigen ESB of één integratiepartner).

Typische use cases:

• Initiële vulling van de aangesloten systemen met de complete set basisgegevens.
• Incrementeel bijhouden: periodiek alleen de gewijzigde gegevens ophalen en doorzetten.
• Accounts en plaatsing: studenten en medewerkers met hun groepen en groepsdeelnames beschikbaar maken voor bijvoorbeeld accountbeheer/identiteiten en leeromgevingen.

Granulariteit & reikwijdte

EKP biedt uitsluitend leesoperaties en is opgezet rond incrementeel synchroniseren: de zoek-endpoints kunnen met de parameter changed-since alleen de gewijzigde gegevens leveren (zie Wijzigingen ophalen in de technische specificatie).

De koppeling ontsluit:

• Studenten (met verbintenissen en groepsdeelnames)
• Medewerkers (met groepsdeelnames)
• Groepen

Let op — gevoelige gegevens. De informatie uit EKP is zeer uitgebreid en bevat persoonsgegevens die niet standaard met partners gedeeld mogen worden (bijvoorbeeld geheime telefoonnummers en adressen). De school bepaalt — eventueel samen met de integratiepartner — welke gegevens naar welk systeem mogen. Zie Randvoorwaarden & afspraken.

Functionele flows

1. Initiële vulling — haal de volledige set studenten, medewerkers en groepen op en vul de aangesloten systemen.
2. Incrementeel bijhouden — haal periodiek met changed-since alleen de wijzigingen sinds de vorige synchronisatie op en zet deze door.
3. Toekomst — gebeurtenisgestuurd — de notificatiekoppeling EKN zal wijzigingen via cloudevents signaleren, zodat de afnemer direct de nieuwe stand kan ophalen zonder te pollen. Deze notificaties zijn nog niet beschikbaar.

Gegevens op hoofdlijnen

Randvoorwaarden & afspraken

• Eén afnemer per school — EKP wordt door de school zelf gebruikt (eigen ESB of één integratiepartner) voor distributie naar de overige systemen.
• Regie bij de school (AVG) — de gegevens zijn uitgebreid en bevatten gevoelige persoonsgegevens. De school is verantwoordelijk voor de verdere distributie en bepaalt welke gegevens naar welk systeem gaan, volgens dataminimalisatie. Gevoelige gegevens (zoals geheime telefoonnummers en adressen) gaan niet zomaar naar partners.
• Toegang & consent — toegang verloopt via Connect; zie de technische specificatie voor authenticatie en scope.

Verwijzingen

• Technische specificatie: EKP — Technische specificatie (PDF).
• OpenAPI-specificatie: meegeleverd als EKP_v1.0.yml.
• Online referentie: API-referentie van EKP