/
👬 Vertegenwoordigers - Als GI wil ik de vertegenwoordigers van een vereniging beheren, inclusief contactgegevens

👬 Vertegenwoordigers - Als GI wil ik de vertegenwoordigers van een vereniging beheren, inclusief contactgegevens

Beschrijving

Korte beschrijving van de mogelijkheden

  • Definiëren van de initiële set van vertegenwoordigers bij het registreren van een nieuwe vereniging

  • toevoegen van een persoon als vertegenwoordiger van een vereniging

    • POST <beheerURL>/v1/verenigingen/<vCode>/vertegenwoordigers

  • verwijderen van een vertegenwoordiger

    • DEL <beheerURL>/v1/verenigingen/<vCode>/vertegenwoordigers/<vertegenwoordigerId>

  • wijzigen van de gegevens van een vertegenwoordiger

    • PÄTCH <beheerURL>/v1/verenigingen/<vCode>/vertegenwoordigers/<vertegenwoordigerId>

Registreren, toevoegen en verwijderen is enkel mogelijk voor verenigingen zonder eigen rechtspersoonlijkheid

Wijzigen is ook mogelijk voor vertegenwoordigers van KBO verenigingen

Velden beschikbaar in de API

Alle velden uit dataset vertegenwoordigers zijn beschikbaar, behalve:

  • INSZ kan enkel opgegeven worden bij het toevoegen van een persoon (bij registratie van de vereniging of achteraf)

  • Voor- en achternaam kan je enkel meegeven wanneer je ook het INSZ meegeeft. (dus enkel bij registreren van een vereniging en bij toevoegen van een vertegenwoordiger)

Validaties

Regel

Geldig bij registreren

Geldig bij toevoegen

Geldig bij wijzigen

Geldig bij verwijderen

Regel

Geldig bij registreren

Geldig bij toevoegen

Geldig bij wijzigen

Geldig bij verwijderen

Het INSZ nummer is verplicht

x

x

 

 

Er kan slechts 1 primair vertegenwoordiger zijn

x

x

x

 

Contactgegevens moeten een juist formaat bevatten (1)

x

x

x

 

vCode moet gekend zijn

 

x

x

x

vertegenwoordiger moet gekend zijn

 

 

x

x

INSZ formaat moet juist zijn (2)

x

x

 

 

Een INSZ nummer is uniek per vereniging (3)

x

x

 

 

De voornaam is verplicht

x

x

 

 

De voornaam mag geen cijfers bevatten en minstens 1 karakter a-z of A-Z

x

x

 

 

De achternaam is verplicht

x

x

 

 

De achternaam mag geen cijfers bevatten en minstens 1 karakter a-z of A-Z

x

x

 

 

Toevoegen en verwijderen enkel mogelijk voor FV en AFD

x

x

 

x

De laatste vertegenwoordiger mag niet verwijderd worden

 

 

 

x

Vanaf Q1 2026:

 

 

 

 

Het INSZ moet bestaan in KSZ

x

x

 

 

De persoon mag niet overleden zijn

x

x

 

 

(1) Formaat van de contactgegevens:

  • Net zoals contactgegevens bij ☎️ Contactgegevens - Als GI wil ik de contactgegevens van een vereniging beheren

  • E-mail moet voldoen aan het verwachte formaat (naam@domein.vlaanderen). In naam worden de volgende tekens toegestaan '!#$%&'*+/=?^_`{|}~-', in domein enkel '.' en '-'.

    • technische noot: We gebruiken hiervoor een regex validatie: ^([_-]*([a-z0-9]+[\.!#$%&'*+/=?^_`{|}~-]?){1,}[_-]*)@(([a-z0-9]+[\.-]?)*[a-z0-9]\.)+[a-z]{2,}$

  • Telefoon moet bestaan uit cijfers, whitespace en \". /( ) - + \"

  • Mobiel zoals een telefoon

  • socialMedia url moet beginnen met 'http://' of 'https://' (met of zonder hoofdletters) en moet minstens 1 punt bevatten

(2) INSZ formaat:

(3) INSZ nummer is uniek per vereniging

  • Eenzelfde persoon kan slechts 1x gedefinieerd zijn als vertegenwoordiger van een vereniging

  • Diezelfde persoon kan wel vertegenwoordiger zijn van meerdere verenigingen

Verwerking

Na correcte verwerking van de aanvraag:

  • wordt er bij registratie van een vereniging een id gegenereerd voor elke vertegenwoordiger

  • wordt bij toevoegen van een vertegenwoordiger een id gegenereerd voor deze nieuwe vertegenwoordiger

Na correct toevoegen van een nieuwe vertegenwoordiger, wordt het vertegenwoordigerId teruggegeven in de response headers.