This page is part of the HL7 BE patient dossier IG (v1.0.0: Release) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Patient Dossier

Official URL: https://www.ehealth.fgov.be/standards/fhir/patient-dossier/ImplementationGuide/hl7.fhir.be.patient-dossier				Version: 1.0.0
Active as of 2026-03-27				Computable Name: PatientDossier

Introduction

This implementation guide defines the Belgian FHIR profiles for Patient Dossier CareSets — standardized sets of clinical data that are specific to an individual patient and commonly used across care settings, without being transversal in nature.

A CareSet is a structured collection of clinical information designed for secure, standardized exchange between healthcare actors via the national eHealth infrastructure (Hubs & Vaults). Each CareSet defines a logical model, value sets, and business rules that ensure data can be shared, stored, and consulted in a traceable and reusable manner within integrated patient care.

The Patient Dossier CareSets cover clinical domains that are patient-centric — they capture data recorded in the context of a specific patient’s care journey. This distinguishes them from transversal resources (e.g. terminology, practitioner registries) that are shared across patients and contexts.

Scope

This guide covers the following Patient Dossier resources:

Resource	Description	Status
BeDocument (Logical Model)	Generic logical model for a FHIR document that structures and contains CareSets	Active
BeDocument (Bundle Profile)	Minimal document Bundle profile constraining the FHIR Bundle to a document containing a Composition and CareSet entries	Active

The BeDocument provides the generic envelope and structure for clinical documents. It does not contain clinical data itself but references and organises other CareSets into a meaningful, shareable, and traceable document. Examples include discharge summaries, referral letters, surgical reports, and consultation reports.

Content

This implementation guide contains the following types of resources:

• Logical Models — conceptual representations defining data elements, cardinalities, and descriptions independent of any specific FHIR resource. The BeDocument logical model describes the document structure with sections, entries, and metadata.
• Profiles — FHIR resource profiles constraining base resources to the Belgian context. The BeDocument Bundle profile constrains the FHIR Bundle to a document type containing a Composition and CareSet entries.
• Value Sets — coded value sets used within the CareSets, primarily based on SNOMED CT, LOINC, and FHIR standard code systems.

How to Read This Guide

• The Guidance page provides context on the methodology, conventions, and design principles used throughout this guide.
• The Artifacts page lists all profiles, extensions, and value sets defined in this guide.

Dependencies

This guide builds on:

• HL7 Belgium FHIR Core — foundational Belgian FHIR resources and extensions (e.g. Belgian Patient, Practitioner, Organization identifiers).

Authors and Contributors

This guide is published by the eHealth Platform as part of the BeSafeShare programme. For questions or feedback, contact message-structure@ehealth.fgov.be.

This is an R4 IG. None of the features it uses are changed in R4B, so it can be used as is with R4B systems. Packages for both R4 (hl7.fhir.be.patient-dossier.r4) and R4B (hl7.fhir.be.patient-dossier.r4b) are available.

There are no Global profiles defined

Parameter	Value
includeDesignations	true
system-version	SNOMED CT[BE]

This publication includes IP covered under the following statements.

• 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: BeDocument, BeModelDocument and PatientDossier