Breadcrumbs

EPD - eLys integratie (post URL met parameters in de body)

Context

EPD medische softwaresystemen bevatten al een aantal gegevens van de overledene, die in eLys overgenomen kunnen worden. Door gebruik te maken van een geïntegreerde URL in het EPD kunnen artsen/ziekenhuizen dubbel invulwerk vermijden.

Technische uitwerking

Via een beveiligde (HTTPS + TLS 1.3) POST request kan het EPD systeem de eLys web applicatie openen om een nieuwe vaststelling aan te maken, met in de body een aantal parameters die vooringevuld worden (zoals het rijksregisternummer van de overledene, e-mailadres van de arts of eigen patiëntendossiernummer).

9e629cb1-727f-419c-8500-ae550d43343d.png


De flow vanuit het EPD systeem naar eLys wordt hierboven schematisch voorgesteld en hieronder verder toegelicht.

  1. Het EPD systeem stuurt naar https://elys.{{environment}}-athumi.eu/epd/login een POST request met in de body (een deel van) volgende informatie:

Gegevens overledene en eLys-dossier

Parameter

Type

Nullable

Beschrijving

overledene.rijksregisternummer

String

✅


medischDossier.nummerOverledene

String

✅


medischDossier.nummerMoeder

String

✅

enkel voor IIID

arts.email

String

✅


Voor niet-verblijfshouders is er geen Rijksregisternummer, in dat geval kunnen de gegevens van de overledene apart worden meegestuurd.

Parameter

Type

Nullable

Beschrijving

overledene.naam

String

✅


overledene.voornaam

String

✅


overledene.geslacht

String

✅

Mogelijke waarden: ‘MALE'; ‘FEMALE’, 'NKN’

overledene.geboorte.datum

String

✅


overledene.geboorte.uur

String

✅

Enkel voor IIID

overledene.geboorte.adres.land.niscode

String

✅

Niet België? Niet mogelijk ingeval van IIID in Vlaanderen of IID doodgeboorte.

overledene.geboorte.adres.gemeente.niscode

String

✅

Deze worden enkel gebruikt indien niscode die van België is.

Deze worden igv een doodgeboorte genegeerd indien adres overlijden aanwezig is.

Deze dienen beide correct ingevuld te zijn om een gemeente te kunnen tonen

Voor IIID-Vlaams zijn beide sowieso verplicht om te kunnen valideren dat het effectief een Vlaamse gemeente is.

overledene.geboorte.adres.gemeente.postcode

String

✅

overledene.geboorte.adres.buitenlandseGemeente

String

✅

Deze wordt enkel gebruikt indien niscode NIET die van België is.

Deze wordt igv een doodgeboorte genegeerd indien adres overlijden aanwezig is.

overledene.verblijfplaats.adres.land.niscode

String

✅

Enkel voor IIIC

overledene.verblijfplaats.adres.straat

String

✅

Enkel voor IIIC

Deze dienen ofwel allemaal doorgegeven te worden, ofwel niet (maar bus mag leeg zijn).

Deze worden enkel gebruikt indien niscode die van België is.

Niscode en postcode dienen beide correct ingevuld te zijn om een gemeente te kunnen tonen

overledene.verblijfplaats.adres.huisnummer

String

✅

overledene.verblijfplaats.adres.bus

String

✅

overledene.verblijfplaats.adres.postcode

String

✅

overledene.verblijfplaats.adres.niscode

String

✅

overledene.verblijfplaats.adres.buitenlandsAdres

String

✅

Enkel voor IIIC

Deze wordt enkel gebruikt indien niscode NIET die van België is.

overledene.huwelijk.persoonsGegevens.naam

String

✅

Enkel voor IIIC

overledene.huwelijk.persoonsGegevens.voornaam

String

✅

Enkel voor IIIC

Wanneer, naast deze gegevens, toch ook het rijksregisternummer wordt meegestuurd, zal eLys enkel het rijksregisternummer gebruiken en de overige gegevens negeren.

Plaats van overlijden

Parameter

Type

Nullable

Beschrijving

overlijden.locatie

String

✅

Mogelijks waarden: ‘Thuis’, ‘Ziekenhuis’, ‘'Bejaardentehuis’, ‘OpenbareWeg’, ‘Werkplaats’ of ‘Andere’ - voor de laatste drie worden enkel exacte adressen ondersteund.

overlijden.rizivnummerZiekenhuis

String

✅

Enkel relevant bij optie 'Ziekenhuis’

overlijden.adres.niscode

String

✅

Deze dienen beide correct ingevuld te zijn om een gemeente te kunnen tonen

overlijden.adres.postcode

String

✅

overlijden.adres.straat

String

✅

Deze dienen ofwel allemaal doorgegeven te worden, ofwel niet (maar bus mag leeg zijn).

overlijden.adres.huisnummer

String

✅

overlijden.adres.bus

String

✅

overlijden.adres.beschrijving

String

✅

Deze wordt genegeerd indien bovenstaande adres-velden werden ingevuld.

Enkel relevant bij optie ‘Andere’

Enkel als de locatie van het overlijden ‘Ziekenhuis’ is, en het rizivnummerZiekenhuis van het ziekenhuis en adres van het ziekenhuis matchen met een ziekenhuis gekend bij eLys, zal een ziekenhuis geselecteerd worden in de vaststelling. In andere gevallen negeren we de gegevens (en zal er geen voorinvulling gebeuren). De selectie van het juiste ziekenhuis is essentieel voor het ontvangen van de eHealthBox-notificatie.

Gegevens moeder van overledene

Deze gegevens zijn enkel relevant voor een model IIID

Parameter

Type

Nullable

Beschrijving

