Work in progress.
This section of the Implementation Guide is subject to change.

Profile EEBaseEncounter


Profile Purpose

Encounter is an interaction between a patient and healthcare provider(s) to provide healthcare service(s) or assess a patient's health status. There are many types of encounters (such as ambulatory, inpatient, home visits, emergency and the like) which is the reason why the resource encompasses the lifecycle from pre-admission to the actual encounter (for ambulatory encounters) and admission, stay and discharge (for inpatient encounters).

Example Usage Scenarios

  • Query for encounters based on specific status using the query parameter Encounter.status
  • Query for reasons this encounter occurred using the query parameter Encounter.reasonReference
  • Exchange encounter information within a FHIR document or message


Snapshot View

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
modeOfArrivalI0..1Extension(Coding)Binding
id0..1string
extensionI0..0Extension
url1..1uriFixed Value
valueReferenceReference(EEBase Encounter)
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
status1..1codeBinding
periodI1..1Period
classS Σ1..1CodingBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
class1..1CodingBinding
periodI1..1Period
typeΣ0..*CodeableConcept
serviceTypeΣ0..1CodeableConcept
priority0..1CodeableConceptBinding
subjectΣ I0..1Reference(Group | EEBase Patient)
episodeOfCareΣ I0..*Reference(EEBase EpisodeOfCare)
basedOnI0..*Reference(ServiceRequest)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
periodI0..1Period
individualΣ I0..1Reference(EEBase Practitioner | EEBase PractitionerRole | EEBase RelatedPerson)
appointmentΣ I0..*Reference(Appointment)
periodI0..1Period
lengthI0..1Duration
reasonCodeΣ0..*CodeableConceptBinding
reasonReferenceΣ I0..*Reference(Condition | Procedure | ImmunizationRecommendation | EEBase Observation)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
conditionΣ I1..1Reference(Condition | Procedure)
use0..1CodeableConceptBinding
rank0..1positiveInt
accountI0..*Reference(Account)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
preAdmissionIdentifier0..1Identifier
originI0..1Reference(EEBase Location | EEBase Organization)
admitSource0..1CodeableConceptBinding
reAdmission0..1CodeableConcept
dietPreference0..*CodeableConcept
specialCourtesy0..*CodeableConceptBinding
specialArrangement0..*CodeableConceptBinding
destinationI0..1Reference(EEBase Location | EEBase Organization)
dischargeDisposition0..1CodeableConcept
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
locationI1..1Reference(EEBase Location)
status0..1codeBinding
physicalType0..1CodeableConcept
periodI0..1Period
serviceProviderI0..1Reference(EEBase Organization)
partOfI0..1Reference(EEBase Encounter)

Differential View

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
modeOfArrivalI0..1Extension(Coding)Binding
id0..1string
extensionI0..0Extension
url1..1uriFixed Value
valueReferenceReference(EEBase Encounter)
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
status1..1codeBinding
periodI1..1Period
classS Σ1..1CodingBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
class1..1CodingBinding
periodI1..1Period
typeΣ0..*CodeableConcept
serviceTypeΣ0..1CodeableConcept
priority0..1CodeableConceptBinding
subjectΣ I0..1Reference(Group | EEBase Patient)
episodeOfCareΣ I0..*Reference(EEBase EpisodeOfCare)
basedOnI0..*Reference(ServiceRequest)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
periodI0..1Period
individualΣ I0..1Reference(EEBase Practitioner | EEBase PractitionerRole | EEBase RelatedPerson)
appointmentΣ I0..*Reference(Appointment)
periodI0..1Period
lengthI0..1Duration
reasonCodeΣ0..*CodeableConceptBinding
reasonReferenceΣ I0..*Reference(Condition | Procedure | ImmunizationRecommendation | EEBase Observation)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
conditionΣ I1..1Reference(Condition | Procedure)
use0..1CodeableConceptBinding
rank0..1positiveInt
accountI0..*Reference(Account)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
preAdmissionIdentifier0..1Identifier
originI0..1Reference(EEBase Location | EEBase Organization)
admitSource0..1CodeableConceptBinding
reAdmission0..1CodeableConcept
dietPreference0..*CodeableConcept
specialCourtesy0..*CodeableConceptBinding
specialArrangement0..*CodeableConceptBinding
destinationI0..1Reference(EEBase Location | EEBase Organization)
dischargeDisposition0..1CodeableConcept
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
locationI1..1Reference(EEBase Location)
status0..1codeBinding
physicalType0..1CodeableConcept
periodI0..1Period
serviceProviderI0..1Reference(EEBase Organization)
partOfI0..1Reference(EEBase Encounter)

