Service d'Accès aux Soins
1.2.0 - ci-build
Service d'Accès aux Soins
1.2.0 - ci-build
Service d'Accès aux Soins - version de développement local (v1.2.0) construite par les outils de publication FHIR (HL7® FHIR® Standard). Voir le répertoire des versions publiées
Endpoint |
|
Header |
Accept: application/json+fhir |
Encodage |
UTF-8 |
Version FHIR |
4.0.1 |
Version package |
|
Publication |
|
Interaction FHIR |
Create[1] |
Méthode http associée |
POST |
Ressource créée |
Practitioner |
Construction requête de base |
|
[1] https://www.hl7.org/fhir/http.html#create et https://www.hl7.org/fhir/http.html#general
Lien vers la spécification FHIR : https://www.hl7.org/fhir/practitioner.html
Si la création est un succès, le serveur répond :
Location: [base]/Practitioner/12345Plus de précision sur la spécification FHIR : https://www.hl7.org/fhir/http.html
Lien vers la spécification FHIR : https://www.hl7.org/fhir/operationoutcome.html
Si la recherche échoue, le serveur doit répondre :
À titre d'information, les codes erreurs classiques sont les suivants :
Plus de précision sur la spécification FHIR : https://www.hl7.org/fhir/http.html
Requête :
post[BASE]/Practitioner
Corps de la requête :
La requête ci-dessous correspond à la création ou mise à jour du compte de Sébastien LORIDON, dont l’identifiant national est 3456780581/11242343 et le mail sebastien.loridon@test.com.
{
"resourceType" : "Practitioner",
"id" : "ExamplePractitionerRegul1",
"meta" : {
"source" : "urn:oid:1.2.250.1.213.3.6",
"profile" : [
🔗 "https://interop.esante.gouv.fr/ig/fhir/sas/StructureDefinition/FrPractitionerRegul"
]
},
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Narratif généré : Praticien ExamplePractitionerRegul1</b></p><a name=\"ExamplePractitionerRegul1\"> </a><a name=\"hcExamplePractitionerRegul1\"> </a><div style=\"display: inline-block; background-color: #d9e0e7; padding: 6px; margin: 4px; border: 1px solid #8da1b4; border-radius: 5px; line-height: 60%\"><p style=\"margin-bottom: 0px\"/><p style=\"margin-bottom: 0px\">Information Source: <a href=\"https://simplifier.net/resolve?scope=hl7.fhir.fr.core@1.1.0&canonical=urn:oid:1.2.250.1.213.3.6\">urn:oid:1.2.250.1.213.3.6</a></p><p style=\"margin-bottom: 0px\">Profil: <a href=\"StructureDefinition-FrPractitionerRegul.html\">FrPractitionerRegul</a></p></div><p><b>identifier</b>: Identifiant National de Professionnel de Santé/3456780581/11242343</p><p><b>active</b>: true</p><p><b>name</b>: Sébastien Loridon </p><p><b>telecom</b>: <a href=\"mailto:sebastien.loridon@test.com\">sebastien.loridon@test.com</a></p></div>"
},
"identifier" : [
{
"type" : {
"coding" : [
{
"system" : "http://interopsante.org/fhir/CodeSystem/fr-v2-0203",
"code" : "IDNPS"
}
]
},
"system" : "urn:oid:1.2.250.1.71.4.2.1",
"value" : "3456780581/11242343"
}
],
"active" : true,
"name" : [
{
"family" : "Loridon",
"given" : [
"Sébastien"
]
}
],
"telecom" : [
{
"system" : "email",
"value" : "sebastien.loridon@test.com"
}
]
}Interaction FHIR |
Conditional update[2] |
Méthode http associée |
PUT |
Ressource créée |
Practitioner |
Construction requête de base |
|
[2] https://www.hl7.org/fhir/http.html#cond-update et https://www.hl7.org/fhir/http.html#general
Cette requête de modification est donc de type interaction conditional update. Elle permet de mettre à jour une ressource sur la base d’un critère autre que l'id de la ressource
En l’occurrence, les requêtes effectuées par le SAS se baseront sur l’élément « identifier » de la ressource à modifier. [ID] représente l’identifiant national ou technique de cette ressource.
urn:oid:1.2.250.1.71.4.2.1|3456780581/11242343, 3456780581/11242343 étant l’identifiant national préfixéurn:oid:1.2.250.1.213.3.6|b6e39355-8a61-4556-b340-36f7b95fec6a, b6e39355-8a61-4556-b340-36f7b95fec6a étant l’identifiant technique SASPoint d’attention : dans le cas où le flux de mise à jour concerne une ressource non existante à date dans la solution logicielle éditeur, il est attendu que l’interface soit idempotente, réalise les contrôles nécessaires et se comporte comme si une requête de création avait été émise. Point d’information : l’ensemble des régulateurs ne sont pas équipés de carte CPx et n’ont donc pas tous un identifiant national à date. Des travaux sont en cours afin d’accompagner le déploiement de l’équipement nécessaire (lecteur de carte, cartes, etc.) aux régulateurs. C’est pour cette raison que nous utilisons de manière transitoire un identifiant technique SAS permettant d’identifier le régulateur de façon univoque (absence de collision, définition d’une autorité d’affectation, etc.).
Lien vers la spécification FHIR : https://www.hl7.org/fhir/bundle.html
Si la création est un succès, le serveur répond :
Location: [base]/Practitioner/12345Plus de précision sur la spécification FHIR : https://www.hl7.org/fhir/http.html
Lien vers la spécification FHIR : https://www.hl7.org/fhir/operationoutcome.html
Si la recherche échoue, le serveur doit répondre :
À titre d'information, les codes erreurs classiques sont les suivants :
Il n’y aura pas de requête spécifique pour la suppression de compte. Une suppression de compte côté plateforme numérique SAS est modélisée par une requête de type « mise à jour de compte » où l’on retire l’habilitation associée au compte.
Cette section détaille les règles de gestion à utiliser au niveau des éléments retournés par la requête.
urn:oid:1.2.250.1.71.4.2.1. Lorsque l’identifiant transmis est un ID technique SAS, il est valorisé à urn:oid:1.2.250.1.213.3.6.IDNPS. Lorsque l’identifiant transmis est un ID technique SAS, il est valorisé à INTRN.true le compte doit être habilité et actif, si le champ est valorisé à false le compte doit être déshabilité ou désactivé.urn:oid:1.2.250.1.213.3.6.