8.10 Resource EpisodeOfCare - Content

Name	Flags	Card.	Type	Description & Constraints
EpisodeOfCare	TU		DomainResource	An association of a Patient with an Organization and Healthcare Provider(s) for a period of time that the Organization assumes some level of responsibility Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
status	?! Σ	1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error EpisodeOfCareStatus Binding: Episode Of Care Status ( Required )
statusHistory		0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
status		1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error EpisodeOfCareStatus Binding: Episode Of Care Status ( Required )
period		1..1	Period	Duration the EpisodeOfCare was in the specified status
type	Σ	0..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of care type Of Care Type ( Example )
diagnosis reason	Σ	0..*	BackboneElement	The list of diagnosis relevant medical reasons that are expected to this be addressed during the episode of care
condition use	Σ	1..1 0..1	Reference CodeableConcept	What the reason value should be used for/as Binding: Encounter Reason Use ( Example )
value	Σ	0..*	CodeableReference ( Condition | Procedure | Observation | HealthcareService )	Medical reason to be addressed Binding: Encounter Reason Codes ( Example )
diagnosis	Conditions/problems/diagnoses this Σ	0..*	BackboneElement	The list of medical conditions that were addressed during the episode of care is for
role condition	Σ	0..1 0..*	CodeableConcept CodeableReference ( Condition )	Role The medical condition that this diagnosis has within was addressed during the episode of care (e.g. admission, billing, discharge …) DiagnosisRole Binding: Condition/Problem/Diagnosis Codes ( Preferred Example )
rank use	Σ	0..1	positiveInt CodeableConcept	Ranking of the Role that this diagnosis (for each role type) has within the episode of care (e.g. admission, billing, discharge …) Binding: Encounter Diagnosis Use ( Preferred )
patient	Σ	1..1	Reference ( Patient )	The patient who is the focus of this episode of care
managingOrganization	Σ	0..1	Reference ( Organization )	Organization that assumes responsibility for care coordination
period	Σ	0..1	Period	Interval during responsibility is assumed
referralRequest		0..*	Reference ( ServiceRequest )	Originating Referral Request(s)
careManager		0..1	Reference ( Practitioner | PractitionerRole )	Care manager/care coordinator for the patient
team careTeam		0..*	Reference ( CareTeam )	Other practitioners facilitating this episode of care
account		0..*	Reference ( Account )	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

See the Extensions for this resource

<EpisodeOfCare xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business Identifier(s) relevant for this EpisodeOfCare --></identifier>
 <status value="[code]"/><!-- 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error -->
 <statusHistory>  <!-- 0..* Past list of status codes (the current status may be included to cover the start date of the status) -->
  <status value="[code]"/><!-- 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error -->
  <period><!-- 1..1 Period Duration the EpisodeOfCare was in the specified status --></period>
 </statusHistory>
 <type><!-- 0..* CodeableConcept Type/class  - e.g. specialist referral, disease management --></type>
 <
  <</condition>
  <</role>
  <

 <reason>  <!-- 0..* The list of medical reasons that are expected to be addressed during the episode of care -->
  <use><!-- 0..1 CodeableConcept What the reason value should be used for/as --></use>
  <value><!-- 0..* CodeableReference(Condition|HealthcareService|Observation|
    Procedure) Medical reason to be addressed --></value>

 </reason>
 <diagnosis>  <!-- 0..* The list of medical conditions that were addressed during the episode of care -->
  <condition><!-- 0..* CodeableReference(Condition) The medical condition that was addressed during the episode of care --></condition>
  <use><!-- 0..1 CodeableConcept Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …) --></use>

 </diagnosis>
 <patient><!-- 1..1 Reference(Patient) The patient who is the focus of this episode of care --></patient>
 <</managingOrganization>

 <managingOrganization><!-- 0..1 Reference(Organization) Organization that assumes responsibility for care coordination --></managingOrganization>

 <period><!-- 0..1 Period Interval during responsibility is assumed --></period>
 <referralRequest><!-- 0..* Reference(ServiceRequest) Originating Referral Request(s) --></referralRequest>
 <careManager><!-- 0..1 Reference(Practitioner|PractitionerRole) Care manager/care coordinator for the patient --></careManager>
 <</team>

 <careTeam><!-- 0..* Reference(CareTeam) Other practitioners facilitating this episode of care --></careTeam>

 <account><!-- 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare --></account>
</EpisodeOfCare>