Hybrid View

idΣ0..1string
metaΣ0..1Meta
implicitRulesΣ ?!0..1uri
language0..1codeBinding
text0..1Narrative
contained0..*Resource
modeOfArrivalI0..1Extension(Coding)Binding
id0..1string
extensionI0..0Extension
url1..1uriFixed Value
valueReferenceReference(EEBase Encounter)
modifierExtension?! I0..*Extension
identifierΣ0..*Identifier
statusS Σ ?!1..1codeBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
status1..1codeBinding
periodI1..1Period
classS Σ1..1CodingBinding
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
class1..1CodingBinding
periodI1..1Period
typeΣ0..*CodeableConcept
serviceTypeΣ0..1CodeableConcept
priority0..1CodeableConceptBinding
subjectΣ I0..1Reference(Group | EEBase Patient)
episodeOfCareΣ I0..*Reference(EEBase EpisodeOfCare)
basedOnI0..*Reference(ServiceRequest)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
typeΣ0..*CodeableConceptBinding
periodI0..1Period
individualΣ I0..1Reference(EEBase Practitioner | EEBase PractitionerRole | EEBase RelatedPerson)
appointmentΣ I0..*Reference(Appointment)
periodI0..1Period
lengthI0..1Duration
reasonCodeΣ0..*CodeableConceptBinding
reasonReferenceΣ I0..*Reference(Condition | Procedure | ImmunizationRecommendation | EEBase Observation)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
conditionΣ I1..1Reference(Condition | Procedure)
use0..1CodeableConceptBinding
rank0..1positiveInt
accountI0..*Reference(Account)
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
preAdmissionIdentifier0..1Identifier
originI0..1Reference(EEBase Location | EEBase Organization)
admitSource0..1CodeableConceptBinding
reAdmission0..1CodeableConcept
dietPreference0..*CodeableConcept
specialCourtesy0..*CodeableConceptBinding
specialArrangement0..*CodeableConceptBinding
destinationI0..1Reference(EEBase Location | EEBase Organization)
dischargeDisposition0..1CodeableConcept
id0..1string
extensionI0..*Extension
modifierExtensionΣ ?! I0..*Extension
locationI1..1Reference(EEBase Location)
status0..1codeBinding
physicalType0..1CodeableConcept
periodI0..1Period
serviceProviderI0..1Reference(EEBase Organization)
partOfI0..1Reference(EEBase Encounter)

Table View

Encounter..
Encounter.extension0..
Encounter.extensionExtension0..
Encounter.extensionExtension0..
Encounter.extension.value[x]Reference(EEBase Encounter)..
Encounter.status..
Encounter.class..
Encounter.classHistory..
Encounter.classHistory.class..
Encounter.priority..
Encounter.subjectReference(Group | EEBase Patient)..
Encounter.episodeOfCareReference(EEBase EpisodeOfCare)..
Encounter.participant..
Encounter.participant.individualReference(EEBase Practitioner | EEBase PractitionerRole | EEBase RelatedPerson)..
Encounter.reasonReferenceReference(Condition | Procedure | ImmunizationRecommendation | EEBase Observation)..
Encounter.hospitalization..
Encounter.hospitalization.originReference(EEBase Location | EEBase Organization)..
Encounter.hospitalization.destinationReference(EEBase Location | EEBase Organization)..
Encounter.location..
Encounter.location.locationReference(EEBase Location)..
Encounter.serviceProviderReference(EEBase Organization)..
Encounter.partOfReference(EEBase Encounter)..

XML View

