v2.0.0 draft

eReferral Implementation Guide
2.0.0 - Belgium flag

eReferral Implementation Guide, published by Riziv-Inami Platform. This guide is not an authorized publication; it is the continuous build for version 2.0.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/hl7-be/referral-uhmep/ and changes regularly. See the Directory of published versions

Changes

This page documents the changes to the eReferral Implementation Guide specification.

2026-08-05 — v2.0.0 Release: eReferral Referral Prescription (STU1) — FHIR R4

Cookbook integration

The legacy eReferral API cookbook (UHMEP_API_cookbook.pdf) has been fully integrated into this Implementation Guide. This IG now supersedes the cookbook and serves as the single source of truth for integrators.

Nursing support

Profiling

New nursing profiles to add constraints on nursing prescriptions and Annex 81 proposals:

Mapping tables

Field-by-field mapping tables have been added for every prescription type, showing exactly how business concepts map to FHIR:

Radiology (Diagnostic Imaging) support

Profiling

New profiles and operations enable prescription and management of radiology exams:

New radiology-specific operations

Three new operations handle specific parts of radiology prescription workflows:

  1. Accept a Radiology Prescription — confirms the requested exam and readiness to perform the exam
  2. Substitute a Radiology Exam — replaces the exam (e.g., CT instead of X-ray)
  3. Refuse a Radiology Exam — declines to perform the requested exam
Mapping tables for integrators

Field-by-field mapping table has been added for radiology prescription, showing exactly how business concepts map to FHIR:

Machine-to-Machine (M2M) integration

The following operations have been expanded to support M2M workflows:

  1. Create Medical Document — now supports creation of a medical document, prescription or proposal, by an internal professional of an organization
  2. Assign Care Provider — expanded to:
    • Assign to an organization (BeOrganizationTask)
    • Assign to an internal professional within an organization (BePerformerTask)
  3. Record Execution Start — now supports initiation by an internal professional of an organization via POST
  4. Unassign Care Provider — operation to withdraw assignments of an organization or internal professional from a prescription
  5. Evaluate Proposal — now supports evaluation by an internal professional of an organization
  6. Evaluate Radiology Prescription — supports evaluation by an internal professional of an organization

Security & privacy

Reference materials