{
  "resourceType" : "EpisodeOfCare",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business Identifier(s) relevant for this EpisodeOfCare
  "status" : "<code>", // R!  planned | waitlist | active | onhold | finished | cancelled | entered-in-error
  "statusHistory" : [{ // Past list of status codes (the current status may be included to cover the start date of the status)
    "status" : "<code>", // R!  planned | waitlist | active | onhold | finished | cancelled | entered-in-error
    "period" : { Period } // R!  Duration the EpisodeOfCare was in the specified status
  }],
  "type" : [{ CodeableConcept }], // Type/class  - e.g. specialist referral, disease management
  "
    "
    "
    "

  "reason" : [{ // The list of medical reasons that are expected to be addressed during the episode of care
    "use" : { CodeableConcept }, // What the reason value should be used for/as
    "value" : [{ CodeableReference(Condition|HealthcareService|Observation|
    Procedure) }] // Medical reason to be addressed

  }],
  "diagnosis" : [{ // The list of medical conditions that were addressed during the episode of care
    "condition" : [{ CodeableReference(Condition) }], // The medical condition that was addressed during the episode of care
    "use" : { CodeableConcept } // Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …)

  }],
  "patient" : { Reference(Patient) }, // R!  The patient who is the focus of this episode of care
  "

  "managingOrganization" : { Reference(Organization) }, // Organization that assumes responsibility for care coordination

  "period" : { Period }, // Interval during responsibility is assumed
  "referralRequest" : [{ Reference(ServiceRequest) }], // Originating Referral Request(s)
  "careManager" : { Reference(Practitioner|PractitionerRole) }, // Care manager/care coordinator for the patient
  "

  "careTeam" : [{ Reference(CareTeam) }], // Other practitioners facilitating this episode of care

  "account" : [{ Reference(Account) }] // The set of accounts that may be used for billing for this EpisodeOfCare
}

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:EpisodeOfCare;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business Identifier(s) relevant for this EpisodeOfCare
  fhir:status [ code ] ; # 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error
  fhir:statusHistory ( [ # 0..* Past list of status codes (the current status may be included to cover the start date of the status)
    fhir:status [ code ] ; # 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error
    fhir:period [ Period ] ; # 1..1 Duration the EpisodeOfCare was in the specified status
  ] ... ) ;
  fhir:type  ( [ CodeableConcept ] ... ) ; # 0..* Type/class  - e.g. specialist referral, disease management
  fhir:reason ( [ # 0..* The list of medical reasons that are expected to be addressed during the episode of care
    fhir:use [ CodeableConcept ] ; # 0..1 What the reason value should be used for/as
    fhir:value  ( [ CodeableReference(Condition|HealthcareService|Observation|Procedure) ] ... ) ; # 0..* Medical reason to be addressed
  ] ... ) ;
  fhir:diagnosis ( [ # 0..* The list of medical conditions that were addressed during the episode of care
    fhir:condition  ( [ CodeableReference(Condition) ] ... ) ; # 0..* The medical condition that was addressed during the episode of care
    fhir:use [ CodeableConcept ] ; # 0..1 Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …)
  ] ... ) ;
  fhir:patient [ Reference(Patient) ] ; # 1..1 The patient who is the focus of this episode of care
  fhir:managingOrganization [ Reference(Organization) ] ; # 0..1 Organization that assumes responsibility for care coordination
  fhir:period [ Period ] ; # 0..1 Interval during responsibility is assumed
  fhir:referralRequest  ( [ Reference(ServiceRequest) ] ... ) ; # 0..* Originating Referral Request(s)
  fhir:careManager [ Reference(Practitioner|PractitionerRole) ] ; # 0..1 Care manager/care coordinator for the patient
  fhir:careTeam  ( [ Reference(CareTeam) ] ... ) ; # 0..* Other practitioners facilitating this episode of care
  fhir:account  ( [ Reference(Account) ] ... ) ; # 0..* The set of accounts that may be used for billing for this EpisodeOfCare

]

Changes since R3 from both R4 and R4B

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

See R3 <--> R4 <--> R5 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and all r3 resources are valid.) See Conversions Summary .)

