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 - Radiology - Flank pain with suspected recurrent stones

Scenario

  1. A 52-year-old woman is investigated for flank pain and suspected recurrent stone disease.
  2. The physician indicates a preference for a CT examination, but the selected workbook entry is Other and no exact anatomy or protocol is supplied.
  3. Confirm the intended examination and its catalogue code, complete safety screening and only then submit the prescription. No specific CT examination is inferred from the symptom alone.

Examination to confirm: Business Data has no narrative for this test. Technical Data gives Other (74964007), which is not in the local required imaging ValueSet, and a free-text preference for CT. Confirm a specific examination and its permitted SNOMED code. The template is not a validated positive test until this is resolved.

Create Prescription: CT examination: anatomy and protocol to be confirmed

POST /ServiceRequest

Profile: ereferral-servicerequest-diagnosticimaging.

The physician completes imaging safety screening and creates the prescription. Age and sex at birth remain visible as business values, while the contained patient carries encrypted values. Safety answers not supplied by the scenario are runtime inputs, not assumed negative findings. Complete and review them before submitting the completed questionnaire.

Business Values

Business Field Value
Patient age 52 years
Sex at birth Female
Examination CT examination: anatomy and protocol to be confirmed
Clinical indications Flank pain with suspected recurrent stone disease
Clinical context A fifty-two-year-old woman has flank pain with suspected recurrent stone disease. The workbook mentions a CT examination as the preferred alternative but does not specify the examination anatomy or protocol.
Patient Patient pseudonym: {{SEC1}} / {{transitInfo}}
Requester Physician, SSIN {{prescriberSsin}}
Creation date {{createdAt}}
Validity start {{validityStartDate}}
Priority {{imagingPriority}}
Care setting {{careTrack}}
Diabetes {{hasDiabetes}}
Contrast-agent allergy {{hasContrastAllergy}}
Metallic debris {{hasMetallicDebris}}
Renal dysfunction {{hasRenalDysfunction}}
No imaging attention condition {{noAttentionCondition}}

FHIR Mapping

