Guide d'implémentation FR Core
2.2.0-ballot - ballot

Guide d'implémentation FR Core, publié par Interop'Santé. Ce guide nest pas une publication autorisée ; cest la version en intégration continue pour la version 2.2.0-ballot construite par le CI Build FHIR (HL7® FHIR® Standard). Cette version est basée sur le contenu actuel de https://github.com/Interop-Sante/hl7.fhir.fr.core/ et change régulièrement. Voir le répertoire des versions publiées

Plain Language Summary goes here

## Accueil

Official URL: https://hl7.fr/ig/fhir/core/ImplementationGuide/hl7.fhir.fr.core | Version: 2.2.0-ballot
Active as of 2025-12-29 | Computable Name: FRCore

Profils, extensions, jeux de valeurs, et guides de mise en œuvre normalisant l'échange de données de santé : données administratives sur les patients, les professionnels de santé et les organisations, et les rencontres avec les patients (programmées ou effectives), ainsi que les signes vitaux en France.
Profiles, extensions, value sets, code systems and implementation guides standardizing the exchange of health data : administrative data about patients, health professionals and organization, and patient encounters (scheduled or effective), and vital sign in France

> Attention ! Cette version du guide d'implémentation est en concertation. La version officielle est accessible à l'adresse http://hl7.fr/ig/fhir/core</b>

Ce guide d’implémentation est fourni comme fondation pour l’utilisation de FHIR® en France. Il permet de définir les profils, les extensions et les jeux de valeurs normalisant l’échange de données administratives sur les patients, les professionnels de santé et les organisations, et les rencontres avec les patients (programmées ou effectives), les signes vitaux ainsi que les structures des établissements de soins.

### Le rôle du guide d’implémentation FHIR FR Core

L’objectif du guide d’implémentation FR Core est de garantir une base commune pour permettre une utilisation homogène du standard pour l’ensemble des implémentations FHIR en France (version de FHIR, extensions, identifiants, etc.). Pour cela, ce guide va par exemple indiquer comment modéliser un patient FHIR en France (contenant l’identifiant national de santé (INS)), un professionnel de santé (contenant l’identifiant national de professionnel de santé (IDNatPS)), …

Afin de garantir l’uniformité d’usage de FHIR en France, l’ensemble des implémentations FHIR et des guides d’implémentation doit se baser sur FR Core, comme c’est le cas pour les guides d’implémentation de l’Agence du Numérique en Santé (ANS) et d’InteropSanté (IS).

Dans les prochaines versions, FR Core sera également garant de la compatibilité européenne en héritant directement des profils HL7 Base Europe. Ces profils FR Core vont permettre de valider la conformité des instances FHIR sur les espaces de tests.

### Principes de modélisation et d’utilisation de FHIR FR Core

Les profils FHIR de ce guide d’implémentation sont volontairement peu contraignants afin de couvrir le plus grand nombre de cas d’usage et ainsi faciliter son adoption. Par conséquent, ce guide ne traite pas de cas d’usage spécifiques : il est donc recommandé de vérifier dans l’écosystème des guides d’implémentation si des guides plus spécialisés correspondant à votre cas d’usage existent.

Le guide d’implémentation FR Core, et FHIR de manière générale, offrent un large éventail de ressources, d’attributs et de paramètres de recherche. Toutefois, FHIR et FR Core n’imposent pas l’implémentation complète de toutes ces fonctionnalités. Il convient donc pour chaque cas d’usage d’identifier précisément les ressources, profils et les fonctionnalités d’API nécessaires.

Par exemple, l’API FHIR Annuaire Santé, une API ouverte basée sur FR Core, illustre une mise en œuvre concrète de ce guide. Sa documentation et son guide d’implémentation peuvent servir de référence.

### Champ d’application

Ce document présente les concepts d’utilisation français définis par :

- Profils - contraintes utiles des ressources et types de données FHIR essentiels pour l’utilisation en France.
- Extensions - extensions FHIR ajoutées pour un usage local, couvrant les concepts français nécessaires.
- Terminologies - systèmes de codes et ensembles de valeurs définis ou référencés pour la France.

Les activités de profilage donnent la priorité aux ressources ayant un niveau de maturité suffisant (>=3). Chaque sujet fonctionnel est traité par un groupe de travail dédié d’Interop’Santé, réunissant des éditeurs de logiciels, des professionnels des établissements de santé et des représentants d’agences gouvernementales. Le consensus sur les ressources de conformité FHIR est établi d’abord au niveau du groupe de travail, puis au niveau des membres.