Name	Flags	Card.	Type	Description & Constraints
EpisodeOfCare	TU		DomainResource	An association of a Patient with an Organization and Healthcare Provider(s) for a period of time that the Organization assumes some level of responsibility Elements defined in Ancestors: id , meta , implicitRules , language , text , contained , extension , modifierExtension
identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
status	?! Σ	1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error EpisodeOfCareStatus Binding: Episode Of Care Status ( Required )
statusHistory		0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
status		1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error EpisodeOfCareStatus Binding: Episode Of Care Status ( Required )
period		1..1	Period	Duration the EpisodeOfCare was in the specified status
type	Σ	0..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of care type Of Care Type ( Example )
diagnosis reason	Σ	0..*	BackboneElement	The list of diagnosis relevant medical reasons that are expected to this be addressed during the episode of care
condition use	Σ	1..1 0..1	Reference CodeableConcept	What the reason value should be used for/as Binding: Encounter Reason Use ( Example )
value	Σ	0..*	CodeableReference ( Condition | Procedure | Observation | HealthcareService )	Medical reason to be addressed Binding: Encounter Reason Codes ( Example )
diagnosis	Conditions/problems/diagnoses this Σ	0..*	BackboneElement	The list of medical conditions that were addressed during the episode of care is for
role condition	Σ	0..1 0..*	CodeableConcept CodeableReference ( Condition )	Role The medical condition that this diagnosis has within was addressed during the episode of care (e.g. admission, billing, discharge …) DiagnosisRole Binding: Condition/Problem/Diagnosis Codes ( Preferred Example )
rank use	Σ	0..1	positiveInt CodeableConcept	Ranking of the Role that this diagnosis (for each role type) has within the episode of care (e.g. admission, billing, discharge …) Binding: Encounter Diagnosis Use ( Preferred )
patient	Σ	1..1	Reference ( Patient )	The patient who is the focus of this episode of care
managingOrganization	Σ	0..1	Reference ( Organization )	Organization that assumes responsibility for care coordination
period	Σ	0..1	Period	Interval during responsibility is assumed
referralRequest		0..*	Reference ( ServiceRequest )	Originating Referral Request(s)
careManager		0..1	Reference ( Practitioner | PractitionerRole )	Care manager/care coordinator for the patient
team careTeam		0..*	Reference ( CareTeam )	Other practitioners facilitating this episode of care
account		0..*	Reference ( Account )	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

See the Extensions for this resource

<EpisodeOfCare xmlns="http://hl7.org/fhir"> 
 <!-- from Resource: id, meta, implicitRules, and language -->
 <!-- from DomainResource: text, contained, extension, and modifierExtension -->
 <identifier><!-- 0..* Identifier Business Identifier(s) relevant for this EpisodeOfCare --></identifier>
 <status value="[code]"/><!-- 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error -->
 <statusHistory>  <!-- 0..* Past list of status codes (the current status may be included to cover the start date of the status) -->
  <status value="[code]"/><!-- 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error -->
  <period><!-- 1..1 Period Duration the EpisodeOfCare was in the specified status --></period>
 </statusHistory>
 <type><!-- 0..* CodeableConcept Type/class  - e.g. specialist referral, disease management --></type>
 <
  <</condition>
  <</role>
  <

 <reason>  <!-- 0..* The list of medical reasons that are expected to be addressed during the episode of care -->
  <use><!-- 0..1 CodeableConcept What the reason value should be used for/as --></use>
  <value><!-- 0..* CodeableReference(Condition|HealthcareService|Observation|
    Procedure) Medical reason to be addressed --></value>

 </reason>
 <diagnosis>  <!-- 0..* The list of medical conditions that were addressed during the episode of care -->
  <condition><!-- 0..* CodeableReference(Condition) The medical condition that was addressed during the episode of care --></condition>
  <use><!-- 0..1 CodeableConcept Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …) --></use>

 </diagnosis>
 <patient><!-- 1..1 Reference(Patient) The patient who is the focus of this episode of care --></patient>
 <</managingOrganization>

 <managingOrganization><!-- 0..1 Reference(Organization) Organization that assumes responsibility for care coordination --></managingOrganization>

 <period><!-- 0..1 Period Interval during responsibility is assumed --></period>
 <referralRequest><!-- 0..* Reference(ServiceRequest) Originating Referral Request(s) --></referralRequest>
 <careManager><!-- 0..1 Reference(Practitioner|PractitionerRole) Care manager/care coordinator for the patient --></careManager>
 <</team>

 <careTeam><!-- 0..* Reference(CareTeam) Other practitioners facilitating this episode of care --></careTeam>

 <account><!-- 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare --></account>
</EpisodeOfCare>

