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? |
---|---|---|
organisationOrganisationClassificationId | identificator van de toekenning van de classificatie aan de organisatie | (indien aanwezig) |
organisationClassificationTypeId | identificator van het type classificatie dat toegekend wordt aan de organisatie (stabiel doorheen het register) | (indien aanwezig) |
organisationClassificationTypeName | naam van het type classificatie dat toegekend wordt aan de organisatie (stabiel doorheen het register) | (indien aanwezig) |
organisationClassificationId | identificator van de classificatie |
|
organisationClassificationName | naam van de classificatie |
|
validity
| datum waarop declassificatietoewijzing actief wordt |
|
validity
| datum waarop de classificatietoewijzing inactief wordt |
|
Toepassingsgebieden (“Formal Frameworks”)
Naam | Definitie |
---|---|
formalFrameworks (recurrent) | informatie over de toepassingsgebieden (de verschillende wettelijke kaders) waarbinnen een organisatie ressorteert |
Naam | Definitie | Verplicht? |
---|---|---|
organisationFormalFrameworkId | identificator van de koppeling van een organisatie aan een toepassingsgebied | (indien aanwezig) |
formalFrameworkId | identificator van het toepassingsgebied | (indien aanwezig) |
formalFrameworkName | naam van het toepassingsgebied | (indien aanwezig) |
parentOrganisationId | identificator van de moederentiteit van de organisatie binnen het toepassingsgebied | (indien aanwezig) |
parentOrganisationName | naam van de moederentiteit van de organisatie binnen het toepassingsgebied | (indien aanwezig) |
validity
| startdatum van de toewijzing binnen het toepassingsgebied |
|
validity
| einddatum van de toewijzing binnen het toepassingsgebied |
|
Sleutels
Naam | Definitie |
---|---|
keys (recurrent) | informatie mbt. verschillende referentiesleutels waarmee een organisatie in derde systemen geïdentificeerd wordt (vb. ondernemingsnummer binnen KBO) |
Naam | Definitie | Verplicht? |
---|---|---|
organisationKeyId | unieke id van de sleuteltoekenning | (indien aanwezig) |
keyTypeId | unieke id van het type van sleutel | (indien aanwezig) |
keyTypeName | naam van het type sleutel, oftewel aanduiding van het informatiesysteem waarin de sleutel gebruikt kan worden (vb. ‘KBO’) | (indien aanwezig) |
value | ‘waarde' (de sleutel) | (indien aanwezig) |
validity
| datum waarop de sleutel actief wordt |
|
validity
| datum waarop de sleutel inactief wordt |
|
Regelgeving
Naam | Definitie |
---|---|
regulations (recurrent) | regelgeving m.b.t. de organisatie (bv. oprichtingsdecreet, personeelsregelgeving). Enkel toegepast voor de Vlaamse overheid en met voornaamste doel: doorstroom en presentatie op Vlaanderen.be |
Naam | Definitie | Verplicht? |
---|---|---|
organisationRegulationId | uniek id van de koppeling van de regelgeving en de organisatie | (indien aanwezig) |
regulationThemeId | unieke id van het regelgevingthema |
|
regulationTheme | regelgevingthema |
|
regulationSubThemeId | unieke id van het regelgevingsubthema |
|
regulationSubtheme | regelgevingsubthema |
|
name | naam van de regelgeving | (indien aanwezig) |
date | datum van de regelgeving |
|
URL | URL die verwijst naar de regelgeving (vb. link naar Codex) |
|
workRulesURL | URL die verwijst naar het arbeidsreglement |
|
description | rijke, opgemaakte beschrijving van de regelgeving (i.f.v. doorstroom naar Vlaanderen.be) |
|
validity
| datum waarop de regelgeving actief wordt |
|
validity
| datum waarop de regelgeving inactief wordt |
|
Organen
Naam | Definitie |
---|---|
bodies (recurrent) | organen (bv. adviesraden of raden van bestuur) die tot de organisatie behoren |
Naam | Definitie | Verplicht? |
---|---|---|
bodyOrganisationId | uniek id van de koppeling van de organisatie en het orgaan | (indien aanwezig) |
bodyId | unieke id van het orgaan | (indien aanwezig) |
bodyName | naam van het orgaan | (indien aanwezig) |
validity
| datum waarop het orgaan actief wordt |
|
validity
| datum waarop het orgaan stopt te bestaan |
|
Relaties
Naam | Definitie |
---|---|
relations (recurrent) | relatie van de organisatie met een andere organisatie (bv. “is opvolger van”) |
Naam | Definitie | Verplicht? |
---|---|---|
organisationRelationId | unieke id van de relatie | (indien aanwezig) |
relationId | unieke id van het type relatie | (indien aanwezig) |
relationName | naam van de relatie (bv. “is opvolger van”) | (indien aanwezig) |
relatedOrganisationID | unieke id van de gerelateerde organisatie | (indien aanwezig) |
relatedOrganisationOvoNumber | OVOnummer van de gerelateerde organisatie | (indien aanwezig) |
relatedOrganisationName | naam van de gerelateerde organisatie | (indien aanwezig) |
validity
| datum waarop de relatie actief wordt |
|
validity
| datum waarop de relatie inactief wordt |
|
Openingsuren
Naam | Definitie |
---|---|
openingHours (recurrent) | openingsuren van de organisatie |
Naam | Definitie | Verplicht? |
---|---|---|
organisationOpeningHourID | unieke id van de koppeling van de organisatie aan openingsuren | (indien aanwezig) |
opens | het openingsuur | (indien aanwezig) |
closes | het sluitingsuur | (indien aanwezig) |
dayOfWeek | de dag van de week | (indien aanwezig) |
validity
| datum waarop de openingsuren actief worden |
|
validity
| datum waarop de openingsuren inactief worden |
|