...

🔜 15 Sep 2023 [v7.27.0.0] Verrijken KBO gegevens, Stoppen van een vereniging, Aanpassingen aan swagger, nieuwsbrief

datum installatie op staging: nog te bepalen

Verrijken KBO gegevens

Gegevens die we uit KBO obvergenomen hebben, kunnen niet aangepast worden. We maken het nu wel mogelijk om voor deze data objecten de velden in te vullen die niet uit KBO overgenomen zijn.

Wijzigen van de maatschappelijke zetel volgens KBO

Voor de maatschappelijke zetel volgens KBO is het mogelijk om de velden naam en isPrimair aan te passen. Het locatietype, adres en adresID blijven steeds ongewijzigd. Deze actie mogelijk via een apart endpoint

PATCH <BeheerURL>/v1/verenigingen/<vCode>/kbo/locaties/<LocatieID>
{
  "naam": "locatie naam voor de maatschappelijke zetel",
  "isPrimair": true
}

Wijzigen van KBO contactgegevens

Ook voor de contactgegevens die overgenomen worden uit KBO kan je enkel de velden beschrijving en isPrimair aanpassen. Ook hier is dat via een apart endpoint

PATCH <BeheerURL>/v1/verenigingen/<vCode>/kbo/contactgegevens/<contactgegevenID>
{
  "beschrijving": "beschrijving voor dit contactgegeven uit KBO",
  "isPrimair": true
}

Tijdelijk nabootsen van functiehouders uit KBO

Zolang we niet de juiste machtiging hebben om persoonsgegevens op te halen uit KBO, zijn we een beetje geblokkeerd om verder te ontwikkelen op de vertegenwoordigers van een KBO vereniging. Om dit euvel te verhelpen, maken we het nu mogelijk om de KBO functiehouders na te bootsen door bij elke registratie van een KBO vereniging een vaste set van personen toe te voegen. Deze set kan op aanvraag aangepast worden (om zelf ook te kunnen testen). Van elke vertegenwoordiger voegen we insz, voor- en achternaam toe. We vinden deze gegevens terug in beheer detail en in beheer historiek

GET <BEHEERURL>/v1/verenigingen/<vCode>/historiek
...
        {
            "beschrijving": "Vertegenwoordiger 'John Doke' werd overgenomen uit KBO.",
            "gebeurtenis": "VertegenwoordigerWerdOvergenomenUitKBO",
            "data": {
                "vertegenwoordigerId": 1,
                "isPrimair": false,
                "roepnaam": "",
                "rol": "",
                "voornaam": "John",
                "achternaam": "Doke",
                "e-mail": "",
                "telefoon": "",
                "mobiel": "",
                "socialMedia": ""
            },
            "initiator": "Postman",
            "tijdstip": "2023-09-13 07:11"
        },
        {
            "beschrijving": "Vertegenwoordiger 'Jane Doe' werd overgenomen uit KBO.",
            "gebeurtenis": "VertegenwoordigerWerdOvergenomenUitKBO",
            "data": {
                "vertegenwoordigerId": 2,
                "isPrimair": false,
                "roepnaam": "",
                "rol": "",
                "voornaam": "Jane",
                "achternaam": "Doe",
                "e-mail": "",
                "telefoon": "",
                "mobiel": "",
                "socialMedia": ""
            },
            "initiator": "Postman",
            "tijdstip": "2023-09-13 07:11"
        },
...

Wijzigen van KBO vertegenwoordigers

Nu we vertegenwoordigers van KBO verenigingen beschikbaar hebben, kunnen we deze gegevens ook aanvullen met gegevens die niet in KBO terug te vinden zijn. Dit zijn exact dezelfde gegevens dan wat je mag wijzigen voor een vertegenwoordiger van een feitelijke vereniging of een afdeling. We gebruiken hier geen specifiek endpoint voor. We controleren wel dat je voor KBO verenigingen geen vertegenwoordigers kan toevoegen, noch verwijderen.

PATCH <BeheerURL>/v1/verenigingen/<vCode>/vertegenwoordigers/<vertegenwoordigerId>
{
    "vertegenwoordiger": {
        "rol": "voorzitter",
        "roepnaam": "Joske",
        "isPrimair": true,
        "e-mail": "joske@vereniging.be",
        "telefoon": "012 34 56 78",
        "mobiel": "0412 34 56 78",
        "socialMedia": "https://social.media/Joske"
    }
}

Stoppen van een vereniging

Wanneer een feitelijke vereniging of een afdeling de activiteiten stopt, kan je dat ook aangeven in het verenigingsregister. Voor deze gebeurtenis is een apart endpoint beschikbaar. De einddatum is een verplicht veld, waarvoor geldt: startdatum <= einddatum <= vandaag

POST <BeheerURL>/v1/verenigingen/<vCode>/stop
{
    "einddatum": "2023-09-01"
}

Het stoppen van een vereniging heeft enkele gevolgen:

• een nieuwe gebeurtenis wordt toegevoegd in de historiek

• De status van de vereniging wordt “Gestopt”. Deze is zichtbaar in beheer detail en beheer zoek

• De vereniging wordt uit de publieke datastroom gehaald.

  • Je kan deze dus niet meer terugvinden via publiek zoek.

  • Bij het opvragen van deze vereniging in publiek detail , krijg je een 404 terug

  • De vereniging wordt ook niet meer getoond als mogelijke dubbel bij het registreren van een andere vereniging

Het is wel nog mogelijk om wijzigingen aan de vereniging uit te voeren.

Ook op de ACM API heeft dit geen impact, zodat je nu nog steeds zal kunnen aanmelden als vertegenwoordiger van een gestopte vereniging.

Aanpassingen aan swagger

Nieuw pad voor het registreren van een feitelijke vereniging

De URL om een feitelijke vereniging te registreren zal gewijzigd worden naar

POST <BeheerURL>/v1/verenigingen/feitelijkeverenigingen

Voorlopig is het oude pad (zonder extensie feitelijkeverenigingen nog beschikbaar, maar dit zal binnenkort weggehaald worden.

sample data verbeteren

Voor elke mogelijke API call is gecontroleerd dat de sample data in de API documentatie is ingevuld en ook correcte, mogelijek waarden bevat.

Verwijderen van de endpoints voor contexten en parameters uit de beheer API

We hebben de endpoints voor de JSON LD contexten en dat voor de parameters (nu enkel de hoofdactiviteitenVerenigingsloket) weggehaald uit de Beheer API. Voor beide verwijzen we nu naar de Publieke API waar je deze data ook kan opvragen.

GET <PubliekAPI>/v1/contexten/<contextnaam>
GET <PubliekAPI>/v1/hoofdactiviteitenVerenigingsloket

Nieuwsbrief

Indien jullie op de hoogte willen blijven van de verdere doorontwikkelingen op het Verenigingsregister, vragen wij jullie om in te schrijven op ons nieuwsbrief. Deze verschijnt maximaal 2 keer per maand en bevat een overzicht van de nieuwe functionaliteiten, zoals beschikbaar op de staging-omgeving (en tegen het einde van het jaar de productie-omgeving). Qua inhoud zal het in hoofdzaak gaan over onze release notes, zoals je deze hier terugvindt. Ook belangrijke updates over onze testomgeving gaan we via de nieuwsbrief communiceren. De nieuwsbrief is voornamelijk bedoeld voor een functioneel/technisch doelpubliek.

✅ 01 Sep 2023 [v7.10.0.0] ⚠️ 📚 Verrijken KBO verenigingen, 📚 INSZ toevoegen aan beheer detail en ⚠️ 📚 verwerking ontvangen feedback

...