Veldstructuren voor organisaties in het Organisatieregister (datamodel en definities)
- 1 Overzicht parameters in het Organisatieregister
- 2 Veldstructuren voor organisaties in het Organisatieregister
- 2.1 Algemene informatie over de organisatie
- 2.2 Contactinformatie over de organisatie
- 2.3 Functies binnen de organisatie
- 2.4 Hoedanigheden binnen de organisatie (“Capacities”)
- 2.5 Locaties (adressen)
- 2.6 Gebouwen
- 2.7 Historiek (“Parents”)
- 2.8 Benamingen (“Labels”)
- 2.9 Classificaties van de organisatie
- 2.10 Toepassingsgebieden (“Formal Frameworks”)
- 2.11 Sleutels
- 2.12 Regelgeving
- 2.13 Organen
- 2.14 Relaties
- 2.15 Openingsuren
Overzicht parameters in het Organisatieregister
Classificaties, toepassingsgebieden, hoedanigheden, … het zijn allemaal parameters in het Organisatieregister met een unieke code.
In de Excel-file hieronder kan je zowel voor
de test-omgeving (https://api.organisatie.dev-vlaanderen.be/v1/search/organisations?q=*) als voor
de productie-omgeving (https://api.wegwijs.vlaanderen.be/v1/search/organisations?q=*) de namen en bijhorende id’s raadplegen.
Veldstructuren voor organisaties in het Organisatieregister
Algemene informatie over de organisatie
Naam | Definitie | Verplicht? |
|---|---|---|
changeId | de identificator van de laatste change die op de organisatie is uitgevoerd (ihkv. het incrementeel updaten) |
|
changeTime | de datum waarop de laatste change op de organisatie is doorgevoerd |
|
name | de huidige officiële naam |
|
ovoNumber | de identificator (OVO-sleutel) van de organisatie |
|
article | lidwoord van de organisatie: “de” of “het” (toegevoegd in functie van de integratie Vlimpers - Organisatieregister, niet zichtbaar in de UI) |
|
shortName | de korte naam |
|
description | ruimere omschrijving van de organisatie |
|
validity
| de datum waarop de organisatie formeel van start ging |
|
validity
| de datum waarop de organisatie formeel stopgezet werd |
|
operational validity
| de operationele, of onofficiële, begindatum van de organisatie (bv. bij de opzet van een organisatiestructuur in het begin van het jaar (op 01/01) die formeel in werking treedt later dat jaar) |
|
operational validity
| de operationele, of onofficiële, einddatum (bv. het verder bestaan van de organisatie in de administratie/boekhouding nadat de organisatie formeel gestopt is te bestaan) |
|
showOnVlaamseOverheidSites | geeft aan of de organisatie mag getoond worden op Vlaanderen.be (False/True) |
|
purposes ([..]) | de beleidsvelden gekoppeld aan een organisatie |
|
managedBy | ManagedBy betekent dat de creatie van de OVO-code en het beheer van identificerende informatie (zoals naam en levensloop) bij een specifieke organisatie ligt (bv OVO001833 voor AgO indien onder Vlimpersbeheer) |
|
Contactinformatie over de organisatie
Naam | Definitie |
|---|---|
Contacts (recurrent) | Informatie over contactpunten van de organisatie |
Naam | Definitie | Verplicht? |
|---|---|---|
organisationContactId | unieke id van het contactpunt in de organisatie | (indien aanwezig) |
contactTypeId | identificator (uuid) van het contacttype (vb. ‘email’, ‘telefoon’, ‘website’, …) - stabiel voor het contacttype (ook als dit van naam verandert) | (indien aanwezig) |
contactTypeName | naam van het contacttype | (indien aanwezig) |
value | ‘waarde’ v/h contactpunt (concreet telefoonnr of emailadres) |
|
validity
| datum waarop het contactpunt actief wordt |
|
validity
| datum waarop het contactpunt inactief wordt |
|
Functies binnen de organisatie
Naam | Definitie |
|---|---|
functions (recurrent) | Informatie over (voor het register relevante) functies. Functie slaat hier de contractuele band tussen een persoon en een organisatie (bvb. een tewerkstellingscontract of een aanstellingsbesluit). |
Naam | Definitie | Verplicht? |
|---|---|---|
organisationFunctionId | unieke id van het contactpunt in de organisatie | (indien aanwezig) |
functionId | identificator van de functie (stabiel doorheen het register per functie) | (indien aanwezig) |
functionName | naam van de functie | (indien aanwezig) |
personId | de interne identificator van de persoon binnen het register (niet het rijksregisternummer of een andere externe sleutel) die de functie invult | (indien aanwezig) |
personFullName | de naam v/d persoon in de functie die de functie invult |
|
contacts (recurrent) | voor de functie wordt per bestaand contacttype hier de waarde meegegeven. In de vorm van contactTypeId/contactTypeName/value |
|
validity
| datum waarop de functie een start nam |
|
validity
| datum waarop de functie eindigt |
|
Hoedanigheden binnen de organisatie (“Capacities”)
Naam | Definitie |
|---|---|
capacities (recurrent) | Informatie over hoedanigheden binnen een organisatie. Hoedanigheid (soms ook wel rol genoemd) slaat op de (soms minder formele) ‘petjes’ die een persoon kan dragen binnen een organisatie. Het gaat hier minder over de tewerkstellingsrelatie, maar meer over de ‘verschillende hoedanigheden’ waarin personen kunnen optreden binnen een organisatie. Bvb. topkaderfunctie, communicatieambtenaar, … |
Naam | Definitie | Verplicht? |
|---|---|---|
organsiationCapacityId | identificator van de toekenning van de classificatie aan de organisatie | (indien aanwezig) |
capacityId | identificator van het type classificatie dat toegekend wordt aan de organisatie (stabiel doorheen het register) | (indien aanwezig) |
capacityName | naam van de hoedanigheid | (indien aanwezig) |
personId | de interne identificator van de persoon binnen het register (niet het rijksregisternummer of een andere externe sleutel) die de hoedanigheid invult | (indien aanwezig) |
personFullName | de naam v/d persoon in de functie die de hoedanigheid invult |
|
functionId | de identificator van de functie van waaruit de hoedanigheid wordt ingevuld |
|
functionName | naam van de functie |
|
contacts (recurrent) | voor de functie wordt per bestaand contacttype hier de waarde meegegeven. In de vorm van contactTypeId/contactTypeName/value |
|
validity
| datum waarop de hoedanigheid een start nam |
|
validity
| datum waarop de hoedanigheid eindigt |
|
Locaties (adressen)
Naam | Definitie |
|---|---|
locations | informatie mbt. de locaties (adressen) waar een organisatie kan gevonden worden |
Naam | Definitie | Verplicht? |
|---|---|---|
organisationLocationId | identificator van de koppeling van een organisatie aan een adres | (indien aanwezig) |
locationId | identificator van het adres | (indien aanwezig) |
formattedAddress | adresrepresentatie van het adres | (indien aanwezig) |
components | De onderdelen van het adres |
|
| De straat, het huisnummer en eventueel zelfs het busnummer |
|
| de postcode |
|
| de gemeente |
|
| het land |
|
isMainLocation | aanduiding of het adres het hoofdadres is van de organisatie (op één moment kan er maar één hoofdadres zijn) |
|
validity
| startdatum van de koppeling |
|
validity
| einddatum van de koppeling |
|
Gebouwen
Naam | Definitie |
|---|---|
buildings (recurrent) | informatie mbt. de locaties (gebouwen) waar een organisatie kan gevonden worden |
Naam | Definitie | Verplicht? |
|---|---|---|
organisationBuildingId | identificator van de koppeling van een organisatie aan een gebouw | (indien aanwezig) |
buildingId | identificator van het gebouw | (indien aanwezig) |
buildingName | naam van het gebouw | (indien aanwezig) |
isMainBuilding | aanduiding of het gebouw het hoofdgebouw is van de organisatie (op één moment kan er maar één hoofdgebouw zijn) | (indien aanwezig) |
validity
| startdatum van de koppeling |
|
validity
| einddatum van de koppeling |
|
Historiek (“Parents”)
Naam | Definitie |
|---|---|
parents (recurrent) | informatie over de verschillende moederorganisaties die een organisatie kan gehad hebben in de loop van haar bestaan |
Naam | Definitie | Verplicht? |
|---|---|---|
organisationOrganisationParentId | identificator van de koppeling van de organisatie met een parent | (indien aanwezig) |
parentOrganisationId | identificator van de parent waaraan gekoppeld is | (indien aanwezig) |
parentOrganisationName | naam van de parent waaraan gekoppeld is | (indien aanwezig) |
validity
| startdatum van de koppeling |
|
validity
| einddatum van de koppeling |
|
Benamingen (“Labels”)
Naam | Definitie |
|---|---|
labels(recurrent) | Informatie over de verschillende namen waarmee de organisatie gekend is (vb. Engelse naam, Duitse naam, roepnaam, …) |
Naam | Definitie | Verplicht? |
|---|---|---|
organisationLabelId | unieke id van de alternatieve naam | (indien aanwezig) |
labelTypeId | unieke id van het type van alternatieve naam | (indien aanwezig) |
labelTypeName | naam van het type alternatieve naam (vb. ‘Engelse naam’) | (indien aanwezig) |
value | ‘waarde’ (de alternatieve naam zelf) | (indien aanwezig) |
validity
| startdatum van de koppeling |
|
validity
| einddatum van de koppeling |
|
Classificaties van de organisatie
Naam | Definitie |
|---|---|
organisationClassifications (recurrent) | Informatie over de verschillende classificaties waarin de organisatie kan geplaatst worden (vb. departement, IVA, NV, vzw, …) |
Naam | Definitie | Verplicht? |
|---|