EU Health Data API
0.1.0 - ci-build
150
EU Health Data API, published by HL7 Europe. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/bvdh/jwg-api/ and changes regularly. See the Directory of published versions
Contents:
This page provides a list of the FHIR artifacts defined as part of this implementation guide.
The following artifacts define the types of individuals and/or systems that will interact as part of the use cases covered by this implementation guide.
| EEHRxF Document Access Provider |
The Document Access Provider actor provides access to EEHRxF FHIR Documents by receiving documents from Document Producers and serving them to Document Consumers. This composite actor groups MHD Document Recipient, MHD Document Responder, PDQm Patient Demographics Supplier, and IUA Authorization Server/Resource Server. See Document Access Provider CapabilityStatement for technical requirements. |
| EEHRxF Document Consumer |
The Document Consumer actor consumes EEHRxF FHIR Documents by querying a Document Access Provider. This composite actor groups MHD Document Consumer, PDQm Patient Demographics Consumer, and IUA Authorization Client. See Document Consumer CapabilityStatement for technical requirements. |
| EEHRxF Document Producer |
The Document Producer actor produces EEHRxF FHIR Documents and publishes them to a Document Access Provider. This composite actor groups MHD Document Source, PDQm Patient Demographics Consumer, and IUA Authorization Client. See Document Producer CapabilityStatement for technical requirements. |
| EEHRxF Grouped Document Producer/Access Provider |
The grouped Document Producer/Access Provider actor represents a deployment where document production and access provision are co-located in the same system. In this configuration, document submission (ITI-65) is internal and only document query/retrieval (ITI-67, ITI-68) is exposed externally. This is common for hospital EHR systems that produce and serve their own documents. See Grouped Document Producer/Access Provider CapabilityStatement for technical requirements. |
| EEHRxF Resource Access Provider |
The Resource Access Provider actor provides access to FHIR resources following IPA and QEDm patterns. This enables direct resource access complementing document-based exchange. This composite actor groups QEDm Clinical Data Source, IPA Server, PDQm Patient Demographics Supplier, and IUA Authorization Server/Resource Server. See Resource Access Provider CapabilityStatement for technical requirements. |
| EEHRxF Resource Consumer |
The Resource Consumer actor queries for clinical data resources from a Resource Access Provider following IPA and QEDm patterns. This composite actor groups QEDm Clinical Data Consumer, IPA Client, PDQm Patient Demographics Consumer, and IUA Authorization Client. See Resource Consumer CapabilityStatement for technical requirements. |
The following artifacts define the specific capabilities that different types of systems are expected to have in order to comply with this implementation guide. Systems conforming to this implementation guide are expected to declare conformance to one or more of the following capability statements.
| EEHRxF Document Access Provider CapabilityStatement |
CapabilityStatement for the EEHRxF Document Access Provider actor. This composite actor provides access to EEHRxF FHIR Documents by receiving documents from Document Producers and serving them to Document Consumers. Actor GroupingThis composite actor groups the following IHE actors:
Transactions
SecuritySystems SHALL support SMART Backend Services authorization for all transactions. DeploymentThe Document Access Provider may be grouped with Document Producer, in which case the ITI-65 transaction becomes internal. See the grouped Document Producer/Access Provider CapabilityStatement for this deployment pattern. |
||||||||||||||||||
| EEHRxF Document Consumer CapabilityStatement |
CapabilityStatement for the EEHRxF Document Consumer actor. This composite actor consumes EEHRxF FHIR Documents by querying a Document Access Provider. Actor GroupingThis composite actor groups the following IHE actors: Transactions
SecuritySystems SHALL support SMART Backend Services authorization for all transactions. |
||||||||||||||||||
| EEHRxF Document Producer CapabilityStatement |
CapabilityStatement for the EEHRxF Document Producer actor. This composite actor produces EEHRxF FHIR Documents and publishes them to a Document Access Provider. Actor GroupingThis composite actor groups the following IHE actors: Transactions
SecuritySystems SHALL support SMART Backend Services authorization for all transactions. DeploymentThe Document Producer may be grouped with Document Access Provider, in which case the ITI-65 transaction becomes internal and is not exposed externally. See the grouped Document Producer/Access Provider CapabilityStatement for this deployment pattern. |
||||||||||||||||||
| EEHRxF Grouped Document Producer/Access Provider CapabilityStatement |
CapabilityStatement for the grouped EEHRxF Document Producer and Document Access Provider actors. This represents a deployment where document production and access provision are co-located in the same system. Deployment PatternThis CapabilityStatement applies when:
In this grouped deployment, the ITI-65 Provide Document Bundle transaction is internal to the system and not exposed externally. The external API provides only document discovery (ITI-67) and retrieval (ITI-68) capabilities. Actor GroupingThis grouped actor combines:
The underlying IHE actors are:
Note: MHD Document Recipient is not listed because ITI-65 is internal. External Transactions
SecuritySystems SHALL support SMART Backend Services authorization for all transactions. When to Use This CapabilityStatementUse this CapabilityStatement when implementing:
For systems that need to receive documents from external sources, use the separate Document Access Provider CapabilityStatement which includes ITI-65 support. |
||||||||||||||||||
| EEHRxF Resource Access Provider CapabilityStatement |
CapabilityStatement for the EEHRxF Resource Access Provider actor. This actor serves clinical data resources following the International Patient Access (IPA) patterns and IHE QEDm Clinical Data Source capabilities. This CapabilityStatement defines the capabilities for systems providing direct resource access (beyond document-based exchange) in the EU EHR Exchange Format (EEHRxF) ecosystem. It inherits patterns from:
Supported Resources
SecuritySystems SHALL support SMART Backend Services authorization for all transactions. Profile InheritanceResources SHOULD conform to EU Core profiles where available. |
||||||||||||||||||
| EEHRxF Resource Consumer CapabilityStatement |
CapabilityStatement for the EEHRxF Resource Consumer actor. This actor queries for clinical data resources following the International Patient Access (IPA) patterns and IHE QEDm Clinical Data Consumer capabilities. This CapabilityStatement defines the requirements for systems consuming direct resource access (beyond document-based exchange) in the EU EHR Exchange Format (EEHRxF) ecosystem. It inherits patterns from:
Supported Resources
SecuritySystems SHALL support SMART Backend Services authorization for all transactions. Profile InheritanceConsumers SHOULD expect resources conforming to EU Core profiles where available. |
These define constraints on FHIR resources for systems conforming to this implementation guide.
| EEHRxF MHD DocumentReference Profile |
Profile for DocumentReference resources used in the EEHRxF context, based on the IHE MHD Minimal DocumentReference profile. Search Strategy:
See Document Exchange for query examples. |
These define constraints on FHIR data types for systems conforming to this implementation guide.
| Extension: SupportedIdentifier |
This extension indicates that a specific identifier system is supported by the server for a given resource type and parties querying for corresponding resources (i.e. Patients,…) are recommended searching for this identifier. |
These define sets of codes used by systems conforming to this implementation guide.
| EEHRxF Document Priority Category ValueSet |
ValueSet for priority document categories in EEHRxF as the document categories as defined in the EHDS regulation. See EEHRxFDocumentPriorityCategoryCS for the complete list and background. |
| EEHRxF Document Type ValueSet |
Document type codes for clinical precision in document identification. This ValueSet contains LOINC codes for specific document types used in DocumentReference.type. Unlike category (coarse search), type provides clinical precision for identifying exact document kinds. Usage Pattern:
MVP Document Types (Priority Categories):
Note: This list will expand as additional priority categories are implemented. JFM: This ValueSet should be made up of other ValueSets, with each of them assigned to one of the priority categories. Thus it is clear what document types are within each category. Is this the place to find all of them? https://confluence.hl7.org/spaces/HEU/pages/358255737/Implementation+Guides |
These define new code systems used by systems conforming to this implementation guide.
| EEHRxF Document Priority Category CodeSystem |
CodeSystem for priority document categories in EEHRxF as the document categories as defined in the EHDS regulation. The codes defined here are directly linked to the Priority Categories defined in the EHDS regulation. The meaning of these codes is directly linked to the meaning given to the concepts in the EHDS regulation. The EHDS Regulation initially defines six priority categories of electronic health data that all Member States must support first for cross-border primary use. These categories are explicitly listed in Article 14 of Regulation (EU) 2025/327. Article 105 specifies the date when support for these priority categories is required: 26 March 2029 for categories (a), (b) and (c); 28 March 2031 for (d), (e) and (f). EHDS empowers the EU Commission to make changes to the list of priority categories at any point in time by means of a Delegated Act (Article 14(2)). There will be a minimum 1-year lead time between the decision to add a new priority category and the initial date when support ahs to be implemented. The definitions of the priority categories comes from ANNEX I of the EHDS Regulation. |