Breadcrumbs

1.23 change: Schenking lichaam aan de wetenschap doorgeven aan betrokken integratoren

BREAKING

Deze wijziging is functioneel breaking voor uitvaartintegratoren. Zij moeten een nieuw veld en de nieuwe waarde RESERVATION_VIA_ELYS_OPTIONAL voor reservationMethod verwerken en mogen bij schenking aan de wetenschap niet langer veronderstellen dat een reservatie begraafplaats verplicht is om een dossier te archiveren. Voor de andere betrokken integratoren worden alleen optionele gegevens toegevoegd.

Context

Wanneer een lichaam aan de wetenschap wordt geschonken, is de datum van de latere begraving of crematie vaak nog niet bekend. De schenking kan tot twee jaar duren.

Vandaag moet de uitvaartondernemer toch een reservatiefiche begraafplaats indienen en laten aanvaarden om het dossier te kunnen archiveren. Als tijdelijke oplossing wordt een fictieve datum in de toekomst ingevuld. Dat leidt tot foutieve informatie en onnodige reservaties.

Met deze change kan de uitvaartondernemer de schenking registreren. Als nog geen datum bekend is, is geen reservatie nodig om het dossier te archiveren. Als de datum wel bekend is, blijft de normale reservatieflow beschikbaar.

Beschrijving van de wijzigingen

Huidig gedrag

  • De inlichtingenfiche bevat geen aanduiding dat het lichaam aan de wetenschap wordt geschonken.

  • Wanneer een reservatie begraafplaats wordt verwacht, kan de uitvaartondernemer het dossier pas archiveren nadat de reservatie is ingediend en aanvaard.

  • Bij een nog onbekende datum wordt daardoor in de praktijk een fictieve datum gebruikt.

Nieuw gedrag

Aan de inlichtingenfiche wordt de optionele boolean schenkingLichaamAanWetenschap toegevoegd:

  • true: het lichaam wordt aan de wetenschap geschonken;

  • false: het lichaam wordt niet aan de wetenschap geschonken;

  • null: de waarde is niet gekend of werd nog niet ondersteund; functioneel wordt null behandeld als false.

Alleen de uitvaartondernemer kan de waarde invullen en wijzigen. Voor nieuwe dossiers staat de keuze in de eLys-webtoepassing standaard op false.

Wanneer de waarde true is:

  • blijven de gekozen uitvaart en locatie behouden;

  • blijft de reservatiefiche begraafplaats beschikbaar, maar wordt ze optioneel;

  • kan het dossier zonder reservatie worden gearchiveerd als aan alle overige archiveringsvoorwaarden is voldaan;

  • moet een vrijwillig ingediende reservatie wel aanvaard zijn voordat het dossier kan worden gearchiveerd;

  • heeft de wijziging geen impact op een bestaande toestemming tot begraven of cremeren.

Wanneer de boolean in een van beide richtingen wijzigt:

  • wordt een bestaande actieve reservatie geannuleerd;

  • worden de formuliergegevens van de reservatie verwijderd;

  • ontvangt de gemeente van begraven de bestaande annulatie;

  • kan de uitvaartondernemer, afhankelijk van de nieuwe situatie, een nieuwe reservatie indienen.

Na vrijgave van het lichaam kan de verdere afhandeling buiten eLys gebeuren. Als de reservatie toch via eLys moet verlopen, kan de uitvaartondernemer het gearchiveerde dossier opzoeken, heropenen en alsnog een reservatie indienen.

Bestaande dossiers en overgangsperiode

Voor dossiers die vóór de activatie van deze functionaliteit zijn aangemaakt:

  • blijft schenkingLichaamAanWetenschap gelijk aan null;

  • gebeurt geen backfill of automatische omzetting naar false;

  • blijft de bestaande reservatie- en archiveringslogica gelden;

  • wordt de uitzondering om zonder reservatie te archiveren niet toegepast;

  • blijft null beschikbaar in de read-API's en rapportering.

Ook na de overgangsperiode mogen historische dossiers bij een wijziging van de inlichtingenfiche null blijven doorgeven.

De functionaliteit blijft achter een feature toggle totdat de integratoren klaar zijn. De feature toggle wordt op 18 februari 2027 opgeheven. Vanaf die activatie moeten nieuwe dossiers via de API expliciet true of false doorgeven.