<StructureDefinition xmlns="http://hl7.org/fhir">
    <id value="EEBase-Encounter" />
    <url value="https://hl7.ee/fhir/StructureDefinition/EEBase-Encounter" />
    <version value="1.0.0" />
    <name value="EEBaseEncounter" />
    <title value="EEBase Encounter" />
    <status value="draft" />
    <date value="2022-11-21T13:22:24.2179018+00:00" />
    <publisher value="HL7 EE" />
    <fhirVersion value="4.0.1" />
    <kind value="resource" />
    <abstract value="false" />
    <type value="Encounter" />
    <baseDefinition value="http://hl7.org/fhir/StructureDefinition/Encounter" />
    <derivation value="constraint" />
    <differential>
        <element id="Encounter.extension">
            <path value="Encounter.extension" />
            <slicing>
                <discriminator>
                    <type value="value" />
                    <path value="url" />
                </discriminator>
                <rules value="open" />
            </slicing>
            <min value="0" />
        </element>
        <element id="Encounter.extension:modeOfArrival">
            <path value="Encounter.extension" />
            <sliceName value="modeOfArrival" />
            <definition value="Esimesel k&#252;lastusel tavaliselt registreeritakse kas tuli ise, kiirabiga v&#245;i teisiti." />
            <min value="0" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/StructureDefinition/encounter-modeOfArrival" />
            </type>
            <isModifier value="false" />
            <binding>
                <strength value="extensible" />
                <description value="The method that the patient arrived at the facility." />
                <valueSet value="https://hl7.ee/fhir/ValueSet/eebase-arrivalmode" />
            </binding>
        </element>
        <element id="Encounter.extension:associatedEncounter">
            <path value="Encounter.extension" />
            <sliceName value="associatedEncounter" />
            <min value="0" />
            <type>
                <code value="Extension" />
                <profile value="http://hl7.org/fhir/StructureDefinition/encounter-associatedEncounter" />
            </type>
            <isModifier value="false" />
        </element>
        <element id="Encounter.extension:associatedEncounter.value[x]">
            <path value="Encounter.extension.value[x]" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Encounter" />
            </type>
        </element>
        <element id="Encounter.status">
            <path value="Encounter.status" />
            <mustSupport value="true" />
        </element>
        <element id="Encounter.class">
            <path value="Encounter.class" />
            <mustSupport value="true" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="EncounterClass" />
                </extension>
                <strength value="extensible" />
                <valueSet value="https://hl7.ee/fhir/ValueSet/eebase-actencountercode" />
            </binding>
        </element>
        <element id="Encounter.classHistory.class">
            <path value="Encounter.classHistory.class" />
            <short value="Classification of patient encounter" />
            <definition value="Concepts representing classification of patient encounter such as ambulatory (outpatient), inpatient, emergency, home health or others due to local variations." />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="EncounterClass" />
                </extension>
                <strength value="extensible" />
                <valueSet value="https://hl7.ee/fhir/ValueSet/eebase-actencountercode" />
            </binding>
        </element>
        <element id="Encounter.priority">
            <path value="Encounter.priority" />
            <binding>
                <extension url="http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName">
                    <valueString value="Priority" />
                </extension>
                <strength value="extensible" />
                <valueSet value="https://hl7.ee/fhir/ValueSet/eebase-actpriority" />
            </binding>
        </element>
        <element id="Encounter.subject">
            <path value="Encounter.subject" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Group" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Patient" />
            </type>
        </element>
        <element id="Encounter.episodeOfCare">
            <path value="Encounter.episodeOfCare" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-EpisodeOfCare" />
            </type>
        </element>
        <element id="Encounter.participant.individual">
            <path value="Encounter.participant.individual" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Practitioner" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-PractitionerRole" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-RelatedPerson" />
            </type>
        </element>
        <element id="Encounter.reasonReference">
            <path value="Encounter.reasonReference" />
            <type>
                <code value="Reference" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Condition" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/Procedure" />
                <targetProfile value="http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Observation" />
            </type>
        </element>
        <element id="Encounter.hospitalization.origin">
            <path value="Encounter.hospitalization.origin" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Location" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Organization" />
            </type>
        </element>
        <element id="Encounter.hospitalization.destination">
            <path value="Encounter.hospitalization.destination" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Location" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Organization" />
            </type>
        </element>
        <element id="Encounter.location.location">
            <path value="Encounter.location.location" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Location" />
            </type>
        </element>
        <element id="Encounter.serviceProvider">
            <path value="Encounter.serviceProvider" />
            <type>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Organization" />
            </type>
        </element>
        <element id="Encounter.partOf">
            <path value="Encounter.partOf" />
            <short value="Reference to previous encounter | Viide eelmisele k&#252;lastusele" />
            <type>
                <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy">
                    <valueBoolean value="true" />
                </extension>
                <code value="Reference" />
                <targetProfile value="https://hl7.ee/fhir/StructureDefinition/EEBase-Encounter" />
            </type>
        </element>
    </differential>
