Digital Referral Prescription Implementation Guide
1.0.0 - STU Belgium flag

Digital Referral Prescription Implementation Guide, published by eHealth Platform. This guide is not an authorized publication; it is the continuous build for version 1.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/ and changes regularly. See the Directory of published versions

Data Models

Data models

Every referral prescription in this guide shares a single, common data model and is expressed as a specialization of it. This page shows how those models relate.

The common model

At the base sits the FHIR ServiceRequest resource. On top of it, BeReferralPrescription — realized as the BeReferralServiceRequest profile — is the common referral prescription model. It captures everything every referral prescription shares: identification, patient and requester, the requested care (code) and its discipline, validity period, status and status reason, notes, feedback, and the links to other requests (basedOn, replaces).

It is deliberately generic — not tied to a single use case. Specific use cases derive from it (Parent: BeReferralServiceRequest) and add only the rules that make them distinct; the common structure is inherited, never repeated.

BeReferralPrescriptionidentifier 1..1 IdentifiershortCode 1..1 CodeableConceptrecordedDate 1..1 dateTimecreationDate 1..1 dateTimepatient 1..1 Identifierauthor 1..1 Identifierstatus 1..1 CodeableConceptstatusReason 0..1 CodeableConceptcareRequested 1..1 CodeableConceptdiscipline 1..1 CodeableConceptdescription 0..1 CodeableConcepttype 1..1 CodeableConceptoriginRequestId 0..1 IdentifiervalidityStartDate 1..1 dateTimevalidityEndDate 1..1 dateTimeproblem 0..* CodeableConceptbodyLocation 0..* CodeableConceptRemoteMonitoringPrescriptionmeasurementSchedule 0..1 Timing "Monitoring duration and measurement frequency "monitoringPlan 1..* "Parameter to monitor"parameter 1..1 CodeableConcept "What is measured (LOINC/SNOMED)"threshold 0..* "Absolute threshold rule"range 1..1 Range "Numeric threshold (max and/or min) with unit"sustainedFor 0..1 Duration "Trigger only if breached for this long"targetRange 0..1 Range "Clinically desired range (TBD — goal tracking / display) "maxIncrease 0..* Ratio "Max allowed increase per time window (e.g. 2 kg / 7 d)"maxDecrease 0..* Ratio "Max allowed decrease per time window (e.g. 3 kg / 14 d) "FHIRServiceRequestCareProposalintent = proposalcategory[discipline] = Nursing procedure (fixed)code from BeVSRequestedServicesNursereasonCode 1..* from BeVSCareProposalReasonCode
The common referral model and its specializations (click a class to open its definition)

The specializations

  • CareProposal (formerly Annex 81) — the proposal-and-approval flow. A nursing request is first proposed and then approved: the approval links back to the preceding proposal through basedOn, and an approved proposal (intent = order) must always reference the proposal it fulfils. It fixes the nursing discipline, constrains the requested service to nursing acts, and mandates a reason.

  • RemoteMonitoringPrescription — the telemonitoring flow. It adds the elements needed to express what vital parameters to measure, how often, and when to alert. See the Telemonitoring page for the full description and the two implementation options.

  • Re-order (continuation of care) — the prolongation flow. When an existing prescription is continued, extended, or superseded, the new prescription is a re-order of the previous one. This relationship is expressed with replaces, pointing back to the prescription being continued (as opposed to basedOn, which points to an upstream proposal or plan).

CareProposal in detail

The CareProposal specialization inherits the full common model and layers its proposal/approval rules on top — fixing the nursing discipline, binding the requested service to nursing acts, and requiring a reason:

BeReferralServiceRequestidentifier 1..1 Identifierstatus 1..1 codeintent 1..1 codecategory 1..* CodeableConceptdiscipline 1..1 (categories-of-care)prescriptionType 0..1code 1..1 CodeableConceptsubject 1..1 Reference(BePatient)occurrence[x] 0..1authoredOn 1..1 dateTimerequester 1..1 Reference(BePractitionerRole)reasonCode 0..* CodeableConceptbasedOn 0..* Reference "fulfils an upstream proposal / plan"replaces 0..* Reference "continuation of care"occurrenceTiming weekly (frequency 1 / 1 wk)ext.validity 1..1 Periodext.feedback 0..1 booleanext.statusReason 0..1 CodeableConceptCareProposalintent = proposalcategory[discipline] = Nursing procedure (fixed)code from BeVSRequestedServicesNursereasonCode 1..* from BeVSCareProposalReasonCodeProposal-and-approval flow (formerly Annex 81).The approval links back to the proposal via basedOn.
CareProposal as a specialization of the common referral model

Additional use cases can be introduced the same way — by specializing BeReferralServiceRequest rather than by redefining it.