API-wijzigingen

Het veld schenkingLichaamAanWetenschap wordt toegevoegd aan:

  • GET /uitvaart/v1/dossiers/{dossierNummer}/inlichtingenfiche;

  • POST /uitvaart/v2/dossiers/{dossierNummer}/inlichtingenfiche;

  • PUT /uitvaart/v2/dossiers/{dossierNummer}/inlichtingenfiche;

  • GET /burgerlijke-stand/v1/dossiers/{dossiernummer};

  • GET /burgerlijke-stand/v2/dossiers;

  • GET /burgerlijke-stand/v1/dossiers/gewijzigd;

  • GET /begraafplaats/v1/toestemmingen;

  • GET /crematorium/v1/toestemmingen.

Het attribuut reservationMethod in GET /uitvaart/v2/dossiers/{dossierNummer}/cemeteryReservation krijgt de nieuwe enumwaarde RESERVATION_VIA_ELYS_OPTIONAL.

Een request met schenkingLichaamAanWetenschap = true wordt geweigerd zolang de feature toggle uitstaat.

Impact op integratoren en verwachte acties

Gemeente overlijden

De gemeente van overlijden ontvangt de nieuwe waarde bij de gegevens van de inlichtingenfiche. De bestaande functionele flow wijzigt niet.

Verwachte acties uiterlijk vóór 18 februari 2027:

  • verwerk en toon het veld schenkingLichaamAanWetenschap in de relevante dossierweergave;

  • ondersteun true, false en null, waarbij null betekent dat de waarde niet gekend is;

  • stem de implementatie af op de bijgewerkte Swagger- en integratordocumentatie.

Uitvaartondernemer

De wijziging is functioneel breaking. Uitvaartsoftware moet ondersteunen dat een reservatie bij schenking aan de wetenschap mogelijk, maar niet verplicht is.

Verwachte acties uiterlijk vóór 18 februari 2027:

  • lees en schrijf de boolean schenkingLichaamAanWetenschap;

  • bied de keuze aan de gebruiker aan;

  • ondersteun RESERVATION_VIA_ELYS_OPTIONAL als waarde van reservationMethod;

  • meld bij deze waarde dat geen reservatie nodig is om het dossier te archiveren;

  • laat de gebruiker wel een reservatiefiche invullen wanneer de datum bekend is;

  • volg na indiening de bestaande status- en goedkeuringsflow;

  • pas de archiveringslogica en gebruikersmeldingen aan;

  • verwerk dat een wijziging van de boolean een actieve reservatie annuleert en de formuliergegevens verwijdert;

  • behandel historische dossiers met null volgens de bestaande reservatie- en archiveringslogica;

  • geef voor nieuwe dossiers vanaf de activatie expliciet true of false door;

  • stem de implementatie af op de bijgewerkte Swagger- en integratordocumentatie.

Gemeente begraven

De gemeente van begraven ontvangt en toont de nieuwe waarde wanneer zij volgens de gekozen lijkbezorging toegang heeft tot het dossier. De reservatieflow zelf wijzigt niet.

Wanneer de uitvaartondernemer de boolean wijzigt, ontvangt de gemeente voor een bestaande actieve reservatie de gebruikelijke annulatie.

Verwachte acties uiterlijk vóór 18 februari 2027:

  • verwerk en toon het veld schenkingLichaamAanWetenschap;

  • ondersteun true, false en null;

  • behoud de bestaande verwerking van reservaties en annulaties;

  • stem de implementatie af op de bijgewerkte Swagger- en integratordocumentatie.

Crematorium

Het crematorium ontvangt en toont de nieuwe waarde wanneer het in de inlichtingenfiche is geselecteerd. De bestaande toestemmingsflow blijft behouden.

Verwachte acties uiterlijk vóór 18 februari 2027:

  • verwerk en toon het veld schenkingLichaamAanWetenschap;

  • ondersteun true, false en null;

  • behoud de bestaande toestemmingsflow;

  • stem de implementatie af op de bijgewerkte Swagger- en integratordocumentatie.

Departement Zorg

Geen impact of actie verwacht. De story bevat geen wijziging aan de gegevensuitwisseling of API's voor Departement Zorg.