FHIR API HIEBus™ FHIR API
Interface Guide

Resource Mapping

This section gives some notes about how the CareEvolution concepts are mapped to FHIR Resources.

Condition

For the FHIR Condition resource, the status value is computed using term mapping from Problem.Status (http://hl7.org/fhir/dstu2/valueset-condition-clinical.html). Condition.verificationstatus is set to unknown (http://hl7.org/fhir/dstu2/valueset-condition-ver-status.html).

Diagnostic Order

For the FHIR Diagnostic Order resource, the status value is computed using term mapping from Order.OrderStatus. The default value is completed if Status is not specified or not mapped to any of the standard FHIR diagnostic order statuses.

The priority value is computed using term mapping from Order.Priority. The default value is routine if Status is not specified or not mapped to any of the standard FHIR diagnostic order priorities.

Diagnostic Report

The FHIR Diagnostic Report resource is a combination of the CareEvolution Report and LabReport concepts.

LabReport.status is computed using term mapping from LabReport.ReportStatus or Report.ReportStatus. The default is partial if ReportStatus is not specified or not mapped to any of the standard FHIR diagnostic report statuses.

The F term in the ReportStatus family of the CareEvolution namespace–or any term mapped to it–is converted to the FHIR ‘final’ code.

Encounter

For the FHIR Encounter resource, the class value is computed using term mapping from Encounter.PatientClass. The default value is outpatient if PatientClass is not specified or not mapped to any of the standard FHIR encounter classes.

Medication Administration

For the FHIR Medication Administration resource, the status value is computed using term mapping from MedicationAdministration.Status. The default value is completed if Status is not specified or not mapped to any of the standard FHIR administration statuses.

Medication Order

For the FHIR Medication Order resource, the status value is computed using term mapping from Order.OrderStatus. The default value is completed if OrderStatus is not specified or not mapped to any of the standard FHIR prescription statuses.

Observation

The FHIR Observation resource is a combination of the CareEvolution Observation and LabObservation concepts.

When the FHIR Observation corresponds to a CareEvolution LabObservation, then status is computed using term mapping from LabObservation.ObservationResultStatus.

The default is unknown if ObservationResultStatus is not specified or not mapped to any of the standard FHIR observation statuses.

The F term in the ObservationResultStatus family of CareEvolution namespace–or any term mapped to it–is converted to the FHIR ‘final’ code.

When the FHIR Observation corresponds to a CareEvolution Observation, the status is always unknown

When the Observation is a member of a term subset with a scope of standard value set name ‘http://hl7.org/fhir/dstu2/observation-category’, the name of the term subset is mapped to the ‘category’.

Observations can be searched by specified the standard observation category name as well. Ex: …/api/fhir/Observation?category=vital-signs&patient.id-124325235 will return the set of all vital signs.

Patient

Record groups are represented as links in the Patient resource–i.e., there is a link in the returned Patient resource for each other patient in the same record group.

When searching for other resources related to a patient (e.g., all patient’s observations) the system automatically uses the record group. This means it will return the resources related to ANY patient in the same record group as the specified patient.