EKB — BPV
Doel & introductie
EKB (Eduarte Koppeling BPV) ondersteunt het volledige proces rond de beroepspraktijkvorming (BPV) — van het matchen van studenten aan leerbedrijven tot de begeleiding tijdens de stageperiode. De koppeling stelt partners (bijvoorbeeld systemen voor stagematching en BPV-begeleiding) in staat om samen te werken met Eduarte.
In tegenstelling tot een leeskoppeling als EKS werkt EKB in twee richtingen: gegevens worden zowel opgehaald (lezen) als aangemaakt en bijgewerkt (schrijven). Zo kan een partner het hele BPV-traject ondersteunen en de resultaten terugschrijven naar Eduarte.
Domein & context
EKB valt binnen het domein BPV van Eduarte Connect. Het is een E-koppeling (Eduarte-specifiek, Nederlandstalig).
EKB bouwt voort op de algemene stamdata uit Eduarte (zie de connector EKS — Stamdata) voor referentiegegevens zoals organisatie-eenheden en locaties. Binnen Connect is EKB een typische partnerkoppeling: domeinspecifiek, tweerichtings, met hoge waarde voor zowel school als partner.
Doelgroep & use cases
EKB is bedoeld voor partners die het BPV-proces ondersteunen (stagematching, BPV-begeleiding) en voor scholen die dit proces met een externe partner willen inrichten.
Typische use cases:
- Matchen: studenten en groepen ophalen en koppelen aan een leerbedrijf.
- Leerbedrijven beheren: bedrijven en contactpersonen opvragen, aanmaken en bijwerken.
- BPV-inschrijvingen: een inschrijving aanmaken, bijwerken en de status door het BPV-traject heen bewaken.
- Documenten: overeenkomsten, verslagen en beoordelingsformulieren toevoegen aan een BPV-inschrijving.
- Logboek: gewerkte uren en bijzonderheden tijdens de BPV vastleggen en bijwerken.
Granulariteit & reikwijdte
EKB biedt zowel lees- als schrijfoperaties. De functionaliteit valt uiteen in drie clusters:
- Matching (lezen) — groepen, studenten en onderwijsbegeleiders opvragen.
- Leerbedrijven (lezen + schrijven) — bedrijven en contactpersonen volledig beheren (opvragen, aanmaken, bijwerken, verwijderen van contactpersonen).
- BPV-inschrijvingen (lezen + schrijven) — inschrijvingen opvragen, aanmaken en bijwerken, inclusief statusbeheer, documenten en logboek.
Een BPV-inschrijving combineert de gegevens van student, onderwijsinschrijving, opleiding, bedrijf, begeleiders en logboek, aangevuld met informatie over de BPV-periode zelf (duur, aantal uren, status).
Buiten scope: het inhoudelijke onderwijsproces buiten de BPV en gegevens die tot andere domeinen behoren (die via de betreffende connectoren worden ontsloten).
Functionele flows
1. Matchen en inschrijven
- Haal groepen en studenten op die in aanmerking komen voor BPV.
- Zoek of registreer het leerbedrijf (en contactpersoon).
- Maak een BPV-inschrijving aan. Bij het aanmaken is alleen de status MATCHING of VOORLOPIG toegestaan (standaard MATCHING).
2. Statusverloop van een BPV-inschrijving
Een inschrijving doorloopt achtereenvolgens:
MATCHING → VOORLOPIG → VOLLEDIG → OVEREENKOMST AFGEDRUKT → DEFINITIEF → BEËINDIGD
Daarnaast bestaan de eindstatussen AFGEMELD en AFGEWEZEN. Statuswijzigingen lopen via een aparte statusactie, zodat businessregels en de statushistorie consistent blijven; een gewone bijwerking (PUT) verandert de status niet.
Voor filteren en rapportage zijn de statussen samengevat in drie high-level statussen: MATCHING (vrijgegeven in Eduarte), ACTIEF (in uitvoering) en BEËINDIGD (afgerond of afgebroken).
3. Begeleiden
Tijdens de BPV worden documenten (overeenkomst, verslag, beoordelingsformulier) toegevoegd en wordt het logboek bijgehouden met gewerkte uren en bijzonderheden.
Gegevens op hoofdlijnen
| Object | Functionele omschrijving |
|---|---|
| BPV-inschrijving | Centrale eenheid: student + opleiding + bedrijf + begeleiders + periode + status. |
| Bedrijf | Leerbedrijf waar de BPV plaatsvindt. |
| Contactpersoon | Contactpersoon bij een leerbedrijf. |
| Groep | Groep studenten, gebruikt bij het matchen. |
| Student | Student die BPV gaat lopen. |
| Onderwijsbegeleider | Medewerker die de student vanuit school begeleidt. |
| Document | Bij de inschrijving horend document (overeenkomst, verslag, beoordeling). |
| Logboekregel | Registratie van gewerkte uren en bijzonderheden op een datum. |
Randvoorwaarden & afspraken
- Toegang & consent — gebruik van EKB vereist een afspraak met de school (consent) en toegang via Connect; zie de technische specificatie voor authenticatie en scopes.
- AVG — EKB verwerkt persoonsgegevens van studenten en contactpersonen. Verwerk alleen wat nodig is voor het BPV-proces (dataminimalisatie) en houd je aan de met de school gemaakte afspraken.
- Stamdata — referentiegegevens (organisatie-eenheden, locaties) komen uit Eduarte; zie de connector EKS.
Verwijzingen
- Technische specificatie: EKB — Technische specificatie (PDF).
- OpenAPI-specificatie: meegeleverd als
EKB_v1.0.yml. - Online referentie: API-referentie van EKB