Opgelet: Dit is een breaking change. De V1 zal uitgefaseerd worden, bekijk de timing hiervoor via de feature planning en plan de wijzigingen tijdig in.
Context
Vandaag kan een API-gebruiker in de inlichtingenfiche zowel een rijksregisternummer (RRN) als persoonsgegevens zoals naam en adres invullen voor bepaalde betrokken personen.
Hierdoor kan een situatie ontstaan waarbij de meegedeelde persoonsgegevens niet overeenstemmen met de gegevens die gekoppeld zijn aan het opgegeven rijksregisternummer. Gemeenten beschikken vandaag niet over een mechanisme om deze inconsistentie te detecteren.
Om de kwaliteit en betrouwbaarheid van de gegevens te verhogen, zorgen we ervoor dat persoonsgegevens die gebaseerd zijn op een rijksregisternummer steeds rechtstreeks uit het Rijksregister worden opgehaald.
Beschrijving van de wijzigingen
Beschrijving functionaliteit
Om de kwaliteit van de persoonsgegevens in de inlichtingenfiche via API te verhogen, wordt de verwerking van rijksregisternummers aangepast.
Wanneer een rijksregisternummer (RRN) wordt meegestuurd voor in de inlichtingenfiche, zal eLys voortaan zelf een Rijksregisterbevraging uitvoeren en de persoonsgegevens hieruit gebruiken.
Hierdoor is het niet langer toegestaan om zowel een rijksregisternummer als persoonsgegevens voor dezelfde persoon mee te geven.
Deze wijziging geldt voor:
-
crematie.bestemmingAs.nabestaande -
asWettelijkePartner -
informatieAkteLevenloosKind.vaderOfMeemoeder
API-wijzigingen voor de uitvaartondernemer
Nieuwe versie van PUT en POST
Deze wijziging introduceert een breaking change.
Daarom worden nieuwe API-versies voorzien:
-
POST /uitvaart/v2/dossiers/{dossierNummer}/inlichtingenfiche -
PUT /uitvaart/v2/dossiers/{dossierNummer}/inlichtingenfiche
De bestaande v1-endpoints blijven gedurende 3 maanden beschikbaar zodat integratoren kunnen migreren.
RRN of persoonsgegevens
Voor bovenstaande personen mag voortaan slechts één van beide worden meegestuurd:
-
een rijksregisternummer
-
persoonsgegevens
Indien beide worden meegestuurd, wordt de aanvraag geweigerd.
Rijksregisterbevraging
Bij het indienen of wijzigen van een inlichtingenfiche wordt automatisch een Rijksregisterbevraging uitgevoerd voor elk gewijzigd rijksregisternummer.
Voor ongewijzigde rijksregisternummers gebeurt geen nieuwe bevraging.
De aanvraag wordt enkel succesvol verwerkt wanneer alle vereiste Rijksregisterbevragingen succesvol verlopen. Zoniet wordt een foutcode teruggegeven.
Foutafhandeling
Integratoren moeten rekening houden met bijkomende foutmeldingen bij PUT en POST.
Mogelijke situaties:
|
Situatie |
Foutmelding |
Actie |
|---|---|---|
|
Zowel RRN als persoonsgegevens meegestuurd |
400
|
Enkel RRN of enkel gegevens mogen ingegeven worden |
|
Ongeldig rijksregisternummer |
400
|
Gebruiker moet RRN valideren |
|
Tijdelijke fout tijdens Rijksregisterbevraging |
503
|
Gebruiker moet opnieuw proberen |
|
Rijksregistergegevens kunnen niet verwerkt worden |
500
|
Gebruiker moet gegevens manueel ingeven (en eventueel gemeente contacteren) |
Wij raden aan om na een succesvolle PUT of POST een GET uit te voeren om de gevalideerde gegevens opnieuw op te halen en aan de gebruiker te tonen.
Bestaande dossiers
Bestaande dossiers worden niet retroactief aangepast.
De nieuwe validaties worden enkel toegepast wanneer een inlichtingenfiche opnieuw wordt ingediend of gewijzigd via de nieuwe API-versie.