</StructureDefinition>

JSON View

{
    "resourceType": "StructureDefinition",
    "id": "EEBase-Encounter",
    "url": "https://hl7.ee/fhir/StructureDefinition/EEBase-Encounter",
    "version": "1.0.0",
    "name": "EEBaseEncounter",
    "title": "EEBase Encounter",
    "status": "draft",
    "date": "2022-11-21T13:22:24.2179018+00:00",
    "publisher": "HL7 EE",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "Encounter",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/Encounter",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "Encounter.extension",
                "path": "Encounter.extension",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "url"
                        }
                    ],
                    "rules": "open"
                },
                "min": 0
            },
            {
                "id": "Encounter.extension:modeOfArrival",
                "path": "Encounter.extension",
                "sliceName": "modeOfArrival",
                "definition": "Esimesel külastusel tavaliselt registreeritakse kas tuli ise, kiirabiga või teisiti.",
                "min": 0,
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/StructureDefinition/encounter-modeOfArrival"
                        ]
                    }
                ],
                "isModifier": false,
                "binding": {
                    "strength": "extensible",
                    "description": "The method that the patient arrived at the facility.",
                    "valueSet": "https://hl7.ee/fhir/ValueSet/eebase-arrivalmode"
                }
            },
            {
                "id": "Encounter.extension:associatedEncounter",
                "path": "Encounter.extension",
                "sliceName": "associatedEncounter",
                "min": 0,
                "type":  [
                    {
                        "code": "Extension",
                        "profile":  [
                            "http://hl7.org/fhir/StructureDefinition/encounter-associatedEncounter"
                        ]
                    }
                ],
                "isModifier": false
            },
            {
                "id": "Encounter.extension:associatedEncounter.value[x]",
                "path": "Encounter.extension.value[x]",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Encounter"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.status",
                "path": "Encounter.status",
                "mustSupport": true
            },
            {
                "id": "Encounter.class",
                "path": "Encounter.class",
                "mustSupport": true,
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "EncounterClass"
                        }
                    ],
                    "strength": "extensible",
                    "valueSet": "https://hl7.ee/fhir/ValueSet/eebase-actencountercode"
                }
            },
            {
                "id": "Encounter.classHistory.class",
                "path": "Encounter.classHistory.class",
                "short": "Classification of patient encounter",
                "definition": "Concepts representing classification of patient encounter such as ambulatory (outpatient), inpatient, emergency, home health or others due to local variations.",
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "EncounterClass"
                        }
                    ],
                    "strength": "extensible",
                    "valueSet": "https://hl7.ee/fhir/ValueSet/eebase-actencountercode"
                }
            },
            {
                "id": "Encounter.priority",
                "path": "Encounter.priority",
                "binding": {
                    "extension":  [
                        {
                            "url": "http://hl7.org/fhir/StructureDefinition/elementdefinition-bindingName",
                            "valueString": "Priority"
                        }
                    ],
                    "strength": "extensible",
                    "valueSet": "https://hl7.ee/fhir/ValueSet/eebase-actpriority"
                }
            },
            {
                "id": "Encounter.subject",
                "path": "Encounter.subject",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Group",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Patient"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.episodeOfCare",
                "path": "Encounter.episodeOfCare",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-EpisodeOfCare"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.participant.individual",
                "path": "Encounter.participant.individual",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Practitioner",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-PractitionerRole",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-RelatedPerson"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.reasonReference",
                "path": "Encounter.reasonReference",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "http://hl7.org/fhir/StructureDefinition/Condition",
                            "http://hl7.org/fhir/StructureDefinition/Procedure",
                            "http://hl7.org/fhir/StructureDefinition/ImmunizationRecommendation",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Observation"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.hospitalization.origin",
                "path": "Encounter.hospitalization.origin",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Location",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.hospitalization.destination",
                "path": "Encounter.hospitalization.destination",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Location",
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.location.location",
                "path": "Encounter.location.location",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Location"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.serviceProvider",
                "path": "Encounter.serviceProvider",
                "type":  [
                    {
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Organization"
                        ]
                    }
                ]
            },
            {
                "id": "Encounter.partOf",
                "path": "Encounter.partOf",
                "short": "Reference to previous encounter | Viide eelmisele külastusele",
                "type":  [
                    {
                        "extension":  [
                            {
                                "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-hierarchy",
                                "valueBoolean": true
                            }
                        ],
                        "code": "Reference",
                        "targetProfile":  [
                            "https://hl7.ee/fhir/StructureDefinition/EEBase-Encounter"
                        ]
                    }
                ]
            }
        ]
    }
}