Business FieldFHIR FieldFHIR JSON
Imaging discipline, prescription type and care settingServiceRequest.category
[
  {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "363679005"
      }
    ]
  },
  {
    "coding": [
      {
        "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-prescription-type",
        "code": "diagnostic-imaging-appendix-82"
      }
    ]
  },
  {
    "coding": [
      {
        "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-request-track",
        "code": "{{careTrack}}"
      }
    ]
  }
]
Examination and protocolServiceRequest.code
{
  "coding": [
    {
      "system": "http://snomed.info/sct",
      "code": "{{selectedImagingCode}}"
    }
  ],
  "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{imagingDescriptionJwe}}",
  "_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
          }
        ]
      }
    ]
  }
}
Patient age and sex at birth (encrypted)ServiceRequest.contained (Patient)
{
  "resourceType": "Patient",
  "id": "patient",
  "meta": {
    "profile": [
      "https://www.ehealth.fgov.be/standards/fhir/core/StructureDefinition/be-patient|2.2.0"
    ]
  },
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/core/StructureDefinition/be-ext-gender-at-birth",
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/administrative-gender",
            "code": "other"
          }
        ],
        "extension": [
          {
            "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-pseudonymized-content",
            "extension": [
              {
                "url": "encryptedValue",
                "valueString": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{sexAtBirthJwe}}"
              },
              {
                "url": "marker",
                "valueBoolean": true
              },
              {
                "url": "format",
                "valueCode": "encrypted"
              },
              {
                "url": "version",
                "valuePositiveInt": 1
              }
            ]
          }
        ]
      }
    }
  ],
  "_birthDate": {
    "extension": [
      {
        "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-pseudonymized-content",
        "extension": [
          {
            "url": "encryptedValue",
            "valueString": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{birthDateJwe}}"
          },
          {
            "url": "marker",
            "valueBoolean": true
          },
          {
            "url": "format",
            "valueCode": "encrypted"
          },
          {
            "url": "version",
            "valuePositiveInt": 1
          }
        ]
      }
    ]
  }
}
Patient reference and pseudonymServiceRequest.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
            }
          ]
        }
      ]
    }
  },
  "reference": "#patient"
}
Imaging safety screeningServiceRequest.contained (QuestionnaireResponse)
{
  "resourceType": "QuestionnaireResponse",
  "id": "safety-checklist",
  "meta": {
    "profile": [
      "https://www.riziv-inami.be/standards/fhir/ereferral/StructureDefinition/ereferral-imaging-attention-conditions-response"
    ]
  },
  "questionnaire": "https://www.ehealth.fgov.be/standards/fhir/drp/Questionnaire/be-questionnaire-imaging-attention-conditions",
  "status": "completed",
  "authored": "{{createdAt}}",
  "item": [
    {
      "linkId": "diabetes",
      "answer": [
        {
          "valueBoolean": "{{hasDiabetes}}"
        }
      ]
    },
    {
      "linkId": "allergy-contrast-agent",
      "answer": [
        {
          "valueBoolean": "{{hasContrastAllergy}}"
        }
      ]
    },
    {
      "linkId": "metallic-debris",
      "answer": [
        {
          "valueBoolean": "{{hasMetallicDebris}}"
        }
      ]
    },
    {
      "linkId": "renal-dysfunction",
      "answer": [
        {
          "valueBoolean": "{{hasRenalDysfunction}}"
        }
      ]
    },
    {
      "linkId": "none",
      "answer": [
        {
          "valueBoolean": "{{noAttentionCondition}}"
        }
      ]
    }
  ]
}
Clinical indications and checklist referenceServiceRequest.supportingInfo
[
  {
    "reference": "#safety-checklist",
    "extension": [
      {
        "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-radiology-supporting-info-role",
        "valueCode": "safety-checklist"
      }
    ]
  },
  {
    "display": "Patient condition",
    "extension": [
      {
        "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-radiology-supporting-info-role",
        "valueCode": "patient-condition"
      },
      {
        "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-codeable-concept",
        "valueCodeableConcept": {
          "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{indication1Jwe}}",
          "_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
                  }
                ]
              }
            ]
          }
        }
      }
    ]
  }
]
Clinical contextServiceRequest.reasonCode
[
  {
    "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{clinicalContextJwe}}",
    "_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
            }
          ]
        }
      ]
    }
  }
]
RequesterServiceRequest.requester
{
  "reference": "PractitionerRole/{{prescriberSsin}}-PHYSICIAN"
}
Validity startServiceRequest.extension (be-ext-validity-period)
{
  "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-validity-period",
  "valuePeriod": {
    "start": "{{validityStartDate}}"
  }
}
PriorityServiceRequest.priority
{
  "priority": "{{imagingPriority}}"
}
Creation dateServiceRequest.authoredOn
{
  "authoredOn": "{{createdAt}}"
}

Complete FHIR Payload

