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

Guide d'implémentation Fr Core, published by Interop'Santé. This guide is not an authorized publication; it is the continuous build for version 2.2.0-ballot built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Interop-Sante/hl7.fhir.fr.core/ and changes regularly. See the Directory of published versions

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-11-18 | Computable Name: FrCore

Profils, extensions, jeux de valeurs, et guides de mise en œuvre 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), ainsi que les signes vitaux en France.
Profiles, extensions, value sets, code systems and implementation guides standardizing the exchange of 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 pour validation. La version officielle est accessible à l'adresse http://hl7.fr/ig/fhir/core</b>

Ce guide de mise en œuvre est fourni pour soutenir 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), ainsi que les signes vitaux.

Les profils FHIR de ce guide d’implémentation sont volontairement très peu contraignants et ne répondent pas à des cas d’usages spécifiques, l’objectif de ce guide d’implémentation est de proposer un socle commun pour l’ensemble des échanges de données utilisant le standard FHIR en France. Par exemple, ce guide indique comment modéliser un patient FHIR en France (contenant l’identifiant national de santé (INS)), le professionnel de santé (contenant l’identifiant national de professionnel de santé (IDNatPS)), …

Ainsi, on y retrouve :

- Les ressources essentielles profilées pour la France
- Les extensions nécessaires à l’utilisation locale en France.

### 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

Le Guide d’implémentation FR Core est basé sur la version Release 4 de HL7 FHIR et définit l’ensemble minimum de contraintes sur les ressources FHIR pour créer les profils FR Core. Elles font référence à un certain nombre de ressources du standard ainsi qu’aux spécifications de l’API REST FHIR, basées sur le protocole HTTP. Les syntaxes retenues sont la syntaxe XML et JSON.

En établissant la “base” des normes pour promouvoir l’interopérabilité et l’adoption par le biais d’une mise en œuvre commune, il permet une évolution ultérieure de l’élaboration des normes pour des cas d’utilisation spécifiques.

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 adressés par Interop’Santé et l’ANS : privilégier FHIR R4 et anticiper la transition vers R6

Pour garantir la cohérence au sein de l’écosystème français, éviter tout problème de compatibilité ainsi que les 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 une double transition R4 vers R5 et R5 vers R6 qui aurait un coût non négligeable. Ce choix est conforté car la release 6 se veut être la version finale stable de FHIR, une transition vers R6 se voudra de toute manière nécessaire. 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. Il est également à noter que le choix national de la version FHIR utilisée devra être en accord avec le règlement de l’EEDS qui se dessine progressivement et qui pour l’heure semble se diriger vers R4.

#### Ne pas créer de guide d’implémentation (IG) se basant sur R5 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 2025+ - améliorer la qualité de l’existant

De nombreux travaux ont été menés en 2023 pour mettre en qualité les spécifications FHIR et encourager leur déploiement, tel que le passage au format IG et la mise à jour des tests et validateurs gazelle.

Les priorités des prochaines années sont de continuer dans cette direction :

- 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, ...
- S’assurer de la faisabilité d’implémentation des IGs existants (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 vers une autre version de FHIR.
- Anticiper les prochaines évolutions internationales : passage au FHIR Document dans le cadre du règlement européen, anticiper la transition vers FHIR R6, ...

Il est également nécessaire de rester à l’écoute des tendances internationales en interopérabilité et de se garder la possibilité de réitérer l’analyse si le besoin ou le contexte international évolue, en particulier l’EEDS.

### 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.

### Auteurs et contributeurs

Role | Nom | Organisation
--- | --- | ---
Auteur | Nicolas Riss | Agence du Numérique en Santé
Auteur | Yohann Poiron | Agence du Numérique en Santé
Contributeur | Marie Brulliard | Kereval
Contributeur | Sylvain Demey | Agence du Numérique en Santé
Contributeur | Isabelle Gibaud | Agence du Numérique en Santé

### 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.0 | 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.8.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.8.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, Aug 5, 2025 20:09+1000+10: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.

- Copyright HL7. Licensed under creative commons public domain
  Show Usage
  - admissionType: FRCoreEncounterProfile and FRCoreValueSetEncounterType
  - contactRole2: FRCorePatientProfile, FRCoreRelatedPersonProfile, FRCoreValueSetContactRelationship and FRCoreValueSetPatientContactRole
  - nameAssemblyOrder: FRCoreAssemblyOrderExtension
- 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: FRCoreAddressInseeCodeExtension, FRCoreAddressProfile... Show 124 more, 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, FRCoreValueSetUnavailabilityReason and FrCore
- 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
  - identifierType: FRCorePatientINSProfile, FRCorePatientProfile, FRCorePractitionerProfile, FRCoreValueSetPatientIdentifierType and FRCoreValueSetPractitionerIdentifierType
  - 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