1.24 change: API-wijzigingen dienst burgerlijke stand: wijzigingsaanvragen door arts

Context

Artsen kunnen een vaststelling van overlijden na indiening vandaag niet meer aanpassen in eLys. Bij een fout bezorgen ze een attest van wijziging aan de gemeente, buiten eLys om. Met deze uitbreiding kan de arts in eLys zelf:

• het tijdstip van vaststelling en/of het tijdstip van overlijden wijzigen;

• de plaats van overlijden wijzigen (eventueel naar een andere gemeente);

• melden dat de verkeerde persoon werd doodverklaard.

Zo'n wijziging past het dossier van de gemeente niet rechtstreeks aan. Ze komt binnen als een wijzigingsaanvraag die de gemeente van overlijden moet aanvaarden. De wijzigingsaanvraag geldt als bewijsstuk en vervangt het attest dat vandaag per mail bezorgd wordt.

Kernprincipes

• Een wijzigingsaanvraag wordt altijd gericht aan het lokaal bestuur dat het dossier op dat moment behandelt. Bij een wijziging van plaats naar een andere gemeente is dat de oude gemeente.

• De gegevens van het dossier wijzigen pas bij aanvaarding. Pas dan worden de nieuwe waarden ook doorgegeven aan crematorium, begraafplaats en Departement Zorg.

• Een gemeente kan een wijzigingsaanvraag niet weigeren. Ze kan het dossier wel niet afsluiten (status BEHANDELD) zolang er openstaande wijzigingsaanvragen zijn.

• Per type is er maximaal één openstaande wijzigingsaanvraag. Er kunnen wel meerdere aanvaarde aanvragen van hetzelfde type zijn.

• De arts kan wijzigingen indienen zolang het dossier niet in status BEHANDELD staat. Wordt een dossier heropend, dan kan de arts opnieuw wijzigen.

• Elke wijzigingsaanvraag wordt afzonderlijk aanvaard (zie open vragen).

Overzicht van de wijzigingen

Alle paden hieronder starten met /burgerlijke-stand/v1/dossiers/{dossiernummer}, tenzij anders vermeld.

1. Wijzigingsaanvragen in het dossier

Aan DossierBurgerlijkeStandJSON wordt een lijst wijzigingsaanvragen toegevoegd. Die bevat zowel openstaande als eerder aanvaarde, vervangen of vervallen aanvragen. De lijst is leeg als er geen aanvragen zijn.

Omdat het volledige dossier ook in /v2/dossiers en /v1/dossiers/gewijzigd zit, zijn de wijzigingsaanvragen daar automatisch beschikbaar.

Voorbeeld

"wijzigingsaanvragen": [
  {
    "id": "6f1c2a90-3b1e-4c55-9a0e-1d2b7c8e4f10",
    "type": "TIJDSTIP_OVERLIJDEN",
    "status": "OPENSTAAND",
    "ingediendOp": "2026-11-06T18:12:00+01:00",
    "ingediendDoor": {
      "registratie": "10212714001",
      "naam": "Faict",
      "voornaam": "Jonas"
    },
    "toelichting": "Uur van overlijden foutief ingegeven. Volgens de thuisverpleging was het overlijden om 09u45.",
    "oudeWaarde": { "datum": "2026-11-06T10:08:00+01:00" },
    "nieuweWaarde": { "datum": "2026-11-06T09:45:00+01:00" },
    "aanvaardOp": null,
    "aanvaardBoodschap": null,
    "attestURI": "https://…/burgerlijke-stand/v1/dossiers/20261106-005-C7VF/wijzigingsaanvragen/6f1c2a90-…/attest"
  }
]

Velden

Types

Statussen

Laatste wijziging

Het indienen van een nieuwe aanvraag (ook een vervangende) past laatsteWijziging van het dossier aan. Daardoor verschijnt het dossier in GET /burgerlijke-stand/v1/dossiers/gewijzigd. Er is geen nieuw gebeurtenistype nodig.

2. Filter op openstaande wijzigingsaanvragen

GET /burgerlijke-stand/v2/dossiers krijgt een nieuwe optionele queryparameter, naar analogie met de bestaande heeft…-filters:

3. Wijzigingsaanvraag aanvaarden

