Datatypes en codelijsten¶
Bindende afspraken over de typering van waarden in alle deelmodellen. Deze typen worden niet als objecttype gemodelleerd; ze zijn de bouwstenen van attribuutsoorten en relatie-eigenschappen.
GBO volgt waar mogelijk het Metamodel voor Informatiemodellering (MIM) 1.2 van Geonovum:
- Datatypes zijn MIM-primitieven (
CharacterString,Integer,Date,Boolean, enzovoort) en aanvullende gestructureerde typen (Geometrie,Codelijst~bron, GBO- of BRP-specifieke typen). De MIM-naam is leidend; de Nederlandse synoniem die in de attribuut-tabellen van de deelmodellen wordt gebruikt staat als alias. - Codelijsten (MIM-stereotype
«Codelijst») zijn extern beheerde value-sets bij houders als CBS, ISO, Kadaster, KOOP, RvIG, KVK, IND en Waarderingskamer. Stelselbrede codelijsten staan op deze pagina; deelmodel-specifieke codelijsten staan bij het betreffende deelmodel. - Enumeraties (MIM-stereotype
«Enumeratie») zijn gesloten value-sets die in dit model zelf zijn vastgelegd; zie de## Enumeraties-sectie in elk deelmodel.
Simpele datatypes¶
Eén-op-één afgeleid van de MIM 1.2-primitieve datatypes (zie MIM 1.2).
| MIM-datatype | Alias (NL) | Definitie | Herkomst | Toelichting |
|---|---|---|---|---|
CharacterString |
Tekst |
Reeks Unicode-tekens. | MIM 1.2 | Lengte-varianten: Tekst24 (max. 24 tekens). De alias Alfanumeriek wordt gebruikt voor reeksen uit het alfabet en de cijfers zonder leestekens, met varianten Alfanumeriek10, AN40, AN80. De alias Identificatie wordt gebruikt voor object- of documentidentificaties zonder vaste structuur; de alias Postcode voor de Nederlandse postcode in het formaat 9999 XX (norm NEN 5825). |
Integer |
Numeriek (geheel) |
Geheel getal zonder eenheid. | MIM 1.2 | Varianten met vaste lengte: N2, N4, N5, N6 (geheel getal van precies dat aantal cijfers); varianten met maximumlengte: Numeriek8, Numeriek9, Numeriek12. |
Real |
Numeriek (decimaal) / Decimaal |
Decimaal getal zonder eenheid. | MIM 1.2 | De alias Decimaal wordt in de deelmodellen gebruikt voor breuk-getallen zonder valuta-aanduiding, bijvoorbeeld Schuld.rentepercentage en ModuleInschrijving.ects. Voor bedragen wordt Bedrag gebruikt (zie aanvullende datatypes), niet Real direct, vanwege de verplichte valuta-aanduiding. |
Boolean |
Indicatie |
Logische waarde waar/onwaar. | MIM 1.2 | GBO hanteert als NL-conventie een drie-waardig type Indicatie (Ja / Nee / Onbekend), zodat onbekendheid expliciet kan worden vastgelegd. De waarde Onbekend is geen MIM-Boolean-waarde maar volgt de BRP-conventie voor afwezigheid (zie Logisch Ontwerp BRP). Daarnaast bestaat de tweewaardige variant IndicatieJaNee (Ja / Nee) voor gegevens waarbij een afwezige waarde zelf betekenis draagt (niet vastgesteld of niet van toepassing), zoals de BRP-kiesrechtgegevens uitsluitingKiesrecht en europeesKiesrecht. |
Date |
Datum |
Kalenderdatum in ISO 8601, precisie tot op de dag (jjjj-mm-dd). |
MIM 1.2 / ISO 8601 | Gebruikt voor de materiële tijdlijn (geldigheid van een gegeven in de werkelijkheid). |
DateTime |
DatumTijd |
Datum met tijdstip in ISO 8601, precisie tot op de seconde (jjjj-mm-ddThh:mm:ss). |
MIM 1.2 / ISO 8601 | Gebruikt voor de formele tijdlijn (registratiemoment in een systeem). |
Year |
Jaar |
Kalenderjaar in ISO 8601, vier cijfers (jjjj). |
MIM 1.2 / ISO 8601 | Gebruikt voor oorspronkelijkBouwjaar op Pand en andere jaar-precieze gegevens. |
Duration |
Duur |
Tijdsduur in ISO 8601-periode-notatie (P5Y, P3M, P7D). |
MIM 1.2 / ISO 8601 | Gebruikt voor bewaartermijnen en doorlooptijden, bijvoorbeeld BijzonderheidsCodering.bewaartermijnPeriode (vijf jaar conform Algemeen Reglement CKI). |
URI |
URI |
Uniform Resource Identifier conform RFC 3986. | MIM 1.2 / RFC 3986 | Gebruikt voor begrip-verwijzingen naar NL-SBB en andere semantische ankers. |
Aanvullende datatypes¶
Samengestelde of domeinspecifieke datatypes. Waar een MIM- of ISO-19107-equivalent bestaat staat dat in de tweede kolom; waar geen MIM-equivalent bestaat is de notatie GBO-specifiek of BRP-specifiek.
| Datatype | MIM-equivalent | Definitie | Herkomst | Toelichting |
|---|---|---|---|---|
DatumIncompleet |
(geen) | Datum waarin jaar, maand of dag elk afzonderlijk onbekend kan zijn. Formaten: jjjj, jjjj-mm of jjjj-mm-dd; nullen op de onbekende positie. |
Logisch Ontwerp BRP | BRP-conventie voor geboortedatum, datum overlijden en datum verkrijging nationaliteit die onvolledig in de bronregistratie kunnen staan. MIM kent geen onvolledige datum als primitief. Volledige datum wordt gerepresenteerd als gewone Date / Datum. |
BAGID |
Identificatie |
BAG-objectidentificatie: een 16-cijferige code, opgebouwd uit gemeentecode (4), objecttypecode (2) en objectvolgnummer (10). Specialisatie van NEN3610ID. |
BAG-objecten (Kadaster) | Gebruikt voor de BAG-objecten Pand, Verblijfsobject, Standplaats, Ligplaats, Nummeraanduiding, Openbare ruimte en Woonplaats, voor verwijzingen daarnaar (zoals adresseerbaarObjectId), en voor Binnenlandsadres.adresId (gelijk aan de identificatie van de Nummeraanduiding). Een BAG-identificatie is een stelsel-objectidentificatie met de BAG als namespace; het patroon legt de lokaalID-vorm vast zoals de BAG die uitgeeft, dus zonder het NL.IMBAG.<objecttype>-voorvoegsel. |
NEN3610ID |
Identificatie (in NEN 3610 als gestructureerd datatype) |
Landelijke objectidentificatie voor stelselobjecten, opgebouwd uit namespace : lokalID : versie. Het algemene identificatietype; BAGID is de register-specifieke specialisatie ervan. |
NEN 3610 Basismodel Geo-informatie (documentatie) | Gebruikt voor BRK-objecten (KadastraleOnroerendeZaak, ZakelijkRecht) en publiekrechtelijke beperkingen, waar de waarde de vorm NL.IMKAD.<objecttype>.<lokaalID> heeft. Garandeert uniciteit over registers heen. |
UUID |
(geen) | Universally Unique Identifier conform RFC 4122 (128 bits, hex-genotat). | RFC 4122 | Interne GBO-identifier voor objecten zonder externe authentieke identifier: Onderneming.identificatie en het adresId van de niet-BAG-adresvormen (Buitenlandsadres, Locatie, Postadres, VerblijfplaatsOnbekend). Partij droeg zo'n UUID tot 2026-08-10; dat attribuut is verwijderd, zie hoofdmodel. |
BSN |
Tekst + patroon ^[0-9]{9}$ |
Burgerservicenummer: 9 cijfers met geldige elfproef. | Wet algemene bepalingen burgerservicenummer | Zoeksleutel van IngeschrevenPersoon (natuurlijk persoon). Als tekst getypeerd zodat een voorloopnul behouden blijft. |
KVKnummer |
Tekst + patroon ^[0-9]{8}$ |
Identificatie van een inschrijving in het Handelsregister: 8 cijfers. | Handelsregisterwet 2007 | Zoeksleutel van Inschrijving (niet-natuurlijke persoon). |
Vestigingsnummer |
Tekst + patroon ^[0-9]{12}$ |
Identificatie van een vestiging in het Handelsregister: 12 cijfers. | Handelsregister (NHR) | Zoeksleutel van Vestiging. |
Kenteken |
Tekst + patroon |
Nederlands voertuigkenteken: zes posities (hoofdletters en cijfers) volgens het RDW-sidecodestelsel, optioneel met streepjes. | RDW (BRV) | Zoeksleutel van Voertuig. |
KadastraleAanduiding |
Tekst |
Kadastrale gemeente, sectie en perceelnummer (bij een appartementsrecht aangevuld met een index), uniek binnen de BRK. | Kadaster (BRK) | Natuurlijke sleutel van Perceel en Appartementsrecht. |
BRINcode |
Tekst + patroon ^[0-9]{2}[A-Z]{2}$ |
BRIN-nummer van een onderwijsinstelling: twee cijfers gevolgd door twee hoofdletters. | DUO (BRIN) | Natuurlijke sleutel van OnderwijsInstelling. |
Aangifteperiode |
Tekst + patroon ^[0-9]{4}(-[MW][0-9]{2})?$ |
Aanduiding van het aangiftetijdvak loonheffingen: jaar plus tijdvak-code, bijvoorbeeld 2026-M01 (maand) of 2026-W04 (vier weken); de kale jaarvorm (2026) duidt een jaaraggregaat aan, zoals de vooringevulde aangifte die levert. |
Gegevensspecificaties aangifte loonheffingen | Gebruikt voor Inkomstenopgave.aangifteperiode en LoonAangifte.aangifteperiode. |
Codelijst~bron |
MIM-stereotype «Codelijst» |
Verwijzing naar een waarde uit een extern beheerde codelijst. De bron staat als suffix achter de tilde. | MIM 1.2 | Voorbeelden: Codelijst~ISO3166 (zie ISO 3166-1 alpha-2), Codelijst~LT33 (BRP-gemeentecode, zie Landelijke Tabel 33), Codelijst~CBS_SBI (CBS Standaard Bedrijfsindeling), Codelijst~KVK_Bedrijf (KVK-rechtsvorm). Stelselbrede codelijsten staan hieronder; deelmodel-specifieke codelijsten staan bij het betreffende deelmodel. |
Geometrie |
GM_Object (ISO 19107, in MIM opgenomen als gestructureerd datatype) |
Ruimtelijke objectplaatsing. Abstract supertype met drie concrete subtypes: Punt, Vlak en Lijn. |
NEN 3610 / ISO 19107 | Default-coördinatenstelsel: EPSG:28992 (RD-New) voor binnenlandse objecten; WGS84 (EPSG:4326) waar uitwisseling internationaal is. Het coördinatenstelsel staat als attribuut op Geometrie zelf, niet op elke toepassing. |
Punt |
GM_Point (ISO 19107) |
Geometrie als één coördinaat (x, y, optioneel z). |
NEN 3610 / ISO 19107 | Gebruikt voor Verblijfsobject.geometriePunt (verblijfsobjectpunt-conventie). |
Vlak |
GM_Surface (ISO 19107) |
Geometrie als gesloten polygoon, eventueel met binnenringen voor uitsparingen. | NEN 3610 / ISO 19107 | Gebruikt voor Pand, Ligplaats, Standplaats, Perceel, Woonplaats, Gemeente, Wijk en Buurt. |
Lijn |
GM_Curve (ISO 19107) |
Geometrie als reeks aaneengesloten lijnsegmenten. | NEN 3610 / ISO 19107 | Gebruikt voor OpenbareRuimte van het type weg of water. |
Bedrag |
(geen; in MIM als gestructureerd datatype «DataType» Bedrag op te nemen) |
Geldbedrag: numerieke waarde met expliciete valuta-aanduiding (ISO 4217). | ISO 4217 | Voor binnenlandse toepassingen impliciet EUR; de valuta wordt expliciet bij internationale uitwisseling. Gebruikt voor WOZWaarde.vastgesteldeWaarde en Zekerheidsrecht.bedrag. |
Breuk |
(geen) | Rationaal getal als teller / noemer. | GBO | Gebruikt voor Tenaamstelling.aandeel (bijvoorbeeld 1/2, 1/3) zodat mede-eigendom exact zonder afrondingsverlies wordt vastgelegd. |
ObjectAanduiding |
(geen) | Gestandaardiseerde samenstelling van gemeentecode en objectnummer als één string. | Wet WOZ / Waarderingskamer — gegevensbeheer | Gebruikt voor WOZObject.aanduiding. Maakt een WOZ-object uniek identificeerbaar buiten de eigen gemeentecontext, want het ruwe wozObjectnummer is alleen binnen één gemeente uniek. |
Codelijst-strategie¶
GBO hanteert een hybride aanpak: internationale norm leidend voor semantiek waar die bestaat (ISO 3166); BRP-Landelijke Tabel leidend voor uitwisseling met de BRP-keten. Cross-walks tussen beide staan hieronder voor de stelselbrede gevallen; deelmodel-specifieke cross-walks staan bij het betreffende deelmodel.
Stelselbrede codelijsten¶
Alfabetisch op bron. Elke rij verwijst direct naar de actuele lijst bij de beheerder.
| Codelijst | Bron / beheerder | GBO-typering | Gebruikt door |
|---|---|---|---|
| BRP-Landelijke Tabel 33 Gemeenten | RvIG / BZK | Codelijst~LT33 |
Stelselbreed voor gemeente-codering. Adressen en gebouwen: Gemeente.gemeentecode. Personen: IngeschrevenPersoon.gemeenteVanInschrijving. Waarde onroerende zaken: WOZObject.verantwoordelijkeGemeente. Formeel een BRP-codelijst, feitelijk de stelselbrede gemeente-codering inclusief historische gemeenten met einddatum. |
| CBS Standaard Bedrijfsindeling (SBI 2008 / 2025) — SBI-zoektool | CBS | Codelijst~CBS_SBI |
Stelselbreed voor bedrijfsindeling; primair in Bedrijven en instellingen (Activiteit.sbiCode, Activiteit.sbiVersie, NietNatuurlijkPersoon.hoofdSbiCode, MaatschappelijkeActiviteit.hoofdSbiCode). |
| CBS Wijk- en Buurtkaart (jaarlijkse uitgave; Kerncijfers wijken en buurten 2024) | CBS | Codelijst~CBS_WijkBuurt |
Adressen en gebouwen: Wijk.wijkcode, Buurt.buurtcode. |
| ISO 3166-1 alpha-2 (landcodes) | ISO | Codelijst~ISO3166 |
Stelselbreed voor land- en nationaliteit-typering. Personen: Nationaliteit.nationaliteit, NatuurlijkPersoon.geboorteland, NatuurlijkPersoon.landOverlijden, Immigratie.landVanwaar, Immigratie.landBinnenkomst, Huwelijk.landVoltrekking, NietIngezetene.landVanVerblijf. Bedrijven en instellingen: BuitenlandseEntiteit.landVanOprichting. Adressen en gebouwen: Buitenlandsadres.land, Locatie.land. |
| Kadastrale aanduiding — kadastrale gemeente / sectie / perceelnummer | Kadaster | Codelijst~Kadaster |
Onroerende zaken: Perceel.kadastraleGemeente. De lijst kadastrale gemeenten is onderdeel van de Basisregistratie Kadaster (BRK) en wijzigt mee met gemeentelijke herindelingen. |
| TOOI-waardelijsten — Register van Overheidsorganisaties (standaard, waardelijsten-documentatie) | KOOP / Logius | Codelijst~TOOI |
Bedrijven en instellingen: Overheidsinstelling.bevoegdGezagCode. |
Cross-walks¶
De cross-walk-fragmenten hieronder tonen een handvol voorbeeldrijen per groep; de volledige lijst telt honderden codes en wordt onderhouden door RvIG op publicaties.rvig.nl. Volg de link onder elke tabel voor het feitelijke bronbestand.
ISO 3166 ↔ BRP-LT 32 (nationaliteit)¶
BRP-Landelijke Tabel 32 Nationaliteiten
levert per nationaliteit een 4-cijferige BRP-code, een omschrijving en,
waar van toepassing, een 2-letterige ISO-code. GBO modelleert het
attribuut Nationaliteit.nationaliteit als
Codelijst~ISO3166
(semantiek leidend) met cross-walk naar LT 32 voor BRP-uitwisseling.
| BRP-code (LT 32) | ISO 3166-1 alpha-2 | Omschrijving |
|---|---|---|
| 0001 | NL | Nederlandse |
| 0026 | DE | Duitse |
| 0027 | BE | Belgische |
| 0083 | FR | Franse |
| 0125 | GB | Britse |
| 0337 | US | Amerikaanse |
| 0498 | (geen) | Statenloos / vluchteling-status (geen ISO-equivalent) |
| … | … | … |
LT 32 bevat codes zonder ISO-equivalent (statenloos, Behandeld als
Nederlander, vluchteling-status). Deze blijven via BRP-code zichtbaar;
de cross-walk-tabel registreert dit als (geen) aan de ISO-zijde.
Volledige lijsten:
- Tabel 32 Nationaliteiten — directe download (publicaties.rvig.nl).
- BRP Landelijke Tabellen — overzicht (RvIG).
- ISO 3166-1 alpha-2 (iso.org).
ISO 3166 ↔ BRP-LT 34 (landen)¶
BRP-Landelijke Tabel 34 Landen gebruikt 4-cijferige BRP-codes; ISO 3166 gebruikt 2-letterige alpha-2-codes.
| BRP-code (LT 34) | ISO 3166-1 alpha-2 | Omschrijving |
|---|---|---|
| 6030 | NL | Nederland |
| 5005 | DE | Duitsland |
| 5010 | BE | België |
| 4030 | FR | Frankrijk |
| 9000 | (escape) | Onbekend |
| … | … | … |
Volledige lijsten:
- Tabel 34 Landen — directe download (publicaties.rvig.nl).
- BRP Landelijke Tabellen — overzicht (RvIG).
- ISO 3166-1 alpha-2 (iso.org).
IND ↔ BRP-LT 56 (verblijfstitel)¶
BRP-Landelijke Tabel 56 Verblijfstitels
levert per verblijfstitel een BRP-code met IND-cross-link. GBO
modelleert Verblijfstitel.aanduiding als
Codelijst~IND (autoritatief
vanuit IND) met cross-walk naar LT 56 voor
BRP-uitwisseling. De cross-walk evolueert mee met IND-beleidswijzigingen.
| BRP-code (LT 56) | IND-aanduiding | Omschrijving |
|---|---|---|
| 9 | (geen verblijfstitel) | Onderdaan EU / EER, geen titel nodig |
| 10 | verblijf onbeperkt | Verblijfsvergunning regulier voor onbepaalde tijd |
| 11 | verblijf bepaald | Verblijfsvergunning regulier voor bepaalde tijd |
| 12 | asiel onbeperkt | Verblijfsvergunning asiel onbepaalde tijd |
| 13 | asiel bepaald | Verblijfsvergunning asiel bepaalde tijd |
| … | … | … |
Volledige lijsten:
- BRP-LT 56 Verblijfstitel — publicaties.rvig.nl, ook beschikbaar via de Haal Centraal BRP Tabellen-API.
- Logisch Ontwerp BRP §11.10.
- IND Verblijfsvergunningen.
Versionering en herindelingen¶
CBS Wijk en Buurt: jaarlijkse herziening¶
CBS herziet Wijk- en Buurtgrenzen jaarlijks via de
Wijk- en Buurtkaart.
Modellering via het Voorkomen-mixin op Wijk en Buurt; bij
grens-mutatie ontstaat een nieuwe versie. Er is geen
nieuweCode-mechanisme: CBS-codes zijn stabiel, alleen de geometrie
muteert.
CBS SBI: verplicht versie-attribuut¶
De overgang van
SBI 2008 naar SBI 2025
maakt versie-aanduiding noodzakelijk. GBO modelleert Activiteit.sbiCode
met een verplicht sbiVersie zodat code en versie samen blijven.
Onderhoudsritme¶
Stelselbrede codelijsten. Voor deelmodel-specifieke codelijsten staat het onderhoudsritme bij het betreffende deelmodel.
| Codelijst | Mutatieritme | Bron |
|---|---|---|
| BRP-LT 32 Nationaliteiten | Halfjaarlijks | RvIG |
| BRP-LT 33 Gemeenten | Jaarlijks (1 januari, gemeentelijke herindelingen) | RvIG |
| BRP-LT 34 Landen | Halfjaarlijks | RvIG |
| BRP-LT 56 Verblijfstitels | Per IND-beleidswijziging | RvIG (afstemming met IND) |
| CBS SBI | Per SBI-revisie | CBS |
| CBS Wijk- en Buurtkaart | Jaarlijks | CBS Open Data |
| ISO 3166 | Sporadisch (paar keer per decennium) | ISO |
| Kadastrale Gemeenten (BRK) | Periodiek (volgt gemeentelijke herindeling) | Kadaster |
| TOOI | Continu | Register van Overheidsorganisaties |
Codelijsten worden bij afnemers als referentie-bestand gehouden, niet hard-gecodeerd. Synchronisatie via de bron-publicatie of de Haal Centraal BRP Tabellen-API, met verifiërende re-resolve bij sleutelmoment (verstrekking, beschikking, inschrijving).