{
  "resourceType": "ServiceRequest",
  "meta": {
    "profile": [
      "https://www.riziv-inami.be/standards/fhir/ereferral/StructureDefinition/ereferral-servicerequest-diagnosticimaging"
    ],
    "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
                    }
                  ]
                }
              ]
            }
          }
        ]
      }
    ]
  },
  "contained": [
    {
      "resourceType": "Patient",
      "id": "patient",
      "meta": {
        "profile": [
          "https://www.ehealth.fgov.be/standards/fhir/core/StructureDefinition/be-patient|2.2.0"
        ]
      },
      "extension": [
        {
          "url": "https://www.ehealth.fgov.be/standards/fhir/core/StructureDefinition/be-ext-gender-at-birth",
          "valueCodeableConcept": {
            "coding": [
              {
                "system": "http://hl7.org/fhir/administrative-gender",
                "code": "other"
              }
            ],
            "extension": [
              {
                "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-pseudonymized-content",
                "extension": [
                  {
                    "url": "encryptedValue",
                    "valueString": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{sexAtBirthJwe}}"
                  },
                  {
                    "url": "marker",
                    "valueBoolean": true
                  },
                  {
                    "url": "format",
                    "valueCode": "encrypted"
                  },
                  {
                    "url": "version",
                    "valuePositiveInt": 1
                  }
                ]
              }
            ]
          }
        }
      ],
      "_birthDate": {
        "extension": [
          {
            "url": "https://www.ehealth.fgov.be/standards/fhir/infsec/StructureDefinition/be-ext-pseudonymized-content",
            "extension": [
              {
                "url": "encryptedValue",
                "valueString": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{birthDateJwe}}"
              },
              {
                "url": "marker",
                "valueBoolean": true
              },
              {
                "url": "format",
                "valueCode": "encrypted"
              },
              {
                "url": "version",
                "valuePositiveInt": 1
              }
            ]
          }
        ]
      }
    },
    {
      "resourceType": "QuestionnaireResponse",
      "id": "safety-checklist",
      "meta": {
        "profile": [
          "https://www.riziv-inami.be/standards/fhir/ereferral/StructureDefinition/ereferral-imaging-attention-conditions-response"
        ]
      },
      "questionnaire": "https://www.ehealth.fgov.be/standards/fhir/drp/Questionnaire/be-questionnaire-imaging-attention-conditions",
      "status": "completed",
      "authored": "{{createdAt}}",
      "item": [
        {
          "linkId": "diabetes",
          "answer": [
            {
              "valueBoolean": "{{hasDiabetes}}"
            }
          ]
        },
        {
          "linkId": "allergy-contrast-agent",
          "answer": [
            {
              "valueBoolean": "{{hasContrastAllergy}}"
            }
          ]
        },
        {
          "linkId": "metallic-debris",
          "answer": [
            {
              "valueBoolean": "{{hasMetallicDebris}}"
            }
          ]
        },
        {
          "linkId": "renal-dysfunction",
          "answer": [
            {
              "valueBoolean": "{{hasRenalDysfunction}}"
            }
          ]
        },
        {
          "linkId": "none",
          "answer": [
            {
              "valueBoolean": "{{noAttentionCondition}}"
            }
          ]
        }
      ]
    }
  ],
  "extension": [
    {
      "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-validity-period",
      "valuePeriod": {
        "start": "{{validityStartDate}}"
      }
    }
  ],
  "status": "active",
  "intent": "order",
  "priority": "{{imagingPriority}}",
  "category": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "363679005"
        }
      ]
    },
    {
      "coding": [
        {
          "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-prescription-type",
          "code": "diagnostic-imaging-appendix-82"
        }
      ]
    },
    {
      "coding": [
        {
          "system": "https://www.ehealth.fgov.be/standards/fhir/terminology/CodeSystem/be-cs-request-track",
          "code": "{{careTrack}}"
        }
      ]
    }
  ],
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "{{selectedImagingCode}}"
      }
    ],
    "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{imagingDescriptionJwe}}",
    "_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
            }
          ]
        }
      ]
    }
  },
  "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
              }
            ]
          }
        ]
      }
    },
    "reference": "#patient"
  },
  "authoredOn": "{{createdAt}}",
  "requester": {
    "reference": "PractitionerRole/{{prescriberSsin}}-PHYSICIAN"
  },
  "reasonCode": [
    {
      "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{clinicalContextJwe}}",
      "_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
              }
            ]
          }
        ]
      }
    }
  ],
  "supportingInfo": [
    {
      "reference": "#safety-checklist",
      "extension": [
        {
          "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-radiology-supporting-info-role",
          "valueCode": "safety-checklist"
        }
      ]
    },
    {
      "display": "Patient condition",
      "extension": [
        {
          "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-radiology-supporting-info-role",
          "valueCode": "patient-condition"
        },
        {
          "url": "https://www.ehealth.fgov.be/standards/fhir/drp/StructureDefinition/be-ext-codeable-concept",
          "valueCodeableConcept": {
            "text": "urn:be:fgov:pseudo-encrypted:v1:{{kid}}:{{indication1Jwe}}",
            "_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
                    }
                  ]
                }
              ]
            }
          }
        }
      ]
    }
  ]
}