...
...
...
Table of Contents |
---|
...
Overzicht
...
Datamodel
Info |
---|
De dataset wordt bij implementatie gemapt op het OSLO-vocabularium Feitelijke Verenigingen (https://data.vlaanderen.be/ns/FeitelijkeVerenigingen/) en het OSLO-vocabularium Organisatie (https://data.vlaanderen.be/ns/organisatie) |
Tip: klik op onderstaand model om het groter te zien.
...
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 meerdere aanwezig zijn, maar ook geen enkel
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 alsnull
groep = een groep van een of meerdere onderliggende eigenschappen, weergegeven als
"groep": { "veld": "waarde", ... }
boolean = een logische waarde die
true
offalse
kan zijnverzameling = nul of meerdere elementen van een andere tabel.
Vereniging
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 |
type | 1 | groep | Mogelijke waarden code en beschrijving: zie https://vlaamseoverheid.atlassian.net/wiki/spaces/AGB/pages/6470042524/Datamodel+Verenigingsregister#Lijst-met-types |
...
Alle datasets die met een groen vinkje gemarkeerd zijn, kan je nu al toevoegen aan een nieuwe vereniging. Deze informatie kan je dus al terugvinden bij het ophalen van de informatie via de beheer API en ook via de publieke API (hier wel zonder vertegenwoordiger en bijhorende contactgegevens).
Veelgestelde vragen bij de datasets
Dataset verenigingen
Expand | ||
---|---|---|
| ||
De vCode is de unieke sleutel voor een vereniging en ziet er uit als volgt: V0001234. De code begint met de letter V (of v) gevolgd door 7 cijfers. De eerst toegekende vCode is V0001001. |
...
title | Wat is de betekenis van het veld korte beschrijving ? |
---|
/spaces/AGB/pages/6470042524/Datamodel+Verenigingsregister#Vereniging-type | |||
| 1 | tekst | mogelijke waarden: zie groep |
| 1 | tekst | mogelijke waarden: zie groep |
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. |
Expand | ||
---|---|---|
| ||
Een vereniging is steeds een van de volgende 3 types:
|
Expand | ||
---|---|---|
| ||
Voor verenigingen met rechtspersoonlijkheid (VZW, iVZW, …) wordt de naam en de korte naam overgenomen uit KBO. Deze kan je in het verenigingsregister niet wijzigen. De roepnaam maakt het voor een KBO-vereniging mogelijk om een naam toe te kennen zoals deze vereniging gebruikelijk genoemd wordt. Dit is trouwens geen verplicht veld. |
Dataset Locatie
Expand | ||
---|---|---|
| ||
Je kan zelf 2 verschillende locatie types opgeven: Correspondentie adres en Plaats van de activiteiten. Elke vereniging heeft maximum 1 correspondentie adres, maar kan wel meerdere activiteit locaties kennen. Een activiteit locatie is een adres (of locatie) waar de activiteiten van de vereniging plaatsvinden. Dit kan een adres zijn, maar (later) ook een geopositie, bijvoorbeeld om een plek in het park aan te duiden. Een correspondentie adres kan gebruikt worden om post naar toe te sturen en moet dus verplicht een adres zijn. |
Expand | ||
---|---|---|
| ||
Van alle locaties kan je max 1 aanduiden als de primaire. De primaire locatie is de locatie waarmee een vereniging het sterkst geassocieerd wordt. Het is niet verplicht om een primaire locatie aan te duiden. Voorbeeld: Onze vereniging komt het meest bijeen in dit zaaltje. Daarom zetten wij dat adres als onze primaire locatie. |
Expand | ||
---|---|---|
| ||
Je kan een adres op 3 manieren opgeven:
|
Expand | ||
---|---|---|
| ||
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, … |
Dataset Contactgegevens
Expand | ||
---|---|---|
| ||
Contactgegevens bij de vereniging zijn te vinden in de publieke datastroom. Dat zijn dus bij voorkeur contactgegevens die niet naar personen verwijzen, zoals bijvoorbeeld info@vereniging.be. Het is wel toegelaten om hier persoonlijke gegevens in te gebruiken (zoals marieke@gmail.com) maar dan moeten de betrokken personen binnen de vereniging hierover geïnformeerd worden. De contactgegevens die bij de vertegenwoordiger geregistreerd worden, zijn enkel beschikbaar voor overheden. |
Expand | ||
---|---|---|
| ||
De contactgegevens worden gecontroleerd op correct formaat. Dat betekent voor:
|
Dataset vertegenwoordigers
Expand | ||
---|---|---|
| ||
Een vertegenwoordiger van een vereniging is een natuurlijk persoon die in naam van de vereniging mag optreden naar de overheid in het kader van een (dienstverlenings)interactie |
Expand | ||
---|---|---|
| ||
Een vertegenwoordiger wordt uniek geïdentificeerd op basis van het rijksregisternummer of BIS nummer, anders gezegd het identificatie nummer van de sociale zekerheid of INSZ. |
Expand | ||
---|---|---|
| ||
In het verenigingsregister willen we de vertegenwoordigers uniek identificeren op basis van hun INSZ. Dat zal hen de mogelijkheid bieden om digitale dienstverlening aan te vragen vanuit hun hoedanigheid als vertegenwoordiger van de vereniging. De Vlaamse bouwsteen ACM/IDM biedt de mogelijkheid om u niet alleen als burger aan te melden, maar ook als vertegenwoordiger van een vereniging. Net zoals u nu reeds kan aanmelden als vertegenwoordiger van een onderneming. Om dit te realiseren is het wel nodig dat we persoon uniek kunnen identificeren op basis van zijn/haar INSZ nummer. |
Expand | ||
---|---|---|
| ||
Het register zal de officiële naam en voornaam van de persoon opvragen bij de Kruispuntbank van de Sociale Zekerheid (KSZ). We geven de mogelijkheid om een alternatieve voornaam op te geven wanneer de gebruikelijke voornaam anders is dan de officiële. (Voorbeeld officiële naam = Jozef, roepnaam = Jos) |
...
title | Wat betekent het veld rol ? |
---|
...
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 | |
| 1 | getal | Vanaf welke leeftijd worden activiteiten voorzien. Default waarde is 0. |
| 1 | getal | Tot welke leeftijd worden activiteiten voorzien. Default waarde is 150. |
status | 1 | tekst | Huidige status van de vereniging. Mogelijke waarden:
|
isUitgeschrevenUitPubliekeDatatroom | 1 | boolean | standaard waarde = false. Deze eigenschap kan enkel voor feitelijke verenigingen gedefinieerd worden. Indien true, betekent dit dat deze feitelijke 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:
|
metadata | 1 | groep | |
| 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” |
relaties | 0..* | verzameling | zie tabel “Relatie” |
Locatie
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:
|
isPrimair | 1 | boolean | Standaardwaarde = 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. |
| 1 | tekst | |
| 1 | tekst | |
| 0..1 | tekst | |
| 1 | tekst | |
| 1 | tekst | |
| 1 | tekst | |
adresvoorstelling | 0..1 | tekst | |
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. |
| 1 | tekst | Mogelijke waarden:
|
| 1 | tekst | Voor bron = AR worden de adresIds weergegeven als een PURI: voorbeeld |
bron | 1 | tekst | Dit veld geeft aan waar deze locatie beheerd wordt Mogelijke waarden:
|
veel gestelde vragen
Expand | ||
---|---|---|
| ||
De volledige integratie met het adresregister wordt in een volgende fase voorzien. Je kan nu al een adres op 3 manieren opgeven:
|
Expand | ||
---|---|---|
| ||
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
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 |
type | 1 | tekst | Mogelijke waarden:
|
waarde | 1 | tekst | de inhoud van dit veld is afhankelijk van het type:
|
beschrijving | 0..1 | tekst | Label dat definieert over welke set contactgegevens in deze set getoond worden. Voorbeelden: “Algemeen”, “Jeugdwerking”, … |
isPrimair | 1 | boolean | Standaard waarde = Dit veld geeft aan per vereniging en per type contact of dit contactgegeven als belangrijkste wordt aanzien. Zo is er per vereniging dus max 1 primair e-mail adres, max 1 primair telefoonnummer… |
bron | 1 | tekst | Dit veld geeft aan waar dit contactgegeven beheerd wordt Mogelijke waarden:
|
veel gestelde vragen
Expand | ||
---|---|---|
| ||
Contactgegevens bij de vereniging zijn te vinden in de publieke datastroom. Dat zijn dus bij voorkeur contactgegevens die niet naar personen verwijzen, zoals bijvoorbeeld info@vereniging.be. Het is wel toegelaten om hier persoonlijke gegevens in te gebruiken (zoals marieke@gmail.com) maar dan moeten de betrokken personen binnen de vereniging hierover geïnformeerd worden. De contactgegevens die bij de vertegenwoordiger geregistreerd worden, zijn enkel beschikbaar voor overheden. |
Vertegenwoordiger
Eigenschap | Kardinaliteit | Formaat | Uitleg |
---|---|---|---|
vertegenwoordigerId | 1 | getal | unieke identificatie van de vertegenwoordiger binnen de vereniging - dit is een getal zonder verdere betekening - start vanaf 1 en gaat sequentieel verder |
insz | 1 | tekst | insz = Identificatie nummer sociale zekerheid. Dit is het rijksregisternummer of BIS-nummer van de persoon zoals gekend in de Kruispuntbank van de Sociale zekerheid (KSZ) |
voornaam | 1 | tekst | |
achternaam | 1 | tekst | |
roepnaam | 0..1 | tekst | Eventuele roepnaam , Voorbeeld: officiële naam = Jozef, Roepnaam = Jos |
rol | 0..1 | tekst | Optioneel en vrij invulbaar veld - welke rol speelt deze persoon in de organisatie, voorbeeld: |
isPrimair | 1 | boolean | Standaardwaarde = De primaire vertegenwoordiger is de persoon die een overheid kan contacteren wanneer zij in contact willen treden met de vereniging. Elke vereniging heeft max 1 primaire vertegenwoordiger.(0 of 1 dus) |
0..1 | tekst | het e-mailadres waarmee men deze persoon kan bereiken. Dit kan een privé e-mailadres (persoon@gmail.com) zijn of een e-mailadres voor deze persoon binnen deze vereniging (persoon@vereniging.be) | |
telefoon | 0..1 | tekst | vaste lijn nummer waarop men deze persoon kan bereiken |
mobiel | 0..1 | tekst | mobiel nummer waarop men deze persoon kan bereiken |
socialMedia | 0..1 | tekst | social media kanaal waarop men deze persoon via direct messaging kan bereiken |
bron | 1 | tekst | Dit veld geeft aan waar deze vertegenwoordiger beheerd wordt Mogelijke waarden:
|
veel gestelde vragen
Expand | ||
---|---|---|
| ||
Een vertegenwoordiger van een vereniging is een natuurlijk persoon die in naam van de vereniging mag optreden naar de overheid in het kader van een (dienstverlenings)interactie |
Expand | ||
---|---|---|
| ||
Het register zal de officiële naam en voornaam van de persoon opvragen bij de Kruispuntbank van de Sociale Zekerheid (KSZ). We geven de mogelijkheid om een alternatieve voornaam op te geven wanneer de gebruikelijke voornaam anders is dan de officiële. (Voorbeeld officiële naam = Jozef, roepnaam = Jos) |
Expand | ||
---|---|---|
| ||
In het verenigingsregister willen we de vertegenwoordigers uniek identificeren op basis van hun INSZ. Dat zal hen de mogelijkheid bieden om digitale dienstverlening aan te vragen vanuit hun hoedanigheid als vertegenwoordiger van de vereniging. De Vlaamse bouwsteen ACM/IDM biedt de mogelijkheid om u niet alleen als burger aan te melden, maar ook als vertegenwoordiger van een vereniging. Net zoals u nu reeds kan aanmelden als vertegenwoordiger van een onderneming. Om dit te realiseren is het wel nodig dat we persoon uniek kunnen identificeren op basis van zijn/haar INSZ nummer. |
Hoofdactiviteit Verenigingsloket
Eigenschap | Kardinaliteit | Formaat | Uitleg |
---|---|---|---|
code | 1 | tekst | |
beschrijving | 1 | tekst |
Sleutel
Eigenschap | Kardinaliteit | Formaat | Uitleg |
---|---|---|---|
bron | 1 | tekst | Mogelijke waarden:
|
waarde | 1 | tekst | Bevat de unieke identificatie van deze vereniging binnen de externe bron. Dit si dus afhankelijk van de bron
|
Relatie
Eigenschap | Kardinaliteit | Formaat | Uitleg |
---|---|---|---|
type | 1 | tekst | Mogelijke waarden:
|
andereVereniging | 1 | groep | geeft informatie over de vereniging waarmee deze vereniging een relatie heeft |
| 0..1 | tekst | unieke identificatie van deze vereniging in KBO |
| 0..1 | tekst | unieke identificatie van deze vereniging in het verenigingsregister |
| 1 | tekst | de naam van de vereniging zoals gekend in VR en/of KBO |
Afhankelijk van het type relatie zijn de velden van andere vereniging al dan niet ingevuld
relatie type | andereVereniging | kboNummer | vCode | naam |
---|---|---|---|---|
is afdeling van | de andere vereniging geeft de moeder vereniging van deze afdeling weer (een KBO vereniging dus) | steeds ingevuld | kan ingevuld zijn, indien de moeder ook geregistreerd is in het verenigingsregister | bevat de officiële naam van de moeder, zoals gedefinieerd in KBO |
heeft als afdeling | de andere vereniging geeft de afdeling aan die onderdeel is van deze vereniging | altijd leeg | altijd ingevuld | altijd ingevuld |
Gebeurtenis
Eigenschap | Kardinaliteit | Formaat | Uitleg |
---|---|---|---|
beschrijving | 1 | tekst | Tekst die beschrijft wat er veranderd is, voorbeeld |
gebeurtenis | 1 | tekst | Definitie van het type wijziging zonder extra context informatie, voorbeeld |
data | 1 | object | Dit veld bevat in JSON formaat de relevante gegevens die gebruikt werden bij deze gebeurtenis. Hierin kan je dan bijvoorbeeld bij een locatie terugvinden welke adrescomponenten doorgegeven werden |
initiator | 1 | tekst | Dit veld geeft aan wie deze gebeurtenis heeft aangereikt aan het verenigingsregister |
tijdstip | 1 | tekst | datum en tijdstip van de gebeurtenis, formaat = Zulu-time, voorbeeld |
Datadefinities en gebruik
...
Er zijn 6 mogelijke types verenigingen die geregistreerd kunnen worden. Sommige types zijn gekend in KBO, andere niet. De types gekend in KBO dragen de naam van de rechtsvorm zoals gekend in KBO.
Code | Beschrijving | Uitleg | |
---|---|---|---|
1 | FV | Feitelijke Vereniging | Een feitelijke vereniging ontstaat zodra twee of meer mensen samen belangeloos een gemeenschappelijk doel nastreven. Er zijn geen vormvereisten en de vereniging heeft geen rechtspersoonlijkheid (bijvoorbeeld een wijkcomité, een kaartersclubje, ...) |
2 | AFD | Afdeling | Een afdeling van een vzw is ook een samenwerking tussen twee of meer mensen die belangeloos een gemeenschappelijk doel nastreven, maar is verbonden aan een overkoepelende vzw (met eigen KBO-nummer). Het is een lokale verankering (zonder KBO-nummer) die afhankelijk is van de werking van de overkoepelende vzw: stopt de overkoepelende vzw, dan stopt ook de lokale afdeling (bijvoorbeeld lokale afdelingen van het Rode Kruis, Natuurpunt, ...). |
3 | VZW | Vereniging Zonder Winstoogmerk | Een vereniging zonder winstoogmerk (vzw) is een groep natuurlijke personen of rechtspersonen die een belangeloos doel nastreven. De vzw bestaat uit ten minste twee personen. De leden van een vzw mogen geen vermogensvoordeel genieten door de vzw. Dit type is ook gekend in KBO met de rechtsvorm “vereniging zonder winstoogmerk”. |
4 | IVZW | Internationale Vereniging zonder Winstoogmerk | De internationale vereniging zonder winstoogmerk is een groepering van natuurlijke personen of rechtspersonen die een belangeloos doel van internationaal nut nastreeft. Dit type is ook gekend in KBO met de rechtsvorm “Internationale Vereniging zonder Winstoogmerk”. |
5 | PS | Private stichting | Een private stichting heeft net zoals een VZW een belangeloos doel. Dit type is ook gekend in KBO met de rechtsvorm “Private Stichting”. |
6 | SVON | Stichting van Openbaar nut | Een stichting van Openbaar nut heeft net zoals een VZW en een private stichting een belangeloos doel. Dit type is ook gekend in KBO met de rechtsvorm “Stichting van Openbaar nut”. |
Doelgroep (leeftijd) Verenigingsloket
...
Er zijn 21 mogelijke hoofdactiviteiten die kunnen worden toegekend.
Code | Beschrijving | |
---|---|---|
1 | BIAG | Burgerinitiatief & Actiegroep |
2 | BWWC | Buurtwerking & Wijkcomité |
3 | DINT | Diversiteit & Integratie |
4 | GEWE | Gezondheid & Welzijn |
5 | HOSP | Hobby & Spel |
6 | INOS | Internationaal & Onwikkelingssamenwerking |
7 | JGDW | Jeugdwerk |
8 | KLDU | Klimaat & Duurzaamheid |
9 | KECU | Kunsten, Erfgoed & Cultuur |
10 | LAVI | Landbouw & Visserij |
11 | LEBE | Levensbeschouwelijk |
12 | MADP | Maatschappelijke dienstverlening & Politiek |
13 | MEDG | Mediawijsheid & Digitale geletterdheid |
14 | MROW | Mobiliteit, Ruimtelijke ordening & Wonen |
15 | NMDW | Natuur, Milieu & Dierenwelzijn |
16 | VORM | Onderwijs & Vorming |
17 | SOVO | Sociaal-cultureel volwassenenwerk |
18 | SPRT | Sport |
19 | ONWE | Technologie & Wetenschap |
20 | TOER | Toerisme |
21 | WESE | Werk & Sociale economie |
Gebruik codelijst
Omdat er in de praktijk vaak meer dan één hoofdactiviteit van toepassing is, kunnen verenigingen via het Verenigingsloket maximum 3 hoofdactiviteiten aanduiden. Daarmee kunnen ze nuance aanbrengen en aangeven dat ze in verschillende gebieden/thema’s/werkvelden actief zijn.
Het register zet geen maximum op het aantal hoofdactiviteiten die toegekend kunnen worden. Besturen die via eigen systemen verenigingsgegevens beheren, kunnen indien nodig, meer dan 3 hoofdactiviteiten aanduiden.
Om te garanderen dat de indeling in hoofdactiviteiten maximaal bruikbaar is, wordt er gestreefd naar een zo kort mogelijke lijst van hoofdactiviteiten, die tegelijk zo veel mogelijk verenigingen afdekt. Ook moeten de benamingen zo begrijpelijk mogelijk zijn voor een breed publiek. Deze principes hebben voorrang op overwegingen met betrekking tot de inhoudelijke consistentie.
...