臺灣社政領域基礎實作指引
0.0.1 - ci-build

臺灣社政領域基礎實作指引, published by 衛生福利部社會及家庭署. This guide is not an authorized publication; it is the continuous build for version 0.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

Resource Profile: 個案服務案件-EpisodeOfCare TWSS Base

Official URL: https://sfaa.gov.tw/base/StructureDefinition/EpisodeOfCare-twss-base Version: 0.0.1
Draft as of 2026-08-10 Computable Name: EpisodeOfCareTWSSBase

個案服務案件-EpisodeOfCare TWSS Base Profile 表達社家署業務中的個案服務案件。因 TW Core 0.3.2 尚未提供 EpisodeOfCare Profile，故繼承原生 EpisodeOfCare，並於設定社福欄位後補回適用的 TW Core 0.3.2 共通交換規則。

Usages:

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.

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:caseCloseReason S 0..* CodeableConceptTW 結案原因
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-close-reason
.... extension:serviceCaseStatus S 0..1 CodeableConceptTW 服務案件狀態
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-status-extension
Binding: TWSS-個案案件狀態值集 (extensible)
.... extension:isReferredAtClosure S 0..1 boolean 結案時是否轉介
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-is-referred-at-closure
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
.... identifier:caseNumber S 0..1 Identifier 個案編號
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
.... identifier:crossSystemCaseNumber S 0..1 Identifier 跨系統個案編號
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/cross-system-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
.... identifier:historicalCaseNumber S 0..1 Identifier 歷史案號
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/historical-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
... status ?!SΣ 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
... statusHistory S 0..* BackboneElement Past list of status codes (the current status may be included to cover the start date of the status)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... status 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
.... period 1..1 Period Duration the EpisodeOfCare was in the specified status
... type SΣ 1..* CodeableConcept 服務或補助案件類型
Binding: TWSS-個案服務或補助案件類型值集 (extensible)
... diagnosis SΣ 0..* BackboneElement The list of diagnosis relevant to this episode of care
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... condition Σ 1..1 Reference(Condition) Conditions/problems/diagnoses this episode of care is for
... patient SΣ 1..1 Reference(個案資料-Patient TWSS Base) The patient who is the focus of this episode of care
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) Organization that assumes care
... period SΣ 0..1 Period 主責單位承擔個案服務案件責任的期間。
... referralRequest S 0..* Reference(個案轉介-ServiceRequest TWSS Base) Originating Referral Request(s)
... careManager S 0..1 Reference(人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) Care manager/care coordinator for the patient
... team S 0..* Reference(CareTeam) Other practitioners facilitating this episode of care
... account S 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EpisodeOfCare.identifier:caseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:crossSystemCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:historicalCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.statusHistory.​status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.type Base extensible TWSS-個案服務或補助案件類型值集 📦0.0.1 This IG

Constraints

