🌎 Werkingsgebieden - Als GI wil ik de werkingsgebieden van een vereniging beheren
Beschrijving
Korte beschrijving van de mogelijkheden
We beheren de velden uit Datamodel verenigingsregister :
Definitie van de werkingsgebieden bij registratie van een vereniging zonder eigen rechtspersoonlijkheid
Wijzigen van de werkingsgebieden voor een bestaande vereniging (eender welk type, ook KBO verenigingen)
PATCH <beheerURL>/v1/verenigingen/<vCode>ofPATCH <beheerURL>/v1/verenigingen/<vCode>/kbo(=zelfde URL als voor beheer basisgegevens)
Velden beschikbaar in de API
De lijst van mogelijke waarden voor het veld Code is terug te vinden via 🔢 Parameter API - Als afnemer wil ik mogelijke waarden van codelijsten opvragen
Zowel bij registreer als bij wijzig kan je telkens een set van werkingsgebieden opgeven op basis van hun Code., voorbeeld ["BE25","BE22"].
Je kan alle werkingsgebieden verwijderen door als werkingsgebied de lege array op te geven: []
Je kan niet 1 werkingsgebied toevoegen of verwijderen. Je moet telkens de volledige set terug opgeven.
Het wijzigen van de werkingsgebieden gebeurt in dezelfde API als het wijzigen van de basisgegevens van de vereniging.
Validaties
Codemoet een gekende waarde zijnCodemag maar 1 keer voorkomen per verenigingde speciale waarde
NVTmag niet gecombineerd worden met andere waarden
Events bij werkingsgebieden
In de historiek worden aparte events gemaakt, afhankelijk van de waarden die werden opgegeven.
Bij registratie van een nieuwe VZER
zonder opgave van het veld
werkingsgebiedenOF metwerkingsgebieden: []event =
verenigingZonderEigenRechtspersoonlijkheidWerdGeregistreerd, in het data element staan geen werkingsgebieden
met
werkingsgebieden: ["NVT]event =
verenigingZonderEigenRechtspersoonlijkheidWerdGeregistreerd, in het data element staan geen werkingsgebiedeneen 2e event =
WerkingsgebiedenWerdenNietVanToepassing
met
werkingsgebieden: [<1 of meerdere waarden>]event =
verenigingZonderEigenRechtspersoonlijkheidWerdGeregistreerd, in het data element staan geen werkingsgebiedeneen 2e event
WerkingsgebiedenWerdenBepaaldmet in de data de opgegeven waarden
Bij wijziging van de werkingsgebieden (voor FV of KBO) zijn de volgende events mogelijk:
WerkingsgebiedenWerdenNietVanToepassingWerkingsgebiedenWerdenBepaaldWerkingsgebiedenWerdenNietBepaaldWerkingsgebiedenWerdenGewijzigd
De tabel hieronder geeft aan wanneer welk event gegenereerd wordt, afhankelijk van de waarde voor en na de wijziging
Bij wijziging naar | wanneer waarde was | dan wordt event gegenereerd |
|---|---|---|
[] | [] | <geen wijziging> |
[] | eender wat anders |
|
NVT | NVT | <geen wijziging> |
NVT | eender wat anders |
|
Waarden | zelfde waarden | <geen wijzigingen> |
Waarden | NVT of [] |
|
Waarden | andere waarden |
|