1.19 change: Verwijderen van dossier door uitvaartondernemer blokkeren na aflevering toestemming

Context

Uitvaartondernemers verwijderen geregeld onopzettelijk een dossier terwijl ze het eigenlijk willen archiveren. Hoewel onze diensten zo'n verwijdering operationeel kan herstellen, heeft dit bijkomende gevolgen: de uitvaartondernemer moet de inlichtingenfiche opnieuw indienen en de gemeente van overlijden moet de toestemming opnieuw opladen.

Om deze herstelacties te vermijden, wordt het verwijderen van een dossier door de uitvaartondernemer beperkt zodra een toestemming aanwezig is.

Beschrijving van de wijzigingen

Huidig gedrag

Een uitvaartondernemer kan een dossier verwijderen, ook wanneer het lokaal bestuur van overlijden al een toestemming heeft afgeleverd.

Nieuw gedrag

Wanneer geen toestemming aanwezig is:

• kan de uitvaartondernemer het dossier blijven verwijderen via de webtoepassing en de API;

• geeft GET /uitvaart/v2/dossiers voor het dossier magAnnulatie: true terug.

Wanneer een toestemming aanwezig is:

• kan de uitvaartondernemer het dossier niet meer verwijderen;

• blijft de verwijderoptie zichtbaar in de webtoepassing, maar wordt de knop Verwijderen uitgeschakeld;

• verschijnt bij de uitgeschakelde knop de toelichting: De toestemming is al afgeleverd. Neem contact op met het lokaal bestuur van overlijden om dit dossier te verwijderen.;

• wordt een annulatie via de API geweigerd;

• geeft GET /uitvaart/v2/dossiers voor het dossier magAnnulatie: false terug.

Wanneer de toestemming later wordt verwijderd, is verwijderen door de uitvaartondernemer opnieuw mogelijk.

De gemeente van overlijden behoudt de mogelijkheid om de uitvaartondernemer van het dossier te ontkoppelen of de toestemming te verwijderen.

API-wijzigingen

Annuleren van een dossier

Het bestaande endpoint blijft behouden:

POST /uitvaart/v1/dossiers/{dossierNummer}/annuleer

De actie is voortaan alleen mogelijk zolang toestemmingUitvaart/status niet gelijk is aan AANWEZIG. Wanneer de status AANWEZIG is, wordt de aanvraag geweigerd met de boodschap dat de uitvaartondernemer niet uit het dossier kan worden verwijderd omdat het lokaal bestuur al een toestemming heeft afgeleverd.

De 403 HTTP-statuscode is nog te bevestigen.

Aanduiding of annuleren is toegestaan

Het volgende endpoint wordt uitgebreid:

GET /uitvaart/v2/dossiers

Per dossier wordt het booleaanse attribuut magAnnulatie toegevoegd:

• true: de uitvaartondernemer kan het dossier verwijderen;

• false: de uitvaartondernemer kan het dossier niet verwijderen omdat een toestemming aanwezig is.

Impact op integratoren en verwachte acties

Gemeente overlijden

Er wijzigt niets aan de bestaande API-acties voor de gemeente van overlijden.

Wanneer een uitvaartondernemer een dossier na aflevering van de toestemming toch moet verlaten, neemt die contact op met het lokaal bestuur van overlijden. De gemeente kan vervolgens via de bestaande mogelijkheden de uitvaartondernemer ontkoppelen of de toestemming verwijderen.

Verwachte actie: geen technische aanpassing vereist. Houd operationeel rekening met vragen van uitvaartondernemers die een dossier na aflevering van de toestemming moeten verlaten.

Uitvaartondernemer

Deze wijziging is functioneel breaking voor integraties die POST /uitvaart/v1/dossiers/{dossierNummer}/annuleer gebruiken. Een aanroep die vandaag nog slaagt, wordt na deze wijziging geweigerd wanneer een toestemming aanwezig is.

Verwachte acties:

• controleer vóór het aanbieden of uitvoeren van de annulatieactie de waarde van magAnnulatie uit GET /uitvaart/v2/dossiers;

• bied de annulatieactie alleen aan wanneer magAnnulatie: true;

• verwerk de foutrespons wanneer toch een annulatie wordt gevraagd terwijl een toestemming aanwezig is;

• verwijs de gebruiker in dat geval naar het lokaal bestuur van overlijden.

Er is geen aanpassing nodig voor dossiers zonder toestemming of dossiers waarvan de toestemming opnieuw is verwijderd.

Gemeente begraven

Geen impact of actie verwacht. De wijziging raakt geen acties, berichten of API's van de gemeente van begraven.

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.