moeder.rijksregisternummer

String

✅


moeder.naam

String

✅


moeder.voornaam

String

✅


moeder.geslacht

String

✅


moeder.geboorte.datum

String

✅


moeder.geboorte.adres.land.niscode

String

✅


moeder.geboorte.adres.gemeente.niscode

String

✅

Deze worden enkel gebruikt indien niscode die van België is.

Deze dienen beide correct ingevuld te zijn om een gemeente te kunnen tonen

moeder.geboorte.adres.gemeente.postcode

String

✅

moeder.geboorte.adres.buitenlandseGemeente

String

✅

Deze wordt enkel gebruikt indien niscode NIET die van België is.

moeder.verblijfplaats.adres.land.niscode

String

✅


moeder.verblijfplaats.adres.straat

String

✅

Deze dienen ofwel allemaal doorgegeven te worden, ofwel niet (maar bus mag leeg zijn).

Deze worden enkel gebruikt indien niscode die van België is.

moeder.verblijfplaats.adres.huisnummer

String

✅

moeder.verblijfplaats.adres.bus

String

✅

moeder.verblijfplaats.adres.postcode

String

✅

moeder.verblijfplaats.adres.niscode

String

✅

moeder.verblijfplaats.adres.buitenlandsAdres

String

✅

Deze wordt enkel gebruikt indien niscode NIET die van België is.

Wanneer, naast de gedetailleerde gegevens, toch ook het rijksregisternummer wordt meegestuurd, zal eLys enkel het rijksregisternummer gebruiken en de overige gegevens negeren.

Voorbeeld IIIC - overledene met rijksregisternummer in ziekenhuis

JSON
{
  "overledene": {
   "rijksregisternummer" : "41620999728"
  },
  "overlijden": {
   "locatie" : "Ziekenhuis",
   "rizivnummerZiekenhuis": "71032209",
   "adres": {
      "straat": "Herestraat",
      "huisnummer": "49",
      "bus": "",
      "postcode": "3000",
      "niscode": "24062"
    } 
  },
  "medischDossier": {
    "nummerOverledene": "NR1234"
  },
  "arts": {
    "email":"test@arts.be"
  }
}

Voorbeeld IIID - rijksregisternummer overledene en moeder gekend, in ziekenhuis

JSON
{
  "overledene": {
   "rijksregisternummer" : "24110100986" 
  },
  "moeder": {
   "rijksregisternummer" : "84020203237" 
  },
  "overlijden": {
   "locatie" : "Ziekenhuis",
   "rizivnummerZiekenhuis": "71032209",
   "adres": {
      "straat": "Herestraat",
      "huisnummer": "49",
      "bus": "",
      "postcode": "3000",
      "niscode": "24062"
    } 
  },
  "medischDossier": {
    "nummerOverledene": "NR1234",
    "nummerMoeder": "NR5678"
  },
  "arts": {
    "email":"test@arts.be"
  }
}

Voorbeeld IIIC - niet-verblijfshouder, langs openbare weg

JSON
{
  "overledene": {
   "naam" : "Janssens",
   "voornaam" : "Eric",
   "geslacht" : "MALE",
   "geboorte": {
      "datum": "1941-05-12",
      "adres": {
        "land": {
          "niscode": "150"
        },
        "gemeente": {
          "niscode": "24062",
          "postcode": "3000"
        }
      }
    },
    "verblijfplaats": {
      "adres": {
        "land": {
          "niscode": "150"
        },
        "straat": "Kerkstraat",
        "huisnummer": "5",
        "bus": "",
        "postcode": "3000",
        "niscode": "24062"
      }
    },
    "huwelijk": {
      "persoonsGegevens": {
        "naam": "Maria",
        "voornaam": "Janssens"
      }
    }
  },
  "overlijden": {
   "locatie" : "OpenbareWeg",
   "adres": {
      "postcode": "3000",
      "niscode": "24062"
    } 
  },
  "medischDossier": {
    "nummerOverledene": "NR1234"
  },
  "arts": {
    "email":"test@arts.be"
  }
}



  1. JSON
    {
  "overledene": {
   "rijksregisternummer" : "{{RRN}}" 
  },
  "medischDossier": {
    "nummerOverledene": "{{EPDNummer}}",
    "nummerMoeder": "{{EPDNummerMoeder}}"
  },
  "arts": {
    "email":"{{email}}"
  }
}

Medische gegevens zijn niet toegelaten via de post-URL.

  1. eLys houdt de informatie tijdelijk bij en geeft een url terug waarnaar de gebruiker moet navigeren.

  2. Deze url zorgt ervoor dat de login flow met eHealth connect wordt opgestart alvorens de gegevens terug klaar te zetten voor de gebruiker.

  3. Na een succesvolle login wordt de session info terug opgehaald en beschikbaar gemaakt voor de gebruiker. Die info kan dan vooringevuld worden in bepaalde velden binnen eLys (bijvoorbeeld het rijksregisternummer van de overledene). Mocht de gebruiker niet aanmelden dan wordt de informatie automatisch verwijderd (na een kortere session timeout dan de standaard, 15').

Dit is zowel mogelijk voor Model IIIC als Model IIID, de arts zal het type aangifte moeten selecteren en pas bij het openen van de eerste stap zal het Rijksregisternummer vooringevuld staan. Opgelet: inloggen door de arts blijft noodzakelijk (via CSAM).

Indien er gekozen wordt om het eigen EPD patiëntendossiernummer mee te geven, gelieve dit enkel te doen als dit geen Rijksregisternummer bevat. Deze informatie wordt immers bezorgd aan het Departement Zorg voor eventuele contactname nadien rond het dossier een mag geen RRN bevatten.