extension:modeOfArrival

This element describes how the patient was brought to the healthcare facility.

The ValueSet used in this case is EEBaseArrivalMode (Binding Strength = Extended), meaning these values SHOULD be exchanged, however, using additional concepts is allowed if necessary.


extension:associatedEncounter

A reference to associated encounter using reference to EEBaseEncounter.

This extension is used, when this encounter occurs within the scope of the referenced encounter.


identifier

The business identifier(s) associated with this encounter.


status (Must Support)

This is a mandatory data element.

Coded value for the status of the encounter.

The required ValueSet used in this case is encounter-status, meaning these values MUST be exchanged. Local value sets SHOULD be mapped to the required ValueSet.

HTML View

This code system http://hl7.org/fhir/encounter-status defines the following codes:

CodeDisplayDefinition
plannedPlannedThe Encounter has not yet started.
arrivedArrivedThe Patient is present for the encounter, however is not currently meeting with a practitioner.
triagedTriagedThe patient has been assessed for the priority of their treatment based on the severity of their condition.
in-progressIn ProgressThe Encounter has begun and the patient is present / the practitioner and the patient are meeting.
onleaveOn LeaveThe Encounter has begun, but the patient is temporarily on leave.
finishedFinishedThe Encounter has ended.
cancelledCancelledThe Encounter has ended before it has begun.
entered-in-errorEntered in ErrorThis instance should not have been part of this patient's medical record.
unknownUnknownThe encounter status is unknown. Note that "unknown" is a value of last resort and every attempt should be made to provide a meaningful value other than "unknown".

Table View

CodeSystem.id[0]encounter-status
CodeSystem.meta[0].lastUpdated[0]2019-11-01T09:29:23.356+11:00
CodeSystem.extension[0].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-wg
CodeSystem.extension[0].value[0]pa
CodeSystem.extension[1].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status
CodeSystem.extension[1].value[0]trial-use
CodeSystem.extension[2].url[0]http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm
CodeSystem.extension[2].value[0]2
CodeSystem.url[0]http://hl7.org/fhir/encounter-status
CodeSystem.identifier[0].system[0]urn:ietf:rfc:3986
CodeSystem.identifier[0].value[0]urn:oid:2.16.840.1.113883.4.642.4.247
CodeSystem.version[0]4.0.1
CodeSystem.name[0]EncounterStatus
CodeSystem.title[0]EncounterStatus
CodeSystem.status[0]draft
CodeSystem.experimental[0]False
CodeSystem.date[0]2019-11-01T09:29:23+11:00
CodeSystem.publisher[0]HL7 (FHIR Project)
CodeSystem.contact[0].telecom[0].system[0]url
CodeSystem.contact[0].telecom[0].value[0]http://hl7.org/fhir
CodeSystem.contact[0].telecom[1].system[0]email
CodeSystem.contact[0].telecom[1].value[0]fhir@lists.hl7.org
CodeSystem.description[0]Current state of the encounter.
CodeSystem.caseSensitive[0]True
CodeSystem.valueSet[0]http://hl7.org/fhir/ValueSet/encounter-status
CodeSystem.content[0]complete
CodeSystem.concept[0].code[0]planned
CodeSystem.concept[0].display[0]Planned
CodeSystem.concept[0].definition[0]The Encounter has not yet started.
CodeSystem.concept[1].code[0]arrived
CodeSystem.concept[1].display[0]Arrived
CodeSystem.concept[1].definition[0]The Patient is present for the encounter, however is not currently meeting with a practitioner.
CodeSystem.concept[2].code[0]triaged
CodeSystem.concept[2].display[0]Triaged
CodeSystem.concept[2].definition[0]The patient has been assessed for the priority of their treatment based on the severity of their condition.
CodeSystem.concept[3].code[0]in-progress
CodeSystem.concept[3].display[0]In Progress
CodeSystem.concept[3].definition[0]The Encounter has begun and the patient is present / the practitioner and the patient are meeting.
CodeSystem.concept[4].code[0]onleave
CodeSystem.concept[4].display[0]On Leave
CodeSystem.concept[4].definition[0]The Encounter has begun, but the patient is temporarily on leave.
CodeSystem.concept[5].code[0]finished
CodeSystem.concept[5].display[0]Finished
CodeSystem.concept[5].definition[0]The Encounter has ended.
CodeSystem.concept[6].code[0]cancelled
CodeSystem.concept[6].display[0]Cancelled
CodeSystem.concept[6].definition[0]The Encounter has ended before it has begun.
CodeSystem.concept[7].code[0]entered-in-error
CodeSystem.concept[7].display[0]Entered in Error
CodeSystem.concept[7].definition[0]This instance should not have been part of this patient's medical record.
CodeSystem.concept[8].code[0]unknown
CodeSystem.concept[8].display[0]Unknown
CodeSystem.concept[8].definition[0]The encounter status is unknown. Note that "unknown" is a value of last resort and every attempt should be made to provide a meaningful value other than "unknown".

