APIs
Guides d'intégration
Import de prescription

Import de prescription

Introduction

Posos permet à ses utilisateurs hospitaliers d’importer directement dans leur DPI la liste des médicaments (et les posologies associées) inscrits sur une ordonnance. Cette documentation explique les fonctions disponibles, les formats utilisés et les modalités d’intégrations possibles.

Pré-requis

L’utilisateur est inscrit sur Posos et utilise l’application sur son téléphone mobile ou sur un ordinateur équipé d’une webcam.

Le DPI de l’établissement est intégré avec Posos et permet l’import de prescriptions.

Le compte utilisateur est configuré pour être autorisé à utiliser la fonction d’import de prescription.

Les ordonnances à lire sont dactylographiées.

La technologie de scan intelligent est capable de reconnaitre la plupart des médicaments et de structurer les formulations de posologie les plus courantes. Néanmoins, il restera toujours un risque pour que ça ne soit pas possible, le DPI doit donc tenir compte de cette possibilité ou utiliser l'interface de validation Scan & Go.

Comment ça fonctionne ?

Il s’agit d’importer dans le DPI une liste de médicaments et de posologies associées tels que décrits sur une ordonnance papier. Cette liste peut alimenter par exemple un recueil de traitement en cours ou un outil de conciliation médicamenteuse.

Récupération de l'identité du patient

Récupérer un identifiant technique permettant au DPI de faire le lien avec l'ordonnance scannée.

Scan de l'ordonnance

Scanner l'ordonnance avec l'application Scan & Go pour une intégration minimale ou bien envoyer l'ordonnance sur le point d'api correspondant pour analyse.

Transfert de l'ordonnance au DPI

Une fois l'analyse terminée, l'ordonnance est envoyée au DPI. Si le DPI ne propose pas d'API accessible sur Internet, une boite aux lettres peut être mise en place.

Format de fichiers de sortie

Les ordonnances scannées et interprétées sont enregistrées sous forme d’un fichier JSON contenant l’ensemble des informations et utilisant les représentations proposées par le standard FHIR. Une documentation précise est accessible et fait référence : Modélisation export d’ordonnance.

Modalité d’intégration avec le DPI

1. Récupération de l’identité du patient

L’intégration revient à faire parvenir au DPI les informations suivantes :

  • le contenu de la prescription
  • l’identité du médecin réalisant l’opération
  • l’identité du patient concerné

La première est directement fournie par le scan, la seconde correspond au compte utilisateur courant du médecin, la troisième est une information indispensable moins triviale à obtenir.

La première étape est ainsi de fournir à l’application Posos un moyen de lier l’ordonnance qu’elle scanne au patient. Nous proposons une intégration simple, minimisant d’une part les manipulations d’informations personnelles et d’autre part les travaux de développement chez l’éditeur tiers.

Ce dont à besoin Posos est un identifiant technique permettant au DPI de faire le lien avec le dossier patient. Posos n’a pas besoin d’informations identifiantes telle que l’INS, le nom ou le prénom. Nous proposons deux modes d’intégration différents.

Affichage d’un QR Code

Pour transmettre cet identifiant technique, le DPI peut afficher sur le dossier patient (dans un volet ou une fenêtre dédié par exemple) un QR Code encodant les informations nécessaires (identifiant de l’établissement + identifiant du patient). Ce QR code sera ensuite scanné par le médecin au même moment que l’ordonnance, et l’application Posos y lira ainsi tout ce qui lui faut.


Consultez la documentation de l'API de génération du QR Code

Intégration du Scan & Go

Posos propose aussi l’intégration dans votre logiciel d’une application gérant le recueil des fichiers de prescription, leur retranscription et l’affichage d’une interface de validation et de correction. Cette interface ajoute aussi des modes d’envois de fichier (par webcam du poste de travail ou par glisser-déposer de fichiers locaux).


Consultez la documentation du Scan & Go

2. Transfert de l’ordonnance au DPI

La seconde étape consiste à transmettre au DPI la prescription scannée. Deux possibilités sont offertes selon l’architecture du DPI destinataire.

Pour un DPI proposant une API accessible sur Internet

Posos peut développer un connecteur vers l’API mise à disposition en se chargeant de la transformation du fichier issu du scan d’ordonnance si nécessaire.

Pour un DPI ne proposant pas une API accessible sur Internet

C’est la situation qui nécessite le plus d’étude préalable mais la solution la plus commune sera la mise en place d’une boite aux lettres accessible depuis le système d’information de l’établissement :

  • soit sous forme d’un dépôt de fichier (dans le format qui conviendra le mieux, Posos pouvant produire un format spécifique si besoin) ; c’est une solution souvent plus simple à mettre en oeuvre mais qui est la moins “temps réel”.
  • soit sous forme d’une API mise en ligne et proposant au DPI d’aller “tirer” les ordonnances en temps réel ou en asynchrone ; là aussi, Posos peut proposer de produire un format plus adapté au DPI de destination. Cette API de destination peut être une API ad-hoc ou un entrepôt FHIR détaillé dans le guide : Accéder à l’entrepôt FHIR.

Terminologies employées

Les prescriptions, notamment en ville, ne sont pas systématiquement exhaustives et ne permettent pas nécessairement d’identifier avec précision une spécialité médicamenteuse prescrite. Pour pallier ce problème, Posos code chaque ligne de prescription avec plusieurs terminologies :

  • si possible le Code Identifiant de Spécialité (CIS)
  • si possible, le nom de générique ou nom de marque du médicament
  • sinon a minima, sa Dénomination Commune (tel qu’identifié dans Medicabase et bientôt dans le Référentiel d’Interopérabilité du médicament de l’ANS quand il sera disponible)
  • et sa classe ATC

Cette codification multiple permet au DPI destinataire de traiter l’information avec la plus grande précision dans toutes les circonstances.

L'autre alternative consiste à utiliser l'interface de Scan & Go qui permettra d'envoyer spécifiquement l'UCD/CIS final (voir la section Intégration du Scan & Go)