/
Datamodel verenigingsregister

Datamodel verenigingsregister

Overzicht

image-20250725-095343.png

 

Detail per tabel

Kardinaliteit:

  • 1: Deze eigenschap heeft steeds een waarde

  • 0..1: optioneel veld - kan dus ook leeg zijn

  • 0..*: van dit element kunnen er nul, 1 of meerdere aanwezig zijn

Mogelijke formaten:

  • tekst = tekstveld met 0 of meer karakters, het lege veld is ""

  • getal = een numeriek veld, een geheel getal. Deze eigenschap heeft altijd een waarde.

  • datum = datumveld in ISO formaat = "yyyy-mm-dd". Een lege datum wordt in de beheer functies doorgegeven als "" en wordt teruggegeven als null

  • groep = een groep van een of meerdere onderliggende eigenschappen, weergegeven als "groep": { "veld": "waarde", ... }

  • boolean = een logische waarde die true of false kan zijn

  • verzameling = nul of meerdere elementen van een andere tabel.

Vereniging

De dataset zelf wordt gemapt op zowel Feitelijke vereniging (als specialisatie van Vereniging) als op een geregistreerde organisatie (voor de VZW’s). Al deze mogelijkheden zijn allen specialisaties van een Organisatie.

Interessante opmerkingen over het model: een VZW is tegelijk een vereniging en een geregistreerde organisatie - https://github.com/Informatievlaanderen/OSLOthema-feitelijkeVerenigingen/issues/48

Een dubbele vereniging wordt weergegeven met de relatie http://www.w3.org/2002/07/owl#sameAs . Dit is zowel voor de verebniging die gemarkeerd werd als dubbel (met de verwijzing naar de andere via veld isDubbelVan) als voor de vereniging die blijft bestaan (via het veld corresponderendeVCodes)

Eigenschap

Kardinaliteit

Formaat

Uitleg

Eigenschap

Kardinaliteit

Formaat

Uitleg

vCode

1

tekst

De unieke identificatie van een vereniging.

Dit veld begint met de letter V en wordt gevolgd door 7 cijfers. voorbeeld V0012345. Er zit geen betekenis achter deze cijfers, ook geen controlegetal. De eerste vereniging is V0001001, gevolgd door V0001002, V0001003, ...

verenigingsType

1

groep

Mogelijke waarden code en naam: zie Datamodel verenigingsregister | Lijst met types

Zie ook Datamodel verenigingsregister | Vereniging type

  • code

1

tekst

mogelijke waarden: zie groep

  • naam

1

tekst

mogelijke waarden: zie groep

verenigingssubtype

0..1

groep

Mogelijke waarden code en naam: zie Datamodel verenigingsregister | Subtypes voor VZER

Dit veld is enkel beschikbaar voor verenigingen van type VZER

  • code

1

tekst

mogelijke waarden: zie groep

  • naam

1

tekst

mogelijke waarden: zie groep

subverenigingVan

0..1

groep

Dit veld is enkel beschikbaar wanneer type = VZER en subtype : SUB. Zie beschrijving velden in subverenigingvan

naam

1

tekst

De volledige naam van de vereniging. Voor KBO-verenigingen is dit de officiële naam

roepnaam

0..1

tekst

Eigen naam die enkel kan gegeven worden aan KBO-verenigingen - dit veld is enkel beschikbaar voor KBO-verenigingen

korteNaam

0..1

tekst

korte naam of afkorting. Voor KBO-verenigingen is dit de officiële korte naam

korteBeschrijving

0..1

tekst

De korte beschrijving beschrijft de vereniging in leesbare zinnen. Hierin beschrijft de vereniging zichzelf, hun doel en hun activiteiten. Deze tekst kan bestaan uit meerdere lijnen, maar in het register wordt deze opgeslagen als 1 grote tekstblok.

startdatum

0..1

datum

datum waarop de vereniging is opgericht. Deze datum mag niet in de toekomst liggen (max vandaag dus)

einddatum

0..1

datum

datum waarop de vereniging is stopgezet. Deze datum is enkel beschikbaar voor verenigingen met status gestopt. Ook deze datum moet altijd in het verleden liggen en groter of gelijk zijn aan de startdatum.

doelgroep

1

groep

zie Datamodel verenigingsregister | Doelgroep (leeftijd) Verenigingsloket

  • minimumleeftijd

1

getal

Vanaf welke leeftijd worden activiteiten voorzien. Default waarde is 0.

  • maximumleeftijd

