SIL HIE Implementation Guide, published by Kathurima Kimathi. This guide is not an authorized publication; it is the continuous build for version 0.1.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/savannahghi/hie-fhir-ig-profile/ and changes regularly. See the Directory of published versions

• Content
• Detailed Descriptions
• Mappings
• Examples
• XML
• JSON
• TTL

Resource Profile: HIE EpisodeOfCare

EpisodeOfCare is the representation of EpisodeOfCare FHIR resource to be used with national HIE

Usages:

• Refer to this Profile: HIE DocumentReference, HIE Encounter and HIE MedicationDispense
• Examples for this Profile: EpisodeOfCare/ExampleKenyaEpisodeOfCare

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

• Key Elements Table
• Differential Table
• Snapshot Table
• Statistics/References
• All

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
EpisodeOfCare		0..*	EpisodeOfCare	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
EpisodeOfCare.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
EpisodeOfCare.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
EpisodeOfCare.identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
EpisodeOfCare.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
EpisodeOfCare.identifier.type	Σ This element is included in summaries. C	1..1	HIECodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible) Constraints: cc-text-or-code
EpisodeOfCare.identifier.system	Σ This element is included in summaries.	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
EpisodeOfCare.identifier.value	S This element must be supported. Σ This element is included in summaries.	1..1	string	The value that is unique Example General: 123456
EpisodeOfCare.identifier.assigner	S This element must be supported. Σ This element is included in summaries.	0..1	HIEReference(HIE Organization)	Organization that issued id (may be just text)
EpisodeOfCare.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory	S This element must be supported.	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
EpisodeOfCare.statusHistory.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.statusHistory.status		1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory.period		1..1	Period	Duration the EpisodeOfCare was in the specified status
EpisodeOfCare.type	Σ This element is included in summaries.	1..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of Care Service Types (required)
EpisodeOfCare.diagnosis	S This element must be supported. Σ This element is included in summaries.	0..*	BackboneElement	The list of diagnosis relevant to this episode of care
EpisodeOfCare.diagnosis.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.diagnosis.condition	Σ This element is included in summaries.	1..1	Reference(Condition)	Conditions/problems/diagnoses this episode of care is for
EpisodeOfCare.patient	Σ This element is included in summaries.	1..1	Reference(Patient)	The patient who is the focus of this episode of care
EpisodeOfCare.managingOrganization	Σ This element is included in summaries.	1..1	Reference(Organization)	Organization that assumes care
EpisodeOfCare.referralRequest	S This element must be supported.	0..*	Reference(ServiceRequest)	Originating Referral Request(s)
EpisodeOfCare.careManager	S This element must be supported.	0..1	Reference(Practitioner | PractitionerRole)	Care manager/care coordinator for the patient
EpisodeOfCare.account	S This element must be supported.	0..*	Reference(Account)	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
EpisodeOfCare.identifier.​use	Base	required	IdentifierUse	📍4.3.0	FHIR Std.
EpisodeOfCare.identifier.​type	Base	extensible	IdentifierType	📍4.3.0	FHIR Std.
EpisodeOfCare.status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.statusHistory.​status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.type	Base	required	Episode of Care Service Types	📦0.1.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
cc-text-or-code	warning	EpisodeOfCare.identifier.type	Text is optional, coding is required	coding.exists()
dom-2	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	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-5	error	EpisodeOfCare	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	EpisodeOfCare	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