Id Grade Path(s) Description Expression
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 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(canonical) = '#').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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:caseCloseReason S 0..* CodeableConceptTW 結案原因
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-close-reason
.... extension:serviceCaseStatus S 0..1 CodeableConceptTW 服務案件狀態
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-status-extension
Binding: TWSS-個案案件狀態值集 (extensible)
.... extension:isReferredAtClosure S 0..1 boolean 結案時是否轉介
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-is-referred-at-closure
... Slices for identifier S 0..* Identifier Business Identifier(s) relevant for this EpisodeOfCare
Slice: Unordered, Open by value:system
.... identifier:caseNumber S 0..1 Identifier 個案編號
..... system S 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/case-number
..... value S 1..1 string The value that is unique
.... identifier:crossSystemCaseNumber S 0..1 Identifier 跨系統個案編號
..... system S 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/cross-system-case-number
..... value S 1..1 string The value that is unique
.... identifier:historicalCaseNumber S 0..1 Identifier 歷史案號
..... system S 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/historical-case-number
..... value S 1..1 string The value that is unique
... status S 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
... type S 1..* CodeableConcept 服務或補助案件類型
Binding: TWSS-個案服務或補助案件類型值集 (extensible)
... diagnosis S 0..* BackboneElement The list of diagnosis relevant to this episode of care
... patient S 1..1 Reference(個案資料-Patient TWSS Base) The patient who is the focus of this episode of care
... managingOrganization S 0..1 Reference(機構資料-Organization TWSS Base) Organization that assumes care
... period S 0..1 Period 主責單位承擔個案服務案件責任的期間。
... referralRequest S 0..* Reference(個案轉介-ServiceRequest TWSS Base) Originating Referral Request(s)
... careManager S 0..1 Reference(人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) Care manager/care coordinator for the patient
... team S 0..* Reference(CareTeam) Other practitioners facilitating this episode of care
... account S 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
EpisodeOfCare.type Base extensible TWSS-個案服務或補助案件類型值集 📦0.0.1 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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
... 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
... 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
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:caseCloseReason S 0..* CodeableConceptTW 結案原因
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-close-reason
.... extension:serviceCaseStatus S 0..1 CodeableConceptTW 服務案件狀態
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-status-extension
Binding: TWSS-個案案件狀態值集 (extensible)
.... extension:isReferredAtClosure S 0..1 boolean 結案時是否轉介
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-is-referred-at-closure
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... Slices for identifier S 0..* Identifier Business Identifier(s) relevant for this EpisodeOfCare
Slice: Unordered, Open by value:system
.... identifier:caseNumber S 0..1 Identifier 個案編號
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
.... identifier:crossSystemCaseNumber S 0..1 Identifier 跨系統個案編號
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/cross-system-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
.... identifier:historicalCaseNumber S 0..1 Identifier 歷史案號
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/historical-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... status ?!SΣ 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
... statusHistory S 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 Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... status 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
.... period 1..1 Period Duration the EpisodeOfCare was in the specified status
... type SΣ 1..* CodeableConcept 服務或補助案件類型
Binding: TWSS-個案服務或補助案件類型值集 (extensible)
... diagnosis SΣ 0..* BackboneElement The list of diagnosis relevant to this episode of care
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... condition Σ 1..1 Reference(Condition) 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): The type of diagnosis this condition represents.
.... rank Σ 0..1 positiveInt Ranking of the diagnosis (for each role type)
... patient SΣ 1..1 Reference(個案資料-Patient TWSS Base) The patient who is the focus of this episode of care
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) Organization that assumes care
... period SΣ 0..1 Period 主責單位承擔個案服務案件責任的期間。
... referralRequest S 0..* Reference(個案轉介-ServiceRequest TWSS Base) Originating Referral Request(s)
... careManager S 0..1 Reference(人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) Care manager/care coordinator for the patient
... team S 0..* Reference(CareTeam) Other practitioners facilitating this episode of care
... account S 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EpisodeOfCare.language Base preferred Common Languages 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:caseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:caseNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:crossSystemCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:crossSystemCaseNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:historicalCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:historicalCaseNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
EpisodeOfCare.status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.statusHistory.​status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.type Base extensible TWSS-個案服務或補助案件類型值集 📦0.0.1 This IG
EpisodeOfCare.diagnosis.​role Base preferred DiagnosisRole 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
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 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(canonical) = '#').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()

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:caseCloseReason S 0..* CodeableConceptTW 結案原因
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-close-reason
.... extension:serviceCaseStatus S 0..1 CodeableConceptTW 服務案件狀態
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-status-extension
Binding: TWSS-個案案件狀態值集 (extensible)
.... extension:isReferredAtClosure S 0..1 boolean 結案時是否轉介
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-is-referred-at-closure
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
.... identifier:caseNumber S 0..1 Identifier 個案編號
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
.... identifier:crossSystemCaseNumber S 0..1 Identifier 跨系統個案編號
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/cross-system-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
.... identifier:historicalCaseNumber S 0..1 Identifier 歷史案號
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/historical-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
... status ?!SΣ 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
... statusHistory S 0..* BackboneElement Past list of status codes (the current status may be included to cover the start date of the status)
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... status 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
.... period 1..1 Period Duration the EpisodeOfCare was in the specified status
... type SΣ 1..* CodeableConcept 服務或補助案件類型
Binding: TWSS-個案服務或補助案件類型值集 (extensible)
... diagnosis SΣ 0..* BackboneElement The list of diagnosis relevant to this episode of care
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... condition Σ 1..1 Reference(Condition) Conditions/problems/diagnoses this episode of care is for
... patient SΣ 1..1 Reference(個案資料-Patient TWSS Base) The patient who is the focus of this episode of care
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) Organization that assumes care
... period SΣ 0..1 Period 主責單位承擔個案服務案件責任的期間。
... referralRequest S 0..* Reference(個案轉介-ServiceRequest TWSS Base) Originating Referral Request(s)
... careManager S 0..1 Reference(人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) Care manager/care coordinator for the patient
... team S 0..* Reference(CareTeam) Other practitioners facilitating this episode of care
... account S 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EpisodeOfCare.identifier:caseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:crossSystemCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:historicalCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.statusHistory.​status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.type Base extensible TWSS-個案服務或補助案件類型值集 📦0.0.1 This IG