1

getal

Tot welke leeftijd worden activiteiten voorzien. Default waarde is 150.

status

1

tekst

Huidige status van de vereniging.

Mogelijke waarden:

  • Actief

  • Gestopt

  • Dubbel

isUitgeschrevenUitPubliekeDatatroom

1

boolean

standaard waarde = false.

Deze eigenschap kan enkel voor verenigingen zonder eigen rechtspersoonlijkheid gedefinieerd worden. Indien true, betekent dit dat deze vereniging zich niet publiek kenbaar wenst te maken en dus uit de publieke datastroom wordt gehouden.

bron

1

tekst

Wie beheert de levensloop van deze vereniging?

Mogelijke waarden:

  • Initiator: Deze vereniging wordt beheerd door een gegevens initiator - dit is geldig voor verenigingen zonder eigen rechtspersoonlijkheid

  • KBO: De levensloop wordt in KBO bepaald - dit is geldig voor de verenigingen met rechtspersoonlijkheid

isDubbelVan

0..1

tekst

Dit veld wordt enkel ingevuld wanneer de status van deze vereniging = Dubbel. In dit geval bevat dit veld de vCode van de andere vereniging waarvan deze een dubbel is.

corresponderendeVCodes

0..*

tekst

Deze lijst bevat de vCodes van alle vereniging die als dubbel gemarkeerd zijn van deze vereniging.

metadata

1

groep

 

  • datumLaatsteAanpassing

1

datum

Datum dat er voor het laatst ergens iets is aangepast voor deze vereniging

hoofdactiviteitenVerenigingsloket

0..*

verzameling

zie tabel Hoofdactiviteit Verenigingsloket

contactgegevens

0..*

verzameling

zie tabel Contactgegeven

locaties

0..*

verzameling

zie tabel Locatie

vertegenwoordigers

0..*

verzameling

zie tabel Vertegenwoordiger

sleutels

0..*

verzameling

zie tabel Sleutel

lidmaatschappen

0..*

verzameling

zie tabel Lidmaatschappen

werkingsgebieden

0..*

verzameling

zie tabel Werkingsgebieden

Locatie

Voor elke vereniging zijn er 0..* locaties. Je kan dus verenigingen hebben zonder locaties, maar er kunnen er meerdere zijn.

Per locatie type is het een ander verhaal:

  • Er is max 1 correspondentie adres (0 of 1 dus)

  • Er zijn meerdere activiteiten adressen mogelijk (0..*)

  • Als er een KBO nummer is opgegeven dan is er meestal een locatie van het type Maatschappelijk zetel volgens KBO, anders is er geen.

Onderling is er geen enkel verband. Zo kan je bijvoorbeeld gerust meerdere activiteiten adressen hebben zonder een correspondentie adres.

Zie ook: https://data.vlaanderen.be/doc/applicatieprofiel/adresregister/

Elke locatie verwijst naar Vestiging met daarin het vestigingsadres van het type Contactinfo, meer bepaald adres van het type Adresvoorstelling

Eigenschap

Kardinaliteit

Formaat

Uitleg

Eigenschap

Kardinaliteit

Formaat

Uitleg

locatieId

1

getal

unieke identificatie van deze locatie binnen de vereniging - dit is een getal zonder verdere betekening - start vanaf 1 en gaat sequentieel verder

locatietype

1

tekst

Mogelijke waarden:

  • Correspondentie - maximum 1 per vereniging - Een correspondentie adres kan gebruikt worden om post naar toe te sturen

  • Activiteiten - Een activiteit locatie is een adres waar de activiteiten van de vereniging plaatsvinden.

  • Maatschappelijke zetel volgens KBO - enkel beschikbaar voor KBO verenigingen

isPrimair

1

boolean

Standaardwaarde = false

De primaire locatie is de locatie waarmee een vereniging het sterkst geassocieerd wordt. Voorbeeld: Onze vereniging komt het meest bijeen in dit zaaltje. Daarom zetten wij dat adres als onze hoofdlocatie.

Elke vereniging heeft max 1 hoofdlocatie.(0 of 1 dus)

naam

0..1

tekst

naamgeving van deze locatie. Voorbeeld: “speelplein Dorpegem”

adres

0..1

groep

Blok dat bestaat uit adrescomponenten. Dit blok kan ook afwezig zijn, maar dan moet het blok adresId aanwezig zijn. Beide blokken kunnen ook samen aanwezig zijn.

  • straatnaam

