dsft des webservices de annuaire.santeesante.gouv.fr/...fr_dsft_webservices_consultation... · dsft...

DSFT des WebServices de annuaire.sante.fr 19/12/13

Classification : public 2 / 91

Identification du document

Référence Annuaire_sante_fr_DSFT_WebServices_Consultation_20131021_V1.0.0.docx

Date de création 23 janvier 2013

Date de dernière mise à jour

19 décembre 2013

Etat Validé

Version V1.0.0

Classification Non sensible – Public

Nombre de pages 91

Historique du document

Version Date Auteur Commentaires V0.X 2013 ASIP Santé Versions de travail successives du document

V1.0.0 03/07/13 ASIP Santé Première version pour diffusion



Documents de référence

Référence Descriptif

[ref.1 ] CI-SIS_TRANSPORT_VOLET-SYNCHRONE

Cadre d’interopérabilité des Systèmes de santé (Ci-SIS) - Couche Transport - Volet Synchrone pour Client Lourd

[ref.2 ] CI-SIS : EVOLUTION DU VIHF : PROFIL POUR

ANNUAIRE DE PROFESSIONNEL DE SANTÉ CI-SIS : Evolution du VIHF : profil pour annuaire de professionnel de santé

[ref.3] VOLET STRUCTURATION MINIMALE DES DOCUMENTS MÉDICAUX

Couche Contenu - Volet Structuration Minimale de Documents Médicaux

[ref 4] NAS-Modèle de données- Principes et Définitions- NAS et Modèle de données de annuaire.sante.fr - Principes et définitions

[ref 5] NAS-Modèle de données du RASS NAS - Modèle des données d’identification des acteurs pris en charge par le système annuaire.sante.fr

[ref 6] NAS-Ressources terminologiques utilisées par le RASS

NAS - Ressources terminologiques associées aux données publiées par annuaire.sante.fr

[ref 7]

Annuaire.sante.fr_WebServices_Consultation-Annexes-wsdl_xsd

WSDL et XSD du service

http://esante.gouv.fr/sites/default/files/CI-SIS_DOC-CHAPEAU_V1.3.1_0.pdf

http://esante.gouv.fr/sites/default/files/EVOLUTIONVIHF-PROFIL_Annuaire_20130614_v1.0.0.pdf

http://esante.gouv.fr/sites/default/files/EVOLUTIONVIHF-PROFIL_Annuaire_20130614_v1.0.0.pdf

http://esante.gouv.fr/sites/default/files/CI-SIS_CONTENU_VOLET-STRUCTURATION-MINIMALE_V1.3.1.1.pdf

http://esante.gouv.fr/sites/default/files/CI-SIS_CONTENU_VOLET-STRUCTURATION-MINIMALE_V1.3.1.1.pdf

http://esante.gouv.fr/sites/default/files/NAS-Modele_de_donnees-Principes_et_Definitions-V1.0.0.pdf

http://esante.gouv.fr/sites/default/files/NAS-Modele_de_donnees_du_RASS-V1.0.0.pdf

http://esante.gouv.fr/sites/default/files/NAS-Ressources_terminologiques_des_donnees_RPPS_V1.0.0.pdf

http://esante.gouv.fr/sites/default/files/NAS-Ressources_terminologiques_des_donnees_RPPS_V1.0.0.pdf



Sommaire

1. Introduction ..................................................................................................................... 6

1.1 Objet du document ..................................................................................................................... 6

1.2 Gestion des versions successives ................................................................................................ 6

1.3 Guide de lecture.......................................................................................................................... 6

2. Contexte de mise en œuvre des Web Service de annuaire.sante.fr ..................................... 7

2.1 Présentation de l’ASIP Santé ....................................................................................................... 7

2.2 Historique ................................................................................................................................... 8

2.3 Définition d’« annuaire.sante.fr » ............................................................................................... 8

2.4 Cadre juridique de mise en œuvre.............................................................................................. 9

2.5 Description des acteurs du système ........................................................................................... 9

3. Accès sécurisé aux Webservices de annuaire.sante.fr : disposition générale ..................... 10

3.1 Exigences de confidentialité spécifiques aux données du RPPS ............................................... 10

3.2 Sécurité et intégrité spécifique aux échanges avec le système « annuaire.sante.fr » ............. 10

4. Présentation des services offerts par les Webservices de annuaire.sante.fr ...................... 12

4.1 Les différents Webservices proposées ..................................................................................... 12

4.1.1 Webservices pour accéder aux données des personnes physiques ............................ 12

4.1.2 Webservices pour accéder aux données personnes morales dans lesquelles exerce un PS 12

4.2 Trajectoire et méthodologie ..................................................................................................... 13

4.2.1 Obtenir un certificat CPS .............................................................................................. 13

4.2.2 Obtenir l’autorisation d’accès aux données RPPS ........................................................ 14

4.2.3 Développer une application cliente ............................................................................. 14

4.2.4 Tester son application sur un environnement de test ................................................. 15

4.3 Cas d’utilisation identifiés ......................................................................................................... 15

4.4 Processus d’utilisation d’un web service de annuaire.sante.fr ................................................. 16

4.4.1 Description ................................................................................................................... 16

4.4.2 Scénario principal ......................................................................................................... 17

4.4.3 Scénarios alternatifs ..................................................................................................... 18

5. Description détaillée du système .................................................................................... 19

5.1 Protocole et référence .............................................................................................................. 19

5.2 Encodage et espaces de nommage ........................................................................................... 19

5.3 Principe d’authentification et d’identification .......................................................................... 20

5.4 Description des échanges ......................................................................................................... 22

5.4.1 Principe de construction des messages ....................................................................... 22

5.4.2 Principe d’échanges ..................................................................................................... 22

5.4.3 Version des données échangées .................................................................................. 22

5.4.4 Version des web services ............................................................................................. 23



5.5 Description des ressources terminologiques ............................................................................ 23

5.6 Description du message d’entête ............................................................................................. 23

6. Description fonctionnelle détaillée des services .............................................................. 33

6.1 Recherche de personnes physiques .......................................................................................... 33

6.1.1 Principe de construction des flux ................................................................................. 33

6.1.2 Description du flux d’entrée ........................................................................................ 34

6.1.3 Description du flux de sortie ........................................................................................ 37

6.1.4 Traitements métier, contrôles ..................................................................................... 37

6.2 Consultation de personnes physiques ...................................................................................... 40





6.3 Recherche de personnes morales ............................................................................................. 66





6.4 Consultation de personnes morales ......................................................................................... 72





6.5 Gestion des erreurs ................................................................................................................... 82

6.5.1 Réponses standards en cas d’erreur ............................................................................ 82

7. Annexes ......................................................................................................................... 83

7.1 WSDL - Contrats d’interfaces .................................................................................................... 83

7.2 XSD ............................................................................................................................................ 83

7.3 Identifiants des Ressources Terminologiques utilisées par le système annuaire.sante.fr ........ 83

7.4 Droit de rectification des données collectées par le service annuaire.sante.fr ........................ 83

7.5 Lexique, abréviations et légende .............................................................................................. 83

7.5.1 Lexique ......................................................................................................................... 83

7.5.2 Abréviations ................................................................................................................. 86

7.5.3 Liste des figures ............................................................................................................ 88

7.5.4 Liste des tableaux ......................................................................................................... 89



1. Introduction

1.1 Objet du document

L’objectif du présent document est de décrire en détail les principes, les fonctionnalités et les

interfaces d’accès à la consultation des données rattachées aux personnes morales et physiques à

partir de « annuaire.sante.fr ».

Nous vous proposons donc de :

rappeler le contexte de mise en œuvre de « annuaire.sante.fr » ;

décrire les acteurs du processus de consultation des données rattachées aux personnes

morales et physiques et expliciter son organisation ;

rappeler les exigences de sécurité et de confidentialité attachées aux services offerts par

l’ASIP Santé ;

présenter les services proposés, les cas d’utilisation et la méthode pour y accéder ;

définir les spécifications fonctionnelles détaillées des interfaces mises à disposition.

préciser les modalités d’accès aux données présentes dans « annuaire.sante.fr ».

1.2 Gestion des versions successives

La présente spécification sera mise à jour pour tenir compte des évolutions du système, pour des raisons réglementaires, fonctionnelles ou techniques.

Cette gestion de versions est prise en compte dès la conception du système. Le cycle d’élaboration du DSFT des interfaces annuaire.sante.fr, est disponible dans un tableau au début du document.

Plusieurs versions majeures des interfaces d’accès du système annuaire.sante.fr peuvent coexister en même temps, ceci afin de laisser suffisamment de temps aux éditeurs pour adapter leurs produits.

Il est possible d’être automatiquement informé des dernières mises à jour de ce dossier en s’abonnant aux notifications « RNR » disponible sur le site web (onglet de droite) abritant ce document.

1.3 Guide de lecture

Ce document est destiné principalement aux décideurs et aux profils techniques. Selon son profil, le lecteur pourra se concentrer sur certains chapitres spécifiques :

Profil 1 – Décideurs, chefs de projet : Chapitres 2 à 4

Profil 2 - Développeurs, architectes logiciels, consultants techniques : Chapitres 4 à 6

La lecture des documents relatifs au modèle de données et aux ressources terminologiques est un préalable à la lecture des chapitres techniques de ce document (à partir du chapitre 5).

http://esante.gouv.fr/services/referentiels/identification/acceder-aux-webservices-du-rass



2. Contexte de mise en œuvre des Web Service de annuaire.sante.fr

Ce chapitre décrit le contexte ayant amené la mise en œuvre du service proposé par le système annuaire.sante.fr

2.1 Présentation de l’ASIP Santé

L’Agence des Systèmes d’Information Partagés de Santé (ASIP Santé) a été créée en 2009 sous l’impulsion de Roselyne Bachelot-Narquin, ministre de la Santé et des Sports. Agence d’Etat placée sous la tutelle du ministère en charge de la santé, sa mise en œuvre résulte de la volonté des pouvoirs publics de renforcer la maîtrise d’ouvrage publique des systèmes d’information en France ; elle regroupe depuis novembre 2009 le GIP Dossier Médical Personnel, le GIP Carte de Professionnel de Santé et les missions du GMSIH relatives à l’interopérabilité.

Le rôle de l’ASIP Santé consiste à promouvoir et encadrer le développement des systèmes d’information dans le secteur de la santé et du médico-social.

L’instruction générale interministérielle n°6600/SGDN/PSE/PPS relative à la sécurité des activités d’importance vitale du 26 septembre 2008 a classé ce secteur parmi les secteurs d’activités d’importance vitale pour l’État.

En matière d’e-santé, l’ASIP Santé conçoit et développe des systèmes d’information partagés de santé qui mettent en œuvre les référentiels nationaux et internationaux qu’elle promeut. En outre, elle encadre le développement de la télémédecine.

L’Agence contribue également à la définition des conditions d’une protection efficace des données de santé à caractère personnel qui jouissent d’un encadrement juridique important.

De plus, les missions reprises du GIP - Carte de Professionnel de Santé donnent à l’Agence un rôle officiel dans la constitution des annuaires de référence des acteurs de santé. C’est à ce titre qu’elle assure la maîtrise d’ouvrage de annuaire.sante.fr.

Les activités métier assurées par l’ASIP Santé sont les suivantes :

maîtrise d’ouvrage de projets délégués par les pouvoirs publics ; élaboration et promotion de référentiels d’interopérabilité sémantique, technique et de

sécurité de l’information ; élaboration et promotion des référentiels d’identification des Acteurs Sanitaires et Sociaux ; conduite des projets pour la construction de systèmes d’information de santé partagés dont

la maîtrise d’ouvrage est assurée par l’Agence (exemple : DMP) ; activité d’identification des acteurs de santé et la mise en œuvre par l’agence du service de

annuaire de référence associé ; accompagnement et communication envers les partenaires : relations avec les professionnels de santé et les patients, relations avec les institutionnels, relations avec les maîtrises d’ouvrage régionales de SISP, relations avec les industriels ; mise en place et pilotage des Appels à Projets contribuant au développement des systèmes

d’information partagés activité de prestataire de service de confiance dans le cadre de la gestion des Cartes de

Professionnels de Santé (CPS), d’autres types de cartes de la famille CPx et d’autres dispositifs équivalents visés à l’article 1110-4 du code de santé publique ;

assistance et secrétariat du Comité d’agrément des hébergeurs de données de santé à caractère personnel pour l’instruction des dossiers de demandes d’agrément.



2.2 Historique

Créé par l’arrêté du 6 février 2009 modifié par l’arrêté du 23 décembre 2011 (dit « arrêté RPPS »), le RPPS a vocation à identifier de manière unique et pérenne les professionnels de santé.

L’ASIP Santé assure la mise en œuvre et la maintenance du RPPS, en coopération avec l’Etat, le Service de Santé des Armées, les Ordres professionnels et la CNAMTS, constitué à partir des informations certifiées et transmises par les Autorités d’Enregistrement.

Les Autorités d’Enregistrement assurent une fonction de guichet unique pour l’ensemble des professionnels de santé relevant de leur ressort. Elles ont pour mission la régulation de l'accès à la profession (vérification de la qualification professionnelle, éventuellement la validation de diplômes) et son suivi (tenue de registres d'immatriculation des professions réglementées). Ainsi, en qualité d’Autorité d’Enregistrement, les ordres professionnels doivent tenir à jour la liste des membres de leur profession en situation d’exercice régulier, ainsi que les structures non gérées dans FINESS (cabinets libéraux, autres établissements, …) dans lesquels ces membres exercent après avoir procédé aux contrôles nécessaires.

La fonction de guichet unique est respectivement assurée par les Ordres pour les professionnels à ordre, le Service de Santé des Armées pour les professionnels qui ont le statut militaire, les services concernés de l’État et ses établissements publics tels les Agences Régionales de Santé, pour les professionnels de santé relevant de leur compétence administrative.

Dès son inscription au tableau de son ordre ou auprès de son autorité d’enregistrement, les informations sur le professionnel de santé sont portées au RPPS.

A ce jour, quatre professions sont dans le RPPS : les chirurgiens-dentistes, les médecins, les pharmaciens et les sages-femmes. L’intégration des pédicures-podologues, masseurs-kinésithérapeutes et infirmiers est en phase d’étude.

En sa qualité de responsable de traitement au sens de la loi n°78-17 du 6 janvier 1978 modifiée

relative à l’informatique, aux fichiers et aux libertés, l’ASIP Santé est tenue de respecter les finalités

du RPPS définies par l’arrêté du 6 février 2009 modifié portant création du RPPS.

Ces finalités sont les suivantes :

identifier les professionnels de santé en exercice, ayant exercé ou susceptibles d’exercer ;

suivre l’exercice de ces professionnels ;

contribuer aux procédures de délivrance et de mise à jour des cartes de professionnel de

santé ;

permettre la réalisation d’études et de recherches ainsi que la production de statistiques

relatives aux professionnels répertoriés, à partir d’une base de référence anonymisée.

En outre, l’ASIP Santé a pour mission de mettre les données librement communicables du RPPS à

disposition du public au moyen d’un service de communication sous forme électronique.

2.3 Définition d’« annuaire.sante.fr »

« annuaire.sante.fr » permet de mettre à disposition des utilisateurs autorisés l’ensemble des données de description des professionnels de santé enregistrés dans le RPPS (données d’identité, exercice professionnel, situations d’exercice…) dans le respect des règles définies par l’arrêté RPPS .

« annuaire.sante.fr » permet aussi d’accéder aux données d’identification des établissements dans lesquels ces professionnels de santé exercent, que ces établissements soient du domaine sanitaire, médico-social ou social.



Il comprend plusieurs canaux de publication :

une IHM web, permettant une consultation des données en mode authentifié ou non

authentifié ;

une mise à disposition des données sous forme de fichiers (extractions), accessibles

uniquement en accès authentifié (un accès non authentifié doit également être mis en

œuvre au regard de l’évolution récente de l’article 6 de l’arrêté dit « RPPS » du 6 février

2009;

des webservices, accessibles uniquement en accès authentifié.

C’est ce dernier canal de publication qui est détaillé dans le présent document.

2.4 Cadre juridique de mise en œuvre

Les différents services de publication de données présents dans annuaire.sante.fr s’inscrivent dans le

cadre de la réglementation « RPPS », soit l’arrêté du 6 février 2009 modifié les 23 décembre 2011 et

2 octobre 2013 (cette dernière modification n’est pas encore techniquement traduite dans ce

document).

Les informations relatives aux établissements soumis à autorisation ont pour source le répertoire FINESS (Ministère des Affaires Sociales et de la Santé – DREES - http://finess.sante.gouv.fr/).

2.5 Description des acteurs du système

Acteurs UML (*) Description

ASIP Santé Maître d'ouvrage du service.

Système initiateur ou Consommateur Organisme utilisant les services exposés par le système «annuaire.sante.fr» (personne physique et/ou personne morale)

Système annuaire.sante.fr Fournisseur des web services de «annuaire.sante.fr»

Tableau 1: Description des acteurs

(*) Un acteur UML est une entité qui interagit avec «annuaire.sante.fr». En réponse à l’action d’un acteur, "annuaire.sante.fr" fournit un service et/ou une réponse qui correspond à son besoin.

http://finess.sante.gouv.fr/



3. Accès sécurisé aux Webservices de annuaire.sante.fr : disposition générale

Ce chapitre décrit les dispositions générales de sécurité à respecter dans le cadre de l’utilisation des webservices de « annuaire.sante.fr ».

3.1 Exigences de confidentialité spécifiques aux données du RPPS

Les droits d’accès aux données contenues dans le RPPS sont définis réglementairement pour chaque catégorie d’utilisateurs (cf. annexe 2 de l’arrêté du 6 février 2009 modifié) :

seules les données dites communicables au public librement accessibles ;

les autres données sont accessibles uniquement aux catégories d’utilisateurs définies à l’article 7 de l’arrêté dit « RPPS » du 6 février 2009.

L’utilisation des données du RPPS au travers des services exposés par le système «annuaire.sante.fr» rend l’organisme « responsable de traitement » au sens de la loi Informatique et Libertés à l’égard des données transmises. Il lui appartient de respecter les obligations s’imposant à tout responsable de traitement au sens de cette même loi.

L’utilisation de ces données dans le respect de la finalité déclarée dans le formulaire est placée sous votre responsabilité. Vous êtes responsable pénalement de toute utilisation frauduleuse qui pourrait être commise à l’égard des données qui vous ont été transmises.

La constitution - ou l’alimentation - d’une application informatique avec les données à caractère personnel issues du RPPS doit faire l’objet des formalités préalables prévues au chapitre IV de cette loi. Si l’organisme utilisant les services exposés par le système «annuaire.sante.fr» poursuit d’autres finalités que les finalités initiales susdécrites du RPPS, vous devez le mentionner lors de vos démarches auprès de la CNIL. L’organisme est également tenus de respecter les droits des personnes mentionnés au chapitre V de la même loi, notamment le droit des personnes concernées à l’information préalable et le droit de s’opposer, pour un motif légitime, à ce que ses données à caractère personnel fassent l’objet d’un tel traitement.

Lorsque l’organisme a accès en extraction aux données du RPPS, il doit prendre toutes les précautions utiles pour que ces données soient conservées dans des conditions garantissant leur sécurité, leur intégrité et leur confidentialité. Enfin, la rediffusion des données est interdite, sauf si vous appartenez à l’une des catégories d’utilisateurs identifiées à l’article 8 de l’arrêté RPPS autorisées à rediffuser ces données, dont fait partie l’ASIP Santé.

3.2 Sécurité et intégrité spécifique aux échanges avec le système « annuaire.sante.fr »

La sécurité des échanges entre le système « annuaire.sante.fr » et les autres applications comporte plusieurs niveaux :

- le transport - le non répudiation des messages

- la validation des données

La mise en œuvre des Webservices de annuaire.sante.fr s’effectue dans le respect des standards utilisés dans les échanges de données de santé définis par le Cadre d’Interopérabilité des Systèmes d’Information de Santé (CI-SIS) pour ce qui concerne les fonctions de d’identification et d’authentification. Les Web services de annuaire.sante.fr appliquent les spécifications de la « couche transport – volet synchrone pour client lourd » du CI-SIS. Ce volet est complété, en attente de sa



mise à jour, d’un document de définition du profil du VIHF (Vecteur d’Identification et d’Habilitation Formelles) pour l’échange de données d’identité.

Pour être conforme au CI-SIS un système émetteur d’une demande d’utilisation des web services de annuaire.sante.fr, doivent utiliser un certificat émis par l'IGC-CPS que celui-ci soit associé à une personne physique (CPS personnelle et nominative) ou à une personne morale (certificat serveur). Les échanges se font sur le protocole http 1.1 encapsulé dans une connexion sécurisée TLS. La version TLS minimale admise est la 1.0.

Les exigences de sécurité et d’intégrité sont détaillées dans le document [ref.1 ] CI-SIS_TRANSPORT_VOLET-SYNCHRONE.



4. Présentation des services offerts par les Webservices de annuaire.sante.fr

Ce chapitre détaille les différents services proposés, les cas d’utilisations et l’ensemble des étapes nécessaires à l’obtention de l’accès aux Webservices de annuaire.sante.fr.

4.1 Les différents Webservices proposées

Les Webservices fonctionnent en mode synchrone. On distingue 4 web services pour la consultation des données des personnes physiques et des personnes morales.

4.1.1 Webservices pour accéder aux données des personnes physiques

Web Service de recherche de personnes physiques :

o Le client du Web service recherche les personnes physiques répondant à un filtre de sélection. En réponse, annuaire.sante.fr lui renvoie les identifiants des personnes physiques répondant à ces critères.

Web Service de consultation des données d’une ou plusieurs personnes physiques

o Le client du Web service communique dans sa requête le (ou les) identifiants des personnes physiques sélectionnées. En retour, annuaire.sante.fr lui retourne l’ensemble des attributs qu’il est habilité à extraire de annuaire.sante.fr.

4.1.2 Webservices pour accéder aux données personnes morales dans lesquelles exerce un PS

Les Web services sont du même type que ceux dédiés aux personnes physiques.

Web service de recherche de personnes morales

Web Service de consultation des données d’une ou plusieurs personnes morales. Annuaire.sante.fr communique en outre la liste des PP exerçant au sein de la personne morale.

Figure 1: Synoptique d’utilisation des web services



Nom du WS Description

WS1 Web Service de recherche des PP

WS2 Web Service de recherche des PM

WS3 Web Service de consultation des PP

WS4 Web Service de consultation des PM

Tableau 1: Liste des web services

4.2 Trajectoire et méthodologie

L’accès aux données doit est réalisé dans le respect des règles définies par l’arrêté RPPS. En conséquence, l’usage des Web services est conditionné par l’instruction par l’ASIP Santé d’une demande d’accès au RPPS. Afin de respecter les règles de contrôles d’accès aux données, l’accès aux Webservices s’effectue via une authentification forte par certificat CPS. L’utilisateur du service annuaire.sante.fr doit donc être détenteur d’une autorisation d’accès au RPPS et d’un certificat d’authentification de la famille CPS.

(*)Si vous ne disposez pas d’un tel contrat.

4.2.1 Obtenir un certificat CPS

Le niveau de confidentialité des données exposées par les WebServices de annuaire.sante.fr requiert un niveau de sécurisation justifiant l’utilisation de cartes et/ou de certificats de la famille CPS. La commande de ces produits de certification est subordonnée à l’établissement d’un contrat CPS avec l’ASIP Santé. Pour vous assurer qu’un contrat n’a pas déjà été établi avec votre organisme, il vous faut contacter le service Établissements de l’ASIP Santé qui pourra vous confirmer l’existence ou non d’un Contrat. La phase technique de distribution d’un certificat serveur consistera à procéder à la génération des clés de sécurité des serveurs, à leur certification par l’ASIP Santé et à l’installation du certificat dans les serveurs de votre organisation. Pour plus d’information, vous pouvez accéder aux étapes de commandes d’un certificat CPS



Pour plus d’information sur l’accès aux conditions d’établissement d’un contrat CPS et de commandes de produits de certification sur le portail de l’ASIP Santé, nous vous invitons à visiter l’espace CPS au sein du portail esanté.gouv.fr L’accès au système annuaire.sante.fr est soumis à l’obtention d’un certificat dédié. Si vous disposez déjà d’un certificat CPS, celui-ci ne peut être utilisé afin d’accéder aux données de annuaire.sante.fr pour des raisons de sécurité.

4.2.2 Obtenir l’autorisation d’accès aux données RPPS

Le service annuaire.sante.fr est le vecteur de publication des données du RPPS. Les règles d’accès aux données sont fixées par l’arrêté « RPPS » du 6 février 2009 modifié par l’arrêté du 23 décembre 2011. L’ASIP Santé doit s’assurer que seules les personnes autorisées peuvent accéder aux données à caractère personnel contenues dans le RPPS et annuaire.sante.fr, dans le respect de ses règles de fonctionnement. C’est pourquoi les demandes d’accès font l’objet d’une fiche de demande d’accès au RPPS, instruite par l’ASIP Santé. Les droits d’accès aux données sont définis en fonction de catégories d’utilisateurs spécifiées en annexe II de l’arrêté RPPS. En fonction de la nature de votre organisation, l’ASIP Santé associe à celle-ci une catégorie d’utilisateur.

4.2.3 Développer une application cliente

L’ASIP Santé met à disposition des éditeurs souhaitant implémenter l’utilisation des WebServices de annuaire.sante.fr :

le modèle de données et les ressources terminologiques (nomenclatures) associées, que vous retrouverez dans la page dédiée "Nomenclature des Acteurs de Santé";

http://esante.gouv.fr/services/espace-cps/



le dossier de spécifications techniques des WebServices de annuaire.sante.fr; les schémas et WSDL associés ; d’un exemple de code du client (Java) des Web Service implémentant les fonctions :

o d’authentification par certificat serveur; o de génération d’un jeton VIHF; o d’établissement d’une connexion TLS ; o de génération de requêtes clientes des Web Services exposés par le système

annuaire.sante.fr.

4.2.4 Tester son application sur un environnement de test

Une plateforme de test des WebServices de annuaire.sante.fr est mise à disposition des organismes par l’ASIP Santé. Cette plateforme contient des jeux de données fictifs permettant aux partenaires de tester leur application cliente. L’ASIP Santé ne réalise aucune homologation des applications clientes utilisant les WebServices de annuaire.sante.fr. Les éléments suivants doivent être communiqués à l’ASIP Santé afin de permettre l’accès à l’environnement de test :

La liste des adresses IP qui accèderont à l’environnement de test ; L’identifiant du certificat serveur CPS à paramétrer sur la plateforme de test. Celui-ci peut

être le certificat de test inclus dans le contrat éditeur CPS ou un certificat de production si vous disposez d’un tel produit.

Deux processus distinct peuvent être utilisés pour accéder à cette plateforme en fonction des produits de certifications dont vous disposez : Cas 1 : Accès avec un certificat de test

Cas 2 : Accès avec un certificat de production

4.3 Cas d’utilisation identifiés

Les cas d’utilisation sont classifiés suivant 2 processus :



récupération des identités (identifiants) des personnes (physiques ou morales) répondant à un filtre de sélection communiqué dans la requête par le système initiateur. En réponse, le système annuaire.sante.fr lui renvoie les identifiants des personnes physiques répondant à ces critères.

consultation des dossiers d’une ou plusieurs dossiers personnes (physiques ou morales) en fonction du (des) identifiants communiqués dans sa requête par le système initiateur. En retour, le système annuaire.sante.fr lui retourne l’ensemble des attributs rattachés au(x) dossiers(s) qu’il est habilité à extraire de annuaire.sante.fr.

Code UC Cas d’utilisation Acteurs UML

01.01 Récupérer des identifiants des personnes (PP ou PM) Système initiateur

01.02 Consulter des dossiers personnes (PP ou PM) Système initiateur

4.4 Processus d’utilisation d’un web service de annuaire.sante.fr

4.4.1 Description

Le processus d’utilisation d’un web service de consultation de annuaire.sante.fr est identique pour

les deux cas.



Cas d’utilisation Utilisation d’un web service de consultation exposé par le système annuaire.sante.fr

Résumé

Permettre à un système initiateur d’extraire des informations à partir de annuaire.sante.fr :

soit de(s) identifiant(s) personnes (PP ou PM)

soit les dossiers descriptifs d’une ou plusieurs personnes (PP ou PM)

Déclencheur Invocation de l’URL correspondant au web service exposé par le système initiateur

Mode Interactif

Objectif Fournir un ensemble d’informations précisées dans la requête sur les personnes (PP ou PM).

Fréquence d’utilisation

A la demande

Acteur(s) principal(aux)

Les systèmes initiateurs

Pré conditions L’utilisateur est inscrit* au service annuaire.sante.fr et il possède un moyen d’identification (certificat émis par l'IGC-CPS que celui-ci soit associé à une personne physique (CPS personnelle et nominative) ou à une personne morale (certificat serveur)) en cours de validité.

Post conditions L’exécution de ce Web service ne provoquera aucune modification sur les informations extraites.

4.4.2 Scénario principal

Étapes Activité Scénario Alternatif

1

Un utilisateur, qui souhaite récupérer des informations à partir de annuaire.sante.fr, invoque par l’intermédiaire d’un système initiateur le web service en établissant une session TLS avec authentification mutuelle.

Il envoie un message avec sa requête accompagnée d’un jeton VIHF qui est porteur des informations d’identification et d’habilitation.

SA1

2 Le système annuaire.sante.fr réceptionne le message accompagné du jeton VIHF et procède à son interprétation.

SA2

3

annuaire.sante.fr :

Identifie l’utilisateur,

vérifie qu’il est inscrit au système annuaire.sante.fr,

effectue le contrôle d’accès par rapport aux droits accordés à l’utilisateur via les matrices de responsabilités

SA3

SA4




4 Le système annuaire.sante.fr traite la requête et fournit en retour un message contenant le résultat du traitement.

4.4.3 Scénarios alternatifs


SA1 : Le service n’est pas disponible.

2 Il n y a pas de message de réponse de la part du système annuaire.sante.fr

SA2 : Le message envoyé est mal formaté

4 Le système annuaire.sante.fr envoie un message d’erreur sans traiter la

demande

SA3 : Les informations d’identification et d’habilitation sont insuffisantes

4

Si les informations d’identification sont insuffisantes pour déterminer

l’identité de l’utilisateur le contrôle d’accès le système annuaire.sante.fr

envoie un message d’erreur sans traiter la demande.

SA4 : L’Utilisateur n’est pas inscrit au service annuaire.sante.fr

4 Si l’utilisateur n’est pas inscrit, le système annuaire.sante.fr envoie un

message d’erreur sans traiter la demande.



5. Description détaillée du système

Ce chapitre détaille d’un point de vue technique les Webservices proposés par annuaire.sante.fr.

5.1 Protocole et référence

Le tableau suivant présente les protocoles utilisés pour la mise en place des web services.

Protocole Version Description

SOAP 1.2 Spécifier les formats de messages

HTTP 1.1 Protocole d’échange

WS-I Security 1.1 Sécurisation des échanges

TLS 1.0 1.0 Transport Layer Security

SAML 2.0 Security Assertion Markup Language

Tableau 2: Protocoles et référence

La structure des messages SOAP décrit dans la suite du document est conforme aux exigences de conformité définie dans le cadre d’interopérabilité de SIS couche transport décrites dans le document CI-SIS_TRANSPORT_VOLET-SYNCHRONE_V1.3.0.pdf. Le principe de construction des messages est présenté en section §5.4.1.

5.2 Encodage et espaces de nommage

L’encodage standard pour les documents XML est l’UTF8.

Les espaces de nommage des entités manipulées ont le format suivant :

http://annuaire.sante.fr/webservices/VERSION/ACTION/<Nom du WS>

« ACTION »: consultation ou recherche

« VERSION »: Correspond à la version des web services

NOM DU WS DESCRIPTION

WSRECHERCHEPP Web Service de recherche des PP

WSRECHERCHEPM Web Service de recherche des PM

WSCONSULTATIONPP Web Service de consultation des PP

WSCONSULTATIONPM Web Service de consultation des PM

Tableau 3: Nommage des web services

Les types de données utilisés pour les représentations des entités sont ceux définis par le standard du schéma XML (http://www.w3.org/TR/xmlschema-2/).

Pour qualifier les types de données, le préfixe « xsd » sera utilisé pour distinguer les données standards. Il est déclaré ainsi :

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

http://annuaire.sante.fr/webservices/VERSION/ACTION/%3cNom

http://www.w3.org/TR/xmlschema-2/



Pour les types primtifs : xsd :decimal, , xsd :date , xsd:time, xsd :dateTime, xsd :base64Binary, xsd

:boolean

Pour les types dérivés : xsd : token, xsd :positiveInteger, xsd :nonNegativeInteger

Les types de données spécifiques utilisés dans le cadre de annuaire.sante.fr sont déclarés comme

suit :

xmlns:annuairesante="http://annuaire.sante.fr/webservices/commun"

xmlns:annuairesanteEntete="http://annuaire.sante.fr/webservices/commun/ente

te"

xmlns:annuairesanteException="http://annuaire.sante.fr/webservices/commun/e

xception"

5.3 Principe d’authentification et d’identification

Le cadre d’interopérabilité « du volet transport » définit deux configurations d’authentification qui pourront être utilisées :

en configuration « authentification indirecte » : c’est le cas d’un système initiateur hébergé au sein d'un établissement de santé qui s'authentifie auprès du système annuaire.sante.fr via un certificat serveur. L'utilisateur final s'authentifie localement au sein de la structure, qui porte ainsi la responsabilité des échanges avec le système annuaire.sante.fr.

en configuration « authentification directe » : l’authentification est effectuée par le système annuaire.sante.fr à partir de certificats contenus dans la carte CPS du professionnel de santé.

L’identification et l’authentification sont effectuées par le système annuaire.sante.fr par rapport aux informations transmises par le système initiateur. Les éléments fonctionnels récupérés afin d’effectuer cette opération sont :

Le certificat émetteur ;

L’identifiant de l’utilisateur ;

Le profil de l’utilisateur ;

Le périmètre du profil utilisateur. Le contrôle d’accès est réalisé par rapport aux droits accordés à l’utilisateur dans le système annuaire.sante.fr via la matrice d’accès aux données et en fonction des informations transmises par le système initiateur.

Le schéma ci-dessous présente le diagramme de séquences d’identification d’un utilisateur par le système annuaire.sante.fr à partir du jeton VIHF.



Figure 2: Principe d’authentification et d’identification

La cinématique est la suivante pour chaque requête de consultation de personnes physiques ou morales :

Etablissement d’une session TLS avec authentification mutuelle entre le système annuaire.sante.fr et l’application consommatrice ;

Présentation du jeton VIHF à chaque requête ; Contrôles de sécurité du système annuaire.sante.fr ; Réponse du système annuaire.sante.fr à la requête ; Fin de la session TLS.

Le processus d’identification est basé sur l’usage du VIHF. Le modèle VIHF impose l’utilisation du jeton de sécurité SAML 2.0. Le jeton VIHF est transmis au système annuaire.sante.fr à chaque requête. Il contient l’identité de l’utilisateur et les éléments nécessaires à la détermination des habilitations. Le système annuaire.sante.fr, selon la configuration utilisée et les informations d’identification et d’habilitation transmises, vérifie la conformité des informations et calcule ses droits.

Le principe d’authentification est décrit dans le document de référence « CI-SIS_TRANSPORT_VOLET-SYNCHRONE_V1.3.0.pdf ».

La signature du VIHF n'est pas demandée.



Connexion sécurisée TLS mutuelle

La connexion sécurisée s’effectue via une authentification TLS mutuelle. Les certificats utilisés sont ;

Certificat établissement du système initiateur connu par le système annuaire.sante.fr ;

Certificat serveur du système annuaire.sante.fr.

5.4 Description des échanges

Les messages s’appuient sur les descriptions décrites dans le cadre d’interopérabilité et sur l’utilisation du protocole SOAP. Les sections suivantes décrivent la structure des messages véhiculés entre les systèmes sources et le système annuaire.sante.fr.

5.4.1 Principe de construction des messages

Chaque message est constitué d’une Envelope (Enveloppe) qui contient un élément Header (en-tête) et un élément Body (corps). L’enveloppe constitue la racine du document XML et spécifie le Namespace SOAP-ENV http://schemas.xmlsoap.org/soap/envelope/.

Dans le cadre d’interopérabilité la structure d’un message SOAP est décrite dans le paragraphe 3.2 « Message SOAP » du document « CI_SIS_TRANSPORT VOLET-SYNCHRONE_V1.3.0.

5.4.1.1 Entête du message

Dans le cadre du système annuaire.sante.fr, l’élément HEADER du message contient le jeton VIHF et les informations sur le message (WS-Adressing).

Eléments spécifiques de l’entête Dans le cas des SIS français l’élément Header (en-tête) du message SOAP est obligatoire et aucun nœud

intermédiaire n’est prévu entre système initiateur et système cible. Le jeton VIHF, permet d’identifier le système initiateur par le système cible (annuaire.sante.fr).

Le message SOAP proposé est étendu avec la spécification WS-Addressing qui permet d’indiquer le

destinataire du message (élément <To>), l’identifiant du message (élément <MessageID>), l’action à réaliser (élément <Action>) et l’adresse à laquelle le message de réponse doit être envoyé (élément <ReplyTo>). Ces éléments sont obligatoires.

5.4.1.2 Corps du message

Le corps du message BODY véhicule un ensemble d’éléments composés chacun d’un espace de noms avec des attributs portant les données applicatives.

Le corps du message contient également un élément FAULT, qui permet éventuellement de renvoyer vers l’émetteur le type d’erreur intervenu lors du traitement du message par le destinataire.

5.4.2 Principe d’échanges

Les échanges avec les web services de consultation de personnes physiques et de personnes morales sont de type requête/réponse donc synchrone.

5.4.3 Version des données échangées

Les données sont gérées dans annuaire.sante.fr avec une date de fin présente dans chaque entité. Cette dernière permet de déterminer l’état de la donnée (Active ou Historisée). L’accès aux données en fonction de leur état est géré par la matrice d’habilitation en accès.

http://schemas.xmlsoap.org/soap/envelope/



5.4.4 Version des web services

La version est portée par l’URI d’invocation du web service. Chaque version est considérée comme un service différent à part entière. Chaque service est associé à un namespace différent, portant le numéro de version.

La version courante du web service est la V203.

5.5 Description des ressources terminologiques

Les ressources terminologiques décrivant les personnes physiques et morales sont gérées dans le NAS (Nomenclatures du Référentiel d’identification des acteurs du domaine sanitaire). Ce sont des concepts codés avec une structuration des valeurs codées conforme à la description donnée au paragraphe §3.5.7.3 « Types de données "CS", "CV", "CE", "CD" » du document [ref 3] « CI-SIS_CONTENU_VOLET-STRUCTURATION-MINIMALE_V1.3.1.1.pdf » :

Pour rappel la structuration d’une ressource terminologique est la suivante:

code (cs) : la valeur du code du concept ;

codeSystem (uid): OID de la table de la terminologie source (cf. document [ref 6]) ;

codeSystemName (st): le nom lisible de la terminologie source qui correspond à l'information "Code Table" (cf. document [ref 6]) ;

codeSystemVersion (st): la version de la terminologie source ;

displayName (st): le libellé court associée au code dans la terminologie source qui correspond au Libellé de la table.

originalText (ED) : texte ou phrase utilisé comme base du codage

5.6 Description du message d’entête

Le modèle de l’en-tête « ENTETE » est identique pour tous les web services. L’en-tête est obligatoire dans chaque message. Elle contient une entrée WS-Adressing obligatoire qui étend les spécifications du protocole SOAP 1.2

5.6.1.1 L’entrée WS-Adressing

Le paramètre est actif dans le message SOAP avec la syntaxe suivante :

<wsaw:UsingAddressing wsdl:required="true" />

ATTRIBUT DEFINITION TYPE OBLIGATOIRE COMMENTAIRE

WS-ADRESSING

ACTION Action à réaliser sur le message X(I) X

TO Le destinataire du message X(I) annuaire.sante.fr

MESSAGEID l’identifiant du message X(I) X

REPLYTO l’adresse à laquelle le message de réponse doit être envoyé

X(I) X




FAULTO Identité du consommateur

Communiqué par le système annuaire.sante.fr après l’abonnement ou l’inscription

X(1024)

Tableau 4: Eléments du WS-Adressing

5.6.1.2 Le contenu du jeton VIHF

Dans le contexte d’un Web service de consultation appelé par un système utilisateur de annuaire.sante.fr, l’identification de l’appelant ne permet pas à elle seule de déterminer le contexte d’usage du Web service. Le système initiateur doit préciser le contexte dans lequel s’inscrit la transaction via le jeton VIHF.

Le contenu du jeton VIHF est dépendant de la configuration utilisée (directe ou indirecte) par le système utilisateur.

En plus des champs SAML standards le jeton comporte des informations complémentaires telles que le profil et le périmètre métier de l’utilisateur. Ces informations dépendent du contexte applicatif et sont exploitées pour le contrôle d’accès aux données en consultation. De façon générale, les informations contenues dans le jeton VIHF proviennent :

du certificat émis par l’IGC-CPS pour les : o personnes disposant d’une carte et de certificats, o établissements disposant de certificats serveur,

du SI de l'établissement qui émet l'assertion,

Le processus d’authentification du système annuaire.sante.fr lit dans le jeton l’identité de l’émetteur (personne physique ou personne morale) de l’assertion afin d’effectuer les contrôles de cohérence avec le certificat d’authentification qui a initié la connexion TLS :

o le certificat serveur émis par l’IGC-CPS, en cas d’authentification indirecte, o le certificat CPS de la personne physique en cas d’authentification directe.

Le tableau suivant présente les champs présents dans le jeton VIHF avec leur valorisation pour un profil et un contexte d’utilisation « annuaire de professionnels de santé ». Ce tableau complète les spécifications d'utilisation et de format définies dans le document de référence « CI-SIS_TRANSPORT_VOLET-SYNCHRONE ».

CHAMP DESCRIPTION REQUIS : (R) OPTIONNEL :

(O) FORMAT

VALEUR / CONTRÔLE

CHAMPS STANDARDS

//Assertion/@xmlns:saml2 namespace xml SAML R Alpha

numérique

Constante :"urn:oasis:names:tc:SAML:2.0:assertion"

//Assertion/@Version Version utilisée R Alpha

numérique

Constante : "2.0"

//Assertion/@ID Identifiant unique de

l’assertion R

Alpha

numérique

Id de l’assertion




(O) FORMAT

VALEUR / CONTRÔLE

//Assertion/@IssueInstant Date et heure d'émission

de l'assertion SAML R xs: dateTime

Date et heure d'émission de

l'assertion SAML

Pas de contrôle

//Assertion/Issuer

Identité de l’émetteur

contenue dans le

certificat (DN)

R

DN

(Distinguishe

d Name)

DN de la Personne Physique ou Personne Morale ayant émis l'assertion. Si le VIHF n'est pas signé : contrôle de cohérence avec le DN du certificat ayant initié la connexion TLS. Si le VIHF est signé : contrôle de cohérence avec le DN du certificat ayant signé le VIHF.

//Assertion/Issuer/@Format

Type de valeur utilisée

pour renseigner le champ

Issuer (X509) R

Alpha

numérique

Constante :

urn:oasis:names:tc:SAML:1.1

:nameid-

format:X509SubjectName

//Assertion/ds:Signature Emplacement réservé à la

signature R Si le jeton

est signé

Alpha

numérique

Eléments de la signature

//Assertion/Subject/Name

ID

l’identifiant de

l’utilisateur final envoyé

par le système initiateur

R Alpha

numérique

L’identifiant national de la

personne « PS_IdNat », ou

identifiant de la personne

responsable du traitement,

dans le cas d’un traitement

automatisé.

En authentification directe :

doit être renseigné avec le

PS_Idnat contenu dans le DN

du certificat

d’authentification

En authentification indirecte

(authent serveur) : pas de

contrôle

//Assertion/AuthnStatement/AuthnContext/AuthnContextClassRef

La méthode

d’authentification de

l'utilisateur

R Alpha

numérique

En authentification directe par CPS la valeur est "urn:oasis:names:tc:SAML:2.0:ac:classes:SmartcardPKI". En authentification indirecte, la valeur est laissée au choix de l'émetteur de l'assertion dès lors qu'elle est sélectionnée dans le document http://docs.oasis-open.org/security/saml/v2.0/saml-authn-context-2.0-




(O) FORMAT

VALEUR / CONTRÔLE

os.pdf

//Assertion/AuthnStatement/@AuthnInstant

La date et l’heure

exprimée en UTC .à

laquelle l’authentification

a été réalisée par le

système initiateur

R xs: dateTime

Date/heure

d’authentification SI

//Assertion/Conditions/AudienceRestriction

Plusieurs champs

Audience qui contient

chacun un URI qui

référence la PSSI du

système initiateur

applicable pour traiter

l’assertion

O OID

Présent si une PSSI est définie

//Assertion/Conditions/@NotBefore

La date et l’heure UTC de

début de validité de

l’assertion O xs: dateTime

Date/heure de début de

validité de l’assertion

pas de contrôle

//Assertion/Conditions/@NotOnOrAfter

La date et l’heure UTC de

fin de validité de

l’assertion O xs: dateTime

Date/heure de fin de validité

de l’assertion

pas de contrôle

CHAMPS COMPLEMENTAIRES - SITUES DANS LA BALISE <SAML:ATTRIBUTESTATEMENT> DU JETON SAML

VIHF_Version Version du VIHF utilisée R Numérique

Constante : "2.0"

urn:oasis:names:tc:xacml:2.0:subject:role

Rôle fonctionnel de

l’utilisateur (profession)

qui peut être multi-valeur O

Type de

donnée CE

d’HL7 v3

Les règles de valorisation

sont détaillées dans le &

4.3.1.5.3.2 du Volet

Transport Synchrone

Secteur_Activite Secteur d’activité dans

lequel exerce l’utilisateur

O OID

Nomenclature Secteur

d’activité

code : Code du secteur

d’activité

codeSystem:

1.2.250.1.71.4.2.4

codeSystemName :

optionnel

displayName : optionnel

urn:oasis:names:tc:xacml:2.0:resource:resource-id

Identifiant du patient

concerné par la requête

N/A CX de HL7

v2.5.

Vide (Non applicable pour

annuaire.sante.fr)

Ressource_URN

Ressource visée par

l’utilisateur. R URN

Constante:

"urn:annuairesante"




(O) FORMAT

VALEUR / CONTRÔLE

urn:oasis:names:tc:xspa:1.0:subject:purposeofuse

Indique le mode d’accès

demandé par l’utilisateur

O CE d’HL7 v3

Non significatif dans le

contexte annuaire.sante.fr

Valeurs possibles: normal, bris de glace ou centre 15

Valeurs par défaut: normal

Mode_Acces_Raison Explication de la raison de

l’usage du bris de glace. O

Alpha

numérique



urn:oasis:names:tc:xspa:1.0:subject:subject-id

Identité de l’utilisateur

R Si

authentificati

on indirecte

Alpha

numérique

Identification explicite de

l’utilisateur (ex. nom,

prénom, service au sein d’un

établissement…) ou

Identification explicite de la

machine (ex. nom du logiciel,

nom du modèle, service au

sein d’un établissement…)

Pas de contrôle sur la valeur

Identifiant_Structure

Identifiant de

l’établissement de santé

ou du cabinet depuis

lequel la requête a été

émise

O Alpha

numérique

L’identifiant national de la

structure « Struct_IdNat »

LPS_Nom Nom du logiciel utilisé O

Alpha

numérique



LPS_Version Version du logiciel utilisé O

Alpha

numérique



LPS_ID Numéro de série ou

identifiant de

l’installation du logiciel

O Alpha

numérique



PROFIL_UTILISATEUR Le profil de l’utilisateur

R OID

Nomenclature Catégorie

utilisateur

code : catégorie utilisateur

valeur : Voir § 3.9.1.3.1

Liste des valeurs pour

l’élément

‘Profil_Utilisateur’

codeSystem : 1.2.250.1.213.1.6.1.66

codeSystemName (attribut




(O) FORMAT

VALEUR / CONTRÔLE

optionnel) : ‘R78’

displayName (attribut optionnel)

Contrôle de cohérence du profil avec l’utilisateur parmi les utilisateurs inscrits.

PROFIL_UTILISATEUR_PERIMETRE

Le contexte métier ou

périmètre de l’utilisateur

O La

présence de

ce champ

dépend de la

valeur de

PROFIL_UTILI

SATEUR

OID

Nomenclature Périmètre utilisateur

valeur : Voir § 3.9.1.3.2 « règle de gestion de l’élément « Profil_utilisateur_perimetre »

Contrôle de cohérence du code ordre ou de l’identifiant de la structure avec l’utilisateur parmi les utilisateurs inscrits.

VIHF_PROFIL Le profil VIHF

O OID

Nomenclature Profil VIHF

code : profil_annuaire_PS

codeSystem:

1.2.250.1.213.1.1.4.312

codeSystemName (attribut

optionnel) : ‘profil VIHF’

displayName (attribut

optionnel) : Profil pour

annuaire de professionnels

de santé du VIHF 2.0 Tableau 5: Descriptifs des attributs du jeton SAML 2.0

La récupération de l’émetteur se fera à partir des attributs Issuer et/ou Subject/NameId respectivement de type :

« urn:oasis:names:tc:SAML:2.0:namid-format:X509SubjectName » et alphanumérique.

5.6.1.2.1 Liste des valeurs pour l’élément « Profil_Utilisateur »

Ci-dessous la liste des valeurs du l’attribut « code » de l’élément « Profil_Utilisateur »

VALEUR DESCRIPTION

CU01 Services du ministère chargé de la santé

CU02 Agences régionales de santé

CU03 SSA et autres autorités employeurs

CU04 Conseils des Ordres



VALEUR DESCRIPTION

CU05 Autorités et représentants Etat dans COM

CU06 CNAMTS

CU07 Régimes d'AMO dans les COM

CU08 ASIP Santé

CU09 CPAM et CGSS

CU10 Autres services de l'Etat

CU11 Etablissements et services de santé 6ème partie CSP & Collectivités territoriales et associations gestionnaires d'un service sanitaire ou social

CU12 Etablissements médico-sociaux ou sociaux

CU13 Autres établissements publics, groupements, organismes créés par la loi ou le règlement dans le domaine sanitaire et social

CU14 Hébergeurs, éditeurs, imprimeurs d'ordonnances

CU15 Organismes et établissements scientifiques ayant pour mission d'agir pour le développement et la diffusion des connaissances dans le domaine sanitaire et social

CU16 Autres régimes d'AMO et organismes d'AMC

CU17 Professionnel de santé

Tableau 6: Liste des valeurs possibles pour l’élément « Profil_Utilisateur »

5.6.1.2.2 Règle de gestion de l’élément « Profil_Utilisateur_Perimetre »

Cas où le Profil_Utilisateur est égal à CU04

Si l’utilisateur d’un service web s’authentifie avec le profil « CU04 » (l’attribut « code » de l’élément « Profil_Utilisateur » est positionné à « CU04 »), l’attribut « code » de l’élément « Profil_Utilisateur_Perimetre » est positionné avec une des valeurs issue de la terminologie de référence « Ordre » (code system 1.2.250.1.213.1.6.1.70 , codeSystemName R82) dont le contenu est rappelé ci-dessous :

VALEUR DESCRIPTION

CNOM Ordre des Médecins

ONCD Ordre des Chirurgiens-Dentistes

CNOP Ordre des Pharmaciens

CNOSF Ordre des Sages-Femmes

Tableau 7: Liste des valeurs de la terminologie de référence « Ordre »

Cas où le Profil_Utilisateur est égal à CU11



Si l’utilisateur d’un service web s’authentifie avec le profil « CU11 », l’élément « originalText » de l’élément « Profil_Utilisateur_Perimetre » est valorisé avec la valeur de l’identifiant de la structure (Struct_IdNat).

Cas où le profil_Utilisateur est égal à CU05, CU07 ou CU12 La règle de gestion relative à l’attribut « Profil_Utilisateur_Perimetre » sera définie dans une version ultérieure des web service. Autres cas

Dans les autres cas, l’attribut « Profil_Utilisateur_Perimetre » n’est pas utilisé.

5.6.1.3 Exemples de jetons VIHF

Ci-dessous un exemple de la structure d’un jeton VIHF en mode authentification directe :

<saml2:Assertion xmlns:hl7="urn:hl7-org:v3" xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ID="34c34ba6-ba3f-47c8-b906-db079425d6af" IssueInstant="2013-06-07T15:22:51.003Z" Version="2.0"> <saml2:Issuer Format="urn:oasis:names:tc:SAML:2.0:nameid-format:X509SubjectName">CN=30B0025920/CDET0001 + SURNAME=ENFANCE025920001 + GIVENNAME=CHRISTINE, OU=10B0025920, L=Paris (75), O=TEST, C=FR</saml2:Issuer> <saml2:Subject> <saml2:NameID>30B0025920/CDET0001</saml2:NameID> </saml2:Subject> <saml2:AuthnStatement AuthnInstant="2013-06-07T15:22:51.042Z"> <saml2:AuthnContext> <saml2:AuthnContextClassRef>urn:oasis:names:tc:SAML:2.0:ac:classes:SmartcardPKI</saml2:AuthnContextClassRef> </saml2:AuthnContext> </saml2:AuthnStatement> <saml2:AttributeStatement> <saml2:Attribute Name="VIHF_Version"> <saml2:AttributeValue>2.0</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Secteur_Activite"> <saml2:AttributeValue>SA07^1.2.250.1.71.4.2.4</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Ressource_URN"> <saml2:AttributeValue>urn:annuairesante</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="urn:oasis:names:tc:xspa:1.0:subject:subject-id"> <saml2:AttributeValue>CHRISTINE ENFANCE025920001</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Identifiant_Structure"> <saml2:AttributeValue>10B0025920</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="LPS_Version"> <saml2:AttributeValue>1.1</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="LPS_ID"> <saml2:AttributeValue>ID DU LPS </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="LPS_Nom"> <saml2:AttributeValue>SUPER_LPS</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Profil_Utilisateur"> <saml2:AttributeValue> <Profil_Utilisateur xmlns="urn:hl7-org:v3" xmlns:xsi="urn:hl7-org:v3" hl7:code="CU04" hl7:codeSystem="1.2.250.1.213.1.6.1.66" hl7:codeSystemName="R78" hl7:displayName=" Conseils des Ordres ="CE"/> </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Profil_Utilisateur_Perimetre">



<saml2:AttributeValue> <Profil_Utilisateur_Perimetre xmlns="urn:hl7-org:v3" xmlns:xsi="urn:hl7-org:v3" hl7:code="CNOM" hl7:codeSystem="1.2.250.1.213.1.6.1.70" hl7:codeSystemName="R82" hl7:displayName=" Ordre des Médecins " xsi:type="CE"> <originalText/> </Profil_Utilisateur_Perimetre> </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="VIHF_Profil"> <saml2:AttributeValue> <VIHF_Profil xmlns="urn:hl7-org:v3" xmlns:xsi="urn:hl7-org:v3" hl7 :code="profil_annuaire_PS" hl7:codeSystem="1.2.250.1.213.1.1.4.312" hl7:codeSystemName="profil VIHF" hl7:displayName="Profil pour annuaire de professionnels de santé du VIHF 2.0" xsi:type="CE"/> </saml2:AttributeValue> </saml2:Attribute> </saml2:AttributeStatement> </saml2:Assertion>

Ci-dessous un exemple de la structure d’un jeton VIHF en mode authentification indirecte :

<saml2:Assertion xmlns:hl7="urn:hl7-org:v3" xmlns:saml2="urn:oasis:names:tc:SAML:2.0:assertion" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" ID="4df37536-4fc6-4f21-a192-837fb4153bed" IssueInstant="2013-06-07T15:49:24.669Z" Version="2.0"> <saml2:Issuer Format="urn:oasis:names:tc:SAML:2.0:nameid-format:X509SubjectName">CN=Client webservices, OU=annuairesante, O=ASIP, ST=IDF, C=FR</saml2:Issuer> <saml2:Subject> <saml2:NameID>30B0025920/CDET0001</saml2:NameID> </saml2:Subject> <saml2:AuthnStatement AuthnInstant="2013-06-07T15:49:24.706Z"> <saml2:AuthnContext> <saml2:AuthnContextClassRef>urn:oasis:names:tc:SAML:2.0:ac:classes:Password</saml2:AuthnContextClassRef> </saml2:AuthnContext> </saml2:AuthnStatement> <saml2:AttributeStatement> <saml2:Attribute Name="VIHF_Version"> <saml2:AttributeValue>2.0</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Secteur_Activite"> <saml2:AttributeValue>SA07^1.2.250.1.71.4.2.4</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="urn:oasis:names:tc:xacml:2.0:resource:resource-id"> <saml2:AttributeValue/> </saml2:Attribute> <saml2:Attribute Name="Ressource_URN"> <saml2:AttributeValue>urn:annuairesante</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="urn:oasis:names:tc:xspa:1.0:subject:subject-id"> <saml2:AttributeValue>Jean Dupont </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Identifiant_Structure"> <saml2:AttributeValue>10B0025920</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="LPS_Version"> <saml2:AttributeValue>1.1</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="LPS_ID"> <saml2:AttributeValue>ID du LPS </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="LPS_Nom"> <saml2:AttributeValue>SUPER_LPS</saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Profil_Utilisateur"> <saml2:AttributeValue>



<Profil_Utilisateur xmlns="urn:hl7-org:v3" xmlns:xsi="urn:hl7-org:v3" hl7:code="CU11" hl7:codeSystem="1.2.250.1.213.1.6.1.66" hl7:codeSystemName="R78" hl7:displayName=" Etablissements et services de santé 6ème partie CSP & Collectivités territoriales et associations gestionnaires d'un service sanitaire ou social " xsi:type="CE"/> </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="Profil_Utilisateur_Perimetre"> <saml2:AttributeValue> <Profil_Utilisateur_Perimetre xmlns="urn:hl7-org:v3" xsi:type="CE"> <originalText>10B0025920</originalText> </Profil_Utilisateur_Perimetre> </saml2:AttributeValue> </saml2:Attribute> <saml2:Attribute Name="VIHF_Profil"> <saml2:AttributeValue> <VIHF_Profil xmlns="urn:hl7-org:v3" xmlns:xsi="urn:hl7-org:v3" hl7 :code="profil_annuaire_PS" hl7:codeSystem="1.2.250.1.213.1.1.4.312" hl7:codeSystemName="profil VIHF" hl7:displayName="Profil pour annuaire de professionnels de santé du VIHF 2.0" xsi:type="CE"/> </saml2:AttributeValue> </saml2:Attribute> </saml2:AttributeStatement> </saml2:Assertion>



6. Description fonctionnelle détaillée des services

Ce chapitre détaille d’un point de vue fonctionnel les Webservices proposés par annuaire.sante.fr.

6.1 Recherche de personnes physiques

6.1.1 Principe de construction des flux

6.1.1.1 Présentation du flux d’entrée

Chaque message en entrée est constitué de deux parties :

Une structure d’en-tête qui contient les informations propres au flux de données (utilisées par la couche technique) - ENTETE ;

Le corps du message qui contient les critères en entrée du web service - FILTRERECHERCHEPP.

Figure 3: Corps de message pour la recherche de personnes physiques

6.1.1.2 Présentation du flux de sortie

Chaque message en sortie est constitué de deux parties essentielles :

Une structure d’en-tête qui contient les informations propres au flux de données - ENTETE ;

Le corps du message composé de :

o Une entrée contenant les critères en entrée - FILTRERECHERCHEPP ;

o Une entrée qui contient l’ensemble des résultats trouvés dans annuaire.sante.fr. Les données retournées sont fonction des habilitations de l’application consommatrice – LISTEPP ;

o Une entrée contenant des informations complémentaires sur les résultats de recherche - INFORESULTATSRECHERCHEPP ;

o Une entrée contenant l’exception en cas d’erreur - FAULT.

A noter : le nombre de résultats retournés dans le flux de sortie (LISTEPP) est limité à 30 Professionnels de santé. Au-delà, les résultats ne sont pas fournis.



Figure 4: Corps de message pour la réponse du service de recherche de personnes physiques

6.1.2 Description du flux d’entrée

6.1.2.1 Entête de la requête

La structure « ENTETE »est identique à celle présenté en section §5.6.

6.1.2.2 Critères de recherche

La structure « FILTRERECHERCHEPP » regroupant les critères de recherche est détaillé dans le tableau suivant :

ATTRIBUT COMMENTAIRE Nom de TR (CodeSystemName)

OID TR (CodeSystem) TYPE Longue

ur

NOM EXERCICE Nom d’exercice du professionnel de santé

N/A N/A X(80) 80

IDENTIFIANTPP

Structure contenant l’identifiant de la PP + le type d’identifiant : 8 pour RPPS, 0 pour ADELI.

Dans la version actuelle du service, seule la valeur 8 (RPPS) est prise en compte.

N/A

1.2.250.1.71.4.2.1

X(20) 20

G08 1.2.250.1.71.1.2.15

PRENOM EXERCICE

Prénom d’exercice du professionnel de santé

N/A N/A X(50) 50

CODEPROFESSION Code issu du NASS

Référence : NPROFESSION G15 1.2.250.1.71.1.2.7 X(2) 2

CODETYPESAVOIR FAIRE

Code appartenant à une nomenclature

Référence : NTYPESAVOIRFAIRE

R04 1.2.250.1.213.1.6.1.16 X(15) 15

CODESAVOIRFAIRE

Code issu du NASS

Référence : NSAVOIFAIRE R38 ;

R39 ;

R40 ;

R41 ;

1.2.250.1.213.2.28,

1.2.250.1.213.2.29,

1.2.250.1.213.2.30,

1.2.250.1.213.2.31,

X(15) 15





ur

R42 ;

R43 ;

R44 ;

R45 ;

R46.

1.2.250.1.213.2.32,

1.2.250.1.213.2.33,

1.2.250.1.213.2.34,

1.2.250.1.213.2.35,

1.2.250.1.213.2.36

Indicateur Présence adresse MSS (*)

Indicateur Présence adresse MSS – Cet attribut sera pris en compte dans une version ultérieure du web service

LD (oui,

non) 1

Indicateur Présence DAM (*)

Indicateur Présence DAM – Cet attribut sera pris en compte dans une version ultérieure du web

LD (oui,

non) 1

VILLEEXERCICE Code postal ou libellé de la commune du lieu d’exercice

R13 1.2.250.1.213.2.23 X(100) 100

CODEDEPARTEMENTEXERCICE

Code département du lieu d’exercice

G09 1.2.250.1.71.1.2.16 X(3) 3

CODETERRITOIRE DESANTE(*)

Cet attribut sera pris en compte dans une version ultérieure du web service

N/A N/A N/A 15

CODECOMMUNE NAISSANCE (*)

Code postal de la commune de naissance –


R13 1.2.250.1.213.2.23 X(5) 5

CODEPAYS NAISSANCE (*)

Code pays de naissance –


R20 1.2.250.1.213.2.24 X(5) 5

DTNAISSANCE (*) Date de naissance du professionnel de santé –


N/A N/A DT(AAAAMMJJ

)

NOCARTECPx (*) Numéro de carte CPx N/A N/A X(10) 10

IDENTIFIANTPM Structure contenant l’identifiant de la PM + le type d’identifiant : FINESS, SIREN, SIRET, RPPSRang, etc.

N/A 1.2.250.1.71.4.2.2 X(20) 20

G07 1.2.250.1.71.1.2.14 X(1) 1

CODESECTEURACCode Secteur d’activité issu

R02 1.2.250.1.71.4.2.4 X(15) 15





ur

TIVITE de annuaire.sante.fr

CODECATEGORIE ETABLISSEMENT

Code catégorie d’établissement issu de annuaire.sante.fr

R66 1.2.250.1.213.1.6.1.8 X(3) 3

CODEAGREGAT CATEGORIEETABLISSEMENT

Code agrégat de catégorie d’établissement issu de annuaire.sante.fr

R65 1.2.250.1.213.1.6.1.7 X(3) 3

Tableau 8: Description d’un filtre de recherche pour les personnes physiques

(*) Champ prédéfini non utilisable dans la version actuelle.

La structure « IDENTIFIANTPP » permet de représenter l’identifiant d’une personne physique. Ci-dessous illustrée et détaillée la structure.

Figure 5:Structure Identifiant d’une personne physique


CLASSE IDENTIFIANTPP : CONTENEUR DE L’IDENTIFIANT PP

IDENTIFIANTPP Identifiant de la personne physique (1)

X(20) X

TYPEIDENTIFIANTPP Type de l’identifiant RPPS ou ADELI

NOMENCLATURE X Référence annuaire.sante.fr : NTYPEIDNATIONALPP

Code SystemName : G08

CodeSystem : 1.2.250.1.71.1.2.15

Tableau 9: Description des attributs Identifiant d’une personne physique



(1) Numéro RPPS pour un PS inscrit au RPPS, numéro ADELI pour un PS dont la profession n’est pas prise en compte par le RPPS, identifiant délivré par l’application consommatrice et stockés dans les éléments de preuve.

6.1.3 Description du flux de sortie

6.1.3.1 Entête

La structure « ENTETE »est identique à celle présenté en section §5.6. Les données retournées correspondent à celles fournies en entrée.


La structure «FILTRERECHERCHE » est identique à celle présenté en section §6.1.2.2. Les données retournées correspondent à celle fournie en entrée.

6.1.3.3 Résultat de recherche

Pour un identifiant de personne donnée, si la personne existe, le résultat est communiqué dans un liste de PP trouvées, sinon, l’identifiant est inscrit dans une liste de PP non trouvées.

6.1.3.4 Informations complémentaires sur le résultat de la recherche

Les informations complémentaires sur le résultat de la recherche sont communiquées dans cette structure « INFORESULTATSRECHERCHEPP ».


STRUCTURE_INFORECHERCHE : CONTENEUR DES INFORMATIONS COMPLEMENTAIRES SUR LA RECHERCHE

NOMBRERESULTATS Nombre de résultats trouvés par annuaire.sante.fr

N(5) X

LIMITMAX Nombre de résultats maximums autorisé

N(5) X

MESSAGE Message d’information retourné par annuaire.sante.fr

X(1024)

Tableau 10: Description des infos complémentaires retournées par le service recherche des PP

6.1.3.5 Message d’exception

Un message est stocké dans l’entrée FAULT en cas d’erreur.

6.1.4 Traitements métier, contrôles

6.1.4.1 Traitements effectués sur les critères de recherche

Le tableau suivant donne pour chaque critère, les règles qui lui sont appliquées pour rechercher les personnes physiques.



DONNEES REGLES METIER ASSOCIEES DONNEES PUBLIQUES

NOM EXERCICE

RM_RECH_PP1,

RM_RECH_PP3,

RM RECH_PP4

O

IDENTIFIANTPP RM RECH_PP1, RM RECH_PP3,

RM RECH_PP4

O

PRENOM EXERCICE RM RECH_PP1, RM RECH_PP3,

RM RECH_PP4

O

PROFESSION RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4

O

TYPE DE SAVOIR FAIRE RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4

O

SAVOIR FAIRE RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4

O

Indicateur Présence adresse MSS (*) RM RECH_PP3 (*)

Indicateur Présence DAM (*) RM RECH_PP3 (*)

VILLE D’EXERCICE RM RECH_PP1, RM RECH_PP3,

RM RECH_PP4

O

DEPARTEMENT D’EXERCICE RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4

O

TERRITOIRE DE SANTE(*) RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4 (*)

COMMUNE DE NAISSANCE (*) RM RECH_PP2,RM RECH_PP3,

RM RECH_PP4 N

PAYS DE NAISSANCE (*) RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4 N

DATE DE NAISSANCE (*) RM RECH_PP3, RM RECH_PP4 N

NUMERO DE CARTE CPx (*) RM RECH_PP3, RM RECH_PP4 N

IDENTIFIANTPM RM RECH_PP1, RM RECH_PP3,

RM RECH_PP4, RM RECH_PP4, RM RECH_PP9 O

SECTEUR D’ACTIVITE RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4

O

CATEGORIE D’ETABLISSEMENT RM RECH_PP2, RM RECH_PP3, O



DONNEES REGLES METIER ASSOCIEES DONNEES PUBLIQUES

RM RECH_PP4

AGREGAT DE CATEGORIE D’ETABLISSEMENT RM RECH_PP2, RM RECH_PP3,

RM RECH_PP4

O

Tableau 11: Règles métiers appliquées aux critères pour le service recherche des PP

(*) Champ prédéfini non utilisable dans la version actuelle.

.

6.1.4.2 Description des règles

Code Description Concerne

RM RECH_PP1 Chaîne de caractères pouvant inclure les motifs « * » et « ? »

RM RECH_PP2 Code issu des nomenclatures de référence (2)

RM RECH_PP3 Critère non obligatoire

Pour information, aucun critère de recherche n’est obligatoire

RM RECH_PP4

L’opérateur « = » est appliqué sur le critère

Exemple :

RPPSRANG=<valeur contenue dans le message>

RM RECH_PP5 Au moins un critère doit être renseigné.

RM RECH_PP6 Le nombre maximum de résultat de recherche est limité. Ce nombre est paramétrable dans le système annuaire.sante.fr.

RM RECH_PP7 La recherche doit être exacte. La recherche prend en compte les critères faisant référence à des données publiques. Seules sont sélectionnées les PP dont les attributs correspondent aux critères saisis.

RM RECH_PP8 La recherche interprète le motif « ? » comme joker sur un caractère et le motif « * » comme joker sur un ensemble de caractères).

RM RECH_PP9

L’identifiant de la personne morale est une clé composée du type d'identifiant de personne morale et la valeur de l'identifiant.

Les valeurs du type d’identifiant sont données par la table G07 :

0 - Id. Cabinet ADELI

1 – FINESS (Juridique ou Géographique)

2 – SIREN

3 – SIRET

4 - Id. Cabinet RPPS

5 - FINESS Juridique

6 - FINESS Géographique

recherche d’une entité juridique :




2 – SIREN

1 ou 5 - FINESS Juridique

recherche d’une entité géographique

0 - Id. Cabinet ADELI

3 – SIRET

4 - Id. Cabinet RPPS

1 ou 6 - FINESS Géographique

Tableau 12: Description des règles métiers du service recherche des PP

6.2 Consultation de personnes physiques





Le corps du message qui contient les critères en entrée du web service - IDENTIFIANTCONSULTATIONPP.

Figure 6: Corps de message pour la consultation de personnes physiques

Attention : Le nombre d'identifiants en entrée est limité à 20 identités. Ce nombre est paramétrable dans le système annuaire.sante.fr.


Chaque message en sortie est constitué de deux parties essentielles :



o Une entrée contenant les critères en entrée – IDENTIFIANTCONSULTATIONPP ;



o Une entrée qui contient l’ensemble des résultats trouvés dans annuaire.sante.fr. Les données retournées sont fonction des habilitations de l’application consommatrice – LISTEPPTROUVEES ;

o Une entrée qui contient les identifiants des PP non trouvées dans annuaire.sante.fr - LISTEPPNONTROUVEES ;

o Une entrée contenant des informations complémentaires sur les résultats de recherche - INFOCONSULTATIONPP ;


Figure 7: Corps de message pour la réponse du service de consultation de personnes physiques



La structure « ENTETE »est identique à celle présenté en section §5.6


Les critères de recherche de recherche sont fournies dans la requête d’entrée sous forme de liste d’identifiant avec une structure de type « IDENTIANTPP ». Cette structure est décrite dans la section § 6.1.2.1


6.2.3.1 Entête



La structure est identique à celle présenté en section §6.2.2.2. Les données retournées correspondent à celle fournies en entrée.



6.2.3.3 Résultat de la consultation

Les résultats trouvés sont transmis par le web service sous forme de listes :

Une liste contenant les PP dont les identifiants sont référencés dans annuaire.sante.fr : «LISTEPPTROUVEES» avec la structure «STRUCTURE_MESSAGEPP»

Une liste contenant les identifiants non référencés ou non accessibles dans annuaire.sante.fr : «LISTEPPNONTROUVEES» avec la structure «STRUCTURE_MESSAGEPPNONTROUVEES».

Ci-dessous illustrée la structure de message retournée par le web service pour une personne physique présente dans annuaire.sante.fr.

Figure 8: Structure des résultats retournés par le service de consultation des personnes physiques


STRUCTURE_MESSAGEPP: CONTENEUR DE LA STRUCTURE D’UN MESSAGE PP

IDENTITE L’identifiant de la personne physique

STRUCTURE_IDENTITE X

ETATCIVIL Conteneur de données de base d’une personne physique

STRUCTURE_PERSONNE

X

COORDONNEESCORRESPONDANCE

Coordonnées de correspondance

STRUCTURE_COORDONNEES

ETUDIANTS Conteneur de données d’un Etudiant

LISTE DE STRUCTURE_ETUDIANT




LANGUESPARLEES Conteneur de données d’une langue parlée

LISTE DE STRUCTURE_LANGUEPARLEE

EXERCICESPROFESSIONNELS

Conteneur de données d’un exercice professionnel

LISTE DE STRUCTURE_EXERCICEPROFESSIONNEL

DIPLOMES Conteneur de données d’un diplôme

LISTE DE STRUCTURE_DIPLOME

AUTRESDIPLOMES Conteneur de données d’un diplôme

LISTE DE STRUCTURE_AUTREDIPLOME

AUTORISATIONS Conteneur de données d’une autorisation

LISTE DE STRUCTURE_AUTORISATION

Tableau 13: Description de la structure retournée par le service de consultation des PP

Ci-dessous illustrée la structure de message retournée par le web service pour un identifiant de personne physique non trouvé dans annuaire.sante.fr.

Figure 9: Structure message des résultats des personnes physiques non trouvées dans annuaire.sante.fr


STRUCTURE_MESSAGEPPNONTROUVEES: CONTENEUR DE LA STRUCTURE D’UN MESSAGE PP NON TROUVEES

IDENTIFIANTPP Structure contenant l’identifiant de la PP + le type d’identifiant : RPPS, ADELI, etc.

IDENTIFIANTPP

X

MESSAGE Message retourné par le système annuaire.sante.fr

X(1024) X

Tableau 14: Description de la structure retournée par le service de consultation des PP

6.2.3.3.1 Identité

Ci-dessous illustrée la structure « STRUCTURE_IDENTITE » :



Figure 10: Structure identité d’une personne physique

Le modèle de la structure « STRUCTURE_IDENTITE » est détaillé ci-dessous :

ATTRIBUT DEFINITION TYPE COMMENTAIRE

STRUCTURE_IDENTITE: CONTENEUR DE DONNEES D’IDENTITES D’UNE PERSONNE PHYSIQUE

IDENTIFIANTPP Structure contenant l’identifiant de la PP + le type d’identifiant : RPPS, ADELI, etc.

IDENTIFIANTPP

CIVILITE

Civilité

NOMENCLATURE Référence annuaire.sante.fr : NCIVILITE

Code SystemName : R81

CodeSystem :

1.2.250.1.213.1.6.1.69

NOMUSAGE Nom d’usage X(80)

PRENOMUSAGE Prénom d’usage X(50)

DATEACQUISITIONNATIONALITEFR Date d'acquisition de la nationalité française

DT(AAAAMMJJ)

DATEEFFET Date d’effet DT(AAAAMMJJ)

PAYSNATIONALITE

Pays de nationalité actuelle

NOMENCLATURE Référence annuaire.sante.fr : NPAYS


CodeSystem :

1.2.250.1.213.2.24

Tableau 15: Description des attributs de l’identité d’une PP

6.2.3.3.2 Etat Civil

Ci-dessous illustrée la structure « STRUCTURE_ETATCIVIL » :



Figure 11: Structure état civil d’une personne physique

Le modèle de la structure « STRUCTURE_ETATCIVIL » est détaillé ci-dessous :


STRUCTURE_ETATCIVIL: CONTENEUR DE DONNEES D’ETAT CIVIL D’UNE PERSONNE PHYSIQUE

NSTATUTETATCIVIL

Le code statut de l’état-civil

NOMENCLATURE Référence annuaire.sante.fr : NSTATUTETATCIVIL


CodeSystem :

1.2.250.1.213.1.6.1.9

NSEXE

Le code sexe

NOMENCLATURE Référence annuaire.sante.fr : NSEXE


CodeSystem :

1.2.250.1.213.2.27

NOMFAMILLE Nom de famille X(80)

PRENOMS Prénoms X(150)

DATENAISSANCE Date de naissance DT(AAAAMMJJ)

LIEUNAISSANCE Lieu de naissance X(50)

DATEDECES Date de décès DT(AAAAMMJJ)

DATEEFFET Date d’effet de l’état-civil

DT(AAAAMMJJ)

NCOMMUNENAISSANCE Le code de la commune de naissance

NOMENCLATURE Référence annuaire.sante.fr : NCOMMUNE





CodeSystem :

1.2.250.1.213.2.23

NPAYSNAISSANCE

Le code du pays de naissance

NOMENCLATURE Référence annuaire.sante.fr : NPAYS


CodeSystem :

1.2.250.1.213.2.24

Tableau 16: Description des attributs de l’état civil d’une PP

6.2.3.3.3 Coordonnées de correspondance

Ci-dessous illustrée la structure « STRUCTURE_COORDONNEES » :

Figure 12: Structure coordonnées d’une personne physique

Le modèle de la structure « STRUCTURE_COORDONNEES » est détaillé ci-dessous :


STRUCTURE_ COORDONNEES : CONTENEUR DES COORDONNEES DE CORRESPONDANCE

L2COMPLEMENTLOCALISATION Complément X(38)




d’identification du destinataire ou du point de remise

L 3COMPLEMENTDISTRIBUTION

Complément d’identification de la voie (Bis, Ter, etc.)

X(38)

L 4NUMEROVOIE Numéro dans la voie X(5)

L 4COMPLEMENTNUMEROVOIE Indice de répétition dans la voie

X(38)

NTYPEVOIE Le code type de voie (Rue, Voie, etc.)

NOMENCLATURE Référence annuaire.sante.fr : NTYPEVOIE


CodeSystem :

1.2.250.1.213.2.44

L4LIBELLEVOIE L’intitulé de la voie X(38)

L5LIEUDITMENTION Lieu-dit ou Service particulier de distribution

X(38)

L6LIGNEACHEMINEMENT Complément d'identification du point géographique (Code postal ou code CEDEX)

X(38)

NCODEPOSTAL Le code postal NOMENCLATURE Référence annuaire.sante.fr : NCODEPOSTAL


CodeSystem :

1.2.250.1.213.2.45

NCOMMUNE Le code de la commune

NOMENCLATURE Référence annuaire.sante.fr : NCOMMUNE


CodeSystem :

1.2.250.1.213.2.23

NDEPARTEMENT Le code département de la commune

NOMENCLATURE Référence annuaire.sante.fr : NDEPARTEMENT


CodeSystem :

1.2.250.1.71.1.2.16

NPAYS Le code du pays NOMENCLATURE Référence annuaire.sante.fr : NPAYS





CodeSystem :

1.2.250.1.213.2.24

TELEPHONE Le numéro de téléphone

X(15)

TELEPHONE2 Le numéro de téléphone portable

X(15)

TELECOPIE Le numéro de télécopie

X(15)

COURRIEL L’adresse du courriel X(80)

Tableau 17: Description des attributs coordonnés d’une PP

6.2.3.3.4 Etudiant

Ci-dessous illustrée la structure « STRUCTURE_ ETUDIANT » :

Figure 13: Structure étudiant d’une personne physique

Le modèle de la structure « STRUCTURE_ETUDIANT » est détaillé ci-dessous :


STRUCTURE_ ETUDIANT : CONTENEUR DE DONNEES D’UN ETUDIANT

AUTORISATIONSREMPLACEMENTS

Liste des autorisations de remplacement

LISTE DE STRUCTURE_AUTORISATIONREMPLACEMENT

Autorisations d’exercice en qualité de remplaçant.

DATEDEBUTETUDE La date de début des études

DT(AAAAMMJJ)

DATEFINETUDE La date de fin des études

DT(AAAAMMJJ)

Tableau 18: Description des attributs de l’étudiant d’une PP

6.2.3.3.4.1 Autorisation de remplacement



Ci-dessous illustrée la structure « STRUCTURE_ AUTORISATIONREMPLACEMENT » :

Figure 14: Structure autorisation de remplacement d’une personne physique

Le modèle de la structure « STRUCTURE_AUTORISATIONREMPLACEMENT » est détaillé ci-dessous :


STRUCTURE_ AUTORISATIONREMPLACEMENT : CONTENEUR DE DONNEES DES AUTORISATIONS DE REMPLACEMENTS

DATEDEBUT La date de début DT(AAAAMMJJ) AUTORISATIONS D’EXERCICE EN QUALITE DE REMPLAÇANT.

DATEFIN La date de fin DT(AAAAMMJJ)

NORDRE AE ayant délivré la licence de remplacement :

NOMENCLATURE Référence annuaire.sante.fr : NAUTORITEENREGISTREMENT


CodeSystem :

1.2.250.1.213.1.6.1.57

Tableau 19: Description des attributs Autorisation de remplacement d’une PP

6.2.3.3.5 Langue Parlée

Ci-dessous illustrée la structure « STRUCTURE_ LANGUEPARLEE » :

Figure 15: Structure d’une langue parlée par une personne physique

Le modèle de la structure « STRUCTURE_LANGUEPARLEE » est détaillé ci-dessous :


STRUCTURE_LANGUEPARLEE : CONTENEUR DE DONNEES D’UNE LANGUE

NLANGUE Le code de la langue NOMENCLATURE Référence annuaire.sante.fr : NLANGUEPARLE





CodeSystem :

1.2.250.1.71.1.2.10

DATEFIN La date de fin DT(AAAAMMJJ)

Tableau 20: Description des attributs de Langue parlée d’une PP

6.2.3.3.6 Diplôme Obtenu

Ci-dessous illustrée la structure « STRUCTURE_ DIPLOME » :

Figure 16: Structure diplôme d’une personne physique

Le modèle de la structure « STRUCTURE_DIPLOME » est détaillé ci-dessous :


STRUCTURE_DIPLOME : CONTENEUR DE DONNEES D’UN DIPLOME

NLIEUFORMATION Le lieu de formation NOMENCLATURE Référence annuaire.sante.fr : NLIEUFORMATION

Code SystemName: R16

CodeSystem : 1.2.250.1.213.1.6.1.35

NDIPLOME Le code du diplôme NOMENCLATURE Référence annuaire.sante.fr : NDIPLOME

Code SystemName: R47, R48, R49, R50, R51

CodeSystem : 1.2.250.1.213.1.6.1.30,

1.2.250.1.213.1.6.1.31,

1.2.250.1.213.1.6.1.32,

1.2.250.1.213.1.6.1.48,

1.2.250.1.213.1.6.1.49

DIPLOMELIBELLE Le libelle du diplôme X(250)




NTYPEDIPLOME Le type de diplôme NOMENCLATURE Référence annuaire.sante.fr : NTYPEDIPLOME


CodeSystem : 1.2.250.1.213.1.6.1.36

NUMERODIPLOME Le numéro de diplôme X(40)

DATEOBTENTION La date d’obtention DT(AAAAMMJJ)

Tableau 21: Description des attributs Diplôme d’une PP

6.2.3.3.7 Autre Diplôme Obtenu

Ci-dessous illustrée la structure « STRUCTURE_ AUTREDIPLOME » :

Figure 17: Structure autre diplôme d’une personne physique

Le modèle de la structure « STRUCTURE_AUTREDIPLOME » est détaillé ci-dessous :


STRUCTURE_AUTREDIPLOME : CONTENEUR DE DONNEES D’UN AUTRE DIPLOME OBTENU

NAUTREDIPLOME Le code autre diplôme non référencé dans la nomenclature Diplôme standard

NOMENCLATURE Référence annuaire.sante.fr : NAUTREDIPLOME


CodeSystem : 1.2.250.1.213.1.6.1.54

AUTREDIPLOMELIBELLE Le libelle du diplôme X(250)

NLIEUFORMATION Le lieu de formation NOMENCLATURE Référence annuaire.sante.fr : NLIEUFORMATION


CodeSystem : 1.2.250.1.213.1.6.1.35

NUMERODIPLOME Le numéro de X(40)




diplôme

DATEOBTENTION La date d’obtention DT(AAAAMMJJ)

Tableau 22: Description des attributs Autre Diplôme Obtenu

6.2.3.3.8 Autorisation

Ci-dessous illustrée la structure « STRUCTURE_ AUTORISATION » :

Figure 18: Structure autorisation d’une personne physique

Le modèle de la structure « STRUCTURE_AUTORISATION » est détaillé ci-dessous :


STRUCTURE_AUTORISATION : CONTENEUR DE DONNEES D’UNE AUTORISATION

NPROFESSION Le code de la profession

NOMENCLATURE Référence annuaire.sante.fr : NPROFESSION

Code SystemName: G15

CodeSystem : 1.2.250.1.71.1.2.7

NTYPEAUTORISATION Le type d’autorisation NOMENCLATURE Référence annuaire.sante.fr : NTYPEAUTORISATION


CodeSystem : 1.2.250.1.213.1.6.1.14

DATEEFFET La date d’effet de l’autorisation

DT(AAAAMMJJ)

DATEFIN La date de fin de l’autorisation

DT(AAAAMMJJ)

NDISCIPLINE Le code de la discipline d’autorisation

NOMENCLATURE Référence annuaire.sante.fr : NDISCIPLINE


CodeSystem :




1.2.250.1.213.1.6.1.67

Tableau 23: Description des attributs Autorisation d’une PP

6.2.3.3.9 Exercice Professionnel

Ci-dessous illustrée la structure « STRUCTURE_ EXERCICEPROFESSIONNEL » :

Figure 19: Structure exercice professionnel d’une personne physique

Le modèle de la structure « STRUCTURE_EXERCICEPROFESSIONNEL » est détaillé ci-dessous :

ATTRIBUT Définition TYPE COMMENTAIRE

STRUCTURE_ EXERCICEPROFESSIONNEL : CONTENEUR DE DONNEES D’UN EXERCICE PROFESSIONNEL

NOMEXERCICE Le nom d’exercice X(80)

PRENOMEXERCICE Le prénom d’exercice X(50)

NPROFESSION Le code de la profession






Code Système : 1.2.250.1.71.1.2.7

NCIVILITEEXERCICE Le code de la civilité de l’exercice

NOMENCLATURE Référence annuaire.sante.fr : NCIVILITEEXERCICE


CodeSystem : 1.2.250.1.213.1.6.1.11

NCATEGORIEPROFESSION Le code de la catégorie du professionnel de santé

NOMENCLATURE Référence annuaire.sante.fr : NCATEGORIEPS


CodeSystem : 1.2.250.1.213.1.6.1.10

DATEEFFET La date d’effet du l’exercice

DT(AAAAMMJJ)

DATEFIN La date de fin du l’exercice

DT(AAAAMMJJ)

DATEDEBUTPREMIEREINSCRIPTION

La date de la première inscription dans l’ordre

DT(AAAAMMJJ)

NORDREPREMIEREINSCRIPTIONC Le code de l’ordre de la première inscription

NOMENCLATURE Référence annuaire.sante.fr : NAUTORITEENREGISTREMENT


CodeSystem : 1.2.250.1.213.1.6.1.57

NDEPARTEMENTPREMIEREINSCRIPTION

Le code du département de la première inscription



CodeSystem : 1.2.250.1.71.1.2.16

SITUATIONPH La situation du PH STRUCTURE_SITUATIONPH

SAVOIRSFAIRES La période de savoir faire

LISTE DE STRUCTURE_PER

IODE SAVOIRFAIRE

SANCTIONS Les sanctions LISTE DE STRUCTURE_SAN

CTION

PERIODESATTRIBUTIONSPARTICU Les périodes d’attributions

LISTE DE STRUCTURE_




LIERES particuliers PERIODEATTRIBUTION

PARTICULIER

REFERENCEMENTAUPRESAE Les inscriptions auprès des AE

LISTE DE STRUCTURE_REFERENCEMENTAE

SITUATIONSEXERCICE La liste des situations de l’exercice

LISTE DE STRUCTURE_

SITUATIONEXERCICE

CARTESCPS Les cartes CPS LISTE DE STRUCTURE_CAR

TECPS

Tableau 24: Description des attributs Exercice Professionnel d’une PP

6.2.3.3.9.1 Situation PH

Ci-dessous illustrée la structure « STRUCTURE_ SITUATIONPH » :

Figure 20: Structure situation praticien hospitalier d’un exercice professionnel

Le modèle de la structure « STRUCTURE_SITUATIONPH » est détaillé ci-dessous :


STRUCTURE_SITUATIONPH : CONTENEUR DE DONNEES D’UNE SITUATION HOSPITALIER

DATENOMINATION La date de la nomination

DT(AAAAMMJJ)

EJRATTACHEMENT L’établissement juridique de rattachement

X(9)

NSTATUTPH Le code statut hospitalier

NOMENCLATURE Référence annuaire.sante.fr : NSTATUTPH


CodeSystem : 1.2.250.1.213.1.6.1.21




NSAVOIRFAIRE Type de savoir-faire NOMENCLATURE Référence annuaire.sante.fr : NSAVOIRFAIRE

Code SystemName: R38 ; R39 ; R40 ; R41 ; R42 ; R43 ; R44 ; R45 ;R46

CodeSystem : 1.2.250.1.213.2.28,

1.2.250.1.213.2.29,

1.2.250.1.213.2.30,

1.2.250.1.213.2.31,

1.2.250.1.213.2.32,

1.2.250.1.213.2.33,

1.2.250.1.213.2.34,

1.2.250.1.213.2.35,

1.2.250.1.213.2.36

DATEDEBUTINSTALL La date de début d’installation

DT(AAAAMMJJ)

DATEFININSTALL La date de fin d’installation

DT(AAAAMMJJ)

DATEFINSTATUTPH La date de fin de statut hospitalier

DT(AAAAMMJJ)

Tableau 25: Description des attributs Situation PH d’une PP

6.2.3.3.9.2 Savoir faire

Ci-dessous illustrée la structure « STRUCTURE_ PERIODESAVOIRFAIRE» :

Figure 21: Structure d’une période de savoir-faire d’un exercice professionnel

Le modèle de la structure « STRUCTURE_PERIODESAVOIRFAIRE » est détaillé ci-dessous :


STRUCTURE_ PERIODESAVOIRFAIRE : CONTENEUR DE DONNEES D’UNE PERIODE DE SAVOIR FAIRE LIEE A UN EXERCICE PROFESSIONNEL

NSAVOIRFAIRE Le code du savoir faire NOMENCLATURE Référence annuaire.sante.fr : NSAVOIRFAIRE




Code SystemName: R38 ; R39 ; R40 ; R41 ; R42 ; R43 ; R44 ; R45 ; R46

CodeSystem :

1.2.250.1.213.2.28,

1.2.250.1.213.2.29,

1.2.250.1.213.2.30,

1.2.250.1.213.2.31,

1.2.250.1.213.2.32,

1.2.250.1.213.2.33,

1.2.250.1.213.2.34,

1.2.250.1.213.2.35,

1.2.250.1.213.2.36

NTYPESAVOIRFAIRE Le code du type de savoir faire

NOMENCLATURE Référence annuaire.sante.fr : NTYPESAVOIRFAIRE


CodeSystem : 1.2.250.1.213.1.6.1.16

DATERECONNAISSANCE La date de la reconnaissance

DT(AAAAMMJJ)

DATEABANDON La date d’abandon DT(AAAAMMJJ)

Tableau 26: Description des attributs Période de savoir-faire d’une PP

6.2.3.3.9.3 Sanction

Ci-dessous illustrée la structure « STRUCTURE_ SANCTION» :

Figure 22: Structure d’une sanction d’un exercice professionnel

Le modèle de la structure « STRUCTURE_SANCTION » est détaillé ci-dessous :




STRUCTURE_SANCTION : CONTENEUR DE DONNEES D’UNE SANCTION

NTYPESANCTION Le code du type de sanction

NOMENCLATURE Référence annuaire.sante.fr : NTYPESANCTION


CodeSystem : 1.2.250.1.213.1.6.1.24

NORIGINESANCTION Le code de l’origine de la sanction

NOMENCLATURE Code issu du NASS table libellée NORIGINESANCTION


CodeSystem : 1.2.250.1.213.1.6.1.26

NNIVEAUSANCTION Le niveau de la sanction

DT(AAAAMMJJ) Référence annuaire.sante.fr : NNIVEAUSANCTION


CodeSystem : 1.2.250.1.213.1.6.1.25

DATEDEBUT La date de début de la sanction

DT(AAAAMMJJ)

DATEFIN La date de fin de la sanction

DT(AAAAMMJJ)

MENTION La mention de la sanction

X(100)

DATEMENTION La date de la mention DT(AAAAMMJJ)

NINFRACTION Le code de l’infraction

NOMENCLATURE Référence annuaire.sante.fr : NINFRACTION


CodeSystem : 1.2.250.1.213.1.6.1.68

Tableau 27: Description des attributs Attribution d’une PP

6.2.3.3.9.4 Attribution particulière

Ci-dessous illustrée la structure « STRUCTURE_ ATTRIBUTIONPARTICULIERE » :

Figure 23: Structure d’une attribution particulière d’un exercice professionnel

Le modèle de la structure « STRUCTURE_ATTRIBUTIONPARTICULIERE » est détaillé ci-dessous :





STRUCTURE_ATTRIBUTIONPARTICULIERE : CONTENEUR DE DONNEES D’UNE ATTRIBUTION PARTICULIERE

NATTRIBUTIONPARTICULIERE Le code de l’attribution particulière

NOMENCLATURE Référence annuaire.sante.fr : NATTRIBUTIONPARTICULIERE


CodeSystem : 1.2.250.1.71.1.2.27

DATERECONNAISSANCE La date de reconnaissance

DT(AAAAMMJJ)

DATEABANDON La date de l’abandon DT(AAAAMMJJ)

Tableau 28: Description des attributs Période Attribution Particulières d’une PP

6.2.3.3.9.5 Référencement auprès de l'AE

Ci-dessous illustrée la structure « STRUCTURE_ REFERENCEMENTAE » :

Figure 24: Structure d’un référencent d’auprès AE

Le modèle de la structure « STRUCTURE_REFERENCEMENTAE » est détaillé ci-dessous :


STRUCTURE_REFERENCEMENTAE : CONTENEUR DE DONNEES D’UNE INSCRIPTION AUPRES D’UNE AE

NAUTORITEENREGISTREMENT Le code de l’ordre NOMENCLATURE Référence annuaire.sante.fr : NAUTORITEENREGISTREMENT


CodeSystem : 1.2.250.1.213.1.6.1.57

DATEENREGISTREMENT

Date d'enregistrement dans le fichier de l'autorité d’enregistrement (différent de la date d’inscription)

DT(AAAAMMJJ)

DATEDEBUTINSCRIPTION Date de l’inscription du professionnel de santé auprès de l’autorité d’enregistrement gérant sa profession

DT(AAAAMMJJ)

DATEFININSCRIPTION Date à partir de laquelle le

DT(AAAAMMJJ)




professionnel de santé n’est plus autorisé à exercer la profession pour laquelle il a été référencé

NSTATUTINSCRIPTION

Statut de l’inscription

Nomenclature indiquant l’avancement du traitement du dossier de l’inscription :

- T : Transfert dossier

- P : Provisoire : la commission n’a pas encore statué sur la demande de référencement

- D : Définitif : la commission a statué et a donné son avis (positif ou négatif)

- N : Non inscrit

NOMENCLATURE

Référence annuaire.sante.fr : NSTATUTINSCRIPTION


CodeSystem : 1.2.250.1.213.1.6.1.12

NDEPTINSCRIPTION Le département d’inscription



CodeSystem : 1.2.250.1.71.1.2.16

NDEPTACCUEIL Département d’accueil (si transfert de dossier)



CodeSystem : 1.2.250.1.71.1.2.16

Tableau 29: Description des attributs Référencement d’auprès AE d’une PP

6.2.3.3.9.6 Situation exercice

Ci-dessous illustrée la structure « STRUCTURE_ SITUATIONEXERCICE » :



Figure 25: Structure d’une activité d’un exercice professionnel

Le modèle de la structure « STRUCTURE_SITUATIONEXERCICE » est détaillé ci-dessous :


STRUCTURE_SITUATIONEXERCICE : CONTENEUR DE DONNEES D’UNE SITUATION DE L’EXERCICE PROFESSIONNEL

IDENTIFIANTACTIVITE L’identifiant de l’activité

X(10)

MODEEXERCICE Le mode d’exercice (libéral, salarie, etc.)

NOMENCLATURE Référence annuaire.sante.fr : NMODEEXERCICE


CodeSystem : 1.2.250.1.213.1.6.1.18

DATEDEBUT La date de début de l’activité

DT(AAAAMMJJ)

DATEFIN La date de fin de l’activité

DT(AAAAMMJJ)

NGENREACTIVITE Activité standard de soin ou de pharmacien ; Activité non soignante

NOMENCLATURE Référence annuaire.sante.fr : NGENREACTIVITE


CodeSystem : 1.2.250.1.213.1.6.1.19

NSECTIONPHARMACIEN Le code section du tableau de l’Ordre des Pharmaciens

NOMENCLATURE Référence annuaire.sante.fr : NSECTIONPHARMACIEN





CodeSystem : 1.2.250.1.213.2.37

NSOUSSECTIONPHARMACIEN Le code de la sous-section du tableau de l’Ordre des Pharmaciens

NOMENCLATURE Référence annuaire.sante.fr : NSOUSSECTIONPHARMACIEN


CodeSystem : 1.2.250.1.213.2.43

NREGIONORDREDUPHARMACIEN La région d’exercice pour les pharmaciens d’officines

NOMENCLATURE Référence annuaire.sante.fr : NREGION


CodeSystem : 1.2.250.1.213.2.25

NSTATUTPH Le code du statut hospitalier

NOMENCLATURE Référence annuaire.sante.fr : NSTATUTHOSPITALIER


CodeSystem : 1.2.250.1.213.1.6.1.21

NTYPEACTIVITELIBERALE Le code type d’activité libérale

NOMENCLATURE Référence annuaire.sante.fr : NTYPEACTIVITELIBERALE


CodeSystem : 1.2.250.1.213.1.6.1.22

NFONCTION Le code fonction NOMENCLATURE Référence annuaire.sante.fr : NFONCTION


CodeSystem : 1.2.250.1.213.1.6.1.17

NSTATUTPSSA Le code du statut des professionnels du SSA

NOMENCLATURE Référence annuaire.sante.fr : NSTATUTPSSA


CodeSystem : 1.2.250.1.213.1.6.1.23

COORDONNEESSITUATION Les coordonnées STRUCTURE_COORDONNEES

NMOTIFFINACTIVITE Le code du motif de fin d’activité

NOMENCLATURE Référence annuaire.sante.fr : NMOTIFFINACTIVITE


CodeSystem : 1.2.250.1.213.1.6.1.20




STRUCTUREACTIVITE L’identifiant de la structure d’exercice (lieu d’activité)

IDENTIFIANTPM

Tableau 30: Description des attributs Situation d’Exercice d’une PP

6.2.3.3.9.7 Carte CPS

Ci-dessous illustrée la structure « STRUCTURE_ CARTECPS» :

Figure 26: Structure d’une carte CPS

Le modèle de la structure « STRUCTURE_CARTECPS » est détaillé ci-dessous :


STRUCTURE_CARTECPS : CONTENEUR DE DONNEES D’UNE CARTE CPS

NUMERO Le numéro de la carte CPS

X(10)

DATEDEBUTVALIDITE La date de début de la validité de la carte

DT(AAAAMMJJ)

DATEFINVALIDITE La date de fin de la validité de la carte

DT(AAAAMMJJ)

DATEOPPOSITION La date d’opposition de la carte

DT(AAAAMMJJ)

NTYPECPS Le type de carte professionnelle

NOMENCLATURE Référence annuaire.sante.fr : NTYPECPS


Code System : 1.2250.1.71.1.2.2

Tableau 31: Description des attributs Carte CPS d’une PP

6.2.3.4 Informations complémentaires sur le résultat de la consultation

Les informations complémentaires sur le résultat de la consultation sont communiquées dans cette structure.




STRUCTURE_INFOCONSULTATION : CONTENEUR DES INFORMATIONS COMPLEMENTAIRES SUR LA CONSULTATION

NOMBRECONSULTATIONS Nombre de résultats trouvés par le système annuaire.sante.fr

N(5) x


N(5) x

MESSAGE Message d’information retourné par le système annuaire.sante.fr

X(1024)

Tableau 32: Description des attributs Informations complémentaires retournées par le service de consultation des PP





Le tableau suivant donne pour chaque critère la règle qui lui est appliquée pour rechercher les données.

DONNEES Règles métier associées DONNEES PUBLIQUES

STRUCTURE IDENTIFIANTCONSULTATION

IDENTIFIANTPERSONNE RM_CONS_PP1 O

TYPEIDENTIFIANTPERSONNE RM_CONS_PP1 O

Tableau 33: Description des règles métiers du service consultation des PP



RM_CONS_PP1 Le critère est obligatoire

RM_CONS_PP2


Exemple :


RM_CONS_PP3 Le nombre maximum de résultat de recherche est limité. Ce nombre est paramétrable

RM_CONS_PP4

Le système annuaire.sante.fr recherche les PP dont les identifiants sont passés en critère de recherche.

Les PP trouvées sont retournées dans la liste LISTEPPTROUVEES avec une structure contenant les informations de la PP.




Les PP non trouvées sont retournées dans la liste LISTEPPNONTROUVEES contenant l’identifiant passé en entrée et un message d’information.

RM CONS_PP5 Le nombre de message retourné par le système annuaire.sante.fr est identique au nombre d’identifiants passé en entrée du service.

RM CONS_PP6 Il faut un minimum une structure d’identifiant en entrée.

Tableau 34: Description des règles métiers du service de consultation des PP



6.3 Recherche de personnes morales





Le corps du message qui contient les critères en entrée du web service - FILTRERECHERCHEPM.

Figure 27: Corps de message pour la recherche de personnes morales


Chaque message en sortie est constitué de quatre parties essentielles :



o Une entrée contenant les critères en entrée - FILTRERECHERCHEPM ;

o Une entrée qui contient l’ensemble des résultats trouvés par le système annuaire.sante.fr. Les données retournées sont fonction des habilitations de l’application consommatrice – LISTESPM ;

o Une entrée contenant des informations complémentaires sur les résultats de recherche - INFORESULTATSRECHERCHEPM ;


A noter : le nombre de résultats retournés dans le flux de sortie (LISTEPM) est limité à 30 Etablissements de santé.



Figure 28: Corps de message pour la réponse du service de recherche de personnes morales





La structure « FILTRERECHERCHEPM» regroupant les critères de recherche est détaillé dans le tableau suivant :

ATTRIBUT COMMENTAIRE Nom de TR CodeSystemName

OID TR CodeSystem TYPE Longueur

RAISON SOCIALE S/O X (164) 164

ENSEIGNE COMMERCIALE

S/O X (50) 50

IDENTIFIANTPM Structure contenant l’identifiant de la PM + le type d’identifiant : SIRET, FINESS, SIREN, etc.

IDENTIFIANTP

M

CODETYPE STRUCTURE

Le code de type structure initialisé avec une des valeurs :

EG – Entité géographique

EJ – Entité juridique

R67 1.2.250.1.213.1.6.1.62 X(2) 2

Indicateur Présence adresse MSS

Indicateur Présence adresse MSS – Valeur non traitée dans la version actuelle du système

LD (oui/non) 1





Indicateur Présence DAM

Indicateur Présence DAM – Valeur non traitée dans la version actuelle du système

LD (oui/non) 1

CODESTATUTJURIDIQUE

Le code du statut juridique équivalent à la catégorie juridique issue du RPPS

R72 1.2.250.1.213.1.6.1.44

X(15) 15

CODEETAT Le code d’état d’un établissement (ouvert ou fermé)

R75 1.2.250.1.213.1.6.1.47 LD (OUVERT,

FERME) 10

CODEAPE Sous classe Nomenclature d’Activités Française NAF

X (15) 15

CODEDOMAINE Le code du domaine – Catégories établissement

R62 1.2.250.1.213.1.6.1.59 X (15) 15

CODEAGREGATCATEGORIEETABLISSEMENT

Le code d’agrégat de catégories d’établissement

R65 1.2.250.1.213.1.6.1.7 X (3) 3

CODECATEGORIEETABLISSEMENT

Le code de la catégorie d’établissement

R66 1.2.250.1.213.1.6.1.8 X (3) 3

CODESECTEUR ACTIVITE

Le code du secteur d’activité santé

R02 1.2.250.1.71.4.2.4 X (15) 15

CODEREGION Le code de la région de localisation de l’établissement –

Valeur non traitée dans la version actuelle du système

R30 1.2.250.1.213.2.25

X (3)

3

CODEDEPARTEMENT Le code du département de localisation de l’établissement

G09 1.2.250.1.71.1.2.16 X (3) 3

CODECOMMUNE Le code de la commune de localisation de l’établissement

R13 1.2.250.1.213.2.23 X (5) 5

CODETERRITOIRESAN

TE Territoire de santé –

Valeur non traitée dans la version actuelle du





système

Tableau 35: Description u filtre de recherche pour les personnes morales

La structure « IDENTIFIANTPM » permet de représenter l’identifiant d’une personne morale. Ci-dessous illustrée et détaillée la structure.

Figure 29: Structure Identifiant d’une personne morale


CLASSE IDENTIFIANTPP : CONTENEUR DE L’IDENTIFIANT PP

IDENTIFIANTPM Identifiant de la personne morale (1)

X(20) X

TYPEIDENTIFIANTPM Type d’identifiant de la personne morale (SIRET, SIREN, FINESS, etc).

NOMENCLATURE X Référence annuaire.sante.fr : N/A


CodeSystem : 1.2.250.1.71.1.2.14

Tableau 36: Description des attributs Identifiant d’une personne physique

(1) Identifiant de personne morale : il peut s’agir d’un SIREN, d’un SIRET, d’un numéro FINESS, d’un RPPS-rang…


6.3.3.1 Entête

La structure « ENTETE » est identique à celle présenté en section §6.2.2. Les données retournées correspondent à celles fournies en entrée.




La structure «FILTRERECHERCHEPM» est identique à celle présenté en section §6.3.2.2. Les données retournées correspondent à celle fournies en entrée.

6.3.3.3 Résultat de recherche

Pour un identifiant de personne morale donnée, si elle existe, le résultat est communiqué dans un liste de PM trouvées, sinon, l’identifiant est inscrit dans une liste de PM non trouvées.

6.3.3.4 Informations complémentaires sur le résultat de la recherche

Les informations complémentaires sur le résultat de la recherche sont communiquées dans cette structure « INFORESULTATSRECHERCHEPM ».


STRUCTURE_INFORECHERCHE : CONTENEUR DES INFORMATIONS COMPLEMENTAIRES SUR LA RECHERCHE

NOMBRERESULTATS Nombre de résultats trouvés par le système annuaire.sante.fr

N(5) X


N(5) X


X(1024)

Tableau 37: Description des infos complémentaires retournées par le service recherche des PM





Le tableau suivant donne pour chaque critère, les règles qui lui sont appliquées pour rechercher les personnes morales.


RAISON SOCIALE RM_RECH_PM1,

RM_RECH_PM3 O

ENSEIGNE COMMERCIALE RM_RECH_PM1,

RM_RECH_PM3 O

IDENTIFIANTPM RM_RECH_PM1,

RM_RECH_PM3,

RM_RECH_PM9

O




TYPE STRUCTURE (EG ou EJ) RM_RECH_PM2,

RM_RECH_PM3 O

Indicateur Présence adresse MSS (*) – Valeur non traitée

dans la version actuelle du système RM_RECH_PM3 x

Indicateur Présence DAM (*) – Valeur non traitée dans la version actuelle du système

RM_RECH_PM3 x

STATUT JURIDIQUE RM_RECH_PM2,

RM_RECH_PM3 O

ETAT RM_RECH_PM3 O

CODE APE RM_RECH_PM2,

RM_RECH_PM3 O

DOMAINE RM_RECH_PM2,

RM_RECH_PM3 O

AGREGAT DE CATEGORIE D’ETABLISSEMENT RM_RECH_PM2,

RM_RECH_PM3 O

CATEGORIE D’ETABLISSEMENT RM_RECH_PM2,

RM_RECH_PM3 O

SECTEUR D’ACTIVITE RM_RECH_PM2,

RM_RECH_PM3 O

REGION RM_RECH_PM2,

RM_RECH_PM3 O

DEPARTEMENT RM_RECH_PM2,

RM_RECH_PM3 O

COMMUNE RM_RECH_PM2,

RM_RECH_PM3 O

TERRITOIRE DE SANTE RM_RECH_PM 3 O

Tableau 38: Règles métiers appliquées aux critères pour le service recherche des PM

(*) Champ non pris en compte dans le filtre de recherche dans la version courante du Web service



RM_RECH_PM1 Chaîne de caractères pouvant inclure les motifs « * » et « ? »




RM_RECH_PM2 Code issu des nomenclatures de référence

RM_RECH_PM3 Critère non obligatoire

Pour information, aucun critère de recherche n’est obligatoire

RM_RECH_PM4


Exemple :


RM_RECH_PM5 Au moins un critère est obligatoire.

RM_RECH_PM6 Le nombre maximum de résultat de recherche est limité. Ce nombre est paramétrable

RM_RECH_PM7 La recherche doit être exacte. La recherche prend en compte tous les critères saisis. Seules sont sélectionnées les PM dont les attributs correspondent à l'ensemble des critères saisis.

RM_RECH_PM8

La recherche interprète le motif « ? » comme joker sur un caractère et le motif « * » comme joker sur un ensemble de caractères)

RM_RECH_PM9

La recherche des établissements s’effectue par rapport à l’identifiant PM et le type d’identifiant.

Si le type d'identifiant = 1 alors on recherche, sur l’ensemble des établissements juridiques et géographique, la structure correspondante à l’identifiant PM.

Si le type d'identifiant = 5 alors on recherche l’entité juridique correspondante à l’identifiant PM

Type d'identifiant =6 alors on recherche l’entité géographique correspondante à l’identifiant PM

Tableau 39: Description des règles métiers du service recherche des PM

6.4 Consultation de personnes morales





Le corps du message qui contient les critères de recherche en entrée du web service - IDENTIFIANTCONSULTATIONPM.



Figure 30: Corps de message pour la consultation de personnes morales

Attention : Le nombre d'identifiants en entrée est limité à 20. Ce nombre est paramètre dans le système annuaire.sante.fr.


Chaque message en sortie est constitué de quatre parties essentielles :



o Une entrée contenant les critères en de recherche – IDENTIFIANTCONSULTATIONPM ;

o Une entrée qui contient l’ensemble des résultats trouvés dans annuaire.sante.fr. Les données retournées sont fonction des habilitations de l’application consommatrice – LISTEPMTROUVEES ;

o Une entrée qui contient les identifiants des PM non trouvées dans annuaire.sante.fr - LISTEPMNONTROUVEES ;

o Une entrée contenant des informations complémentaires sur les résultats de recherche - INFOCONSULTATIONPM ;


Figure 31: Corps de message pour la réponse du service de consultation de personnes morales





La structure « ENTETE »est identique à celle présenté en section §5.66.2.2.


Les critères de recherche de recherche sont fournies dans la requête d’entrée sous forme de liste d’identifiant avec une structure de type « IDENTIANTNPM ». Cette structure est décrite dans la section §6.3.2.1


6.4.3.1 Entête



La structure est identique à celle présenté en section §6.3.2.2. Les données retournées correspondent à celle fournies en entrée.

6.4.3.3 Résultat de la consultation

Les résultats trouvés sont transmis par le web service sous forme de listes :

Une liste contenant les PM dont les identifiants sont référencés dans annuaire.sante.fr : «LISTEPMTROUVEES» avec la structure «STRUCTURE_MESSAGEPM»

Une liste contenant les identifiants non référencés ou non accessibles dans annuaire.sante.fr : «LISTEPMNONTROUVEES» avec la structure «STRUCTURE_MESSAGEPMNONTROUVEES».

Figure 32: Structure des résultats retournés par le service de consultation des personnes morales


STRUCTURE_MESSAGEPM: CONTENEUR DE LA STRUCTURE D’UN MESSAGE PM

IDENTIFIANTPM L’identifiant de la personne morale

STRUCTURE_IDENTITE

X

Structure contenant l’identifiant de la PM + le type d’identifiant : SIRET, FINESS, SIREN,




etc.

STRUCTURE Les informations sur la structure

STRUCTURE_STRUCTURE

X

LISTEPP Liste des PP en exercice dans la structure

STRCTURE_MESSAGEPP

Les informations restituées sont réduites pour chaque PM (PS : identifiant, Nom Exe, Prénom Exe, Profession & Savoirs Faire)

LISTEEG Liste des EG dans le cas où la structure est de type EJ

STRCTURE_MESSAGE_EG

Les informations restituées sont réduites pour chaque EJ, la liste des EG correspondantes (EG : id, RS, EC, catégorie)

Tableau 40: Description de la structure retournée par le service de consultation des PM

Ci-dessous illustrée la structure de message retournée par le web service pour un identifiant de personne physique non trouvé dans annuaire.sante.fr.

Figure 33: Structure message des résultats des personnes morales non trouvées dans annuaire.sante.fr


STRUCTURE_MESSAGEPMNONTROUVEES: CONTENEUR DE LA STRUCTURE D’UN MESSAGE PM NON TROUVEES

IDENTIFIANTPM Structure contenant l’identifiant de la PM + le type d’identifiant : SIRET, SIREN, etc.

IDENTIFIANTPM

X

MESSAGE Message retourné par le système annuaire.sante.fr

X(1024) X

Tableau 41: Description de la structure retournée par le service de consultation des PM

6.4.3.3.1 Identifiant de la structure

Le modèle de la structure « IDENTIFIANTPM » est détaillé en section §6.3.2.1.

6.4.3.3.2 Structure

Ci-dessous illustrée la structure « STRUCTURE_ STRUCTURE » :



Figure 34: Structure d’une personne morale trouvée dans annuaire.sante.fr

Le modèle de la structure « STRUCTURE_STRUCTURE » est détaillé ci-dessous :


STRUCTURE_STRUCTURE: CONTENEUR DE DONNEES DE BASE D’UNE STRUCTURE (PERSONNE MORALE)

IDENTIFIANTPM

Identifiant structure


TYPE STRUCTURE Le type de structure:

Valeurs EG (Etablissement géographique) ou EJ

NOMENCLATURE Référence annuaire.sante.fr : TYPESTRUCTURE





(Entité juridique) Code System : 1.2.250.1.213.1.6.1.62

RAISONSOCIALE Libelle Raison Sociale X(164)

RAISONSOCIALELONG Libelle Raison Sociale Long

X(164)

COMPLEMENTRAISONSOCIALE

Complément de la Raison Sociale

X(164)

ENSEIGNECOMMERCIALE Enseigne Commerciale X(50)

NATUREETABLISSEMENT Nature Etablissement

Valeur G ou B

X(1)

NUMEROFINESSETABPRINCIPAL

Numéro FINESS Etablissement Principal

X(9)

NUMEROSIRET Numéro Siret

X(14) Information restituée pour les entités géographiques (EG)

NUMEROSIREN Numéro Siren

X(9) Information restituée pour les entités juridiques (EJ)

DATEMAJSIREN La date de mise à jour SIREN

DT(AAAAMMJJ)

ORIGINEMAJSIREN L’origine de mise à jour SIREN

X(20)

DATEMAJSIRET La date de mise à jour Siret

DT(AAAAMMJJ)

ORIGINEMAJSIRET L’origine de mise à jour SIRET

X(20)

DATECREATION La date de création DT(AAAAMMJJ)

QUALIFICATIONCREATION La qualification création X(3)

DATEOUVERTURE La date d’ouverture DT(AAAAMMJJ)

DATEMAJSTRUCTURE La date de mise à jour de la structure

DT(AAAAMMJJ)

DATECADUCITE La date de caducité DT(AAAAMMJJ)

INDICATEURCADUCITE L’indicateur de caducité LD (oui, non)

DATEFERMETURE La date de fermeture DT(AAAAMMJJ)




TYPEFERMETURE Le type de fermeture X(3)

DATEAUTORISATION La date d’autorisation DT(AAAAMMJJ)

NUMEROLICENCEEXPLOITATION

Le numéro de licence d’exploitation

X(10)

NUMEROEDUCATIONNATIONALE

Le numéro de licence de l’Education Nationale

X(8)

NSTATUTJURIDIQUE

Le statut juridique

NOMENCLATURE Référence annuaire.sante.fr : NSTATUTJURIDIQUE


CodeSystem :

1.2.250.1.213.1.6.1.44

CODEAPE Le code APE X (15)

NSECTEURACTIVITESANTE

Le secteur d’activité santé

NOMENCLATURE Référence annuaire.sante.fr : NSECTEURACTIVITESANTE


CodeSystem : 1.2.250.1.71.4.2.4

NCATEGORIEETABLISSEMENT

La catégorie d’établissement

NOMENCLATURE Référence annuaire.sante.fr : NCATEGORIEETABLISSEMENT


CodeSystem : 1.2.250.1.213.1.6.1.8

NAGREGATCATEGORIE

L’agrégat de la catégorie d’établissement

NOMENCLATURE Référence annuaire.sante.fr : NAGREGATCATEGORIE


CodeSystem : 1.2.250.1.213.1.6.1.7

NESPIC

ESPIC (anciennement Service Public Hospitalier)

NOMENCLATURE Référence annuaire.sante.fr : NSPH


CodeSystem : 1.2.250.1.213.1.6.1.45

NMFT

Mode de fixation tarifaire

NOMENCLATURE Référence annuaire.sante.fr : NMFT


CodeSystem :




1.2.250.1.213.1.6.1.46

NSOUSCLASSENAFSTRUCTURE

Code APE ou La sous-classe NAF

NOMENCLATURE Référence annuaire.sante.fr : NNAF


CodeSystem : 1.2.250.1.213.1.6.1.47

COORDONNEES Les coordonnées


IDSTRUCTUREPRED L’identifiant de la structure précédente

IDENTIFIANTPM

Tableau 42: Description des attributs de Structure d’une PM

6.4.3.3.3 Liste des personnes physiques exerçant dans la structure

Ci-dessous illustrée la structure « STRUCTURE_ MESSAGEPP_EG » :

Figure 35: Structure d’une personne physique exerçant dans une structure

Le modèle de la structure « STRUCTURE MESSAGEPP_EG » utilisé dans la liste est détaillée ci-dessous :


STRUCTURE_MESSAGEPP: CONTENEUR DE DONNEES DE BASE DES PP D’UNE STRUCTURE

IDENTIFIANTPP L’identifiant de la personne physique

NOMENCLATURE Structure contenant l’identifiant de la PP + le type d’identifiant : RPPS, ADELI, etc.

NOMEXERCICE Le nom de l’exercice X(80)

PRENOMEXERCICE Le prénom d’exercice X(50)

NPROFESSION

Le code de la profession



Code Système : 1.2.250.1.71.1.2.7

SAVOIRSFAIRES Les périodes de savoir faire

LISTE DE STRUCTURE_PERIO




DE SAVOIRFAIRE

Tableau 43: Description des attributs des Personnes physiques d’une structure

6.4.3.3.4 Liste des entités géographiques pour les structures de type EJ structure

Ci-dessous illustrée la structure « STRUCTURE_ STRUCTURE EG » :

Figure 36: Structure d’une entité géographique liée à une entité juridique

Le modèle de la structure « STRUCTURE_STRUCTURE_EG » utilisé dans la liste est détaillée ci-dessous :


STRUCTURE_STRUCTURE_EG: CONTENEUR DE DONNEES DE BASE D’UNE STRUCTURE DE TYPE EG(PERSONNE MORALE)

IDENTIFIANTPM

Identifiant de la structure géographique


RAISONSOCIALE Libelle Raison Sociale X(164)

ENSEIGNECOMMERCIALE Enseigne Commerciale X(50)

NCATEGORIEETABLISSEMENT

La catégorie d’établissement

NOMENCLATURE Référence annuaire.sante.fr : NCATEGORIEETABLISSEMENT


CodeSystem : 1.2.250.1.213.1.6.1.8

NSECTEURACTIVITESANTE

Le secteur d’activité santé

NOMENCLATURE Référence annuaire.sante.fr : NSECTEURACTIVITESANTE


CodeSystem : 1.2.250.1.71.4.2.4

COORDONNEES Les coordonnées de l’établissement


Tableau 44: Description des attributs des établissements liés à une entité juridiques



6.4.3.4 Informations complémentaires sur le résultat de la consultation

Les informations complémentaires sur le résultat de la consultation communiquées dans cette structure.


STRUCTURE_INFOCONSULTATION : CONTENEUR DES INFORMATIONS COMPLEMENTAIRES SUR LA CONSULTATION

NOMBRECONSULTATIONS Nombre de résultats trouvés par le système annuaire.sante.fr

N(5) x


N(5) x


X(1024)

Tableau 45: Informations complémentaires retournées par le service de consultation des PM





Le tableau suivant donne pour chaque critère la règle qui lui est appliquée pour rechercher les données.

DONNEES Règles métier associées DONNEES PUBLIQUE

STRUCTURE IDENTIFIANCONSULTATION

IDENTIFIANTPERSONNE RM_CONS_PM1 O

TYPEIDENTIFIANTPERSONNE RM_CONS_PM1 O

Tableau 46: Règles métiers associées aux critères en entrée du service de consultation des PM



RM_CONS_PM1 Le critère est obligatoire

RM_CONS_PM2


Exemple :


RM_CONS_PM3 Le nombre maximum de résultat de recherche est limité. Ce




nombre est paramétrable

RM_CONS_PM4

Le système annuaire.sante.fr recherche les PM dont les identifiants sont passés en critère de recherche.

Les PM trouvées sont retournées dans la liste LISTEPMTROUVEES avec une structure contenant les informations de la PM.

Les PM non trouvées sont retournées dans la liste LISTEPMNONTROUVEES contenant l’identifiant passé en entrée et un message d’information.

RM_CONS_PM5 Le nombre de message retourné par le système annuaire.sante.fr est identique au nombre d’identifiants passé en entrée du service.

RM_CONS_PM6 Il faut un minimum une structure d’identifiant en entrée.

RM_CONS_PM7 Seules les EG en provenance de FINESS sont restituées par annuaire.sante.fr (les EG fictifs ne sont pas restituées)

Tableau 47: Règles métiers associées au service de consultation des PM

6.5 Gestion des erreurs

6.5.1 Réponses standards en cas d’erreur

Pour chaque Service, une réponse with failure renvoie une SOAP Fault à l’appelant en cas d’exception.



7. Annexes

7.1 WSDL - Contrats d’interfaces

WS1 : WSRecherchePP – Web Service de recherche des personnes physiques

WS2 : WSConsultationPP – Web Service de consultation des personnes physiques

WS3 : WSRecherchePM – Web Service de recherche des personnes morales

WS4 : WSConsultationPM– Web Service de consultation des personnes morales

Voir document de référence [ref 7].

7.2 XSD


7.3 Identifiants des Ressources Terminologiques utilisées par le système annuaire.sante.fr


7.4 Droit de rectification des données collectées par le service annuaire.sante.fr

Les données à caractère personnel recueillies par l’intermédiaire du service présenté dans le présent document ne sont accessibles qu’aux personnes en charge de la gestion des demandes d’accès aux données contenues dans le RPPS au sein de l’ASIP Santé. Elles ne sauraient, en aucun cas être transmises, à titre gratuit ou onéreux, à des tiers n’intervenant pas dans la gestion du RPPS. Conformément à la loi n°78-17 du 6 janvier 1978 modifiée en 2004, l’utilisateur bénéficie d’un droit d’accès, de modification, de rectification, d'effacement des données à caractère personnel qui le concerne, ainsi que d'un droit d'opposition. Pour exercer ces droits, il convient d’adresser une demande par courrier postal : ASIP Santé -9 rue Georges Pitard-Paris 75015 – à l'attention du Correspondant Informatique et Libertés du GIP ASIP Santé, ou d’écrire à l'adresse suivante : [email protected]

7.5 Lexique, abréviations et légende

Vous trouverez dans ce chapitre une explication succincte d’un ensemble de termes et d’abréviations utilisés dans ce document.

7.5.1 Lexique

Définitions

ADELI Répertoire officiel de gestion des listes départementales des professionnels de santé et des professions à usage de titre. Ce répertoire attribue à chaque professionnel un numéro d’identification dénommé N°ADELI.

Autorisation de remplacement

Autorisation d’une personne de type professionnel de santé à exercer une activité professionnelle, notamment lors de ses études, dans une profession de santé pendant une période déterminée.

mailto:[email protected]



Définitions

Autorité d’Enregistrement

Autorité compétente pour l’enregistrement des données concernant la population d’acteurs relevant de son champ de compétence. Exemple : Ordres, SSA, ARS, DRJSCS

Catégorie d’Etablissement

(source FINESS)

Chaque établissement est rattaché à une catégorie d'établissement qui caractérise le cadre réglementaire dans lequel s'exerce l'activité de l'établissement.

Les catégories d'établissements sont elles-mêmes classifiées en grands agrégats qui sont :

Etablissements relevant de la loi hospitalière.

Autres établissements de soins et de prévention.

Autres établissements à caractère sanitaire.

Etablissements et services sociaux d'accueil, hébergement, assistance, réadaptation.

Etablissements et services sociaux d'aide à la famille.

Etablissements de formation des personnels sanitaires et sociaux.

DAM Données d’Assurance Maladie. Les DAM sont des coefficients de remboursement des actes d’un professionnel de santé. Ces données sont fournies par la CNAMTS.

Exercice professionnel

Désigne la (les) activité(s) et modalités d’exercice d’un professionnel de santé

FINESS

Fichier National des Etablissements Sanitaires et Sociaux

Le N° de FINESS permet d’identifier un établissement de soins. Il existe un FINESS juridique et un FINESS géographique qui sont les équivalents des numéros de SIREN et de SIRET.

Le Ministère Chargé des Affaires Sanitaires et Sociales et ses services déconcentrés répertorient pour leurs besoins et ceux de l’assurance maladie les structures autorisées à installer des équipements sanitaires ou sociaux (Entité Juridique) ainsi que les lieux dans lesquels sont installés ces équipements et s’exercent les activités de soins ou de service social correspondant (Etablissement). A chacune d’elles est attribué un NUMERO FINESS.

La Direction de la Recherche, des Etudes, de l’Evaluation et des Statistiques (DREES) est responsable de ; les ARS en assurent la mise à jour : c’est le registre des établissements de santé.

Ce mode d’identification devrait être remplacé à terme par le système SIREN, SIRET.

Nomenclature

Ensemble de terminologies de référence cohérent d'un point de vue métier ou technique, de terminologies de référence qui peuvent être maintenues par des organisations distinctes.

Exemples :

La NASS, est l’ensemble de terminologies de référence servant à l’identification et à la description des acteurs des domaines sanitaire, médico social et social – personnes physiques et morales sont gérées notamment par la DGOS et la DREES (FINESS), les Ordres (RPPS), l’INSEE …



Définitions

Personne morale

Pour les besoins du présent référentiel, cette notion désigne : - Une entité juridique FINESS (EJ) : correspond à la notion de personne morale. Une entité

juridique détient des droits (autorisations, agréments, conventions,...) lui permettant d'exercer ses activités dans des établissements. A chaque entité juridique est associé un statut juridique.

- Un établissement (ET dans le vocabulaire FINESS ou EG dans le vocabulaire SIRENE) correspond à une implantation géographique. Un établissement est caractérisé par une catégorie d'établissement. Un établissement est obligatoirement relié à une entité juridique.

La notion de personne morale couvre également les cas dans lesquels l’acteur concerné n’est ni une personne physique, ni une personne morale au sens strictement juridique, mais dont les caractéristiques justifient de l’inclure dans le périmètre du référentiel consacré aux personnes morales.

Exemple : communauté hospitalière de territoire, réseau de santé non doté de la personnalité morale…

Professionnel de santé

Personne exerçant une des professions de santé prévues à la quatrième partie du CSP et réparties en trois groupes :

-professions médicales (Médecins, sage-femme…)

-professions de pharmacien

- auxiliaires médicaux, aides-soignants, auxiliaires de puériculture et ambulanciers

Pour les besoins du présent référentiel, les étudiants d’une de ces professions et autorisé à exercer sont inclus dans la catégorie Professionnel de santé

Ressource terminologique

Tous les objets "terminologie de référence", "nomenclature"ou "jeu de valeurs constituent une ressource terminologique qui possède un jeu de métadonnées permettant de l'identifier de façon univoque, de la nommer, de gérer ses versions successives, son statut, et de fournir d'autres informations contextuelles.

Savoir-faire

Il s’agit pour une personne de type professionnel de santé de :

- la qualification (pneumologie, médecine sportive...) ou l’orientation particulière (homéopathie…) reconnue par l’autorité d’enregistrement ;

- la spécialité de concours hospitalier dont une personne PH est lauréate (ex : cardiologie et maladies vasculaires) ;

- la spécialité de concours SSA qu’une personne militaire a obtenue (ex : bactériologie) pour un exercice professionnel.

SIRENE Système Informatique pour le Répertoire des ENtreprises et des Etablissements

SIREN

Le numéro SIREN est un identifiant de 9 chiffres attribué de manière nationale à chaque entreprise. Les huit premiers chiffres n’ont aucune signification sauf pour les organismes publics (communes, etc.) dont le numéro SIREN commence par 1 ou 2. Le neuvième chiffre est un chiffre de contrôle de validité du numéro.

SIRET

Le numéro SIRET d’identité d’un établissement est articulé en deux parties. La première est le numéro SIREN de l’entreprise (ou unité légale ou personne juridique) à laquelle appartient l’unité SIRET. La seconde, dénommée NIC (Numéro Interne de Classement), se compose d’un numéro d’ordre à 4 chiffres attribué à l’établissement et d’un chiffre de contrôle, qui permet de vérifier la validité de l’ensemble du numéro SIRET



Définitions

Statut juridique

(Source FINESS)

Chaque entité juridique est rattachée à un statut juridique qui caractérise la situation juridique de la personne morale. La nomenclature des statuts juridiques est une notion propre à FINESS. Les statuts juridiques sont eux-mêmes classifiés en grands agrégats qui sont :

Organismes et établissements publics o Etat et collectivités territoriales o Etablissement public

Organismes privés o Organisme privé à but non lucratif o Organisme privé à caractère commercial

Personne morale de droit étranger

Terminologie de référence

Ensemble de concepts codés maintenu par une organisation officiellement désignée. Chaque concept possède des propriétés parmi lesquelles on trouve au minimum son code et un libellé donnant sa signification en clair. La terminologie peut être une simple liste à plat de concepts sans relation entre eux, ou peut être plus complexe en comprenant des relations hiérarchiques (exemple des catégories d’établissement liées à des agrégats correspondant à des ensemble de catégories d’établissement) ou d'autres natures entre ses concepts.

La terminologie sert de source de vérité aux produits dérivés.

Exemple : professions, catégories d’établissement …

7.5.2 Abréviations

Plusieurs abréviations apparaissent dans ce document :

Abréviations

AE Autorité d’Enregistrement

ARS Agence Régionale de Santé

ASIP Santé Agence des Systèmes d’Information Partagés de Santé

ADELI « Automatisation Des Listes ».

CNAMTS Caisse Nationale d’Assurance Maladie des Travailleurs Salariés

CNIL Commission Nationale de l’Informatique et des Libertés

CPAM Caisse Primaire d’Assurance Maladie

CDE Carte de Directeur d’Etablissement

CPA Carte de Personnel Autorisé

CPE Carte de Personnel d’Etablissement

CPF Carte de Professionnel en Formation

CPS Carte de Professionnel de Santé

CPx Cartes CPA, CPS, CPF, CPE, CDE

CNOI Conseil National de l’Ordre des Infirmiers

CNOM Conseil National de l’Ordre des médecins

CNOP Conseil National de l’Ordre des Pharmaciens

CNOMK Conseil National de l’Ordre des Masseurs Kinésithérapeutes

CNOPP Conseil National de l’Ordre des pédicures podologues

DAM Données d’Assurance Maladie.

DGOS Direction Générale de l’Offre de Soins



Abréviations

DREES Direction de la Recherche, des Etudes, de l’Evaluation et des Statistiques

EJ Entité Juridique

EG Etablissement géographique (ET dans le vocabulaire FINESS ou EG dans le vocabulaire SIRENE)

ET Etablissement (ET dans le vocabulaire FINESS ou EG dans le vocabulaire SIRENE)

ESPIC Etablissements de santé privés d’intérêt collectif (anciennement Service Public Hospitalier)

FINESS Fichier National des Etablissements Sanitaires et Sociaux

FINESS EJ FINESS de l’entité juridique

FINESS ET FINESS de l’Etablissement géographique (A « ET » pour ETablissement issu de FINESS est préféré l’acronyme « EG » pour Etablissement géographique issu de SIRENE)

ID Identifiant

INSEE Institut National de la Statistique et des Etudes Economiques

ONCD Ordre National des Chirurgiens-Dentistes

PH Praticien Hospitalier

PM Personne Morale

PP Personne Physique

PS Professionnel de Santé

RPPS Répertoire Partagé des Professionnels de Santé

SIREN Système d’Identification de des Entreprises

SIRET Système d'Identification de des ETablissements

SSA Service de Santé des Armées

TR Terminologie de Référence

Plusieurs abréviations sont utilisées dans les descriptions des attributs et règles.

Abréviation Description

Paragraphe : Description détaillée de l’écran

Format

X(i) Champ alphanumérique avec entre parenthèse le nombre de caractères

N(i)

N (i, j)

Champ numérique avec entre parenthèses le nombre de chiffres suivi (i) ou du nombre de décimales si nécessaire (j)

Binaire (i) Champ binaire avec entre parenthèse le nombre de bits

DT(F) Champ de type date au format F

DT(AAAAMMJJ) Champ de type date au format AAAAMMJJ

DateTime Horodatage de type AAAAMMJJ:HH:MM:SS

LV (1,…, n) Champ appartient à une liste de valeurs de 1 à n



Abréviation Description

LD (Oui, Non) Liste de valeurs avec les valeurs admises Oui et Non

Paragraphe : Traitements métiers et contrôles

RAi Règle d'affichage suivie de son indice

Code

RMi Règle métier suivie de son indice

RCi Règle de contrôle suivie de son indice

Le document en général

S/O Sans objet

7.5.3 Liste des figures

Figure 1: Synoptique d’utilisation des web services .............................................................................. 12

Figure 2: Principe d’authentification et d’identification ........................................................................ 21

Figure 3: Corps de message pour la recherche de personnes physiques ............................................... 33

Figure 4: Corps de message pour la réponse du service de recherche de personnes physiques ........... 34

Figure 5:Structure Identifiant d’une personne physique ....................................................................... 36

Figure 6: Corps de message pour la consultation de personnes physiques ........................................... 40

Figure 7: Corps de message pour la réponse du service de consultation de personnes physiques ....... 41

Figure 8: Structure des résultats retournés par le service de consultation des personnes physiques ... 42

Figure 9: Structure message des résultats des personnes physiques non trouvées dans annuaire.sante.fr ................................................................................................................................... 43

Figure 10: Structure identité d’une personne physique ......................................................................... 44

Figure 11: Structure état civil d’une personne physique ....................................................................... 45

Figure 12: Structure coordonnées d’une personne physique ................................................................ 46

Figure 13: Structure étudiant d’une personne physique ....................................................................... 48

Figure 14: Structure autorisation de remplacement d’une personne physique .................................... 49

Figure 15: Structure d’une langue parlée par une personne physique .................................................. 49

Figure 16: Structure diplôme d’une personne physique ........................................................................ 50

Figure 17: Structure autre diplôme d’une personne physique .............................................................. 51

Figure 18: Structure autorisation d’une personne physique ................................................................. 52

Figure 19: Structure exercice professionnel d’une personne physique.................................................. 53

Figure 20: Structure situation praticien hospitalier d’un exercice professionnel .................................. 55

Figure 21: Structure d’une période de savoir-faire d’un exercice professionnel ................................... 56

Figure 22: Structure d’une sanction d’un exercice professionnel .......................................................... 57



Figure 23: Structure d’une attribution particulière d’un exercice professionnel ................................... 58

Figure 24: Structure d’un référencent d’auprès AE ............................................................................... 59

Figure 25: Structure d’une activité d’un exercice professionnel ............................................................ 61

Figure 26: Structure d’une carte CPS ..................................................................................................... 63

Figure 27: Corps de message pour la recherche de personnes morales ................................................ 66

Figure 28: Corps de message pour la réponse du service de recherche de personnes morales ............ 67

Figure 29: Structure Identifiant d’une personne morale ....................................................................... 69

Figure 30: Corps de message pour la consultation de personnes morales............................................ 73

Figure 31: Corps de message pour la réponse du service de consultation de personnes morales ........ 73

Figure 32: Structure des résultats retournés par le service de consultation des personnes morales .... 74

Figure 33: Structure message des résultats des personnes morales non trouvées dans annuaire.sante.fr ................................................................................................................................... 75

Figure 34: Structure d’une personne morale trouvée dans annuaire.sante.fr ...................................... 76

Figure 35: Structure d’une personne physique exerçant dans une structure ........................................ 79

Figure 36: Structure d’une entité géographique liée à une entité juridique ......................................... 80

7.5.4 Liste des tableaux

Tableau 1: Liste des web services .......................................................................................................... 13

Tableau 2: Protocoles et référence ........................................................................................................ 19

Tableau 3: Nommage des web services ................................................................................................ 19

Tableau 4: Eléments du WS-Adressing .................................................................................................. 24

Tableau 5: Descriptifs des attributs du jeton SAML 2.0......................................................................... 28

Tableau 6: Liste des valeurs possibles pour l’élément « Profil_Utilisateur » ......................................... 29

Tableau 7: Liste des valeurs de la terminologie de référence « Ordre » ............................................... 29

Tableau 8: Description d’un filtre de recherche pour les personnes physiques ..................................... 36

Tableau 9: Description des attributs Identifiant d’une personne physique ........................................... 36

Tableau 10: Description des infos complémentaires retournées par le service recherche des PP ........ 37

Tableau 11: Règles métiers appliquées aux critères pour le service recherche des PP ......................... 39

Tableau 12: Description des règles métiers du service recherche des PP .............................................. 40

Tableau 13: Description de la structure retournée par le service de consultation des PP .................... 43

Tableau 14: Description de la structure retournée par le service de consultation des PP .................... 43

Tableau 15: Description des attributs de l’identité d’une PP ................................................................ 44

Tableau 16: Description des attributs de l’état civil d’une PP ............................................................... 46

Tableau 17: Description des attributs coordonnés d’une PP ................................................................. 48

Tableau 18: Description des attributs de l’étudiant d’une PP ............................................................... 48

Tableau 19: Description des attributs Autorisation de remplacement d’une PP .................................. 49



Tableau 20: Description des attributs de Langue parlée d’une PP ........................................................ 50

Tableau 21: Description des attributs Diplôme d’une PP ...................................................................... 51

Tableau 22: Description des attributs Autre Diplôme Obtenu .............................................................. 52

Tableau 23: Description des attributs Autorisation d’une PP ................................................................ 53

Tableau 24: Description des attributs Exercice Professionnel d’une PP ................................................ 55

Tableau 25: Description des attributs Situation PH d’une PP ................................................................ 56

Tableau 26: Description des attributs Période de savoir-faire d’une PP ............................................... 57

Tableau 27: Description des attributs Attribution d’une PP .................................................................. 58

Tableau 28: Description des attributs Période Attribution Particulières d’une PP ................................ 59

Tableau 29: Description des attributs Référencement d’auprès AE d’une PP ....................................... 60

Tableau 30: Description des attributs Situation d’Exercice d’une PP .................................................... 63

Tableau 31: Description des attributs Carte CPS d’une PP .................................................................... 63

Tableau 32: Description des attributs Informations complémentaires retournées par le service de consultation des PP ............................................................................................................................... 64

Tableau 33: Description des règles métiers du service consultation des PP ......................................... 64

Tableau 34: Description des règles métiers du service de consultation des PP ..................................... 65

Tableau 35: Description u filtre de recherche pour les personnes morales ........................................... 69

Tableau 36: Description des attributs Identifiant d’une personne physique ......................................... 69

Tableau 37: Description des infos complémentaires retournées par le service recherche des PM ....... 70

Tableau 38: Règles métiers appliquées aux critères pour le service recherche des PM ........................ 71

Tableau 39: Description des règles métiers du service recherche des PM ............................................ 72

Tableau 40: Description de la structure retournée par le service de consultation des PM ................... 75

Tableau 41: Description de la structure retournée par le service de consultation des PM ................... 75

Tableau 42: Description des attributs de Structure d’une PM............................................................... 79

Tableau 43: Description des attributs des Personnes physiques d’une structure ................................. 80

Tableau 44: Description des attributs des établissements liés à une entité juridiques ......................... 80

Tableau 45: Informations complémentaires retournées par le service de consultation des PM .......... 81

Tableau 46: Règles métiers associées aux critères en entrée du service de consultation des PM ........ 81

Tableau 47: Règles métiers associées au service de consultation des PM ............................................ 82