XML View

<CodeSystem xmlns="http://hl7.org/fhir">
    <id value="encounter-status" />
    <meta>
        <lastUpdated value="2019-11-01T09:29:23.356+11:00" />
    </meta>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-wg">
        <valueCode value="pa" />
    </extension>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status">
        <valueCode value="trial-use" />
    </extension>
    <extension url="http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm">
        <valueInteger value="2" />
    </extension>
    <url value="http://hl7.org/fhir/encounter-status" />
    <identifier>
        <system value="urn:ietf:rfc:3986" />
        <value value="urn:oid:2.16.840.1.113883.4.642.4.247" />
    </identifier>
    <version value="4.0.1" />
    <name value="EncounterStatus" />
    <title value="EncounterStatus" />
    <status value="draft" />
    <experimental value="false" />
    <date value="2019-11-01T09:29:23+11:00" />
    <publisher value="HL7 (FHIR Project)" />
    <contact>
        <telecom>
            <system value="url" />
            <value value="http://hl7.org/fhir" />
        </telecom>
        <telecom>
            <system value="email" />
            <value value="fhir@lists.hl7.org" />
        </telecom>
    </contact>
    <description value="Current state of the encounter." />
    <caseSensitive value="true" />
    <valueSet value="http://hl7.org/fhir/ValueSet/encounter-status" />
    <content value="complete" />
    <concept>
        <code value="planned" />
        <display value="Planned" />
        <definition value="The Encounter has not yet started." />
    </concept>
    <concept>
        <code value="arrived" />
        <display value="Arrived" />
        <definition value="The Patient is present for the encounter, however is not currently meeting with a practitioner." />
    </concept>
    <concept>
        <code value="triaged" />
        <display value="Triaged" />
        <definition value="The patient has been assessed for the priority of their treatment based on the severity of their condition." />
    </concept>
    <concept>
        <code value="in-progress" />
        <display value="In Progress" />
        <definition value="The Encounter has begun and the patient is present / the practitioner and the patient are meeting." />
    </concept>
    <concept>
        <code value="onleave" />
        <display value="On Leave" />
        <definition value="The Encounter has begun, but the patient is temporarily on leave." />
    </concept>
    <concept>
        <code value="finished" />
        <display value="Finished" />
        <definition value="The Encounter has ended." />
    </concept>
    <concept>
        <code value="cancelled" />
        <display value="Cancelled" />
        <definition value="The Encounter has ended before it has begun." />
    </concept>
    <concept>
        <code value="entered-in-error" />
        <display value="Entered in Error" />
        <definition value="This instance should not have been part of this patient&#39;s medical record." />
    </concept>
    <concept>
        <code value="unknown" />
        <display value="Unknown" />
        <definition value="The encounter status is unknown. Note that &quot;unknown&quot; is a value of last resort and every attempt should be made to provide a meaningful value other than &quot;unknown&quot;." />
    </concept>
</CodeSystem>

JSON View