1

tekst

 

  • huisnummer

1

tekst

 

  • busnummer

0..1

tekst

 

  • postcode

1

tekst

 

  • gemeente

1

tekst

 

  • land

1

tekst

 

adresvoorstelling

0..1

tekst

Volledig adres samengesteld uit de elementen van groep adres. Voorbeeld: “Straat 1, 1234 Gemeente" of indien busnummer aanwezig is "Straat 1 bus 2, 1234 Gemeente"

adresId

0..1

groep

Blok dat een adresidentificatie via een extern register bevat. Dit blok kan ook afwezig zijn, maar dan moet het blok adres aanwezig zijn. Beide blokken kunnen ook samen aanwezig zijn.

  • broncode

1

tekst

Mogelijke waarden:

  • AR = adresregister

  • bronwaarde

1

tekst

Voor bron = AR worden de adresIds weergegeven als een PURI: voorbeeld https://data.vlaanderen.be/id/adres/3706808

bron

1

tekst

Dit veld geeft aan waar deze locatie beheerd wordt

Mogelijke waarden:

  • Initiator - Deze locatie werd toegevoegd door een gegevens initiator. Deze locatie mag vrij gewijzigd worden alsook verwijderd.

  • KBO - Deze locatie is afkomstig uit KBO (de maatschappelijke zetel volgens KBO) - Deze locatie mag niet verwijderd worden en enkel verrijkt met naam en isPrimair

veel gestelde vragen

De volledige integratie met het adresregister wordt in een volgende fase voorzien. Je kan nu al een adres op 3 manieren opgeven:

  • op basis van de adrescomponenten (straat, huisnummer, postcode, gemeente…). Na integratie met het adresregister, gaan wiji dat geval trachten om een adresID op te zoeken dat overeenstemt met deze componenten. Als dat niet lukt, dan worden de adressen opgeslagen zoals we deze ontvangen hebben.

  • op basis van een adres identificator. Dan geef je voor een adres de juiste identificator uit het adresregister mee. Na integratie met het adresregister, halen wij dan het juiste adres op uit het adresregister en geven het zo weer aan eenieder die het adres van de vereniging opvraagt.

  • de combinatie van beide. Na integratie met het adresregister, gaan we het adres overnemen vanuit het adresregister.

In een latere fase zal het mogelijk zijn om voor een vereniging een activiteiten adres toe te voegen als een geopositie, een punt op de kaart. Dit kan dan gebruikt worden voor verenigingen die hun activiteiten laten doorgaan in een park, in een bos, … Je kan nu al eventueel een gedeeltelijk adres ingeven, waar je dan tot op straat niveau gaat en bij huisnummer een indicatie invult, zoals “zonder nummer” of “tussen nummers 5 en 7”

Contactgegeven

Voor elke vereniging zijn er 0..* contactgegevens beschikbaar.

Deze dataset wordt in Oslo gemapt op de entiteit ContactInfo, welke gelinkt is met een FeitelijkeVereniging

Eigenschap

Kardinaliteit

Formaat

Uitleg

Eigenschap

Kardinaliteit

Formaat

Uitleg

contactgegevenId

1

getal

unieke identificatie van dit contactgegeven binnen de vereniging - dit is een getal zonder verdere betekening - start vanaf 1 en gaat sequentieel verder

contactgegevenType

1

tekst

Mogelijke waarden:

  • e-mail - een e-mail adres van de vereniging

  • telefoon - een telefoon nummer (vast of mobiel) van de vereniging

  • website - een URL

  • socialMedia - een URL van een social Media platform waar informatie van de vereniging beschikbaar is

waarde

1

tekst

de inhoud van dit veld is afhankelijk van het type:

  • e-mail : een e-mail adres, zoals bvb info@vereniging.be (naam@domein.extensie - in naam worden de volgende tekens toegestaan '!#$%&'*+/=?^_`{|}~-', in domein enkel '.' en '-'.")

  • telefoon: Een telefoonnummer moet bestaan uit cijfers (minstens 1), whitespace en \". / ( ) - + \"

  • website en socialMedia zijn beide URLs . Deze moeten beginnen met http:// of https:// en minstens 1 punt bevatten.

beschrijving

0..1

tekst

Label dat definieert over welke set contactgegevens in deze set getoond worden. Voorbeelden: “Algemeen”, “Jeugdwerking”, …

isPrimair

1

boolean

Standaard waarde = false