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

Diabetes Education via Convention Centre

Prescription type code: diabetic-education-convention-center.

Example: example-drp-nursing-de-convention-center.

This table maps the business fields to the corresponding FHIR elements.

Business fields

Business field Values / constraints Data type Notes
Prescription type      
Discipline      
Validity period     Business validity of the prescription.
Patient     SSIN identifier; value must follow pseudonymization rules.
Requester / prescriber     Reference to the prescribing practitioner role.
Education type … String  
Frequency     Required in business template. Timing repeat block.
- Number of repetitions … times per Integer Number of repetitions per period.
- Time unit - Day
- Week
- Month		 Enum  
Treatment period     Required in business template. Overall treatment period.
- Duration … Integer Duration value.
- Time unit - Day(s)
- Week(s)
- Month
- Year(s)		 Enum  
Number of sessions (max) … Integer Required in business template. Total number of planned sessions.
General remarks … String Free text; must be encrypted with a pseudonymized key.
Feedback required - Yes
- No (par defaut)		 Boolean Required in business template. be-ext-feedback-to-prescriber.
Prescription validity     be-ext-validity-period.
- Start date Today (default) Date Required in business template. Start of prescription validity.
- End date Start date + 1 year (max) Date Required in business template. End of prescription validity.

FHIR mapping

Business field FHIR representation FHIR JSON example Terminology
Prescription type ServiceRequest.category[prescriptionType] 
{
  "category": [
    {
      "coding": [
        {
          "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-prescription-type",
          "code": "diabetic-education-convention-center"
        }
      ]
    }
  ]
}
Discipline ServiceRequest.category[discipline] 
{
  "category": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "9632001"
        }
      ]
    }
  ]
}
Validity period ServiceRequest.extension[validity] 
{
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/referral/StructureDefinition/be-ext-validity-period",
      "valuePeriod": {
        "start": "2026-02-18",
        "end": "2027-02-18"
      }
    }
  ]
}
Patient ServiceRequest.subject 
{
  "subject": {
    "identifier": {
      "use": "official",
      "system": "https://www.ehealth.fgov.be/standards/fhir/core/NamingSystem/ssin",
      "value": "urn:be:fgov:pseudo:v2:{{SEC1}}:{{transit-info}}",
      "_value": {
        "extension": [
          {
            "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-pseudonymization",
            "extension": [
              {
                "url": "marker",
                "valueBoolean": true
              },
              {
                "url": "format",
                "valueCode": "direct"
              },
              {
                "url": "version",
                "valuePositiveInt": 2
              }
            ]
          }
        ]
      }
    }
  }
}
Requester / prescriber ServiceRequest.requester 
{
  "requester": {
    "reference": "PractitionerRole/72101230445-PHYSICIAN"
  }
}
Education type ServiceRequest.orderDetail 
{
  "orderDetail": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "211141000172109"
        }
      ]
    }
  ]
}
Frequency ServiceRequest.occurrenceTiming.repeat 
{
  "occurrenceTiming": {
    "repeat": {
      "boundsDuration": {
        "value": 4,
        "system": "http://unitsofmeasure.org",
        "code": "mo"
      },
      "count": 52,
      "frequency": 3,
      "period": 1,
      "periodUnit": "wk"
    }
  }
}
- Number of repetitions ServiceRequest.occurrenceTiming.repeat.frequency 
{
  "occurrenceTiming": {
    "repeat": {
      "frequency": 3
    }
  }
}
- Time unit ServiceRequest.occurrenceTiming.repeat.periodUnit 
{
  "occurrenceTiming": {
    "repeat": {
      "periodUnit": "wk"
    }
  }
}
Treatment period ServiceRequest.occurrenceTiming.repeat.boundsDuration 
{
  "occurrenceTiming": {
    "repeat": {
      "boundsDuration": {
        "value": 4,
        "system": "http://unitsofmeasure.org",
        "code": "mo"
      }
    }
  }
}
- Duration ServiceRequest.occurrenceTiming.repeat.boundsDuration.value 
{
  "occurrenceTiming": {
    "repeat": {
      "boundsDuration": {
        "value": 4
      }
    }
  }
}
- Time unit ServiceRequest.occurrenceTiming.repeat.periodUnit 
{
  "occurrenceTiming": {
    "repeat": {
      "periodUnit": "wk"
    }
  }
}
Number of sessions (max) ServiceRequest.occurrenceTiming.repeat.count 
{
  "occurrenceTiming": {
    "repeat": {
      "count": 52
    }
  }
}
General remarks ServiceRequest.note[general-remarks].text 
{
  "note": [
    {
      "extension": [
        {
          "url": "https://www.ehealth.fgov.be/standards/fhir/core/StructureDefinition/be-ext-codeableconcept",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-note-types",
                "code": "general-remarks"
              }
            ]
          }
        }
      ],
      "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{jwe}}",
      "_text": {
        "extension": [
          {
            "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-pseudonymization",
            "extension": [
              {
                "url": "marker",
                "valueBoolean": true
              },
              {
                "url": "format",
                "valueCode": "encrypted"
              },
              {
                "url": "version",
                "valuePositiveInt": 1
              }
            ]
          }
        ]
      }
    }
  ]
}
Feedback required ServiceRequest.extension[feedback].valueBoolean 
{
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/referral/StructureDefinition/be-ext-feedback-to-prescriber",
      "valueBoolean": false
    }
  ]
}
Prescription validity ServiceRequest.extension[validity] 
{
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/referral/StructureDefinition/be-ext-validity-period",
      "valuePeriod": {
        "start": "2026-02-18",
        "end": "2027-02-18"
      }
    }
  ]
}
- Start date ServiceRequest.extension[validity].valuePeriod.start 
{
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/referral/StructureDefinition/be-ext-validity-period",
      "valuePeriod": {
        "start": "2026-02-18",
        "end": "2027-02-18"
      }
    }
  ]
}
- End date ServiceRequest.extension[validity].valuePeriod.end 
{
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/referral/StructureDefinition/be-ext-validity-period",
      "valuePeriod": {
        "start": "2026-02-18",
        "end": "2027-02-18"
      }
    }
  ]
}