Supported Resources

XES Module for FHIR gathers data received from different sources and links it as a resource to the patient this data belongs to. The following table lists available resources and specifies when a new resource based on the received data is created.

Resource Creation Rules
Patient

Demographics (a name, gender, age, marital status, and so on) and other administrative information (contacts, address, and so on) about a person who receives care or other health-related services. When new patient data is received, XES Module for FHIR verifies if this patient has already been added to the server. XES Module for FHIR checks if the first name, last name, and date of birth of a patient matches those of an existing patient. If there is a match, resources are linked to the matching patient and a new patient is not created to avoid duplicates. If no match is found, XES Module for FHIR creates a new patient and assigns a new unique identifier to the newly created patient.

Practitioner

A person who is directly or indirectly involved in the provisioning of healthcare. When information about a new practitioner is received, XES Module for FHIR verifies if this practitioner has already been added to the server. XES Module for FHIR checks if the NPI (national provider identifier) of the new practitioner matches an existing practitioner’s NPI. If no match is found, XES Module for FHIR adds a new practitioner to the server.

Organization

A grouping of people or organizations formed for the purpose of achieving some form of collective action (companies, institutions, corporations, departments, community groups, healthcare practice groups, and so on). Information about an organization. Two organization types are supported:

  • ins (insurer)
  • prov (provider). A health Provider is a practitioner or a medical organization.
Medication

The identification and definition of a medication that includes the ingredients and the packaging. When information about a new medication is received, XES Module for FHIR verifies if this medication has already been added to the server. XES Module for FHIR checks if the code of the new medication matches the code of existing medication. Each drug product intended for human use is assigned a unique code. This code may look different depending on a drug classification system. XES Module for FHIR uses SNOMED - standards that are used by U.S. Federal Government systems for the electronic exchange of clinical health information.

Claim A list of services and products to be provided or have already been provided to a patient that is issued by the provider and sent to insurer for payment recovery. When a new claim is received, XES Module for FHIR verifies if a claim with the same claim identifier has already been added to the server. If the claim identifier is unique, it is added to the server.
Communication

An occurrence of information being transmitted (a notification about a reportable condition). Always added as a new resource. Contains information about an EDI, HL7, or CCD transaction and the original file that is converted to the FHIR format in the payload.

During an HL7/CCD data load, XES Module for FHIR creates a Communication resource with the payload field that contains the original file as an attachment. In this case, the Communication resource is linked to the patient resource.

During an EDI 270, 271, 837 data load, XES Module for FHIR creates a Communication resource with the payload field that contains the original file as an attachment. In this case, the Communication resource is linked to the corresponding CoverageEligibilityRequest, CoverageEligibilityResponse, Claim resources.

Encounter An interaction between a patient and a provider to provide healthcare services or assess the health status of a patient. When information about a new patient encounter is received, XES Module for FHIR checks in the segment PV1 the element 19 – Visit number. This field contains the unique number assigned to each patient visit.
Observation Measurements and simple assertions made about a patient. When information about a new observation is received, XES Module for FHIR checks in the segment OBX in the element 3 – Observation identifier and the element 4 - Observation Sub-ID. This field contains the unique number assigned to each patient visit. The assigning authority and identifier type code are strongly recommended for all CX data types.
AllergyIntolerance Undesirable individual physiological response associated with exposure to a substance. Always added as a new resource.
Composition A logical set of healthcare-related information that is assembled together and provides a single coherent statement of meaning, establishes its own context and that has clinical attestation with regard to who is making the statement. Always added as a new resource.
Procedure An action performed on a patient (an operation, counseling, hypnotherapy, and so on). Always added as a new resource.
DiagnosticReport The findings and interpretation of diagnostic tests performed on patients. Always added as a new resource.
DetectedIssue Indicates an actual or potential clinical issue with or between one or more active or proposed clinical actions for a patient. Always added as a new resource.
CarePlan Describes the intention of how a practitioner(s) intends to deliver care for a particular patient. Always added as a new resource.
MedicationStatement A record of a medication that a patient consumes. Always added as a new resource.
Condition A clinical condition, problem, diagnosis, or other event, situation, issue, or clinical concept that has risen to a level of concern. Always added as a new resource.
Immunization A record of a vaccination that may include vaccine reaction information and the followed vaccination protocol. Always added as a new resource.
CoverageEligibilityRequest Provides patient and insurance coverage information to an insurer to respond. Always added as a new resource.
CoverageEligibilityResponse Provides eligibility and plan details from the processing of an CoverageEligibilityRequest resource. Always added as a new resource.

You can import information from different data files (HL7, CCD, HIPAA) that contain different kinds of information. For example, claim transactions (EDI 837) contain more financial information and less of a patient's personal data. On the other hand, HL7 and CCD files contain a lot of clinical information. The following table shows you what resources can be extracted from the corresponding transactions using maps provided with the package:

FHIR\HL7 ADT-A01 ADT-A03 OUL-R22 CCD 837 270 271
Patient
Practitioner
Organization      
AllergyIntolerance        
Communication
Encounter        
Procedure      
Observation        
DiagnosticReport          
DetectedIssue              
Medication            
MedicationStatement            
CarePlan              
Condition            
Composition            
Immunization              
RelatedPerson        
Coverage        
Location            
Claim            
CoverageEligibilityRequest            
CoverageEligibilityResponse