Aller au contenu principal

Patients

Connecter un patient​

Une fois que les médecins utilisent Legit.Health, c'est le moment également de connecter les patients afin qu'ils puissent aussi utiliser la technologie.

Afin de connecter des patients, vous devez utiliser le terminal createPatient. En envoyant les informations à ce terminal, votre logiciel connectera les informations d'un patient à Legit.Health.

Le patient doit confirmer son compte. Pour que cela se produise, vous devez préciser les coordonnées du patient.

  • Si vous précisez une adresse e-mail, un e-mail sera envoyé au patient pour lui permettre de vérifier son compte.
  • Si vous précisez un numéro de téléphone, un SMS sera envoyé au patient pour lui permettre de vérifier son compte.

Ce n'est pas obligatoire, mais si possible, vous devez également préciser les affections du patient dans la demande, en utilisant la propriété affections. Ce champ est une liste d'objets contenant le code de la pathologie et la zone du corps. La liste complète des codes est disponible dans le document Swagger.

Si vous connectez un patient dont certaines affections sont diagnostiquées, un épisode de soins actif sera automatiquement créé pour chaque affection.

Générer des identifiants de connexion​

Le patient pourra utiliser la technologie Legit.Health sans avoir à se connecter à un autre système. En d'autres termes, votre logiciel aura un bouton, et lorsque les patients cliqueront dessus, ils seront automatiquement dirigés vers l'interface de Legit.Health, comme s'il s'agissait du même environnement, sans avoir à se connecter ou à effectuer des clics supplémentaires.

Pour que cela fonctionne, vous devez utiliser le terminal getPatientsAuthTokens pour générer les jetons correspondants afin de permettre à un patient de se connecter directement.

Vous pouvez également programmer votre logiciel pour que le patient reçoive un e-mail avec le lien de connexion. Si vous joignez le paramètre sendLinkToPatientByEmail à la demande, le patient recevra un e-mail avec un lien pour se connecter à l'interface de Legit.Health.

La structure des liens de connexion est la suivante :

https://app.legit.health/u/home?token=token&refresh_token=refresh_token

Créer un épisode de soins pour un patient​

Pour créer un nouvel épisode de soins pour l'affection d'un patient, vous pouvez utiliser le terminal createEpisodeOfCare.

Vous ne pouvez pas créer un épisode de soins actif si l'affection en a déjà un actif.

Créer une rencontre pour un patient​

Vous pouvez créer une rencontre à l'aide du terminal createEncounter.

Si le champ prévu_ pour est à venir, la rencontre recevra le statut planifié.

Si le champ prévu_pour est à venir, la rencontre recevra le statut prêt afin qu'elle puisse être complétée dès maintenant par le patient.

Obtenir les informations du patient​

La connexion des patients fonctionne dans les deux sens. Après avoir envoyé des informations sur les patients, vous souhaiterez récupérer les informations d'un patient pour les ajouter à votre GRH.

Pour obtenir des informations sur les patients, vous devez utiliser le terminal getPatients.

Vous devez préciser les identifiants dans votre plateforme de chaque patient dans le paramètre URL externalIds. Par exemple :

​​?externalIds[]=a449666c710c&externalIds[]=baa3cf93-6f1c

Obtenir les épisodes de soins du patient​

Il est possible que certains épisodes de soins puissent être créés sur la plateforme Legit.Health par le patient lui-même ou même par le médecin, au fur et à mesure qu'ils téléchargent des images. Dans de tels cas, vous voudrez récupérer ces informations pour les conserver dans votre GRH.

Pour récupérer les épisodes de soins du patient, vous devez utiliser le terminal_getEpisodesOfCare_.

Vous devez préciser l'identifiant de l'affection. Cet identifiant est renvoyé par le terminal getPatients dans la propriété affections.

Soigner un patient​

Vous souhaiterez peut-être modifier les informations d'un patient déjà connecté avec Legit.Health.

Pour soigner un patient, vous pouvez utiliser le terminal patchPatient.

Ce terminal est utile si vous souhaitez mettre à jour certaines informations sur un patient connecté, par exemple :

  • Ajouter une nouvelle affection. Cela implique qu'un nouvel épisode de soins avec le statut « actif » est généré dans le système pour cette affection.
  • Suspendre une affection existante. Cela implique que l'épisode actif de prise en charge de l'affection est changé en statut « terminé ».
  • Suivre une affection existante. Cela implique qu'un nouvel épisode de soins avec le statut « actif » est généré dans le système pour cette affection. Des rencontres seront créées automatiquement à la fréquence spécifiée pour permettre au médecin de suivre l'affection.
  • Modifier les informations de base du patient.

Vous pouvez voir différents exemples d'utilisation de ce terminal dans la section correspondante du document Swagger.

Corriger l'épisode de soins du patient​

Vous voudrez peut-être faire correspondre les épisodes de soins, tels qu'ils sont identifiés dans votre GRH, avec les épisodes de soins sur Legit.Health.

Pour corriger les épisodes d'un patient, vous pouvez utiliser le terminal patchEpisodeOfCare.

Ce terminal est utile si vous souhaitez faire correspondre vos épisodes de soins avec ceux créés dans Legit.Health. Pour que cela fonctionne, le terminal utilise l'identifiant interne généré pour les épisodes de soins dans l'application Legit.Health.

Le flux recommandé que vous pouvez suivre pour corriger un épisode de soins est le suivant :

  • Tout d'abord, obtenez les épisodes de prise en charge de l'affection du patient à l'aide du paramètre getEpisodesOfCare.
  • Ensuite, utilisez l'identifiant interne de l'épisode de soin pour créer l'URL du correctif.