### Choix de la version du standard FHIR

Pour garantir l’interopérabilité à l’échelle nationale, l’utilisation de FHIR R4 est recommandée pour l’ensemble des projets en France. Ainsi, ce guide d’implémentation FR Core est basé sur FHIR R4.

La stratégie sur le choix des versions FHIR a été définie au sein d’un groupe de travail organisé entre Interop’Santé et l’ANS en 2023/2024, validée via une concertation de l’ANS.

#### Nouveaux cas d’usages FHIR : privilégier FHIR R4 et anticiper la transition vers R6

Pour garantir la cohérence au sein de l’écosystème français et éviter tout problème de compatibilité dû à des travaux divergents, il est nécessaire d’utiliser une même version du standard FHIR à l’échelle nationale. Le choix a été fait de conserver FHIR R4 car il y a un existant conséquent en France et cela permet d’éviter des transitions entre version qui complexifierait l’écosystème

La version R6 de FHIR se veut être la version finale stable de FHIR. La décision d’une transition vers R6 dépendra du règlement de l’EEDS qui se dessine progressivement et qui pour l’heure semble se diriger vers R4.

Pour anticiper cette transition, il est jugé important d’être proactif sur les travaux internationaux de développement de R6 et d’anticiper les impacts pour l’écosystème français.

#### Ne pas créer de guide d’implémentation (IG) se basant sur une version différente de R4 sans analyse des normes et standards et des impacts

La priorité actuelle est de faire monter l’écosystème en compétences et de gagner en maturité sur les spécifications existantes. Créer des IGs R5 engendreraient une fragmentation de l’écosystème et un ralentissement de la mise en qualité de l’existant qui finirait par freiner l’adoption de FHIR.

Généralement, rajouter quelques extensions qui miment les attributs R5 s’avère suffisant pour éviter de créer tout un guide en R5. Dans certains cas, une autre version de FHIR peut être justifiée, par exemple si le cas d’usage concerne des échanges internationaux ou si le cas d’usage est significativement mieux couvert par une autre version. Le cas échéant, l’usage d’une autre version devra être validé par une étude des normes et standards publiée et validée par l’écosystème.

Dans certains cas non identifiés à ce jour, il pourrait également être nécessaire de maintenir des guides d’implémentation sous plusieurs versions. Après validation par l’écosystème de ce besoin, cela donnerait l’opportunité d’estimer des travaux de maintenance d’Implementation Guide (IG) sous plusieurs versions ainsi qu’un mapping associé pour gagner en expérience.

#### Priorité FHIR France en 2026+ - accompagner la croissance des usages de FHIR

Entre 2023 et 2025 des travaux structurants de mise en qualité des spécifications FHIR sous forme de guide d’implémentation ont eu lieu.

En 2026, FHIR change d’échelle avec l’arrivée de l’espace européen des données de santé (EEDS), les travaux d’HL7 Europe, et les groupes de travail français qui portent les standards historiques en FHIR (PN-13, PAM, …).

Cette multiplication des usages de FHIR ne vient pas sans risques : il faut s’assurer de la cohérence globale de l’écosystème FHIR national.

En parallèle, ces tâches de fond restent valables :

- La montée en compétences et l’acculturation des développeurs et des chefs de projets aux bonnes pratiques d’usages de FHIR, notamment en organisant des évènements par l'ANS et InteropSanté : projectathon, webinaires, formations, ...
- Amélioration continue des guides d’implémentation existants pour assurer la faisabilité d'implémentation (amélioration du contenu narratif pour expliquer comment utiliser les ressources, s’assurer de la facilité d’accès au contenu, s'assurer que les IGs soient bien connus …).
- Prise en main des outils de mapping tel que le FHIR Mapping Language afin d'assurer une transition maîtrisée entre standards.

### Gouvernance

Le guide d’implémentation FR Core est géré par HL7 France et IHE France au sein du comité technique FHIR de HL7 France.

### Dépendances

IG | Package | FHIR | Comment
--- | --- | --- | ---
Guide d'implémentation FR Core | hl7.fhir.fr.core#2.2.0-ballot | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#7.0.1 | R4 | Automatically added as a dependency - all IGs depend on HL7 Terminology
FHIR Extensions Pack | hl7.fhir.uv.extensions.r4#5.2.0 | R4 |
Terminologies de Santé | ans.fr.terminologies#1.4.0 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#6.5.0 | R4 |
International Patient Summary Implementation Guide | hl7.fhir.uv.ips#1.1.0 | R4 |
HL7 Terminology (THO) | hl7.terminology.r4#5.0.0 | R4 |
fhir.dicom | fhir.dicom#2022.4.20221006 | R4 |
FHIR Tooling Extensions IG | hl7.fhir.uv.tools.r4#0.9.0 | R4 | for example references

Package hl7.fhir.uv.extensions.r4#5.2.0 This IG defines the global extensions - the ones defined for everyone. These extensions are always in scope wherever FHIR is being used (built Mon, Feb 10, 2025 21:45+1100+11:00)

Package hl7.fhir.uv.ips#1.1.0 International Patient Summary (IPS) FHIR Implementation Guide (built Tue, Nov 22, 2022 03:24+0000+00:00)

Package ans.fr.terminologies#1.4.0 Les nomenclatures des objets de Santé sont mises à disposition du secteur santé-social par l’agence du numérique en santé (built Mon, Nov 3, 2025 13:37+0000+00:00)

Package hl7.fhir.uv.tools.r4#0.9.0 This IG defines the extensions that the tools use internally. Some of these extensions are content that are being evaluated for elevation into the main spec, and others are tooling concerns (built Tue, Dec 16, 2025 23:18+1100+11:00)

### Propriété intellectuelle

Certaines ressources sémantiques de ce guide sont protégées par des droits de propriété intellectuelle couverte par les déclarations ci-dessous. L’utilisation de ces ressources est soumise à l’acceptation et au respect des conditions précisées dans la licence d’utilisation de chacune d’entre elle.

- ISO maintains the copyright on the country codes, and controls its use carefully. For further details see the ISO 3166 web page: https://www.iso.org/iso-3166-country-codes.html
  Show Usage
  - ISO 3166-1 Codes for the representation of names of countries and their subdivisions — Part 1: Country code: FRCore, FRCoreAddressInseeCodeExtension... Show 124 more, FRCoreAddressProfile, FRCoreAppointmentOperatorExtension, FRCoreAppointmentProfile, FRCoreAssemblyOrderExtension, FRCoreCodeSystemCirconstancesSortie, FRCoreCodeSystemContactRelationship, FRCoreCodeSystemIdentifierType, FRCoreCodeSystemLocationIdentifierType, FRCoreCodeSystemLocationPhysicalType, FRCoreCodeSystemLocationPositionRoom, FRCoreCodeSystemLocationType, FRCoreCodeSystemMaritalStatus, FRCoreCodeSystemMethodCollection, FRCoreCodeSystemModeValidationIdentite, FRCoreCodeSystemReliabilityIdentity, FRCoreCodeSystemScheduleType, FRCoreCodeSystemTypeAdmission, FRCoreCodeSystemTypesOrganisations, FRCoreCodeSystemv2_0203, FRCoreCodeSystemv2_0445, FRCoreCodeSystemv2_3307, FRCoreCodeSystemv2_3311, FRCoreCommentExtension, FRCoreContactPointEmailTypeExtension, FRCoreContactPointProfile, FRCoreEncounterEstimatedDischargeDateExtension, FRCoreEncounterProfile, FRCoreHealthcareServiceProfile, FRCoreHumanNameProfile, FRCoreLocationPartOfPositionRoomExtension, FRCoreLocationProfile, FRCoreLunarDateExtension, FRCoreMedicationAdministrationInhaledOxygenProfile, FRCoreNationalityExtension, FRCoreObservationBmiProfile, FRCoreObservationBodyHeightProfile, FRCoreObservationBodyPositionExtExtension, FRCoreObservationBodyTemperatureProfile, FRCoreObservationBodyWeightProfile, FRCoreObservationBpProfile, FRCoreObservationHeadCircumProfile, FRCoreObservationHeartRateProfile, FRCoreObservationHeightBodyPositionExtension, FRCoreObservationLevelOfExertionExtension, FRCoreObservationOxygenSaturationProfile, FRCoreObservationRespRateProfile, FRCoreOrganizationActivityFieldExtension, FRCoreOrganizationActivityTypeExtension, FRCoreOrganizationAnalysisSectionExtension, FRCoreOrganizationApplicantActExtension, FRCoreOrganizationBudgetLetterExtension, FRCoreOrganizationDescriptionExtension, FRCoreOrganizationExecutantExtension, FRCoreOrganizationExternalExtension, FRCoreOrganizationFieldExtension, FRCoreOrganizationPoleProfile, FRCoreOrganizationPrestationDisciplineExtension, FRCoreOrganizationProfile, FRCoreOrganizationShortNameExtension, FRCoreOrganizationTotalNumberOfTheoricalAccomodationSpaceExtension, FRCoreOrganizationUACProfile, FRCoreOrganizationUFProfile, FRCorePatientBirthDateUpdateIndicatorExtension, FRCorePatientBirthListGivenName, FRCorePatientContactIdentifierExtension, FRCorePatientDeathPlaceExtension, FRCorePatientINSProfile, FRCorePatientIdentityReliabilityExtension, FRCorePatientMultipleBirthExtension, FRCorePatientProfile, FRCorePractitionerProfile, FRCorePractitionerRoleProfile, FRCorePractitionerSpecialtyExtension, FRCoreRelatedPersonProfile, FRCoreScheduleAvailabilityTimeExtension, FRCoreScheduleProfile, FRCoreServiceTypeDurationExtension, FRCoreSlotProfile, FRCoreUsePeriodExtension, FRCoreValueSetAvailabilityTimeRule, FRCoreValueSetBPMeasurementMethod, FRCoreValueSetBloodPressureMeasurementBodyLocation, FRCoreValueSetBloodPressureMeasurementMethod, FRCoreValueSetBodyPosition, FRCoreValueSetBodyTemperatureMeasurementBodyLocation, FRCoreValueSetCOGCommunePays, FRCoreValueSetContactRelationship, FRCoreValueSetEmailType, FRCoreValueSetEncounterClass, FRCoreValueSetEncounterDischargeDisposition, FRCoreValueSetEncounterIdentifierType, FRCoreValueSetEncounterType, FRCoreValueSetHeartRateMeasurementBodyLocation, FRCoreValueSetHeartRateMeasurementMethod, FRCoreValueSetHeightBodyPosition, FRCoreValueSetHeightMeasurementMethod, FRCoreValueSetINSEECode, FRCoreValueSetIdentityMethodCollection, FRCoreValueSetIdentityReliabilityStatus, FRCoreValueSetLocationIdentifierType, FRCoreValueSetLocationPhysicalType, FRCoreValueSetLocationPositionRoom, FRCoreValueSetLocationType, FRCoreValueSetMaritalStatus, FRCoreValueSetModeValidationIdentity, FRCoreValueSetModeValidationIdentityINS, FRCoreValueSetOrganizationActivityField, FRCoreValueSetOrganizationIdentifierType, FRCoreValueSetOrganizationType, FRCoreValueSetOrganizationUFActivityField, FRCoreValueSetPatientContactRole, FRCoreValueSetPatientGender, FRCoreValueSetPatientIdentifierType, FRCoreValueSetPatientIdentifierUseINS, FRCoreValueSetPatientIdentifierUsePI, FRCoreValueSetPatientRelationType, FRCoreValueSetPractitionerIdentifierType, FRCoreValueSetPractitionerRoleExercice, FRCoreValueSetPractitionerSpecialty, FRCoreValueSetRespiratoryRateMeasurementMethod, FRCoreValueSetSPO2BodyLocation, FRCoreValueSetScheduleType, FRCoreValueSetTitle and FRCoreValueSetUnavailabilityReason
- The UCUM codes, UCUM table (regardless of format), and UCUM Specification are copyright 1999-2009, Regenstrief Institute, Inc. and the Unified Codes for Units of Measures (UCUM) Organization. All rights reserved. https://ucum.org/trac/wiki/TermsOfUse
  Show Usage
  - Unified Code for Units of Measure (UCUM): Observation/FRCoreObservationBMIExample, Observation/FRCoreObservationBPExample... Show 5 more, Observation/FRCoreObservationBodyHeightExample, Observation/FRCoreObservationBodyTemperatureExample, Observation/FRCoreObservationBodyWeightExample, Observation/FRCoreObservationHeadCircumExample and Observation/FRCoreObservationHeartRateExample
- This material contains content from LOINC. LOINC is copyright © 1995-2020, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.
  Show Usage
  - LOINC: Observation/FRCoreObservationBMIExample, Observation/FRCoreObservationBPExample... Show 5 more, Observation/FRCoreObservationBodyHeightExample, Observation/FRCoreObservationBodyTemperatureExample, Observation/FRCoreObservationBodyWeightExample, Observation/FRCoreObservationHeadCircumExample and Observation/FRCoreObservationHeartRateExample
- This material contains content that is copyright of SNOMED International. Implementers of these specifications must have the appropriate SNOMED CT Affiliate license - for more information contact https://www.snomed.org/get-snomed or info@snomed.org.
  Show Usage
  - SNOMED Clinical Terms&reg; (SNOMED CT&reg;): FRCoreObservationBodyHeightProfile, FRCoreObservationBodyPositionExtExtension... Show 18 more, FRCoreObservationBodyTemperatureProfile, FRCoreObservationBpProfile, FRCoreObservationHeartRateProfile, FRCoreObservationHeightBodyPositionExtension, FRCoreObservationOxygenSaturationProfile, FRCoreObservationRespRateProfile, FRCoreValueSetBPMeasurementMethod, FRCoreValueSetBloodPressureMeasurementBodyLocation, FRCoreValueSetBloodPressureMeasurementMethod, FRCoreValueSetBodyPosition, FRCoreValueSetBodyTemperatureMeasurementBodyLocation, FRCoreValueSetHeartRateMeasurementBodyLocation, FRCoreValueSetHeartRateMeasurementMethod, FRCoreValueSetHeightBodyPosition, FRCoreValueSetHeightMeasurementMethod, FRCoreValueSetRespiratoryRateMeasurementMethod, FRCoreValueSetSPO2BodyLocation and Observation/FRCoreObservationBPExample
- This material derives from the HL7 Terminology (THO). THO is copyright ©1989+ Health Level Seven International and is made available under the CC0 designation. For more licensing information see: https://terminology.hl7.org/license.html
  Show Usage
  - Discharge disposition: FRCoreEncounterProfile and FRCoreValueSetEncounterDischargeDisposition
  - HL7 Terminology Maintenance Infrastructure Vocabulary: FRCoreCodeSystemModeValidationIdentite
  - HumanNameAssemblyOrder: FRCoreAssemblyOrderExtension
  - Observation Category Codes: Observation/FRCoreObservationBMIExample, Observation/FRCoreObservationBPExample... Show 5 more, Observation/FRCoreObservationBodyHeightExample, Observation/FRCoreObservationBodyTemperatureExample, Observation/FRCoreObservationBodyWeightExample, Observation/FRCoreObservationHeadCircumExample and Observation/FRCoreObservationHeartRateExample
  - Service category: Service de cardiologie
  - Service type: Appointment/FRCoreAppointmentExample, FRCoreServiceTypeDurationExtension, Schedule/FRCoreScheduleExample and Slot/FRCoreSlotExample
  - admissionType: FRCoreEncounterProfile and FRCoreValueSetEncounterType
  - contactRole2: FRCorePatientProfile, FRCoreRelatedPersonProfile, FRCoreValueSetContactRelationship and FRCoreValueSetPatientContactRole
  - identifierType: FRCorePatientINSProfile, FRCorePatientProfile, FRCorePractitionerProfile, FRCoreValueSetPatientIdentifierType and FRCoreValueSetPractitionerIdentifierType
  - nameAssemblyOrder: FRCoreAssemblyOrderExtension
  - ActCode: Encounter/FRCoreEncounterExample and FRCoreValueSetEncounterClass
  - MaritalStatus: FRCorePatientProfile and FRCoreValueSetMaritalStatus
  - NullFlavor: FRCoreAssemblyOrderExtension, FRCorePatientProfile and FRCoreValueSetMaritalStatus
  - ObservationInterpretation: Observation/FRCoreObservationBMIExample and Observation/FRCoreObservationBPExample

### Analyse inter-version

Ceci est un IG R4. Aucune des fonctionnalités quil utilise nest modifiée dans R4B, il peut donc être utilisé tel quel avec les systèmes R4B. Les packages pour R4 (hl7.fhir.fr.core.r4) et R4B (hl7.fhir.fr.core.r4b) sont disponibles.

### Profils internationaux

There are no Global profiles defined