Algemeen: initiële adresmatch

We hebben een proces toegevoegd dat alle adressen overloopt in het register. Elke adres dat nog niet is geverifieerd ten opzichte van het adressenregister, wordt opgezocht via adresmatch. Wanneer een resultaat wordt gevonden, wordt het adresId toegevoegd en worden de adrescomponenten aangepast aan de spelling zoals deze in het adressenregister voorkomt.

Publieke API: Mutatie dienst

In de publieke API is een nieuw endpoint beschikbaar dat kan gebruikt worden voor afnemers die synchroniseren naar hun eigen databank/CRM. Met dit endpoint kan je alle vCodes opvragen waarvoor er een wijziging is gebeurd sinds de laatste keer dat je de synchronisatie hebt uitgevoerd.

Om dit endpoint aan te spreken heb je een API Key nodig.

Voorbeeld:

GET <publiekURL>/v1/verenigingen/mutaties?sinds=<vorigeMaxSequence>
response body:
[
    {
        "vCode": "V0001027",
        "sequence": 86
    },
    {
        "vCode": "V0001024",
        "sequence": 89
    }
]

In dit voorbeeld weet je nu dat je de data van V0001027 en V0001024 moet ophalen via een of meerdere van volgende endpoints:

• Beheer Detail: <BeheerURLviaMAGDA>/v1/verenigingen/<vCode>

  • om alle gegevens van een vereniging op te vragen

• Publiek Detail: <PubliekURL>/v1/verenigingen/<vCode>

  • om alle publieke gegevens van een vereniging op te vragen - wanneer jouw organisatie enkel met publieke gegevens werkt OF geen recht heeft om alle gegevens via MAGDA op te vragen

• Beheer Historiek: <BeheerURLviaMAGDA>/v1/verenigingen/<vCode>/historiek

  • om meer informatie te bekomen over de wijzigingen die zijn uitgevoerd

Na synchronisatie, onthoud je de hoogste verwerkte sequence (in het voorbeeld is dat 89) zodat je de volgende keer alle nieuwe wijzigingen kan opvragen via <publiekURL>/v1/verenigingen/mutaties?sinds=89

Goed om weten: in dit endpoint komen ALLE vCodes voor en worden ALLE wijzigingen gereflecteerd. Dit heeft enkele gevolgen die je best mee overweegt bij de implementatie van deze mutatiedienst. Enkele voorbeelden:

• Wanneer er iets veranderd aan een vertegenwoordiger van een vereniging, dan is dit een wijziging, maar via de publieke data stroom zal je geen enkel verschil opmerken.

• Wanneer een vereniging uitgeschreven wordt uit de publieke datastroom, dan komt dit naar voor als wijziging, maar via de publieke datastroom betekent dit dat je de vereniging plots niet meer zal terugvinden. (Publiek detail geeft dan een 404)

• Wanneer een vereniging verwijderd wordt, dan komt dit naar voor als wijziging, maar noch bij publiek, noch bij beheer detail zal je deze vereniging nog terugvinden (respons = 404). Via beheer historiek kan je wel nog terugvinden dat deze vereniging verwijderd is met de reden van verwijdering.