{
    "resourceType": "CodeSystem",
    "id": "encounter-status",
    "meta": {
        "lastUpdated": "2019-11-01T09:29:23.356+11:00"
    },
    "extension":  [
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-wg",
            "valueCode": "pa"
        },
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-standards-status",
            "valueCode": "trial-use"
        },
        {
            "url": "http://hl7.org/fhir/StructureDefinition/structuredefinition-fmm",
            "valueInteger": 2
        }
    ],
    "url": "http://hl7.org/fhir/encounter-status",
    "identifier":  [
        {
            "system": "urn:ietf:rfc:3986",
            "value": "urn:oid:2.16.840.1.113883.4.642.4.247"
        }
    ],
    "version": "4.0.1",
    "name": "EncounterStatus",
    "title": "EncounterStatus",
    "status": "draft",
    "experimental": false,
    "date": "2019-11-01T09:29:23+11:00",
    "publisher": "HL7 (FHIR Project)",
    "contact":  [
        {
            "telecom":  [
                {
                    "system": "url",
                    "value": "http://hl7.org/fhir"
                },
                {
                    "system": "email",
                    "value": "fhir@lists.hl7.org"
                }
            ]
        }
    ],
    "description": "Current state of the encounter.",
    "caseSensitive": true,
    "valueSet": "http://hl7.org/fhir/ValueSet/encounter-status",
    "content": "complete",
    "concept":  [
        {
            "code": "planned",
            "display": "Planned",
            "definition": "The Encounter has not yet started."
        },
        {
            "code": "arrived",
            "display": "Arrived",
            "definition": "The Patient is present for the encounter, however is not currently meeting with a practitioner."
        },
        {
            "code": "triaged",
            "display": "Triaged",
            "definition": "The patient has been assessed for the priority of their treatment based on the severity of their condition."
        },
        {
            "code": "in-progress",
            "display": "In Progress",
            "definition": "The Encounter has begun and the patient is present / the practitioner and the patient are meeting."
        },
        {
            "code": "onleave",
            "display": "On Leave",
            "definition": "The Encounter has begun, but the patient is temporarily on leave."
        },
        {
            "code": "finished",
            "display": "Finished",
            "definition": "The Encounter has ended."
        },
        {
            "code": "cancelled",
            "display": "Cancelled",
            "definition": "The Encounter has ended before it has begun."
        },
        {
            "code": "entered-in-error",
            "display": "Entered in Error",
            "definition": "This instance should not have been part of this patient's medical record."
        },
        {
            "code": "unknown",
            "display": "Unknown",
            "definition": "The encounter status is unknown. Note that \"unknown\" is a value of last resort and every attempt should be made to provide a meaningful value other than \"unknown\"."
        }
    ]
}


statusHistory

This element allows the encounter resource to contain the status history without having to read through historical versions of the resource, or even store them on the server.


class (Must Support)

This is a mandatory data element.

This element represents the classification of patient encounter.

The ValueSet used in this case is EEBaseActEncounterCode (Binding Strength = Extended), meaning these values SHOULD be exchanged, however, using additional concepts is allowed if necessary.


Code Display Definition
AMB ambulatory A comprehensive term for health care provided in a healthcare facility (e.g. a practitioneraTMs office, clinic setting, or hospital) on a nonresident basis. The term ambulatory usually implies that the patient has come to the location and is not assigned to a bed. Sometimes referred to as an outpatient encounter.
EMER emergency A patient encounter that takes place at a dedicated healthcare service delivery location where the patient receives immediate evaluation and treatment, provided until the patient can be discharged or responsibility for the patient's care is transferred elsewhere (for example, the patient could be admitted as an inpatient or transferred to another facility.)
HH home health Healthcare encounter that takes place in the residence of the patient or a designee
IMP inpatient encounter A patient encounter where a patient is admitted by a hospital or equivalent facility, assigned to a location where patients generally stay at least overnight and provided with room, board, and continuous nursing service.
OBSENC observation encounter An encounter where the patient usually will start in different encounter, such as one in the emergency department (EMER) but then transition to this type of encounter because they require a significant period of treatment and monitoring to determine whether or not their condition warrants an inpatient admission or discharge. In the majority of cases the decision about admission or discharge will occur within a time period determined by local, regional or national regulation, often between 24 and 48 hours.
SS short stay An encounter where the patient is admitted to a health care facility for a predetermined length of time, usually less than 24 hours.
VR virtual A patient encounter where the patient and the practitioner(s) are not in the same physical location. Examples include telephone conference, email exchange, robotic surgery, and televideo conference.

classHistory

The class history permits tracking transitions of encounters without needing to go through the resource history. This would be used for a case where an admission starts off as an emergency encounter, then transitions into an inpatient scenario. Doing this and not restarting a new encounter ensures that any lab/diagnostic results can more easily follow the patient and not require re-processing and not get lost or cancelled during a kind of discharge from emergency to inpatient.