This structure is derived from EpisodeOfCare

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
EpisodeOfCare		0..*	EpisodeOfCare	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
EpisodeOfCare.identifier
EpisodeOfCare.identifier.use		1..1	code	usual | official | temp | secondary | old (If known)
EpisodeOfCare.identifier.type		1..1	HIECodeableConcept	Description of identifier
EpisodeOfCare.identifier.system		1..1	uri	The namespace for the identifier value
EpisodeOfCare.identifier.value	S This element must be supported.	1..1	string	The value that is unique
EpisodeOfCare.identifier.assigner	S This element must be supported.	0..1	HIEReference(HIE Organization)	Organization that issued id (may be just text)
EpisodeOfCare.statusHistory	S This element must be supported.	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
EpisodeOfCare.type		1..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of Care Service Types (required)
EpisodeOfCare.diagnosis	S This element must be supported.	0..*	BackboneElement	The list of diagnosis relevant to this episode of care
EpisodeOfCare.managingOrganization		1..1	Reference(Organization)	Organization that assumes care
EpisodeOfCare.referralRequest	S This element must be supported.	0..*	Reference(ServiceRequest)	Originating Referral Request(s)
EpisodeOfCare.careManager	S This element must be supported.	0..1	Reference(Practitioner | PractitionerRole)	Care manager/care coordinator for the patient
EpisodeOfCare.account	S This element must be supported.	0..*	Reference(Account)	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
EpisodeOfCare.type	Base	required	Episode of Care Service Types	📦0.1.0	This IG

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
EpisodeOfCare		0..*	EpisodeOfCare	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
EpisodeOfCare.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
EpisodeOfCare.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
EpisodeOfCare.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
EpisodeOfCare.language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): IETF language tag Additional Bindings Purpose AllLanguages Max Binding
EpisodeOfCare.text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
EpisodeOfCare.contained		0..*	Resource	Contained, inline Resources Constraints: dom-r4b
EpisodeOfCare.extension		0..*	Extension	Additional content defined by implementations
EpisodeOfCare.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
EpisodeOfCare.identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
EpisodeOfCare.identifier.id		0..1	id	Unique id for inter-element referencing
EpisodeOfCare.identifier.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
EpisodeOfCare.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
EpisodeOfCare.identifier.type	Σ This element is included in summaries. C	1..1	HIECodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible) Constraints: cc-text-or-code
EpisodeOfCare.identifier.system	Σ This element is included in summaries.	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
EpisodeOfCare.identifier.value	S This element must be supported. Σ This element is included in summaries.	1..1	string	The value that is unique Example General: 123456
EpisodeOfCare.identifier.period	Σ This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
EpisodeOfCare.identifier.assigner	S This element must be supported. Σ This element is included in summaries.	0..1	HIEReference(HIE Organization)	Organization that issued id (may be just text)
EpisodeOfCare.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory	S This element must be supported.	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
EpisodeOfCare.statusHistory.id		0..1	string	Unique id for inter-element referencing
EpisodeOfCare.statusHistory.extension		0..*	Extension	Additional content defined by implementations
EpisodeOfCare.statusHistory.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.statusHistory.status		1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory.period		1..1	Period	Duration the EpisodeOfCare was in the specified status
EpisodeOfCare.type	Σ This element is included in summaries.	1..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of Care Service Types (required)
EpisodeOfCare.diagnosis	S This element must be supported. Σ This element is included in summaries.	0..*	BackboneElement	The list of diagnosis relevant to this episode of care
EpisodeOfCare.diagnosis.id		0..1	string	Unique id for inter-element referencing
EpisodeOfCare.diagnosis.extension		0..*	Extension	Additional content defined by implementations
EpisodeOfCare.diagnosis.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.diagnosis.condition	Σ This element is included in summaries.	1..1	Reference(Condition)	Conditions/problems/diagnoses this episode of care is for
EpisodeOfCare.diagnosis.role	Σ This element is included in summaries.	0..1	CodeableConcept	Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …) Binding: DiagnosisRole (preferred): The type of diagnosis this condition represents.
EpisodeOfCare.diagnosis.rank	Σ This element is included in summaries.	0..1	positiveInt	Ranking of the diagnosis (for each role type)
EpisodeOfCare.patient	Σ This element is included in summaries.	1..1	Reference(Patient)	The patient who is the focus of this episode of care
EpisodeOfCare.managingOrganization	Σ This element is included in summaries.	1..1	Reference(Organization)	Organization that assumes care
EpisodeOfCare.period	Σ This element is included in summaries.	0..1	Period	Interval during responsibility is assumed
EpisodeOfCare.referralRequest	S This element must be supported.	0..*	Reference(ServiceRequest)	Originating Referral Request(s)
EpisodeOfCare.careManager	S This element must be supported.	0..1	Reference(Practitioner | PractitionerRole)	Care manager/care coordinator for the patient
EpisodeOfCare.team		0..*	Reference(CareTeam)	Other practitioners facilitating this episode of care
EpisodeOfCare.account	S This element must be supported.	0..*	Reference(Account)	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
EpisodeOfCare.language	Base	preferred	Common Languages	📍4.3.0	FHIR Std.
EpisodeOfCare.identifier.​use	Base	required	IdentifierUse	📍4.3.0	FHIR Std.
EpisodeOfCare.identifier.​type	Base	extensible	IdentifierType	📍4.3.0	FHIR Std.
EpisodeOfCare.status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.statusHistory.​status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.type	Base	required	Episode of Care Service Types	📦0.1.0	This IG
EpisodeOfCare.diagnosis.​role	Base	preferred	DiagnosisRole	📍4.3.0	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cc-text-or-code	warning	EpisodeOfCare.identifier.type	Text is optional, coding is required	coding.exists()
dom-2	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	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-5	error	EpisodeOfCare	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	EpisodeOfCare	A resource should have narrative for robust management	text.`div`.exists()
dom-r4b	warning	EpisodeOfCare.contained	Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems	($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic)
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