Constraints

Id Grade Path(s) Description Expression
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 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(canonical) = '#').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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:caseCloseReason S 0..* CodeableConceptTW 結案原因
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-close-reason
.... extension:serviceCaseStatus S 0..1 CodeableConceptTW 服務案件狀態
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-status-extension
Binding: TWSS-個案案件狀態值集 (extensible)
.... extension:isReferredAtClosure S 0..1 boolean 結案時是否轉介
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-is-referred-at-closure
... Slices for identifier S 0..* Identifier Business Identifier(s) relevant for this EpisodeOfCare
Slice: Unordered, Open by value:system
.... identifier:caseNumber S 0..1 Identifier 個案編號
..... system S 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/case-number
..... value S 1..1 string The value that is unique
.... identifier:crossSystemCaseNumber S 0..1 Identifier 跨系統個案編號
..... system S 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/cross-system-case-number
..... value S 1..1 string The value that is unique
.... identifier:historicalCaseNumber S 0..1 Identifier 歷史案號
..... system S 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/historical-case-number
..... value S 1..1 string The value that is unique
... status S 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
... type S 1..* CodeableConcept 服務或補助案件類型
Binding: TWSS-個案服務或補助案件類型值集 (extensible)
... diagnosis S 0..* BackboneElement The list of diagnosis relevant to this episode of care
... patient S 1..1 Reference(個案資料-Patient TWSS Base) The patient who is the focus of this episode of care
... managingOrganization S 0..1 Reference(機構資料-Organization TWSS Base) Organization that assumes care
... period S 0..1 Period 主責單位承擔個案服務案件責任的期間。
... referralRequest S 0..* Reference(個案轉介-ServiceRequest TWSS Base) Originating Referral Request(s)
... careManager S 0..1 Reference(人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) Care manager/care coordinator for the patient
... team S 0..* Reference(CareTeam) Other practitioners facilitating this episode of care
... account S 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
EpisodeOfCare.type Base extensible TWSS-個案服務或補助案件類型值集 📦0.0.1 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. 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
... 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
... 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
... contained 0..* Resource Contained, inline Resources
... Slices for extension 0..* Extension Extension
Slice: Unordered, Open by value:url
.... extension:caseCloseReason S 0..* CodeableConceptTW 結案原因
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-close-reason
.... extension:serviceCaseStatus S 0..1 CodeableConceptTW 服務案件狀態
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-case-status-extension
Binding: TWSS-個案案件狀態值集 (extensible)
.... extension:isReferredAtClosure S 0..1 boolean 結案時是否轉介
URL: https://sfaa.gov.tw/base/StructureDefinition/twss-is-referred-at-closure
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... Slices for identifier S 0..* Identifier Business Identifier(s) relevant for this EpisodeOfCare
Slice: Unordered, Open by value:system
.... identifier:caseNumber S 0..1 Identifier 個案編號
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
.... identifier:crossSystemCaseNumber S 0..1 Identifier 跨系統個案編號
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/cross-system-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
.... identifier:historicalCaseNumber S 0..1 Identifier 歷史案號
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... use ?!Σ 0..1 code usual | official | temp | secondary | old (If known)
Binding: IdentifierUse (required): Identifies the purpose for this identifier, if known .
..... type Σ 0..1 CodeableConcept Description of identifier
Binding: Identifier Type Codes (extensible): A coded type for an identifier that can be used to determine which identifier to use for a specific purpose.
..... system SΣ 1..1 uri The namespace for the identifier value
Required Pattern: https://sfaa.gov.tw/base/identifier/historical-case-number
..... value SΣ 1..1 string The value that is unique
Example General: 123456
..... period Σ 0..1 Period Time period when id is/was valid for use
..... assigner Σ 0..1 Reference(Organization) Organization that issued id (may be just text)
... status ?!SΣ 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
... statusHistory S 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 Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... status 1..1 code planned | waitlist | active | onhold | finished | cancelled | entered-in-error
Binding: EpisodeOfCareStatus (required): The status of the episode of care.
.... period 1..1 Period Duration the EpisodeOfCare was in the specified status
... type SΣ 1..* CodeableConcept 服務或補助案件類型
Binding: TWSS-個案服務或補助案件類型值集 (extensible)
... diagnosis SΣ 0..* BackboneElement The list of diagnosis relevant to this episode of care
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... condition Σ 1..1 Reference(Condition) 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): The type of diagnosis this condition represents.
.... rank Σ 0..1 positiveInt Ranking of the diagnosis (for each role type)
... patient SΣ 1..1 Reference(個案資料-Patient TWSS Base) The patient who is the focus of this episode of care
... managingOrganization SΣ 0..1 Reference(機構資料-Organization TWSS Base) Organization that assumes care
... period SΣ 0..1 Period 主責單位承擔個案服務案件責任的期間。
... referralRequest S 0..* Reference(個案轉介-ServiceRequest TWSS Base) Originating Referral Request(s)
... careManager S 0..1 Reference(人員資料-Practitioner TWSS Base | 人員角色-PractitionerRole TWSS Base) Care manager/care coordinator for the patient
... team S 0..* Reference(CareTeam) Other practitioners facilitating this episode of care
... account S 0..* Reference(Account) The set of accounts that may be used for billing for this EpisodeOfCare

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
EpisodeOfCare.language Base preferred Common Languages 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:caseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:caseNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:crossSystemCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:crossSystemCaseNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:historicalCaseNumber.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
EpisodeOfCare.identifier:historicalCaseNumber.​type Base extensible IdentifierType 📍4.0.1 FHIR Std.
EpisodeOfCare.status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.statusHistory.​status Base required EpisodeOfCareStatus 📍4.0.1 FHIR Std.
EpisodeOfCare.type Base extensible TWSS-個案服務或補助案件類型值集 📦0.0.1 This IG
EpisodeOfCare.diagnosis.​role Base preferred DiagnosisRole 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
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 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(canonical) = '#').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()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

建議應該支援以下查詢參數：

  1. 建議（SHOULD） 支援透過查詢參數 _id 查詢所有 EpisodeOfCare： (如何透過 token 查詢)
    GET [base]/EpisodeOfCare?_id=[id]
    GET [base]/EpisodeOfCare/[id]

  2. 建議（SHOULD） 支援透過查詢參數 identifier 查詢所有 EpisodeOfCare： (如何透過 token 查詢)
    GET [base]/EpisodeOfCare?identifier=[system]|[code]

  3. 建議（SHOULD） 支援透過查詢參數 patient 查詢所有 EpisodeOfCare： (如何透過 reference 查詢)
    GET [base]/EpisodeOfCare?patient={Type/}[id]

  4. 建議（SHOULD） 支援透過查詢參數 status 查詢所有 EpisodeOfCare： (如何透過 token 查詢)
    GET [base]/EpisodeOfCare?status=[code]

  5. 建議（SHOULD） 支援透過查詢參數 type 或 date 查詢所有 EpisodeOfCare： (如何透過 token 查詢)
    GET [base]/EpisodeOfCare?type=[system]|[code]
    (如何透過 date 查詢)
    GET [base]/EpisodeOfCare?date={gt|lt|ge|le}[date]