v3.0.0 draft

eReferral Implementation Guide
3.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 3.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

P2M - Nursing - Diabetes education within care trajectory

Scenario

  1. A patient with type 2 diabetes treated with insulin is enrolled in a diabetes care path and has a complete global medical file. During follow-up, the physician recommends education on using a blood glucose meter.
  2. The physician prescribes five individual education sessions per year, with a maximum of the first five sessions and no required feedback. The validity ends on 31 December of the year in which validity starts.

Source discrepancy: The narrative selects blood glucose meter education. The template lists additional education topics without distinguishing selected values from options. This test follows the narrative and does not add the other topics.

Create Prescription

POST /ServiceRequest

Profile: ereferral-servicerequest-nursing.

Retain the returned ServiceRequest id. Clinical plaintext in the table is represented by encrypted values in the request.

Business Values

Business Field Value
Prescription / proposal type Diabetes education within care trajectory
Requested care Diabetes education within care trajectory
Patient Patient pseudonym: {{SEC1}} / {{transitInfo}}
Requester Physician, SSIN {{prescriberSsin}}
Validity start {{validityStartDate}}
Validity end {{validityEndCalendarYear}}
Feedback required No
Educator Nurse
Frequency 5 time(s) per 1 year
Maximum sessions 5
Education type Use of a blood glucose meter
Session type Individual
Diagnosis / medical problem, before encryption Type 2 diabetes treated with insulin
Creation date {{createdAt}}

FHIR Mapping

Business FieldFHIR FieldFHIR JSON
Prescription / proposal typeServiceRequest.category
[
  {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "9632001"
      }
    ]
  },
  {
    "coding": [
      {
        "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-prescription-type",
        "code": "diabetic-education-within-care-trajectory"
      }
    ]
  }
]
Requested careServiceRequest.code
{
  "coding": [
    {
      "system": "http://snomed.info/sct",
      "code": "385805005"
    }
  ]
}
PatientServiceRequest.subject
{
  "identifier": {
    "use": "official",
    "system": "https://www.ehealth.fgov.be/standards/fhir/core/NamingSystem/ssin",
    "value": "urn:be:fgov:pseudo:v2:{{SEC1}}:{{transitInfo}}",
    "_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
            }
          ]
        }
      ]
    }
  }
}
RequesterServiceRequest.requester
{
  "reference": "PractitionerRole/{{prescriberSsin}}-PHYSICIAN"
}
Validity periodServiceRequest.extension (be-ext-validity-period)
{
  "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-validity-period",
  "valuePeriod": {
    "start": "{{validityStartDate}}",
    "end": "{{validityEndCalendarYear}}"
  }
}
Feedback requiredServiceRequest.extension (be-ext-feedback-to-prescriber)
{
  "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-feedback-to-prescriber",
  "valueBoolean": false
}
EducatorServiceRequest.extension (be-ext-performer-type)
{
  "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-performer-type",
  "valueCodeableConcept": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "224543004"
      }
    ]
  }
}
Frequency, treatment period and sessionsServiceRequest.occurrenceTiming
{
  "repeat": {
    "frequency": 5,
    "period": 1,
    "periodUnit": "a",
    "count": 5
  }
}
Education type, Session typeServiceRequest.orderDetail
[
  {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "370858005"
      }
    ]
  },
  {
    "coding": [
      {
        "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-diabetic-education-type",
        "code": "diabetic-education-glucose-meter"
      }
    ]
  },
  {
    "coding": [
      {
        "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-session-types",
        "code": "individual-session"
      }
    ]
  }
]
Diagnosis / medical problem, before encryptionServiceRequest.reasonCode
[
  {
    "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{diagnosisJwe}}",
    "_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
            }
          ]
        }
      ]
    }
  }
]
Creation dateServiceRequest.authoredOn
{
  "authoredOn": "{{createdAt}}"
}

Complete FHIR Payload

{
  "resourceType": "ServiceRequest",
  "meta": {
    "profile": [
      "https://www.riziv-inami.be/standards/fhir/ereferral/StructureDefinition/ereferral-servicerequest-nursing"
    ],
    "extension": [
      {
        "id": "{{kid}}",
        "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-key-pseudonymization",
        "extension": [
          {
            "url": "key",
            "valueString": "urn:be:fgov:pseudo:v2:{{SEC1}}:{{transitInfo}}",
            "_valueString": {
              "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
                    }
                  ]
                }
              ]
            }
          }
        ]
      }
    ]
  },
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-validity-period",
      "valuePeriod": {
        "start": "{{validityStartDate}}",
        "end": "{{validityEndCalendarYear}}"
      }
    },
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-feedback-to-prescriber",
      "valueBoolean": false
    },
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-performer-type",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "224543004"
          }
        ]
      }
    }
  ],
  "status": "active",
  "intent": "order",
  "category": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "9632001"
        }
      ]
    },
    {
      "coding": [
        {
          "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-prescription-type",
          "code": "diabetic-education-within-care-trajectory"
        }
      ]
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "385805005"
      }
    ]
  },
  "subject": {
    "identifier": {
      "use": "official",
      "system": "https://www.ehealth.fgov.be/standards/fhir/core/NamingSystem/ssin",
      "value": "urn:be:fgov:pseudo:v2:{{SEC1}}:{{transitInfo}}",
      "_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
              }
            ]
          }
        ]
      }
    }
  },
  "occurrenceTiming": {
    "repeat": {
      "frequency": 5,
      "period": 1,
      "periodUnit": "a",
      "count": 5
    }
  },
  "authoredOn": "{{createdAt}}",
  "requester": {
    "reference": "PractitionerRole/{{prescriberSsin}}-PHYSICIAN"
  },
  "orderDetail": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "370858005"
        }
      ]
    },
    {
      "coding": [
        {
          "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-diabetic-education-type",
          "code": "diabetic-education-glucose-meter"
        }
      ]
    },
    {
      "coding": [
        {
          "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-session-types",
          "code": "individual-session"
        }
      ]
    }
  ],
  "reasonCode": [
    {
      "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{diagnosisJwe}}",
      "_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
              }
            ]
          }
        ]
      }
    }
  ]
}