This structure is derived from EpisodeOfCare

Summary

Mandatory: 2 elements(4 nested mandatory elements)
Must-Support: 7 elements

Structures

This structure refers to these other structures:

• HIE CodeableConcept (https://nshr.dha.go.ke/fhir/StructureDefinition/codeable-concept)
• HIE Reference (https://nshr.dha.go.ke/fhir/StructureDefinition/reference)
• HIE Organization (https://nshr.dha.go.ke/fhir/StructureDefinition/organization)

Key Elements View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
EpisodeOfCare		0..*	EpisodeOfCare	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
EpisodeOfCare.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
EpisodeOfCare.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
EpisodeOfCare.identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
EpisodeOfCare.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
EpisodeOfCare.identifier.type	Σ This element is included in summaries. C	1..1	HIECodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible) Constraints: cc-text-or-code
EpisodeOfCare.identifier.system	Σ This element is included in summaries.	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
EpisodeOfCare.identifier.value	S This element must be supported. Σ This element is included in summaries.	1..1	string	The value that is unique Example General: 123456
EpisodeOfCare.identifier.assigner	S This element must be supported. Σ This element is included in summaries.	0..1	HIEReference(HIE Organization)	Organization that issued id (may be just text)
EpisodeOfCare.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory	S This element must be supported.	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
EpisodeOfCare.statusHistory.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.statusHistory.status		1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory.period		1..1	Period	Duration the EpisodeOfCare was in the specified status
EpisodeOfCare.type	Σ This element is included in summaries.	1..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of Care Service Types (required)
EpisodeOfCare.diagnosis	S This element must be supported. Σ This element is included in summaries.	0..*	BackboneElement	The list of diagnosis relevant to this episode of care
EpisodeOfCare.diagnosis.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.diagnosis.condition	Σ This element is included in summaries.	1..1	Reference(Condition)	Conditions/problems/diagnoses this episode of care is for
EpisodeOfCare.patient	Σ This element is included in summaries.	1..1	Reference(Patient)	The patient who is the focus of this episode of care
EpisodeOfCare.managingOrganization	Σ This element is included in summaries.	1..1	Reference(Organization)	Organization that assumes care
EpisodeOfCare.referralRequest	S This element must be supported.	0..*	Reference(ServiceRequest)	Originating Referral Request(s)
EpisodeOfCare.careManager	S This element must be supported.	0..1	Reference(Practitioner | PractitionerRole)	Care manager/care coordinator for the patient
EpisodeOfCare.account	S This element must be supported.	0..*	Reference(Account)	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
EpisodeOfCare.identifier.​use	Base	required	IdentifierUse	📍4.3.0	FHIR Std.
EpisodeOfCare.identifier.​type	Base	extensible	IdentifierType	📍4.3.0	FHIR Std.
EpisodeOfCare.status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.statusHistory.​status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.type	Base	required	Episode of Care Service Types	📦0.1.0	This IG

Constraints

Id	Grade	Path(s)	Description	Expression
cc-text-or-code	warning	EpisodeOfCare.identifier.type	Text is optional, coding is required	coding.exists()
dom-2	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	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-5	error	EpisodeOfCare	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	EpisodeOfCare	A resource should have narrative for robust management	text.`div`.exists()
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

Differential View

This structure is derived from EpisodeOfCare

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
EpisodeOfCare		0..*	EpisodeOfCare	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
EpisodeOfCare.identifier
EpisodeOfCare.identifier.use		1..1	code	usual | official | temp | secondary | old (If known)
EpisodeOfCare.identifier.type		1..1	HIECodeableConcept	Description of identifier
EpisodeOfCare.identifier.system		1..1	uri	The namespace for the identifier value
EpisodeOfCare.identifier.value	S This element must be supported.	1..1	string	The value that is unique
EpisodeOfCare.identifier.assigner	S This element must be supported.	0..1	HIEReference(HIE Organization)	Organization that issued id (may be just text)
EpisodeOfCare.statusHistory	S This element must be supported.	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
EpisodeOfCare.type		1..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of Care Service Types (required)
EpisodeOfCare.diagnosis	S This element must be supported.	0..*	BackboneElement	The list of diagnosis relevant to this episode of care
EpisodeOfCare.managingOrganization		1..1	Reference(Organization)	Organization that assumes care
EpisodeOfCare.referralRequest	S This element must be supported.	0..*	Reference(ServiceRequest)	Originating Referral Request(s)
EpisodeOfCare.careManager	S This element must be supported.	0..1	Reference(Practitioner | PractitionerRole)	Care manager/care coordinator for the patient
EpisodeOfCare.account	S This element must be supported.	0..*	Reference(Account)	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

Terminology Bindings (Differential)

Path	Status	Usage	ValueSet	Version	Source
EpisodeOfCare.type	Base	required	Episode of Care Service Types	📦0.1.0	This IG

Snapshot View

Name	Flags	Card.	Type	Description & Constraints    Filter: Bindings Constraints Obligations
EpisodeOfCare		0..*	EpisodeOfCare	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
EpisodeOfCare.id	Σ This element is included in summaries.	0..1	id	Logical id of this artifact
EpisodeOfCare.meta	Σ This element is included in summaries.	0..1	Meta	Metadata about the resource
EpisodeOfCare.implicitRules	?! This element is a modifier element. Σ This element is included in summaries.	0..1	uri	A set of rules under which this content was created
EpisodeOfCare.language		0..1	code	Language of the resource content Binding: CommonLanguages (preferred): IETF language tag Additional Bindings Purpose AllLanguages Max Binding
EpisodeOfCare.text		0..1	Narrative	Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements
EpisodeOfCare.contained		0..*	Resource	Contained, inline Resources Constraints: dom-r4b
EpisodeOfCare.extension		0..*	Extension	Additional content defined by implementations
EpisodeOfCare.modifierExtension	?! This element is a modifier element.	0..*	Extension	Extensions that cannot be ignored
EpisodeOfCare.identifier		0..*	Identifier	Business Identifier(s) relevant for this EpisodeOfCare
EpisodeOfCare.identifier.id		0..1	id	Unique id for inter-element referencing
EpisodeOfCare.identifier.extension		0..*	Extension	Additional content defined by implementations Slice: Unordered, Open by value:url
EpisodeOfCare.identifier.use	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	usual | official | temp | secondary | old (If known) Binding: IdentifierUse (required)
EpisodeOfCare.identifier.type	Σ This element is included in summaries. C	1..1	HIECodeableConcept	Description of identifier Binding: Identifier Type Codes (extensible) Constraints: cc-text-or-code
EpisodeOfCare.identifier.system	Σ This element is included in summaries.	1..1	uri	The namespace for the identifier value Example General: http://www.acme.com/identifiers/patient
EpisodeOfCare.identifier.value	S This element must be supported. Σ This element is included in summaries.	1..1	string	The value that is unique Example General: 123456
EpisodeOfCare.identifier.period	Σ This element is included in summaries.	0..1	Period	Time period when id is/was valid for use
EpisodeOfCare.identifier.assigner	S This element must be supported. Σ This element is included in summaries.	0..1	HIEReference(HIE Organization)	Organization that issued id (may be just text)
EpisodeOfCare.status	?! This element is a modifier element. Σ This element is included in summaries.	1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory	S This element must be supported.	0..*	BackboneElement	Past list of status codes (the current status may be included to cover the start date of the status)
EpisodeOfCare.statusHistory.id		0..1	string	Unique id for inter-element referencing
EpisodeOfCare.statusHistory.extension		0..*	Extension	Additional content defined by implementations
EpisodeOfCare.statusHistory.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.statusHistory.status		1..1	code	planned | waitlist | active | onhold | finished | cancelled | entered-in-error Binding: EpisodeOfCareStatus (required): The status of the episode of care.
EpisodeOfCare.statusHistory.period		1..1	Period	Duration the EpisodeOfCare was in the specified status
EpisodeOfCare.type	Σ This element is included in summaries.	1..*	CodeableConcept	Type/class - e.g. specialist referral, disease management Binding: Episode of Care Service Types (required)
EpisodeOfCare.diagnosis	S This element must be supported. Σ This element is included in summaries.	0..*	BackboneElement	The list of diagnosis relevant to this episode of care
EpisodeOfCare.diagnosis.id		0..1	string	Unique id for inter-element referencing
EpisodeOfCare.diagnosis.extension		0..*	Extension	Additional content defined by implementations
EpisodeOfCare.diagnosis.modifierExtension	?! This element is a modifier element. Σ This element is included in summaries.	0..*	Extension	Extensions that cannot be ignored even if unrecognized
EpisodeOfCare.diagnosis.condition	Σ This element is included in summaries.	1..1	Reference(Condition)	Conditions/problems/diagnoses this episode of care is for
EpisodeOfCare.diagnosis.role	Σ This element is included in summaries.	0..1	CodeableConcept	Role that this diagnosis has within the episode of care (e.g. admission, billing, discharge …) Binding: DiagnosisRole (preferred): The type of diagnosis this condition represents.
EpisodeOfCare.diagnosis.rank	Σ This element is included in summaries.	0..1	positiveInt	Ranking of the diagnosis (for each role type)
EpisodeOfCare.patient	Σ This element is included in summaries.	1..1	Reference(Patient)	The patient who is the focus of this episode of care
EpisodeOfCare.managingOrganization	Σ This element is included in summaries.	1..1	Reference(Organization)	Organization that assumes care
EpisodeOfCare.period	Σ This element is included in summaries.	0..1	Period	Interval during responsibility is assumed
EpisodeOfCare.referralRequest	S This element must be supported.	0..*	Reference(ServiceRequest)	Originating Referral Request(s)
EpisodeOfCare.careManager	S This element must be supported.	0..1	Reference(Practitioner | PractitionerRole)	Care manager/care coordinator for the patient
EpisodeOfCare.team		0..*	Reference(CareTeam)	Other practitioners facilitating this episode of care
EpisodeOfCare.account	S This element must be supported.	0..*	Reference(Account)	The set of accounts that may be used for billing for this EpisodeOfCare
Documentation for this format

Terminology Bindings

Path	Status	Usage	ValueSet	Version	Source
EpisodeOfCare.language	Base	preferred	Common Languages	📍4.3.0	FHIR Std.
EpisodeOfCare.identifier.​use	Base	required	IdentifierUse	📍4.3.0	FHIR Std.
EpisodeOfCare.identifier.​type	Base	extensible	IdentifierType	📍4.3.0	FHIR Std.
EpisodeOfCare.status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.statusHistory.​status	Base	required	EpisodeOfCareStatus	📍4.3.0	FHIR Std.
EpisodeOfCare.type	Base	required	Episode of Care Service Types	📦0.1.0	This IG
EpisodeOfCare.diagnosis.​role	Base	preferred	DiagnosisRole	📍4.3.0	FHIR Std.

Constraints

Id	Grade	Path(s)	Description	Expression
cc-text-or-code	warning	EpisodeOfCare.identifier.type	Text is optional, coding is required	coding.exists()
dom-2	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL NOT contain nested Resources	contained.contained.empty()
dom-3	error	EpisodeOfCare	If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource	contained.where(((id.exists() and ('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url)))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(uri) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4	error	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-5	error	EpisodeOfCare	If a resource is contained in another resource, it SHALL NOT have a security label	contained.meta.security.empty()
dom-6	best practice	EpisodeOfCare	A resource should have narrative for robust management	text.`div`.exists()
dom-r4b	warning	EpisodeOfCare.contained	Containing new R4B resources within R4 resources may cause interoperability issues if instances are shared with R4 systems	($this is Citation or $this is Evidence or $this is EvidenceReport or $this is EvidenceVariable or $this is MedicinalProductDefinition or $this is PackagedProductDefinition or $this is AdministrableProductDefinition or $this is Ingredient or $this is ClinicalUseDefinition or $this is RegulatedAuthorization or $this is SubstanceDefinition or $this is SubscriptionStatus or $this is SubscriptionTopic) implies (%resource is Citation or %resource is Evidence or %resource is EvidenceReport or %resource is EvidenceVariable or %resource is MedicinalProductDefinition or %resource is PackagedProductDefinition or %resource is AdministrableProductDefinition or %resource is Ingredient or %resource is ClinicalUseDefinition or %resource is RegulatedAuthorization or %resource is SubstanceDefinition or %resource is SubscriptionStatus or %resource is SubscriptionTopic)
ele-1	error	**ALL** elements	All FHIR elements must have a @value or children	hasValue() or (children().count() > id.count())
ext-1	error	**ALL** extensions	Must have either extensions or value[x], not both	extension.exists() != value.exists()

This structure is derived from EpisodeOfCare

Summary

Mandatory: 2 elements(4 nested mandatory elements)
Must-Support: 7 elements

Structures

This structure refers to these other structures:

• HIE CodeableConcept (https://nshr.dha.go.ke/fhir/StructureDefinition/codeable-concept)
• HIE Reference (https://nshr.dha.go.ke/fhir/StructureDefinition/reference)
• HIE Organization (https://nshr.dha.go.ke/fhir/StructureDefinition/organization)

Other representations of profile: CSV, Excel, Schematron