Structure Definition: EpisodeOfCare Profile


Canonical URL: https://signalbhn.org/fhir/StructureDefinition/episodeofcare

Simplifier project page: EpisodeOfCare

Derived from: FHIR Core R4 EpisodeOfCare

Module: Clinical Categorization Module


Formal profile content

identifier0..*Identifier
statusΣ ?!1..1codeBinding
status1..1codeBinding
periodI1..1Period
programΣ0..*CodeableConceptBinding
servicesΣ0..*CodeableConceptBinding
conditionΣ I1..1Reference(Condition)
roleΣ0..1CodeableConceptBinding
rankΣ0..1positiveInt
patientΣ I1..1Reference(Patient)
managingOrganizationΣ I0..1Reference(Organization)
periodΣ I0..1Period
referralRequestI0..*Reference(ServiceRequest)
careManagerI0..1Reference(Practitioner | PractitionerRole)
teamI0..*Reference(CareTeam)
accountI0..*Reference(Account)
identifier0..*Identifier
statusΣ ?!1..1codeBinding
status1..1codeBinding
periodI1..1Period
programΣ0..*CodeableConceptBinding
servicesΣ0..*CodeableConceptBinding
conditionΣ I1..1Reference(Condition)
roleΣ0..1CodeableConceptBinding
rankΣ0..1positiveInt
patientΣ I1..1Reference(Patient)
managingOrganizationΣ I0..1Reference(Organization)
periodΣ I0..1Period
referralRequestI0..*Reference(ServiceRequest)
careManagerI0..1Reference(Practitioner | PractitionerRole)
teamI0..*Reference(CareTeam)
accountI0..*Reference(Account)
{
    "resourceType": "StructureDefinition",
    "id": "signal-epdisodeofcare-profile",
    "url": "https://signalbhn.org/fhir/StructureDefinition/episodeofcare",
    "name": "SignalEpisodeOfCare",
    "title": "EpisodeOfCare Profile",
    "status": "active",
    "fhirVersion": "4.0.1",
    "kind": "resource",
    "abstract": false,
    "type": "EpisodeOfCare",
    "baseDefinition": "http://hl7.org/fhir/StructureDefinition/EpisodeOfCare",
    "derivation": "constraint",
    "differential": {
        "element":  [
            {
                "id": "EpisodeOfCare.status",
                "path": "EpisodeOfCare.status",
                "binding": {
                    "strength": "required",
                    "valueSet": "http://hl7.org/fhir/ValueSet/episode-of-care-status"
                }
            },
            {
                "id": "EpisodeOfCare.type",
                "path": "EpisodeOfCare.type",
                "slicing": {
                    "discriminator":  [
                        {
                            "type": "value",
                            "path": "coding.system"
                        }
                    ],
                    "rules": "open"
                },
                "binding": {
                    "strength": "extensible",
                    "valueSet": "https://signalbhn.org/fhir/ValueSet/signal-healthcare-service-type"
                }
            },
            {
                "id": "EpisodeOfCare.type:program",
                "path": "EpisodeOfCare.type",
                "sliceName": "program",
                "binding": {
                    "strength": "required",
                    "description": "This value set defines the set of codes that could be can be used to classify signal specific programs",
                    "valueSet": "https://signalbhn.org/fhir/ValueSet/signal-program"
                }
            },
            {
                "id": "EpisodeOfCare.type:services",
                "path": "EpisodeOfCare.type",
                "sliceName": "services",
                "binding": {
                    "strength": "required",
                    "description": "Signal specific healthcare service types being performed or delivered",
                    "valueSet": "https://signalbhn.org/fhir/ValueSet/signal-healthcare-service-type"
                }
            }
        ]
    }
}

Profile usage

The EpisodeOfCare resource represents the container for all services or contact points between a patient (client) and a healthcare services (provider). This resource is also called the 'admission' and captures the entire case history for a patient for a program and selected services (service types).

EpisodeOfCare will rarely change once it is created. Some instances of changes will be: an updated period.start date in the case of a referral or a period.end date for a discharge. In the latter case, the status should also be updated to 'complete'. Additional encounters will point to an EpisodeOfCare resource and not the other way around.

Referrals in EpisodeOfCare

Any referrals from the Jolata system (called referrals) will reference a Structure Definition: ServiceRequest Profile on the EpisodeOfCare.referralRequest element. This will often begin a patient's admission record and SHOULD contain an Encounter record for the first contact or any interaction attempt with related codes. Although this first attempt may start an admission and encounter records, the EpisodeOfCare.period.start date MAY correspond to when an admission took place, usually beginning with a survey assessment.

Profile element notes

.type

  • Will remain FHIR default (example) but will be unused at this time (see slices)

.type:program

  • Represents the same concept as the HealthcareService.program element
  • SHALL be used to group services offered by one or more organizations under a formal "program" label; e.g. SUD, CYMHTA, CCS.
  • Programs are relatively static within the organization and create the main taxonomy for the service categories and procedures available.

.type:services

  • Represents the same concept as the HealthcareService.type:services element
  • Custom code system for Signal that represents the "services" or "service type" codes that are available based on Organization qualifications; e.g. asam-0.5, da, crisis-mobile, etc.

.managingOrganization

  • Represents the UI field 'Primary Service Location'
  • Although this represents a single provider location, encounters pointing to this EpisodeOfCare may have different locations and/or with entirely different provider agencies
  • This will primarily be used to provide default HealthcareService offerings on the UI
  • The higher-level Provider Agency (accessed via the highest level of Organization.partOf) should be considered for all HealthcareService offerings available to the UI

.referralRequest

  • SHOULD point to the ServiceRequest resource that represents the referral from the Jolata system
  • This will only represent required information contained in the Jolata referral system. Edits to referral information should come from Jolata.

.careManager

  • SHALL point to the practitioner that is designated as the care manager when .referralRequest is populated

.team

  • Not presently used

Examples