Le but de l’API hospipass mise à disposition par la plateforme Daisyh est de fournir aux hôpitaux une interface pour rechercher, consulter, valider et confirmer l’utilisation d’un hospipass. 


Ce document décrit l’ensemble du processus. Pour l’ensemble des détails des services, nous renvoyons aux documentations techniques et fichiers à destination des outils de analystes-développeurs :  

  • Daisyh API 4Hosp.yaml : fichier YAML décrivant l’API 
  • Daisyh API 4Hosp-openepi.zip : reference technique de l’API au format OpenAPI 
  • Daisyh API 4Hosp-html.zip : référence technique au format html 


Vous trouverez ces documents au bas de cet article.


Authentification 

L’authentification se fait à l’aide d’un utilisateur spécifique qui est possible de gérer via le portail Daisyh (https://www.daisyh.be). Cet utilisateur sera identifié par un login et une clé.


L'option de créer cet utilisateur spécifique pour la connexion API n'est pas encore disponible sur notre portail DaisyH. Elle sera bientôt disponible et une lettre d'information vous sera envoyée dès que cette fonctionnalité sera disponible dans notre environnement de production.


La première étape pour utiliser l’API est de s’authentifier via le service : /auth/token en fournissant le login et la clé. Si l’authentification est réussie le service renverra un token qui permettra l’authentification dans les autres services. 


Recherche d’un hospipass 

La recherche d’un hospipass se fait via le service : /hospipass/find4Hospitals 

Ce service permet de rechercher sur base de plusieurs critères qui peuvent être combinés : 


  • Nom du patient (ou partie de nom)
  • Prénom du patient (ou partie de prénom)
  • Date de naissance du patient
  • Date d’admission du patient
  • Assureur
  • Statut de l’hospipass 


(Le détail des valeurs possibles est donné dans la documentation technique) 


Sur base des critères le système renverra un ou plusieurs hospipass s’il en trouve. La réponse renvoit le détail de chaque hospipass afin de pouvoir choisir le plus approprié s’il y en a plusieurs. (par exemple en fonction du type de chambre, de la date d’admission, …) 


Chaque hospipass est identifié par un « id ». 


Consulter le détail d’un hospipass 

Avec l’id de l’hopipass, vous pouvez consulter le détail de celui-ci et télécharger le courrier transmis par l’assureur. 


Détail de l’hospipass : /hospipass/{hospipassId} 

Fichier lié à l’hospipass : /hospipass/{hospipassId}/file 


Dans le détail, vous retrouverez toutes les mêmes informations qui vous sont déjà transmisses dans le fichier XML qui accompagne l’hospipass. La liste exhaustive des données et valeurs est reprise dans la documentation technique. 


Valider l’utilisation d’un hospipass 


Le service /hospipass/{hospipassId}/check permet de vérifier / valider l’utilisation d’un hospipass pour une admission donnée. En donnant les données suivantes :  

  • Id de l’hospipass 
  • Nom du patient
  • Prénom du patient
  • Date de naissance du patient
  • Date d’admission du patient 


Le système va indiquer si l’utilisation semble valable ou non avec peut-être des alertes. 

Un code global indiquera :  

  • Ok : tout semble valable. L’hospipass peut être utilisé sans problème avec les données reçues
  • Warning : il y a des alertes mais qui ne sont pas bloquantes pour l’utilisation de l’hospipass (p.ex. un décalage d’un jour par rapport à la période de validité)
  • Error : il y a au moins un élément bloquant qui empêche l’utilisation de l’hospipass dans ce cas. 


An cas d’alertes ou d’erreurs, une série de codes et descriptions permettent d’identifier les problèmes :  


  • HOSPIPASS_REPLACED : Hospipass number has been replaced by another one - as there's a valid hospipass reference for this patient, the invoice is eligible to reimbursment by the insurance company. The new reference can be found in the field "new_reference". (level : warning)
  • HOSPIPASS_CANCELLED : Hospipass number has been cancelled. (level : error)
  • HOSPITAL_INVALID : The hospipass is linked to another hospital. (level : error)
  • ADMISSION_DATE_WARNING : The admission date is outside the date range of the document, but is still admissible because the difference is small (less than x days). (level : warning)
  • ADMISSION_DATE_OVERDUE : The admission date is outside the date range of the document. (level : error)
  • INCONSISTENCY_BIRTHDATE : Inconsistency bewteen the birth date given and the birth date provided in the hospipass. (level : warning)
  • INCONSISTENCY_NAME : Inconsistency bewteen the name and firstname given and the name and firstname provided in the hospipass. (level : warning)
  • ROOMTYPE_INVALID : The room type is of a higher level than that provided in the document. (level : warning)
  • INCONSISTENCY_USETYPE : There has already been an admission with this hospipass, which is defined for a single admission. (level : warning)


Confirmer l’utilisation d’un hospipass

Après avoir validé l’utilisation d’un hospipass, il faut confirmer son utilisation. Cette confirmation est importante entre autres pour la gestion des hospipass n’admettant qu’une utilisation unique (USETYPE). 


Nous attirons l’attention sur la date d’admission qui doit être la date d’admission du patient à l’hôpital et non sa date d’enregistrement. Par exemple, une patiente qui entre à l’hôpital le 3/6/2025 à 23h pour un accouchement mais qui ne passe au secrétariat pour s’enregistrer que le lendemain ; il faut bien donner le 3/6/2025 23h comme date d’admission et non le 4/6/2025. 


Le service /hospipass/{hospipassId}/use permet de confirmer l’utilisation d’un hospipass pour une admission donnée. En donnant les données suivantes :  


  • Id de l’hospipass
  • Nom du patient
  • Prénom du patient
  • Date de naissance du patient
  • Date d’admission du patient


les mêmes vérifications seront faites que dans le service précédent. Les messages sont les mêmes.  

En revanche l’admission ne sera enregistrée qu’avec un retour « ok » ou « warning ». En cas d’erreur, l’utilisation ne sera pas enregistrée.