Médicosocial - Suivi Décisions Orientation
4.0.2 - trial-use
Médicosocial - Suivi Décisions Orientation
4.0.2 - trial-use
This page is part of the Médicosocial - Suivi Décisions Orientation (v4.0.2: Release) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions
Ce flux permet à l’ESMS de rechercher les dossiers de nouvelles personnes ayant été orientées vers leur établissement ou de dossiers mis à jour les concernant. Cette recherche est ainsi formulée par le SI-ESMS auprès du SI-SDO. Ce flux permet de récupérer la liste des nouvelles décisions d’orientation avant de les consulter une par une (voir flux 1.3).
Le flux 1.1 est basé sur l’opération « search » de l’API REST FHIR. La recherche s’effectue sur la ressource de type DocumentReference et est constituée des paramètres de recherche obligatoires listés dans le tableau ci-dessous :
|
Paramètre |
Description |
Format du paramètre |
Contrainte |
|
type |
Type de document. |
token |
Ce paramètre doit avoir pour valeur 57830-2 (Admission request Document) |
|
_lastUpdated |
Date de dernière recherche |
date |
Utilisation du préfix « gt » (greater than) pour permettre au SI-ESMS de ne récupérer que les nouvelles ressources DocumentReference créées depuis la dernière interrogation. Pour un cas nominal, la fréquence de recherche est imposée à J-1. Pour un cas exceptionnel (première connexion au SI-SDO d’un DUI), la limite temporelle est fixée à J-30. |
|
Le paramètre élément liste les attributs de la ressource à retourner par le serveur |
Liste d’éléments séparés par des virgules |
Ce paramètre doit avoir pour valeur id. |
Cette recherche sera envoyée au SI-SDO en utilisant la requête HTTPS GET suivante :
GET [base]/DocumentReference?type=57830-2&_lastUpdated=gt[dateDernièreRecherche]&_elements=id
Où :
Ce flux contient le résultat de la recherche de dossiers de nouvelles personnes ayant été orientées vers un ESMS ou de dossiers mis à jour les concernant. Cette réponse est retournée par le SI-SDO au SI-ESMS. Il s’agit d’un flux qui permet de lister les nouveaux dossiers ou les mises à jour qui concerne uniquement l’ESMS à l’origine de la requête. Le SI-SDO s’appuie sur les informations du token d’authentification pour filtrer les dossier.
Le flux 1.2 se compose d’un code HTTPS 200 ok et d’un contenu. Le contenu est une ressource « Bundle » de type « searchset » encapsulant une collection de zéro, une ou plusieurs ressources « DocumentReference » répondant aux critères de recherche. Comme la recherche contient le paramètre _elements=id, les ressources « DocumentReference » ne contiendront pas l’ensemble des données connues du SI-SDO mais uniquement l’identifiant technique de la ressource permettant au SI-ESMS d’aller les consulter (cf flux 1.3).
En cas d’échec, le SI-SDO doit répondre avec le code HTTPS approprié tel que défini par l’API REST FHIR (Http - FHIR v4.0.1 (hl7.org)). Une ressource OperationOutcome doit également y être associé pour véhiculer les messages d’erreurs détaillant la raison de l’erreur (OperationOutcome - FHIR v4.0.1 (hl7.org)).
Ce flux contient une demande de consultation d’une nouvelle décision d’orientation ou de dossiers mis à jour dont l’identifiant technique connu a été remonté par le flux 1.2. Cette demande de consultation est formulée par le SI-ESMS auprès du SI-SDO et fait suite à la recherche de dossiers personnes ayant été orientées vers un ESMS.
Le flux 1.3 est basé sur l’opération « read » de l’API REST FHIR. La demande est envoyée via une requête HTTPS GET basée sur le modèle suivant :
GET [base]/DocumentReference/id
Où :
Ce flux contient le résultat de la demande de consultation d’une nouvelle décision d’orientation ou de dossiers mis à jour (flux 1.3). Cette réponse est retournée par le SI-SDO au SI-ESMS.
Le flux 1.4 se compose d’un code HTTPS 200 ok et contient la ressource DocumentReference. Le SI-ESMS récupère ainsi :
En cas d’échec, le SI-SDO doit répondre avec le code HTTPS approprié tel que défini par l’API REST FHIR (Http - FHIR v4.0.1 (hl7.org)). Une ressource OperationOutcome doit également y être associé pour véhiculer les messages d’erreurs détaillant la raison de l’erreur (OperationOutcome - FHIR v4.0.1 (hl7.org)).