type

Specific type of the encounter (e.g. e-mail consultation, surgical day-care, skilled nursing, rehabilitation).

The ValueSet used in this case is encounter-type. As this is a value set with Example binding, using this value set is not strictly expected.


serviceType

This element defines the type of service that is provided.

The ValueSet used in this case is service-type. As this is a value set with Example binding, using this value set is not strictly expected.


priority

The urgency of the encounter.

The ValueSet used in this case is EEBaseActPriority (Binding Strength = Extended), meaning these values SHOULD be exchanged, however, using additional concepts is allowed if necessary.


subject

Please note that this data element includes a reference to Group resource which has not been covered (profiled) in this Implementation Guide.
A reference to the patient or group present at the encounter by using a reference to EEBasePatient or Group resource.

episodeOfCare

Episode(s) of care that this encouner is part of using a reference to the EEBaseEpisodeOfCare.


basedOn

Please note that this data element includes a reference to ServiceRequest resource which has not been covered (profiled) in this Implementation Guide.
A reference to the ServiceRequest that initiated this encounter.

participant

Participant(s) involved in the encounter other than the patient.

The ValueSet that should be used to describe the type of the participant is encounter-participant-type (Binding Strength = Extended), meaning these values SHOULD be exchanged, however, using additional concepts is allowed if necessary.

The participant.individual element should use a reference to one of the following resources: EEBasePractitioner, EEBasePractitionerRole or EEBaseRelatedPerson.


appointment

Please note that this data element includes a reference to Appointment resource which has not been covered (profiled) in this Implementation Guide.
A reference to the appointment that scheduled this encounter.

period

The start and end time of the encounter.


length

Quantity of time the encounter lasted.


reasonCode

Code describing the reason for the encounter.

The preferred ValueSet used in this case is encounter-reason, meaning these values SHOULD be exchanged, however other ValueSets (either local or developed and published by the community) may be used if required. In that case mapping other ValueSets to encounter-reason by using the ConceptMap resource is encouraged.


reasonReference

Please note that this data element includes a reference to Condition, Procedure and ImmunizationRecommendation resources which have not been covered (profiled) in this Implementation Guide.
A reference to the reason why the encounter takes place by using reference to Condition, Procedure, ImmunizationRecommendation or EEBaseObservation.

diagnosis

Please note that this data element includes a reference to Condition and Procedure resource which has not been covered (profiled) in this Implementation Guide.
The list of diagnoses relevant to this encounter. If populated, reference to Condition or Procedure resource MUST be provided.

The diagnosis.use indicates the role that this diagnosis has within the encounter (e.g. admission, billing, discharge…). The preferred ValueSet used in this case is diagnosis-role.

account

Please note that this data element includes a reference to Account resource which has not been covered (profiled) in this Implementation Guide.
The set of accounts that may be used for billing for this encounter.

hospitalization

This element includes details about the admission to a healthcare facility and the element is only used when the patient is admitted to the hospital.

The child elements used are detailed below:

  • hospitalization.preAdmissionIdentifier - Pre-admission identifier
  • hospitalization.origin - The location/organization from which the patient came before admission by using a reference to EEBaseLocation or EEBaseOrganization.
  • hospitalization.admitSource - From where patient was admitted (physician referral, transfer)
  • hospitalization.reAdmission - The type of hospital re-admission that has occurred (if any). If the value is absent, then this is not identified as a readmission
  • hospitalization.dietPreference - Diet preferences reported by the patient
  • hospitalization.specialCourtesy - Special courtesies (VIP, board member)
  • hospitalization.specialArrangement - Any special requests that have been made for this hospitalization encounter, such as the provision of specific equipment or other things (wheelchair, translator, stretcher, etc..).
  • hospitalization.destination - Location/organization to which the patient is discharged by using a reference to EEBaseLocation or EEBaseOrganization.
  • hospitalization.dischargeDisposition - Category or kind of location after discharge

location

List of locations the encounter takes place using a reference to EEBaseLocation.


serviceProvider

The organization that is primarily providing this encounter's services by reference to EEBaseOrganization.


partOf

Reference to previous Encounter of which this encounter is a part of (administratively or in time) using a reference to EEBaseEncounter.