Vacatures Werken bij
    Alle blogsArchitectuur

    Common Ground en gegevensuitwisseling: praktische lessen voor architecten

    Praktische lessen over gegevensuitwisseling met Common Ground, inclusief API-keuzes, semantiek, BIO en AVG, en wat je morgen al kunt verbeteren.

    16 nov 2026 6 min lezen

    Common Ground belooft betere gegevensuitwisseling door data bij de bron te laten en via gestandaardiseerde API's te ontsluiten. In de praktijk loopt het vaak stuk op definities, autorisatie en het organiseren van eigenaarschap. Hieronder staan lessen die je in gemeentelijke en rijksomgevingen meteen herkent.

    1. Begin bij het informatie- en gegevensmodel, niet bij de koppeling

    Veel trajecten starten met een technische vraag, welke API of welk platform. De knelpunten zitten meestal eerder, bij betekenis en afbakening. Common Ground leunt zwaar op het idee van bronhouderschap en duidelijke begrippen. Als twee afdelingen een "adres" anders definiëren, dan wordt elke uitwisseling rommelig, ook met nette API's.

    Praktisch werkt het goed om per domein eerst vast te leggen:

    • Welke bron is leidend voor welk gegeven (bronregistratie versus afgeleid).
    • Welke definities gelden (bijvoorbeeld BAG-adres, verblijfsobject, correspondentieadres).
    • Welke kwaliteitsregels gelden (actualiteit, volledigheid, herkomst).

    Koppel dit aan NORA-principes zoals hergebruik, interoperabiliteit en scheiding van lagen. In Common Ground-termen voorkom je dat je een "data-kopie" bouwt die stiekem toch weer een nieuwe waarheid wordt.

    Semantiek is een compliance-onderwerp

    Onder AVG is onduidelijkheid over definities snel een probleem. Dan kun je doelbinding en dataminimalisatie lastig aantonen, omdat je niet scherp hebt welke gegevens je verwerkt en waarom.

    "We dachten dat we dezelfde gegevens uitwisselden, tot we ontdekten dat 'contactpersoon' bij ons ook 'mantelzorger' betekende. Daarna moesten we het verwerkingsregister aanpassen." , privacy officer, middelgrote gemeente

    2. Ontwerp gegevensuitwisseling als product, met eigenaarschap

    Een API is geen eenmalige koppeling. Het is een product met levenscyclusbeheer. In Common Ground zie je vaak dat teams wél een endpoint bouwen, maar geen afspraken maken over versiebeheer, beschikbaarheid en incidentafhandeling. Dan gaat de keten alsnog stuk bij de eerste wijziging.

    Maak voor elke gegevensdienst minimaal afspraken over:

    • Product owner of bronhouder, inclusief mandaat.
    • SLA-afspraken die passen bij het proces (kantooruren of 24/7).
    • Versiebeheer en deprecatiebeleid (bijvoorbeeld 6 maanden parallel).
    • Logging en monitoring, inclusief wie meldingen opvolgt.

    Dit sluit aan op BIO, vooral op maatregelen rond wijzigingsbeheer, continuïteit en logging. Het helpt ook bij ENSIA-verantwoording, omdat je aantoonbaar kunt maken hoe je beheerst ontwikkelt en beheert.

    Gebruik een "contract-first" aanpak

    Leg de interface vast voordat je implementeert. Denk aan OpenAPI en duidelijke foutcodes, inclusief betekenis. In de publieke sector scheelt dit veel afstemming, zeker bij leveranciers. Het voorkomt ook dat je later "stilzwijgende" interpretaties moet repareren.

    3. Autorisatie en grondslag: fijnmazig en aantoonbaar

    Gegevens bij de bron houdt in dat bevragingen vaker direct naar bronservices gaan. Dan wordt autorisatie een kernonderdeel van je architectuur. Te grove autorisatie leidt tot te brede toegang. Te fijnmazig zonder beheer leidt tot stilstand.

    Zorg dat je op drie niveaus expliciet bent:

    • Wettelijke grondslag en doel (AVG, sectorwetgeving, gemeentelijke taken).
    • Procescontext (welk zaaktype, welke taak, welke rol).
    • Gegevensniveau (welke attributen, welke gevoeligheid).

    In Common Ground-omgevingen zie je vaak OAuth2 of vergelijkbare patronen, maar de echte winst zit in de autorisatiebeslissing en de audittrail. Onder BIO heb je logging nodig die herleidbaar is naar wie, wat, wanneer en waarom. Onder AVG moet je kunnen uitleggen hoe dataminimalisatie en doelbinding zijn geborgd.

    Praktijkles: behandel "read" als impactvol

    Lezen is ook verwerken. Een raadpleging van persoonsgegevens moet je net zo zorgvuldig ontwerpen als een mutatie. Zet daarom in op attribute-based access control waar dat kan, en leg de beslisregels vast in beleid dat te auditen is.

    4. Standaarden en herbruikbare bouwblokken: klein beginnen, strak kiezen

    Common Ground is geen standaard op zichzelf, het is een set principes en een ontwikkelrichting. In de praktijk werk je met een mix van standaarden en afspraken. Het helpt om die keuzes beperkt te houden en ze te documenteren.

    Handige keuzes die vaak werken:

    • REST met JSON voor brede interoperabiliteit, aangevuld met duidelijke content-negotiation.
    • OpenAPI voor contracten en testbaarheid.
    • NLX of vergelijkbare voorzieningen voor veilige service-to-service uitwisseling, waar passend.
    • Referentie naar landelijke definities waar beschikbaar (BAG, BRP, WOZ, etc.).

    Let op de samenhang met NIS2 als jouw organisatie of keten daaronder valt. Dan wordt ketenbeveiliging en leveranciersbeheer zwaarder. Dat raakt direct je API-landschap, omdat je afhankelijkheden expliciet moet maken en beheersen.

    Common Ground en legacy: accepteer de tussenfase

    Veel gemeenten en uitvoeringsorganisaties zitten in een hybride fase. Data zit in suites, zaaksystemen en vakapplicaties. Een praktische les is om eerst een beperkt domein te kiezen, bijvoorbeeld "meldingen openbare ruimte" of "vergunningaanvragen", en daar de bron- en afnamepatronen scherp te krijgen. Daarna schaal je op.

    5. Logging, datakwaliteit en incidenten: regel het voordat het pijn doet

    Bij gegevensuitwisseling ontstaan incidenten vaak door datakwaliteit en onzichtbare afhankelijkheden. Een afnemer verwacht een veld altijd gevuld, de bron levert null. Of een veld verandert van betekenis door een release. Zonder goede observability wordt het zoeken.

    Bouw minimaal in:

    • Technische logging (request, response codes, latency) met bewaartermijnen die passen bij BIO en AVG.
    • Functionele logging (welke rol raadpleegde welke categorie gegevens, met reden waar mogelijk).
    • Datakwaliteitsmetingen (aantal ontbrekende waarden, validatiefouten) per versie.
    • Incidentproces dat de keten meeneemt, inclusief communicatie naar afnemers.

    Leg bij persoonsgegevens expliciet vast wie toegang heeft tot logs en hoe je voorkomt dat logs zelf een nieuwe gegevensbron worden. Voor ENSIA helpt het als je kunt laten zien dat logging niet alleen bestaat, maar ook wordt gebruikt in beheer en evaluaties.

    Pak morgen één gegevensdienst die jullie al uitwisselen en maak een "minicontract" op één A4: bronhouder, definitie van de belangrijkste velden, autorisatieregels, logging, versiebeleid en een contactpunt. Vergelijk dat document met jullie BIO- en AVG-eisen en plan de eerste twee verbeteracties in het eerstvolgende sprint- of beheeroverleg.

    expertiseCommon GroundgegevensuitwisselingarchitectuurBIOAVG