EHDS Logical Models to FHIR Profiles Mapping

Ongoing alignment:The models are expected to continue evolving, with updates incorporated into this Implementation Guide to maintain alignment with the EHDS Implementing Acts.

EHDS Logical Models → FHIR Profiles

The Xt-EHR Joint Action defines EHDS logical data models for core clinical and administrative concepts. This Implementation Guide provides HL7 FHIR profiles that realise those models.

The sections below group the EHDS logical models into categories.

Each table shows:

the logical model
the FHIR datatype or profile(s) used in this IG
a link to the detailed element-by-element mapping

🧩 Foundational Models

EHDS Logical Model	FHIR Profile / Type in this IG	Mapping Details
EHDSAddress	`AddressEu`	EHDSAddress Mapping
EHDSHumanName	`HumanName`	EHDSHumanName Mapping
EHDSTelecom	`ContactPoint`	EHDSTelecom Mapping

🧑‍⚕️ Entity Models

EHDS Logical Model	FHIR Profile / Type in this IG	Mapping Details
EHDSPatient	`PatientEuCore`	EHDSPatient Mapping
EHDSHealthProfessional	`PractitionerRoleEuCore` , `PractitionerEuCore`	EHDSHealthProfessional Mapping
EHDSOrganisation	`OrganizationEuCore`	EHDSOrganisation Mapping
EHDSLocation	`LocationEuCore`	EHDSLocation Mapping
EHDSBodyStructure	`BodyStructureEuCore`	EHDSBodyStructure Mapping

🩺 Clinical Information Models

EHDS Logical Model	FHIR Profile / Type in this IG	Mapping Details
EHDSAlert	`FlagPatientEuCore`	EHDSAlert Mapping
EHDSAllergyIntolerance	`AllergyIntoleranceEuCore`	EHDSAllergyIntolerance Mapping
EHDSCondition	`ConditionEuCore`	EHDSCondition Mapping
EHDSObservation †	`MedicalTestResultEuCore`	EHDSObservation Mapping
EHDSProcedure	`ProcedureEuCore`	EHDSProcedure Mapping
EHDSImmunisation	`ImmunizationEuCore`	EHDSImmunisation Mapping

📄 Document Models

EHDS Logical Model	FHIR Profile / Type in this IG	Mapping Details
EHDSDocument †	`CompositionEuCore`	EHDSDocument Mapping (Composition)
EHDSDocument †	`DiagnosticReportEuCore`	EHDSDocument Mapping (DiagnosticReport)

💊 Medication Models

EHDS Logical Model	FHIR Profile / Type in this IG	Mapping Details
EHDSMedication	`MedicationEuCore`	EHDSMedication Mapping
EHDSMedicationUse	`MedicationStatementEuCore`	EHDSMedicationUse Mapping

† Mapping with additional clarification note below.

Scope Clarifications:

The mapping EHDSObservation → MedicalTestResultEuCore does not apply to every kind of Observation. Not all observations are medical test results; for example, social history observations are Observation resources but are outside the MedicalTestResult scope.
EHDSDocument is represented as CompositionEuCore when modelling the structured clinical document composition; it is represented as DiagnosticReportEuCore when modelling report-oriented diagnostic content and results.