{
  "resourceType" : "EpisodeOfCare",
  // from Resource: id, meta, implicitRules, and language
  // from DomainResource: text, contained, extension, and modifierExtension
  "identifier" : [{ Identifier }], // Business Identifier(s) relevant for this EpisodeOfCare
  "status" : "<code>", // R!  planned | waitlist | active | onhold | finished | cancelled | entered-in-error
  "statusHistory" : [{ // Past list of status codes (the current status may be included to cover the start date of the status)
    "status" : "<code>", // R!  planned | waitlist | active | onhold | finished | cancelled | entered-in-error
    "period" : { Period } // R!  Duration the EpisodeOfCare was in the specified status
  }],
  "type" : [{ CodeableConcept }], // Type/class  - e.g. specialist referral, disease management
  "
    "
    "
    "

  "reason" : [{ // The list of medical reasons that are expected to be addressed during the episode of care
    "use" : { CodeableConcept }, // What the reason value should be used for/as
    "value" : [{ CodeableReference(Condition|HealthcareService|Observation|
    Procedure) }] // Medical reason to be addressed

  }],
  "diagnosis" : [{ // The list of medical conditions that were addressed during the episode of care
    "condition" : [{ CodeableReference(Condition) }], // The medical condition that was addressed during the episode of care
    "use" : { CodeableConcept } // Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …)

  }],
  "patient" : { Reference(Patient) }, // R!  The patient who is the focus of this episode of care
  "

  "managingOrganization" : { Reference(Organization) }, // Organization that assumes responsibility for care coordination

  "period" : { Period }, // Interval during responsibility is assumed
  "referralRequest" : [{ Reference(ServiceRequest) }], // Originating Referral Request(s)
  "careManager" : { Reference(Practitioner|PractitionerRole) }, // Care manager/care coordinator for the patient
  "

  "careTeam" : [{ Reference(CareTeam) }], // Other practitioners facilitating this episode of care

  "account" : [{ Reference(Account) }] // The set of accounts that may be used for billing for this EpisodeOfCare
}

@prefix fhir: <http://hl7.org/fhir/> .


[ a fhir:EpisodeOfCare;
  fhir:nodeRole fhir:treeRoot; # if this is the parser root

  # from Resource: .id, .meta, .implicitRules, and .language
  # from DomainResource: .text, .contained, .extension, and .modifierExtension
  fhir:
  fhir:
  fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
    fhir:
    fhir:
    fhir:
  ], ...;
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:
  fhir:

  fhir:identifier  ( [ Identifier ] ... ) ; # 0..* Business Identifier(s) relevant for this EpisodeOfCare
  fhir:status [ code ] ; # 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error
  fhir:statusHistory ( [ # 0..* Past list of status codes (the current status may be included to cover the start date of the status)
    fhir:status [ code ] ; # 1..1 planned | waitlist | active | onhold | finished | cancelled | entered-in-error
    fhir:period [ Period ] ; # 1..1 Duration the EpisodeOfCare was in the specified status
  ] ... ) ;
  fhir:type  ( [ CodeableConcept ] ... ) ; # 0..* Type/class  - e.g. specialist referral, disease management
  fhir:reason ( [ # 0..* The list of medical reasons that are expected to be addressed during the episode of care
    fhir:use [ CodeableConcept ] ; # 0..1 What the reason value should be used for/as
    fhir:value  ( [ CodeableReference(Condition|HealthcareService|Observation|Procedure) ] ... ) ; # 0..* Medical reason to be addressed
  ] ... ) ;
  fhir:diagnosis ( [ # 0..* The list of medical conditions that were addressed during the episode of care
    fhir:condition  ( [ CodeableReference(Condition) ] ... ) ; # 0..* The medical condition that was addressed during the episode of care
    fhir:use [ CodeableConcept ] ; # 0..1 Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …)
  ] ... ) ;
  fhir:patient [ Reference(Patient) ] ; # 1..1 The patient who is the focus of this episode of care
  fhir:managingOrganization [ Reference(Organization) ] ; # 0..1 Organization that assumes responsibility for care coordination
  fhir:period [ Period ] ; # 0..1 Interval during responsibility is assumed
  fhir:referralRequest  ( [ Reference(ServiceRequest) ] ... ) ; # 0..* Originating Referral Request(s)
  fhir:careManager [ Reference(Practitioner|PractitionerRole) ] ; # 0..1 Care manager/care coordinator for the patient
  fhir:careTeam  ( [ Reference(CareTeam) ] ... ) ; # 0..* Other practitioners facilitating this episode of care
  fhir:account  ( [ Reference(Account) ] ... ) ; # 0..* The set of accounts that may be used for billing for this EpisodeOfCare

]

Changes since Release 3 from both R4 and R4B

See the Full Difference for further information

This analysis is available for R4 as XML or JSON and for R4B as XML or JSON .

See R3 <--> R4 <--> R5 Conversion Maps (status = 1 test that all execute ok. All tests pass round-trip testing and all r3 resources are valid.) See Conversions Summary .)