Il s’agit d’une ressource qui regroupe les données décrivant l’ « exercice » et la « situation » d’exercice du professionnel :
Données relatives à l’exercice professionnel : nom et prénom d’exercice, profession, civilité d’exercice, catégorie d’exercice, qualifications de spécialiste et disciplines et attributions particulières.
Données sur l’activité professionnelle : fonction ou rôle du professionnel dans la structure d’activité, genre d’activité, mode d’exercice, type d’activité libérale pour les activités concernées, statut hospitalier pour les activités concernées, données de contact du professionnel pour l’activité concernée, données relatives à la structure d’activité.
Données relatives à la carte de professionnel de santé : type de carte, numéro, période de validité.
3) Recherche d’exercice et d’activité du professionnel de santé sur critères
Voici des exemples de requêtes sur les exercices et les activités du professionnel de sante.
3.1) Rechercher tout (sans critère)
Récit utilisateur : En tant que client de l’API, je souhaite récupérer l’ensemble des données correspondant aux situations d’exercice et exercices professionnels des PS.
Requêtes :
GET [base]/PractitionerRole
GET [base]/Organization&?_include=PractitionerRole:organization #inclure les Organization qui sont référencées par les PractitionerRole (PractitionerRole + Organization)
GET [base]/Organization&?_include=PractitionerRole:practitioner #inclure les Practitioner qui sont référencés par les PractitionerRole (PractitionerRole + Practitioner)
GET [base]/Organization&?_include=PractitionerRole:*#inclure toutes les ressources qui sont réféencées les PractitionerRole (PractitionerRole + Practitioner + Oraganization)
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
Practitioner Role found: id=005-5090000-6920000 code=FON-09
Practitioner Role found: id=005-5070000-6900000 code=FON-09
Practitioner Role found: id=005-5080000-6920000 code=FON-AU
Exemples de code :
3.2) Recherche par identifiant (_id)
Récit utilisateur : En tant que client de l’API, je souhaite rechercher une ressource par son identifiant technique.
Requête :
GET [base]/PractitionerRole/005-5087586-6923328
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
total: 1
Practitioner Role found: id=005-5087586-6923328
Exemples de code :
3.3) Recherche par rôle (role)
La recherche par le paramètre “role” permet de rechercher les PractitionerRole selon différents référentiels. Voici les différents référentiels disponibles :
Lorsque vous souhaitez rechercher sur un type particulier, utilisez la combinaison du système et du code souhaité :
PractitionerRole?role=<system>%7C<code>
Quelques exemples :
PractitionerRole?role=http://interopsante.org/fhir/CodeSystem/fr-v2-3307%7CLEGAL-ENTITY Recherche par type d’organization LEGAL-ENTITY
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/FHIR/TRE-R09-CategorieProfessionnelle%7CC Recherche par catégorie professionnelle TRE_R09-CategorieProfessionnelle avec le code C “Civil”
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_R21-Fonction/FHIR/TRE-R21-Fonction%7CFON-02 Recherche par fonction TRE_R21-Fonction avec le code FON-02 “Associé dans une société d’exercice (SEL ou SCP)”
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_R96-AutreFonctionSanitaire/FHIR/TRE-R96-AutreFonctionSanitaire%7CGENR03 Recherche par autres fonctions du domaine sanitaire TRE-R96-AutreFonctionSanitaire avec le code 400 “Aide-soignant”
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_R22-GenreActivite/FHIR/TRE-R22-GenreActivite%7CGENR03 Recherche par genre d’activité JDV_J94-GenreActivite-RASS avec le code GENR03 “Remplacement dans une activité de soins”
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_R23-ModeExercice/FHIR/TRE-R23-ModeExercice%7CS Recherche par Mode d’exercice JDV_J95-ModeExercice-RASS avec le code S “Salarié”
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_R06-SectionTableauCNOP/FHIR/TRE-R06-SectionTableauCNOP%7CS Recherche par Section du tableau de l’Ordre des Pharmaciens TRE_R06-SectionTableauCNOP avec le code A “Pharmacien titulaire officine”
PractitionerRole?role=https://mos.esante.gouv.fr/NOS/TRE_G05-SousSectionTableauCNOP/FHIR/TRE-G05-SousSectionTableauCNOP%7CDA Recherche par Sous-Section du tableau de l’Ordre des Pharmaciens TRE_G05-SousSectionTableauCNOP avec le code DA “Pharmacien adjoint”
3.3.1) Recherche par profession et par catégorie professionnelle
Récit utilisateur : En tant que client de l’API, je souhaite rechercher tous les chirurgiens-dentistes (code profession= “40”) en formation (code catégorie = “E”).
Requête :
GET [base]/PractitionerRole?role=40&role=E
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
Practitioner Role found: id=005-480000-6510001 codes=https://mos.esante.gouv.fr/NOS/TRE_R21-Fonction/FHIR/TRE-R21-Fonction:FON-47|https://mos.esante.gouv.fr/NOS/TRE_G15-ProfessionSante/FHIR/TRE-G15-
ProfessionSante:40|https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/FHIR/TRE-R09-CategorieProfessionnelle:E|https://mos.esante.gouv.fr/NOS/TRE_R22-GenreActivite/FHIR/TRE-R22-GenreActivite:GENR02|https://mos.esante.gouv.fr/NOS/TRE_R23-ModeExercice/FHIR/TRE-R23-ModeExercice:L
Practitioner Role found: id=005-490000-6510000 codes=https://mos.esante.gouv.fr/NOS/TRE_R21-Fonction/FHIR/TRE-R21-Fonction:FON-47|https://mos.esante.gouv.fr/NOS/TRE_G15-ProfessionSante/FHIR/TRE-G15-
ProfessionSante:40|https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/FHIR/TRE-R09-CategorieProfessionnelle:E|https://mos.esante.gouv.fr/NOS/TRE_R22-GenreActivite/FHIR/TRE-R22-GenreActivite:GENR02|https://mos.esante.gouv.fr/NOS/TRE_R23-ModeExercice/FHIR/TRE-R23-ModeExercice:
Exemples de code :
3.4) Recherche par spécialité (specialty)
Récit utilisateur : En tant que client de l’API, je souhaite rechercher tous les chirurgiens-dentistes (code profession= “40”) ayant une spécialité ordinale “orthopédie dento-faciale” (code spécialité = “SCD01”).
Requête :
GET [base]/PractitionerRole?role=40&specialty=SCD01
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
Practitioner Role found: id=005-400000 codes=https://mos.esante.gouv.fr/NOS/TRE_G15-ProfessionSante/FHIR/TRE-G15-ProfessionSante:40|https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/FHIR/TRE-R09-CategorieProfessionnelle:C|urn:oid:1.2.250.1.213.2.28:SCD01
Practitioner Role found: id=005-390000 codes=https://mos.esante.gouv.fr/NOS/TRE_G15-ProfessionSante/FHIR/TRE-G15-ProfessionSante:40|https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/FHIR/TRE-R09-CategorieProfessionnelle:C|urn:oid:1.2.250.1.213.2.28:SCD01
Practitioner Role found: id=005-380000 codes=https://mos.esante.gouv.fr/NOS/TRE_G15-ProfessionSante/FHIR/TRE-G15-ProfessionSante:40|https://mos.esante.gouv.fr/NOS/TRE_R09-CategorieProfessionnelle/FHIR/TRE-R09-CategorieProfessionnelle:C|urn:oid:1.2.250.1.213.2.28:SCD01
Exemples de code :
3.5) Recherche par type de carte (type-smartcard)
Récit utilisateur : En tant que client de l’API, je souhaite rechercher toutes les cartes de type CPS.
Requête :
GET [base]/PractitionerRole?type-smartcard=CPS
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
Practitioner Role found: id=005-54002-100000
Practitioner Role found: id=005-54001
Practitioner Role found: id=005-54000-100000
Exemples de code :
3.6) Recherche par professionnel (practitioner)
Récit utilisateur : En tant que client de l’API, je souhaite rechercher toutes les situations d’exercice et exercices professionnels d’un PS en partant de son identifiant technique ( = “003-138020” dans l’exemple ).
Requête :
GET [base]/PractitionerRole?practitioner=003-138020
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
Practitioner Role found: id=005-109896 practitioner=Practitioner/003-138020
Exemples de code :
3.7) Recherche par statut
Récit utilisateur : En tant que client de l’API, je souhaite rechercher toutes les ressources actives.
Requête :
GET [base]/PractitionerRole??active=true
Réponse (simplifiée) :
HTTP 200 OK
resourceType: Bundle
type: searchset
Practitioner Role found: id=prr-prarole-946 active=true
Practitioner Role found: id=prr-prarole-256 active=true
Practitioner Role found: id=prr-prarole-899 active=true
Exemples de code :
Code source des examples
Vous retrouverez le code source de ces exemples sur notre repository git: