BREAKING
Deze wijziging is functioneel breaking voor uitvaartintegratoren: bij afgebakende wijzigingen aan een inlichtingenfiche wordt een bestaande reservatiefiche begraafplaats voortaan behouden in plaats van geannuleerd. Het endpoint en de API-versie blijven behouden, maar het functionele gedrag en de 200 OK-response wijzigen.
Context
Wanneer een uitvaartondernemer vandaag bepaalde gegevens of documenten in een inlichtingenfiche wijzigt, annuleert eLys de bestaande reservatiefiche begraafplaats. De gemeente van begraven ontvangt daardoor een annulatie, ook wanneer de wijziging niets fundamenteels verandert aan de keuze voor lijkbezorging.
De uitvaartondernemer moet vervolgens onnodig een nieuwe reservatiefiche indienen. Dit veroorzaakt extra administratie voor zowel de uitvaartondernemer als de gemeente van begraven en kan onopgemerkt blijven.
Met deze change blijft de reservatiefiche behouden bij drie duidelijk afgebakende soorten wijzigingen.
Beschrijving van de wijzigingen
Huidig gedrag
Wanneer een uitvaartondernemer een inlichtingenfiche met een bestaande reservatiefiche begraafplaats wijzigt:
-
wordt de reservatiefiche geannuleerd;
-
worden de formuliergegevens van de reservatiefiche verwijderd;
-
ontvangt de gemeente van begraven een annulatie;
-
moet de uitvaartondernemer indien nodig een nieuwe reservatiefiche indienen;
-
waarschuwt de gebruikersinterface dat de reservatie bij de begraafplaats wordt geannuleerd.
Nieuw gedrag
De reservatiefiche wordt niet geannuleerd wanneer binnen één bewerking uitsluitend één of meerdere van de volgende wijzigingen worden uitgevoerd:
-
toevoegen, wijzigen of verwijderen van herbestemming partner;
-
toevoegen, wijzigen of verwijderen van akte levenloos kind;
-
toevoegen, wijzigen of verwijderen van een van deze documenten:
-
verzoek nabestaande;
-
verzoek nabestaande as partner;
-
verzoek opname als vader of meemoeder;
-
toestemming eigenaar.
-
In deze gevallen:
-
blijven de inhoud en de bestaande status van de reservatiefiche behouden;
-
verstuurt eLys geen annulatie naar de gemeente van begraven;
-
hoeft de uitvaartondernemer geen nieuwe reservatiefiche in te dienen;
-
bevat de waarschuwing in de eLys-webtoepassing geen boodschap meer over de annulatie van de reservatie begraafplaats;
-
krijgt de gebruiker een melding van het effectieve resultaat van de wijziging voor de toestemming en de reservatiefiche.
Wanneer een van de uitzonderingen binnen dezelfde bewerking wordt gecombineerd met een andere wijziging aan de inlichtingenfiche, blijft het huidige gedrag van toepassing en wordt de reservatiefiche wel geannuleerd. Dit geldt ook wanneer uitsluitend een andere wijziging wordt uitgevoerd.
API-wijzigingen
De bestaande endpoints voor het bewaren van een inlichtingenfiche blijven behouden:
-
PUT /uitvaart/v2/dossiers/{dossierNummer}/inlichtingenfiche -
POST /uitvaart/v2/dossiers/{dossierNummer}/inlichtingenfiche
De 200 OK-response bevat voortaan een body waarmee de integrator het resultaat voor de toestemming en de reservatiefiche begraafplaats kan bepalen. Voor beide wordt een enum teruggegeven met de mogelijke uitkomsten:
-
niet bestaand;
-
verwijderd;
-
niet veranderd.
De exacte veldnamen en het schema worden opgenomen in de bijgewerkte Swagger-documentatie.
Bestaande dossiers en gegevens
De nieuwe verwerking geldt ook voor bestaande dossiers wanneer na de oplevering in release 1.21 een van de beschreven wijzigingen wordt uitgevoerd.
Er is geen datamigratie of backfill nodig. Bestaande reservatiefiches worden niet vooraf aangepast.
Impact op integratoren en verwachte acties
Gemeente overlijden
Geen impact of actie verwacht. De wijziging verandert geen acties, berichten of API's voor de gemeente van overlijden.
Uitvaartondernemer
De wijziging is functioneel breaking. Integraties mogen niet langer veronderstellen dat iedere wijziging aan een inlichtingenfiche de bestaande reservatiefiche begraafplaats annuleert.
Verwachte acties vóór ingebruikname van release 1.21:
-
pas de gebruikersmelding bij het wijzigen van een inlichtingenfiche aan, zodat alleen een annulatie van de reservatiefiche wordt gemeld wanneer die effectief plaatsvindt;
-
verwerk de nieuwe body van de
200 OK-response en toon het resultaat voor de toestemming en de reservatiefiche aan de gebruiker; -
vraag bij de drie afgebakende uitzonderingen niet om een nieuwe reservatiefiche in te dienen wanneer de response aangeeft dat de reservatiefiche niet is veranderd;
-
behoud het bestaande proces voor alle andere wijzigingen en voor bewerkingen waarin een uitzondering met een andere wijziging wordt gecombineerd;
-
stem de implementatie af op de bijgewerkte Swagger- en integratordocumentatie.
Gemeente begraven
De gemeente van begraven ontvangt bij de drie afgebakende uitzonderingen geen annulatie meer. De bestaande reservatiefiche en haar status blijven ongewijzigd beschikbaar.
Geen technische aanpassing of actie verwacht. Voor andere wijzigingen aan de inlichtingenfiche blijft het bestaande annuleringsgedrag behouden.
Crematorium
Geen impact of actie verwacht. De wijziging raakt geen acties, berichten of API's van het crematorium.
Departement Zorg
Geen impact of actie verwacht. De wijziging raakt geen gegevensuitwisseling of API's van Departement Zorg.