StructureDefinition: ehealth-episodeofcare

Introduction

An EpisodeOfCare is an association between a patient and an organization / healthcare provider(s) during which time encounters may occur.

Scope and Usage

In scope of the eHealth infrastructure, creation of an EpisodeOfCare resource is triggered by a number of actions taking place out-of-band, that is, outside the scope of the eHealth infrastructure. Firstly, a patient is diagnosed with one or more conditions; then assessed as fulfilling criteria for enrollment in a telemedical care program leading to a referral being made to an organization providing such program. At this point a Practitioner within the providing organization creates an EpisodeOfCare referring to the Patient and the corresponding Conditions, all in the eHealth infrastructure. Created with status planned, the Practitioner updates the status to active once:

a Consent to enroll in the program has been given by the Patient
Adjustments have possibly been made to assigned CareTeam(s) in team.

The EpisodeOfCare functions as a representation of a program while the activities comprising it are defined in one or more CarePlan resources.

careManagerOrganization and managingOrganization

An EpisodeOfCare is required to have exactly one reference to the Organization responsible for the treatment through the element ehealth-episodeofcare-caremanagerOrganization.

The element managingOrganization references the Organization which is data controller for the EpisodeOfCare and all other resources directly or indirectly referencing it.

CareTeam and history of CareTeam

The CareTeam(s) currently responsible for the EpisodeOfCare are referenced in element team. Changes in CareTeam references are automatically maintained in the element ehealth-teamHistory.

Formal Views of Profile Content

The official URL for this profile is:

http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare

This profile builds on EpisodeOfCare.

This profile was published on Fri Jul 01 12:30:20 UTC 2022 as a draft by ehealth.sundhed.dk.

Description of Profiles, Differentials, Snapshots, and how the XML and JSON presentations work.

This structure is derived from EpisodeOfCare

Summary

Mandatory: 4 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

This structure is derived from EpisodeOfCare

Name	Card.	Type	Description & Constraints
EpisodeOfCare	0..*	EpisodeOfCare	An association between a patient and an organization / healthcare provider(s) during which time encounters may occur.
extension	0..*	Extension	Extension Slice: Unordered, Open by value:url
ehealth-episodeofcare-caremanagerOrganization	1..1	Reference()	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-caremanagerOrganization
ehealth-teamHistory	0..*	(Complex)	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamHistory
ehealth-episodeofcare-statusschedule	0..*	(Complex)	Status Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-statusschedule
ehealth-teamschedule	0..*	(Complex)	Team Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamschedule
diagnosis	1..*	BackboneElement	The list of diagnosis relevant to this episode of care
condition	1..1	Reference(eHealth Condition) {r }	Conditions/problems/diagnoses this episode of care is for
patient	1..1	Reference(eHealth Patient) {r }	The patient who is the focus of this episode of care
managingOrganization	1..1	Reference(eHealth Organization) {r }	Organization that assumes care
period	1..1	Period	Interval during responsibility is assumed
referralRequest	0..*	Reference(ReferralRequest) {r }	Originating Referral Request(s)
careManager	0..0
team	0..*	Reference(eHealth CareTeam) {r }	Other practitioners facilitating this episode of care
account	0..0
Documentation for this format

This structure is derived from EpisodeOfCare

Name	Flags	Card.	Type	Description & Constraints
EpisodeOfCare	I	0..*	EpisodeOfCare	An association between a patient and an organization / healthcare provider(s) during which time encounters may occur.
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: Common Languages (extensible) Max Binding: All Languages
text	I	0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
ehealth-episodeofcare-caremanagerOrganization	I	1..1	Reference()	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-caremanagerOrganization
ehealth-teamHistory	I	0..*	(Complex)	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamHistory
ehealth-episodeofcare-statusschedule	I	0..*	(Complex)	Status Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-statusschedule
ehealth-teamschedule	I	0..*	(Complex)	Team Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamschedule
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
status	?!Σ	1..1	code	planned \| waitlist \| active \| onhold \| finished \| cancelled \| entered-in-error Binding: EpisodeOfCareStatus (required)
statusHistory	I	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
id		0..1	string	xml:id (or equivalent in JSON)
extension		0..*	Extension	Additional Content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored
status		1..1	code	planned \| waitlist \| active \| onhold \| finished \| cancelled \| entered-in-error Binding: EpisodeOfCareStatus (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: EpisodeOfCareType (example)
diagnosis	ΣI	1..*	BackboneElement	The list of diagnosis relevant to this episode of care
id		0..1	string	xml:id (or equivalent in JSON)
extension		0..*	Extension	Additional Content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored
condition	Σ	1..1	Reference(eHealth Condition) {r }	Conditions/problems/diagnoses this episode of care is for
role	Σ	0..1	CodeableConcept	Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …) Binding: DiagnosisRole (preferred)
rank	Σ	0..1	positiveInt	Ranking of the diagnosis (for each role type)
patient	Σ	1..1	Reference(eHealth Patient) {r }	The patient who is the focus of this episode of care
managingOrganization	Σ	1..1	Reference(eHealth Organization) {r }	Organization that assumes care
period	Σ	1..1	Period	Interval during responsibility is assumed
referralRequest		0..*	Reference(ReferralRequest) {r }	Originating Referral Request(s)
team		0..*	Reference(eHealth CareTeam) {r }	Other practitioners facilitating this episode of care
Documentation for this format

This structure is derived from EpisodeOfCare

Summary

Mandatory: 4 elements
Prohibited: 2 elements

Structures

This structure refers to these other structures:

Extensions

This structure refers to these extensions:

Differential View

This structure is derived from EpisodeOfCare

Name	Card.	Type	Description & Constraints
EpisodeOfCare	0..*	EpisodeOfCare	An association between a patient and an organization / healthcare provider(s) during which time encounters may occur.
extension	0..*	Extension	Extension Slice: Unordered, Open by value:url
ehealth-episodeofcare-caremanagerOrganization	1..1	Reference()	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-caremanagerOrganization
ehealth-teamHistory	0..*	(Complex)	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamHistory
ehealth-episodeofcare-statusschedule	0..*	(Complex)	Status Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-statusschedule
ehealth-teamschedule	0..*	(Complex)	Team Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamschedule
diagnosis	1..*	BackboneElement	The list of diagnosis relevant to this episode of care
condition	1..1	Reference(eHealth Condition) {r }	Conditions/problems/diagnoses this episode of care is for
patient	1..1	Reference(eHealth Patient) {r }	The patient who is the focus of this episode of care
managingOrganization	1..1	Reference(eHealth Organization) {r }	Organization that assumes care
period	1..1	Period	Interval during responsibility is assumed
referralRequest	0..*	Reference(ReferralRequest) {r }	Originating Referral Request(s)
careManager	0..0
team	0..*	Reference(eHealth CareTeam) {r }	Other practitioners facilitating this episode of care
account	0..0
Documentation for this format

Snapshot View