POST /burgerlijke-stand/v1/dossiers/{dossiernummer}/wijzigingsaanvragen/{id}/aanvaarden

Request body (optioneel): het bestaande schema Optionele Boodschap.

{ "boodschap": "Overlijdensakte aangepast." }

Gevolg bij aanvaarden

In alle gevallen worden laatsteWijziging en de historiek bijgewerkt, en worden de nieuwe waarden doorgegeven aan crematorium, begraafplaats en Departement Zorg.

Responses

4. Bewijsstuk opvragen

GET /burgerlijke-stand/v1/dossiers/{dossiernummer}/wijzigingsaanvragen/{id}
GET /burgerlijke-stand/v1/dossiers/{dossiernummer}/wijzigingsaanvragen/{id}/attest

• Het eerste endpoint geeft één wijzigingsaanvraag terug (zelfde structuur als in het dossier), ongeacht de status.

• Het tweede endpoint geeft een PDF met de verklaring van de arts, de oude en nieuwe waarde en de toelichting. Dit document vervangt het attest van wijziging dat vandaag buiten eLys bezorgd wordt.

voorbeeld PDF wordt later toegevoegd

5. Afsluiten bij openstaande wijzigingsaanvragen

Aan POST …/afsluiten wordt een voorwaarde toegevoegd: er mogen geen wijzigingsaanvragen met status OPENSTAAND zijn. Is dat wel het geval, dan wordt het afsluiten geweigerd met een ErrorDTO:

{
  "status": 409,
  "type": "openstaande-wijzigingsaanvragen",
  "title": "Het dossier heeft openstaande wijzigingsaanvragen",
  "detail": "Aanvaard eerst alle openstaande wijzigingsaanvragen voordat u het dossier afsluit.",
  "structuredDetails": ["6f1c2a90-3b1e-4c55-9a0e-1d2b7c8e4f10"]
}

structuredDetails bevat de id's van de openstaande aanvragen.

6. Historiek

HistoriekGebeurtenis krijgt nieuwe enumwaarden. Het veld message bevat de toelichting van de arts (bij ontvangst) of de boodschap van de gemeente (bij aanvaarding).

Bij aanvaarding van een melding VERKEERDE_PERSOON volgt een gebeurtenis DOSSIER_VERWIJDERD met reden VERWIJDERD_NA_MELDING_ARTS, naast het bestaande MANUEEL_VERWIJDERD. De oude en nieuwe waarden zitten in de wijzigingsaanvraag zelf en worden niet in de historiek herhaald.

7. Verwijderen en andere bestaande acties

Verwijderen

• De verplichte boodschap bij POST …/verwijderen wordt voortaan getoond aan de arts die de vaststelling indiende. Vermeld daarin dus geen interne notities.

• Openstaande wijzigingsaanvragen krijgen bij het verwijderen status VERVALLEN.

Wijzig plaats van overlijden door de gemeente

Het bestaande endpoint POST …/wijzig-plaats-overlijden blijft ongewijzigd beschikbaar. Gebruikt de gemeente dit endpoint terwijl er een openstaande aanvraag van type PLAATS_OVERLIJDEN is, dan krijgt die aanvraag status VERVALLEN. Andere openstaande aanvragen verhuizen mee met het dossier.

Heropenen

Na POST …/heropen staat het dossier opnieuw in IN_BEHANDELING, waardoor de arts weer wijzigingsaanvragen kan indienen. Er verandert niets aan het endpoint zelf.

Voorbeeldscenario

1. De arts dient een wijziging van het tijdstip van overlijden in. Het dossier verschijnt in /v1/dossiers/gewijzigd met een aanvraag OPENSTAAND.

2. De software van de gemeente toont de aanvraag aan de ambtenaar, met oude en nieuwe waarde, toelichting en attest.

3. De ambtenaar verwerkt de wijziging in de eigen toepassing (bijvoorbeeld de akte) en roept …/aanvaarden aan.

4. Het dossier bevat nu het nieuwe tijdstip, de aanvraag staat op AANVAARD en de historiek bevat WIJZIGINGSAANVRAAG_AANVAARD.

5. De gemeente kan het dossier afsluiten.

Open vragen voor API-gebruikers