Het doel van de hospipass API van het Daisyh platform is om ziekenhuizen een interface te bieden voor het zoeken, raadplegen, valideren en bevestigen van het gebruik van een hospipass. 


Dit document beschrijft het volledige proces. Voor de volledige details van de diensten verwijzen wij u naar de technische documentatie en bestanden voor de analist-ontwikkelaar tools:  


Daisyh API 4Hosp.yaml: YAML-bestand dat de API beschrijft 

Daisyh API 4Hosp-openepi.zip: technische referentie voor de API in OpenAPI-formaat 

Daisyh API 4Hosp-html.zip: technische referentie in html-formaat


Je vindt deze documenten onderaan dit artikel.


Authenticatie

Authenticatie wordt uitgevoerd met behulp van een specifieke gebruiker die kan worden beheerd en aangemaakt via het Daisyh-portaal (https://www.daisyh.be). Deze gebruiker wordt geïdentificeerd door een login en een sleutel/key.


De optie om deze specifieke gebruiker aan te maken voor de API-verbinding is nog niet beschikbaar op onze DaisyH portal. Zodra deze functionaliteit in onze productieomgeving beschikbaar is, ontvang je hierover een nieuwsletter via mail.


De eerste stap om de API te gebruiken is om je te authenticeren via de service met deze aangemaakte gebruiker: /auth/token door de login en key op te geven. Als de authenticatie succesvol is, zal de service een token teruggeven waarmee die nodig is voor authenticatie in de andere services.


Een hospipass (op)zoeken 

Je kunt een hospipass zoeken via de service: /hospipass/find4Hospitals 

Met deze service kun je zoeken op basis van verschillende criteria die ook gecombineerd kunnen worden: 

  • Achternaam van de patiënt (of deel van de achternaam)
  • Voornaam van de patiënt (of deel van de voornaam)
  • Geboortedatum van de patiënt
  • Opnamedatum van de patiënt
  • Verzekeraar
  • Hospipas-status


(Details over de mogelijke waarden staan in de technische documentatie hieronder)


Op basis van de criteria stuurt het systeem één of meer hospiassen terug indien er gevonden worden. Het resultaat geeft de details van elke hospipass zodat je de geschikte voor de specifieke opname kunt kiezen als er meerdere zijn. (bijvoorbeeld afhankelijk van het type kamer, de opnamedatum, etc.). 


Elke ziekenhuispas wordt geïdentificeerd door een “id”. 


Details van een hospipass bekijken

Met de hopipass id kun je de details van deze hospipass raadplegen en de brief downloaden die door de verzekeraar is verstuurd (in PDF versie).


Details van de hospipass: /hospipass/{hospipassId} 

Bestand/brief gekoppeld aan de hospipass: /hospipass/{hospipassId}/bestand


In de detail vind je dezelfde informatie terug die je al hebt ontvangen in het XML-bestand dat bij de hospipass hoort. De volledige lijst met gegevens en waarden is te vinden in de technische documentatie.


Het gebruik van een hospipass valideren 

De service /hospipass/{hospipassId}/check wordt gebruikt om het gebruik van een hospipass voor een bepaalde opname te controleren/valideren. Door de volgende gegevens te verstrekken:  

  • Hospipass Id 
  • Achternaam patiënt
  • Voornaam patiënt
  • Geboortedatum patiënt
  • Opnamedatum patiënt


Het systeem geeft vervolgens aan of het gebruik al dan niet geldig is, eventueel met waarschuwingen.

Een globale code zal dit aangeven:

  • Ok: alles lijkt geldig. De hospipass kan zonder problemen worden gebruikt op basis van de verstrekte gegevens
  • Waarschuwing: er zijn waarschuwingen, maar deze verhinderen het gebruik van de hospipass niet (bijv. een verschil van één dag ten opzichte van de geldigheidsperiode)
  • Fout: er is ten minste één blokkerend element dat het gebruik van de hospipass in dit geval verhindert.


In het geval van waarschuwingen of fouten kan een reeks codes en beschrijvingen worden gebruikt om de problemen te specifieren:  


  • HOSPIPASS_REPLACED : Hospipass nummer is vervangen door een ander nummer/hospipass. Omdat er een geldige hospipass referentie is voor deze patiënt, komt de factuur in aanmerking voor terugbetaling door de verzekeringsmaatschappij. De nieuwe referentie is te vinden in het veld "new_reference". (niveau : waarschuwing)
  • HOSPIPASS_CANCELLED : Hospipass nummer is geannuleerd. (niveau : error)
  • HOSPITAL_INVALID : De hospipass is gekoppeld aan een ander ziekenhuis. met een ander RIZIV nummer (niveau : error)
  • ADMISSION_DATE_WARNING : De opnamedatum valt buiten het datumbereik van het document, maar is toch toelaatbaar omdat het verschil klein is (minder dan x dagen). (niveau : waarschuwing)
  • ADMISSION_DATE_OVERDUE : De toelatingsdatum ligt buiten het datumbereik van het document. (niveau : error)
  • INCONSISTENCY_BIRTHDATE : Inconsistentie tussen de opgegeven geboortedatum en de geboortedatum in de hospipass. (niveau : waarschuwing)
  • INCONSISTENCY_NAME : Inconsistentie tussen de opgegeven naam en voornaam en de opgegeven naam en voornaam in de hospipass. (niveau : waarschuwing)
  • ROOMTYPE_INVALID : Het kamertype is van een hoger niveau dan in het document is opgegeven. (niveau : waarschuwing)
  • INCONSISTENCY_USETYPE : Er is al een opname geweest met deze hospipas, die is gedefinieerd voor een enkele opname. (niveau : waarschuwing)


Het gebruik van een hospipass bevestigen

Nadat je het gebruik van een hospipass hebt gevalideerd, moet je het gebruik ervan ook bevestigen. Deze bevestiging is onder andere belangrijk voor het beheer van hospipassen die slechts eenmaal kunnen worden gebruikt (USETYPE). 


We willen uw aandacht vestigen op de opnamedatum, die de datum moet zijn waarop de patiënt in het ziekenhuis wordt opgenomen en niet de datum van registratie van deze hospipass. Bijvoorbeeld, een patiënt die op 3/6/2025 om 23.00 uur het ziekenhuis binnenkomt voor een bevalling, maar pas de volgende dag naar het secretariaat gaat om zich in te schrijven: de opnamedatum moet danworden opgegeven als 3/6/2025 23.00 uur en niet 4/6/2025. 


De service /hospipass/{hospipassId}/use wordt gebruikt om het gebruik van een hospipass voor een bepaalde opname te bevestigen. Door de volgende gegevens te verstrekken:  

  • Id van de hospipass
  • Achternaam patiënt
  • Voornaam patiënt
  • Geboortedatum patiënt
  • Opnamedatum patiënt.


Dezelfde controles rond de geldigheid van de hospipass worden uitgevoerd als deze voor de service /hospipass/{hospipassId}/check. De meldingen zijn hetzelfde.  


De opname wordt echter alleen geregistreerd met een “ok” of “waarschuwing” retour. In het geval van een fout wordt het gebruik niet geregistreerd.