Name	Flags	Card.	Type	Description & Constraints
EpisodeOfCare	I	0..*	EpisodeOfCare	An association between a patient and an organization / healthcare provider(s) during which time encounters may occur.
id	Σ	0..1	id	Logical id of this artifact
meta	Σ	0..1	Meta	Metadata about the resource
implicitRules	?!Σ	0..1	uri	A set of rules under which this content was created
language		0..1	code	Language of the resource content Binding: Common Languages (extensible) Max Binding: All Languages
text	I	0..1	Narrative	Text summary of the resource, for human interpretation
contained		0..*	Resource	Contained, inline Resources
extension		0..*	Extension	Extension Slice: Unordered, Open by value:url
ehealth-episodeofcare-caremanagerOrganization	I	1..1	Reference()	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-caremanagerOrganization
ehealth-teamHistory	I	0..*	(Complex)	Extension URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamHistory
ehealth-episodeofcare-statusschedule	I	0..*	(Complex)	Status Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-episodeofcare-statusschedule
ehealth-teamschedule	I	0..*	(Complex)	Team Schedule URL: http://ehealth.sundhed.dk/fhir/StructureDefinition/ehealth-teamschedule
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
status	?!Σ	1..1	code	planned \| waitlist \| active \| onhold \| finished \| cancelled \| entered-in-error Binding: EpisodeOfCareStatus (required)
statusHistory	I	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
id		0..1	string	xml:id (or equivalent in JSON)
extension		0..*	Extension	Additional Content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored
status		1..1	code	planned \| waitlist \| active \| onhold \| finished \| cancelled \| entered-in-error Binding: EpisodeOfCareStatus (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: EpisodeOfCareType (example)
diagnosis	ΣI	1..*	BackboneElement	The list of diagnosis relevant to this episode of care
id		0..1	string	xml:id (or equivalent in JSON)
extension		0..*	Extension	Additional Content defined by implementations
modifierExtension	?!Σ	0..*	Extension	Extensions that cannot be ignored
condition	Σ	1..1	Reference(eHealth Condition) {r }	Conditions/problems/diagnoses this episode of care is for
role	Σ	0..1	CodeableConcept	Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …) Binding: DiagnosisRole (preferred)
rank	Σ	0..1	positiveInt	Ranking of the diagnosis (for each role type)
patient	Σ	1..1	Reference(eHealth Patient) {r }	The patient who is the focus of this episode of care
managingOrganization	Σ	1..1	Reference(eHealth Organization) {r }	Organization that assumes care
period	Σ	1..1	Period	Interval during responsibility is assumed
referralRequest		0..*	Reference(ReferralRequest) {r }	Originating Referral Request(s)
team		0..*	Reference(eHealth CareTeam) {r }	Other practitioners facilitating this episode of care
Documentation for this format

Terminology Bindings

Path	Conformance	ValueSet
EpisodeOfCare.language	extensible	Common Languages Max Binding: All Languages
EpisodeOfCare.status	required	EpisodeOfCareStatus
EpisodeOfCare.statusHistory.status	required	EpisodeOfCareStatus
EpisodeOfCare.type	example	EpisodeOfCareType
EpisodeOfCare.diagnosis.role	preferred	DiagnosisRole

Constraints

Id	Path	Details	Requirements
dom-2	EpisodeOfCare	If the resource is contained in another resource, it SHALL NOT contain nested Resources : contained.contained.empty()
dom-1	EpisodeOfCare	If the resource is contained in another resource, it SHALL NOT contain any narrative : contained.text.empty()
dom-4	EpisodeOfCare	If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated : contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-3	EpisodeOfCare	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource : contained.where(('#'+id in %resource.descendants().reference).not()).empty()
ele-1	EpisodeOfCare.extension:caremanagerOrganization	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())
ext-1	EpisodeOfCare.extension:caremanagerOrganization	Must have either extensions or value[x], not both : extension.exists() != value.exists()
ele-1	EpisodeOfCare.extension:teamHistory	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())
ext-1	EpisodeOfCare.extension:teamHistory	Must have either extensions or value[x], not both : extension.exists() != value.exists()
ele-1	EpisodeOfCare.extension:statusSchedule	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())
ext-1	EpisodeOfCare.extension:statusSchedule	Must have either extensions or value[x], not both : extension.exists() != value.exists()
ele-1	EpisodeOfCare.extension:teamSchedule	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())
ext-1	EpisodeOfCare.extension:teamSchedule	Must have either extensions or value[x], not both : extension.exists() != value.exists()
ele-1	EpisodeOfCare.statusHistory	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())
ele-1	EpisodeOfCare.diagnosis	All FHIR elements must have a @value or children : hasValue() \| (children().count() > id.count())