電子病歷交換單張實作指引(EMR-IG)
0.1.0 - ci-build

This page is part of the 電子病歷交換單張實作指引(EMR-IG) (v0.1.0: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: 門診病歷-門診日期、科別

Official URL: https://twcore.mohw.gov.tw/ig/emr/StructureDefinition/PMREncounter Version: 0.1.0
Draft as of 2024-08-23 Computable Name: PMREncounter

此Profile繼承於臺灣核心-就醫事件(TW Core Encounter),並用於紀錄門診病歷中的門診科別與日期[FMM1]

Usage:

Formal Views of Profile Content

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

This structure is derived from TWCoreEncounter

NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..* TWCoreEncounter 提供病人服務的一種互動
... status 1..1 code planned | arrived | triaged | in-progress | onleave | finished | cancelled +
Fixed Value: finished
... class
.... system 1..1 uri 專門術語系統(terminology system)的識別
Fixed Value: http://terminology.hl7.org/CodeSystem/v3-ActEncounterCode
.... code 1..1 code 系統定義的語法之符號
Fixed Value: AMB
.... display 1..1 string 由系統定義的表示法
Fixed Value: ambulatory
... serviceType 1..1 CodeableConceptTW 服務的特定型別。[應填入於門診病歷科別Department]
.... start S 1..1 dateTime 就醫的開始時間。[應填入於門診病歷門診日期OPD Date]

doco Documentation for this format
NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..* TWCoreEncounter 提供病人服務的一種互動
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... modifierExtension ?! 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier SΣ 0..* Identifier 此就醫事件的識別碼
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果知道,請說明此識別碼的用途;應填入所綁定值集中的其中一個代碼。

.... system SΣ 1..1 uri 識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 1..1 string 唯一值
Example General: 123456
... class S 1..1 CodingTW 病人就醫的分類
Binding: ActEncounterCode (extensible): 就醫的分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... system SΣ 1..1 uri 專門術語系統(terminology system)的識別
Fixed Value: http://terminology.hl7.org/CodeSystem/v3-ActEncounterCode
.... code SΣ 1..1 code 系統定義的語法之符號
Fixed Value: AMB
.... display SΣ 1..1 string 由系統定義的表示法
Fixed Value: ambulatory
... serviceType S 1..1 CodeableConceptTW 服務的特定型別。[應填入於門診病歷科別Department]
Binding: SNOMED CT + 臺灣健保署 + 衛福部統計處診療科別值集 (extensible): 對提供的服務進行廣泛分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

... subject SΣ 0..1 Reference(TW Core Patient | Group) 在場就醫的病人或實體集合(Group)
... participant SΣ 0..* BackboneElement 參與就醫的健康照護服務提供者之名單
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... type S 0..* CodeableConceptTW 參與者在病人就醫事件中的角色
Binding: ParticipantType (extensible): 參與者在病人就醫事件中的角色;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


.... period S 0..1 Period 參與者在病人就醫期間參與的時段
.... individual SΣ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole | RelatedPerson) 除病人外,參與病人就醫事件的人。
... period S 1..1 Period 就醫的開始和結束時間
.... start SΣC 1..1 dateTime 就醫的開始時間。[應填入於門診病歷門診日期OPD Date]
... reasonCode S 0..* CodeableConceptTW 就醫發生的編碼原因
Binding: EncounterReasonCodes (preferred): 發生此就醫事件的原因;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


... hospitalization S 0..1 BackboneElement 關於入院接受健康照護服務的細節
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... dischargeDisposition S 0..1 CodeableConceptTW 出院後的地點類別或種類
Binding: DischargeDisposition (example): 出院處置;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

... location S 0..* BackboneElement 病人曾去過的一個或多個地點
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... location S 1..1 Reference(TW Core Location) 就醫發生的地點
... serviceProvider S 0..1 Reference(TW Core Organization) 負責這次就醫的機構

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Encounter.identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
Encounter.statusrequiredFixed Value: finished
http://hl7.org/fhir/ValueSet/encounter-status|4.0.1
from the FHIR Standard
Encounter.classextensibleFixed Value: AMB
http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
Encounter.serviceTypeextensibleTWHealthDepartmentSCT
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-department-sct-tw
Encounter.participant.typeextensibleParticipantType
http://hl7.org/fhir/ValueSet/encounter-participant-type
from the FHIR Standard
Encounter.reasonCodepreferredEncounterReasonCodes
http://hl7.org/fhir/ValueSet/encounter-reason
from the FHIR Standard
Encounter.hospitalization.dischargeDispositionexampleDischargeDisposition
http://hl7.org/fhir/ValueSet/encounter-discharge-disposition
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorEncounterIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEncounterIf 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-4errorEncounterIf 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-5errorEncounterIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEncounterA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..* TWCoreEncounter 提供病人服務的一種互動
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Encounter紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Encounter Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... language 0..1 code 用以表述Encounter Resource內容的語言。
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguages Max Binding

Example Value: zh-TW
... text 0..1 Narrative Encounter Resource之內容摘要以供人閱讀
... contained 0..* Resource 內嵌的(contained)、行內的Resources
... extension 0..* Extension 擴充的資料項目
... modifierExtension ?! 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier SΣ 0..* Identifier 此就醫事件的識別碼
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果知道,請說明此識別碼的用途;應填入所綁定值集中的其中一個代碼。

.... type 0..1 CodeableConceptTW 識別碼(identifier)的型別說明
Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... system SΣ 1..1 uri 識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 1..1 string 唯一值
Example General: 123456
.... period Σ 0..1 Period 此就醫事件識別碼(identifier)的使用效期
.... assigner Σ 0..1 Reference(TW Core Organization) 簽發identifier的機構(可以只是文字表述)
... status ?!SΣ 1..1 code planned | arrived | triaged | in-progress | onleave | finished | cancelled +
Binding: EncounterStatus (required): 就醫現況的代碼;應填入所綁定值集中的其中一個代碼


Fixed Value: finished
... statusHistory 0..* BackboneElement 過去的就醫狀態清單
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... status 1..1 code planned | arrived | triaged | in-progress | onleave | finished | cancelled +
Binding: EncounterStatus (required): 就醫現狀的代碼;應填入所綁定值集中的其中一個代碼

.... period 1..1 Period 該事件處於特定狀態的時間
... class S 1..1 CodingTW 病人就醫的分類
Binding: ActEncounterCode (extensible): 就醫的分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
.... system SΣ 1..1 uri 專門術語系統(terminology system)的識別
Fixed Value: http://terminology.hl7.org/CodeSystem/v3-ActEncounterCode
.... version Σ 0..1 string 系統的版本—如果相關的話
.... code SΣ 1..1 code 系統定義的語法之符號
Fixed Value: AMB
.... display SΣ 1..1 string 由系統定義的表示法
Fixed Value: ambulatory
.... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇?
... classHistory 0..* BackboneElement 過去就醫類別的列表
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... class 1..1 Coding inpatient | outpatient | ambulatory | emergency +
Binding: ActEncounterCode (extensible): 就醫類別;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... period 1..1 Period 此就醫事件處於特定類別的時間
... type 0..* CodeableConceptTW 就醫的特定型別
Binding: EncounterType (example): 就醫的型別;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


... serviceType S 1..1 CodeableConceptTW 服務的特定型別。[應填入於門診病歷科別Department]
Binding: SNOMED CT + 臺灣健保署 + 衛福部統計處診療科別值集 (extensible): 對提供的服務進行廣泛分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

... priority 0..1 CodeableConceptTW 表明就醫的急迫性
Binding: ActPriority (example): 表明就醫的迫切性;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

... subject SΣ 0..1 Reference(TW Core Patient | Group) 在場就醫的病人或實體集合(Group)
... episodeOfCare Σ 0..* Reference(EpisodeOfCare) 此次就醫應記錄的照護事件
... basedOn 0..* Reference(ServiceRequest) 開始此次就醫的服務請求(ServiceRequest)
... participant SΣ 0..* BackboneElement 參與就醫的健康照護服務提供者之名單
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... type S 0..* CodeableConceptTW 參與者在病人就醫事件中的角色
Binding: ParticipantType (extensible): 參與者在病人就醫事件中的角色;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


.... period S 0..1 Period 參與者在病人就醫期間參與的時段
.... individual SΣ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole | RelatedPerson) 除病人外,參與病人就醫事件的人。
... appointment Σ 0..* Reference(Appointment) 這次就醫的預約紀錄
... period S 1..1 Period 就醫的開始和結束時間
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... start SΣC 1..1 dateTime 就醫的開始時間。[應填入於門診病歷門診日期OPD Date]
.... end ΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... length 0..1 Duration 就醫持續的時間(扣除缺席時間)
... reasonCode S 0..* CodeableConceptTW 就醫發生的編碼原因
Binding: EncounterReasonCodes (preferred): 發生此就醫事件的原因;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


... reasonReference Σ 0..* Reference(TW Core Condition | TW Core Procedure | TW Core Observation Laboratory Result | ImmunizationRecommendation) 就醫發生的原因(參照)
... diagnosis Σ 0..* BackboneElement 與此就醫相關的診斷清單
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... condition Σ 1..1 Reference(TW Core Condition | TW Core Procedure) 與就醫事件相關的診斷或處置
.... use 0..1 CodeableConceptTW 此診斷在病人就醫事件中的作用(例如:住院、收費、出院...)。
Binding: DiagnosisRole (preferred): 此情況所代表的診斷型別;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

.... rank 0..1 positiveInt 診斷的排序(針對每個角色型別)
... account 0..* Reference(Account) 可用於為此病人就醫事件計費的一組帳戶
... hospitalization S 0..1 BackboneElement 關於入院接受健康照護服務的細節
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... preAdmissionIdentifier 0..1 Identifier 住院前識別碼
.... origin 0..1 Reference(TW Core Organization | TW Core Location) 病人住院前來自的地點/機構
.... admitSource 0..1 CodeableConceptTW 病人從哪裡住院(醫生轉介、轉院)?
Binding: AdmitSource (preferred): 病人從哪裡住院;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

.... reAdmission 0..1 CodeableConceptTW 已發生的醫院再入院型別(如果有的話)。如果該值不存在,則不被認定為再入院。
Binding: hl7VS-re-admissionIndicator (example): 這次住院就醫的再入院原因;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... dietPreference 0..* CodeableConceptTW 病人報告的飲食偏好
Binding: Diet (example): 醫療、文化或道德方面的食物偏好,以幫助滿足飲食要求;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


.... specialCourtesy 0..* CodeableConceptTW 特別禮遇(貴賓、董事會成員)
Binding: SpecialCourtesy (preferred): 特別禮遇;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


.... specialArrangement 0..* CodeableConceptTW 輪椅、翻譯人員、擔架等。
Binding: SpecialArrangements (preferred): 特殊安排;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


.... destination 0..1 Reference(TW Core Location | TW Core Organization) 病人出院地點/機構
.... dischargeDisposition S 0..1 CodeableConceptTW 出院後的地點類別或種類
Binding: DischargeDisposition (example): 出院處置;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

... location S 0..* BackboneElement 病人曾去過的一個或多個地點
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... location S 1..1 Reference(TW Core Location) 就醫發生的地點
.... status 0..1 code planned | active | reserved | completed
Binding: EncounterLocationStatus (required): 就醫地點的狀態;應填入所綁定值集中的其中一個代碼。

.... physicalType 0..1 CodeableConceptTW 地點的實體型別(通常是地點的層級—床位、房間、病房等)。
Binding: LocationType (example): 地點的實體型別;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... period 0..1 Period 病人出現在此地點的時段
... serviceProvider S 0..1 Reference(TW Core Organization) 負責這次就醫的機構
... partOf 0..1 Reference(TW Core Encounter) 此就醫是哪次就醫的一部份?

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Encounter.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
Encounter.identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
Encounter.identifier.typeextensibleIdentifier Type Codes
http://hl7.org/fhir/ValueSet/identifier-type
from the FHIR Standard
Encounter.statusrequiredFixed Value: finished
http://hl7.org/fhir/ValueSet/encounter-status|4.0.1
from the FHIR Standard
Encounter.statusHistory.statusrequiredEncounterStatus
http://hl7.org/fhir/ValueSet/encounter-status|4.0.1
from the FHIR Standard
Encounter.classextensibleFixed Value: AMB
http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
Encounter.classHistory.classextensibleActEncounterCode
http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
Encounter.typeexampleEncounterType
http://hl7.org/fhir/ValueSet/encounter-type
from the FHIR Standard
Encounter.serviceTypeextensibleTWHealthDepartmentSCT
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-department-sct-tw
Encounter.priorityexampleActPriority
http://terminology.hl7.org/ValueSet/v3-ActPriority
Encounter.participant.typeextensibleParticipantType
http://hl7.org/fhir/ValueSet/encounter-participant-type
from the FHIR Standard
Encounter.reasonCodepreferredEncounterReasonCodes
http://hl7.org/fhir/ValueSet/encounter-reason
from the FHIR Standard
Encounter.diagnosis.usepreferredDiagnosisRole
http://hl7.org/fhir/ValueSet/diagnosis-role
from the FHIR Standard
Encounter.hospitalization.admitSourcepreferredAdmitSource
http://hl7.org/fhir/ValueSet/encounter-admit-source
from the FHIR Standard
Encounter.hospitalization.reAdmissionexampleHl7VSReAdmissionIndicator
http://terminology.hl7.org/ValueSet/v2-0092
Encounter.hospitalization.dietPreferenceexampleDiet
http://hl7.org/fhir/ValueSet/encounter-diet
from the FHIR Standard
Encounter.hospitalization.specialCourtesypreferredSpecialCourtesy
http://hl7.org/fhir/ValueSet/encounter-special-courtesy
from the FHIR Standard
Encounter.hospitalization.specialArrangementpreferredSpecialArrangements
http://hl7.org/fhir/ValueSet/encounter-special-arrangements
from the FHIR Standard
Encounter.hospitalization.dischargeDispositionexampleDischargeDisposition
http://hl7.org/fhir/ValueSet/encounter-discharge-disposition
from the FHIR Standard
Encounter.location.statusrequiredEncounterLocationStatus
http://hl7.org/fhir/ValueSet/encounter-location-status|4.0.1
from the FHIR Standard
Encounter.location.physicalTypeexampleLocationType
http://hl7.org/fhir/ValueSet/location-physical-type
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorEncounterIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEncounterIf 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-4errorEncounterIf 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-5errorEncounterIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEncounterA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from TWCoreEncounter

Summary

Mandatory: 6 elements
Must-Support: 1 element
Fixed: 4 elements

Differential View

This structure is derived from TWCoreEncounter

NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..* TWCoreEncounter 提供病人服務的一種互動
... status 1..1 code planned | arrived | triaged | in-progress | onleave | finished | cancelled +
Fixed Value: finished
... class
.... system 1..1 uri 專門術語系統(terminology system)的識別
Fixed Value: http://terminology.hl7.org/CodeSystem/v3-ActEncounterCode
.... code 1..1 code 系統定義的語法之符號
Fixed Value: AMB
.... display 1..1 string 由系統定義的表示法
Fixed Value: ambulatory
... serviceType 1..1 CodeableConceptTW 服務的特定型別。[應填入於門診病歷科別Department]
.... start S 1..1 dateTime 就醫的開始時間。[應填入於門診病歷門診日期OPD Date]

doco Documentation for this format

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..* TWCoreEncounter 提供病人服務的一種互動
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... modifierExtension ?! 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier SΣ 0..* Identifier 此就醫事件的識別碼
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果知道,請說明此識別碼的用途;應填入所綁定值集中的其中一個代碼。

.... system SΣ 1..1 uri 識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 1..1 string 唯一值
Example General: 123456
... class S 1..1 CodingTW 病人就醫的分類
Binding: ActEncounterCode (extensible): 就醫的分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... system SΣ 1..1 uri 專門術語系統(terminology system)的識別
Fixed Value: http://terminology.hl7.org/CodeSystem/v3-ActEncounterCode
.... code SΣ 1..1 code 系統定義的語法之符號
Fixed Value: AMB
.... display SΣ 1..1 string 由系統定義的表示法
Fixed Value: ambulatory
... serviceType S 1..1 CodeableConceptTW 服務的特定型別。[應填入於門診病歷科別Department]
Binding: SNOMED CT + 臺灣健保署 + 衛福部統計處診療科別值集 (extensible): 對提供的服務進行廣泛分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

... subject SΣ 0..1 Reference(TW Core Patient | Group) 在場就醫的病人或實體集合(Group)
... participant SΣ 0..* BackboneElement 參與就醫的健康照護服務提供者之名單
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... type S 0..* CodeableConceptTW 參與者在病人就醫事件中的角色
Binding: ParticipantType (extensible): 參與者在病人就醫事件中的角色;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


.... period S 0..1 Period 參與者在病人就醫期間參與的時段
.... individual SΣ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole | RelatedPerson) 除病人外,參與病人就醫事件的人。
... period S 1..1 Period 就醫的開始和結束時間
.... start SΣC 1..1 dateTime 就醫的開始時間。[應填入於門診病歷門診日期OPD Date]
... reasonCode S 0..* CodeableConceptTW 就醫發生的編碼原因
Binding: EncounterReasonCodes (preferred): 發生此就醫事件的原因;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


... hospitalization S 0..1 BackboneElement 關於入院接受健康照護服務的細節
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... dischargeDisposition S 0..1 CodeableConceptTW 出院後的地點類別或種類
Binding: DischargeDisposition (example): 出院處置;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

... location S 0..* BackboneElement 病人曾去過的一個或多個地點
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... location S 1..1 Reference(TW Core Location) 就醫發生的地點
... serviceProvider S 0..1 Reference(TW Core Organization) 負責這次就醫的機構

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Encounter.identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
Encounter.statusrequiredFixed Value: finished
http://hl7.org/fhir/ValueSet/encounter-status|4.0.1
from the FHIR Standard
Encounter.classextensibleFixed Value: AMB
http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
Encounter.serviceTypeextensibleTWHealthDepartmentSCT
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-department-sct-tw
Encounter.participant.typeextensibleParticipantType
http://hl7.org/fhir/ValueSet/encounter-participant-type
from the FHIR Standard
Encounter.reasonCodepreferredEncounterReasonCodes
http://hl7.org/fhir/ValueSet/encounter-reason
from the FHIR Standard
Encounter.hospitalization.dischargeDispositionexampleDischargeDisposition
http://hl7.org/fhir/ValueSet/encounter-discharge-disposition
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorEncounterIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEncounterIf 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-4errorEncounterIf 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-5errorEncounterIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEncounterA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Encounter 0..* TWCoreEncounter 提供病人服務的一種互動
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Encounter紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此Encounter Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... language 0..1 code 用以表述Encounter Resource內容的語言。
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。

Additional BindingsPurpose
AllLanguages Max Binding

Example Value: zh-TW
... text 0..1 Narrative Encounter Resource之內容摘要以供人閱讀
... contained 0..* Resource 內嵌的(contained)、行內的Resources
... extension 0..* Extension 擴充的資料項目
... modifierExtension ?! 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier SΣ 0..* Identifier 此就醫事件的識別碼
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
.... use ?!Σ 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果知道,請說明此識別碼的用途;應填入所綁定值集中的其中一個代碼。

.... type 0..1 CodeableConceptTW 識別碼(identifier)的型別說明
Binding: Identifier Type Codes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... system SΣ 1..1 uri 識別碼(identifier)的命名空間(namespace)
Example General: http://www.acme.com/identifiers/patient
.... value SΣ 1..1 string 唯一值
Example General: 123456
.... period Σ 0..1 Period 此就醫事件識別碼(identifier)的使用效期
.... assigner Σ 0..1 Reference(TW Core Organization) 簽發identifier的機構(可以只是文字表述)
... status ?!SΣ 1..1 code planned | arrived | triaged | in-progress | onleave | finished | cancelled +
Binding: EncounterStatus (required): 就醫現況的代碼;應填入所綁定值集中的其中一個代碼


Fixed Value: finished
... statusHistory 0..* BackboneElement 過去的就醫狀態清單
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... status 1..1 code planned | arrived | triaged | in-progress | onleave | finished | cancelled +
Binding: EncounterStatus (required): 就醫現狀的代碼;應填入所綁定值集中的其中一個代碼

.... period 1..1 Period 該事件處於特定狀態的時間
... class S 1..1 CodingTW 病人就醫的分類
Binding: ActEncounterCode (extensible): 就醫的分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
.... system SΣ 1..1 uri 專門術語系統(terminology system)的識別
Fixed Value: http://terminology.hl7.org/CodeSystem/v3-ActEncounterCode
.... version Σ 0..1 string 系統的版本—如果相關的話
.... code SΣ 1..1 code 系統定義的語法之符號
Fixed Value: AMB
.... display SΣ 1..1 string 由系統定義的表示法
Fixed Value: ambulatory
.... userSelected Σ 0..1 boolean 此編碼是否由使用者直接選擇?
... classHistory 0..* BackboneElement 過去就醫類別的列表
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... class 1..1 Coding inpatient | outpatient | ambulatory | emergency +
Binding: ActEncounterCode (extensible): 就醫類別;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

.... period 1..1 Period 此就醫事件處於特定類別的時間
... type 0..* CodeableConceptTW 就醫的特定型別
Binding: EncounterType (example): 就醫的型別;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


... serviceType S 1..1 CodeableConceptTW 服務的特定型別。[應填入於門診病歷科別Department]
Binding: SNOMED CT + 臺灣健保署 + 衛福部統計處診療科別值集 (extensible): 對提供的服務進行廣泛分類;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。

... priority 0..1 CodeableConceptTW 表明就醫的急迫性
Binding: ActPriority (example): 表明就醫的迫切性;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

... subject SΣ 0..1 Reference(TW Core Patient | Group) 在場就醫的病人或實體集合(Group)
... episodeOfCare Σ 0..* Reference(EpisodeOfCare) 此次就醫應記錄的照護事件
... basedOn 0..* Reference(ServiceRequest) 開始此次就醫的服務請求(ServiceRequest)
... participant SΣ 0..* BackboneElement 參與就醫的健康照護服務提供者之名單
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... type S 0..* CodeableConceptTW 參與者在病人就醫事件中的角色
Binding: ParticipantType (extensible): 參與者在病人就醫事件中的角色;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。


.... period S 0..1 Period 參與者在病人就醫期間參與的時段
.... individual SΣ 0..1 Reference(TW Core Practitioner | TW Core PractitionerRole | RelatedPerson) 除病人外,參與病人就醫事件的人。
... appointment Σ 0..* Reference(Appointment) 這次就醫的預約紀錄
... period S 1..1 Period 就醫的開始和結束時間
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... start SΣC 1..1 dateTime 就醫的開始時間。[應填入於門診病歷門診日期OPD Date]
.... end ΣC 0..1 dateTime End time with inclusive boundary, if not ongoing
... length 0..1 Duration 就醫持續的時間(扣除缺席時間)
... reasonCode S 0..* CodeableConceptTW 就醫發生的編碼原因
Binding: EncounterReasonCodes (preferred): 發生此就醫事件的原因;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


... reasonReference Σ 0..* Reference(TW Core Condition | TW Core Procedure | TW Core Observation Laboratory Result | ImmunizationRecommendation) 就醫發生的原因(參照)
... diagnosis Σ 0..* BackboneElement 與此就醫相關的診斷清單
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... condition Σ 1..1 Reference(TW Core Condition | TW Core Procedure) 與就醫事件相關的診斷或處置
.... use 0..1 CodeableConceptTW 此診斷在病人就醫事件中的作用(例如:住院、收費、出院...)。
Binding: DiagnosisRole (preferred): 此情況所代表的診斷型別;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

.... rank 0..1 positiveInt 診斷的排序(針對每個角色型別)
... account 0..* Reference(Account) 可用於為此病人就醫事件計費的一組帳戶
... hospitalization S 0..1 BackboneElement 關於入院接受健康照護服務的細節
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... preAdmissionIdentifier 0..1 Identifier 住院前識別碼
.... origin 0..1 Reference(TW Core Organization | TW Core Location) 病人住院前來自的地點/機構
.... admitSource 0..1 CodeableConceptTW 病人從哪裡住院(醫生轉介、轉院)?
Binding: AdmitSource (preferred): 病人從哪裡住院;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。

.... reAdmission 0..1 CodeableConceptTW 已發生的醫院再入院型別(如果有的話)。如果該值不存在,則不被認定為再入院。
Binding: hl7VS-re-admissionIndicator (example): 這次住院就醫的再入院原因;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... dietPreference 0..* CodeableConceptTW 病人報告的飲食偏好
Binding: Diet (example): 醫療、文化或道德方面的食物偏好,以幫助滿足飲食要求;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


.... specialCourtesy 0..* CodeableConceptTW 特別禮遇(貴賓、董事會成員)
Binding: SpecialCourtesy (preferred): 特別禮遇;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


.... specialArrangement 0..* CodeableConceptTW 輪椅、翻譯人員、擔架等。
Binding: SpecialArrangements (preferred): 特殊安排;鼓勵使用所綁定值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。


.... destination 0..1 Reference(TW Core Location | TW Core Organization) 病人出院地點/機構
.... dischargeDisposition S 0..1 CodeableConceptTW 出院後的地點類別或種類
Binding: DischargeDisposition (example): 出院處置;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

... location S 0..* BackboneElement 病人曾去過的一個或多個地點
.... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
.... extension 0..* Extension 擴充的資料項目
.... modifierExtension ?!Σ 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... location S 1..1 Reference(TW Core Location) 就醫發生的地點
.... status 0..1 code planned | active | reserved | completed
Binding: EncounterLocationStatus (required): 就醫地點的狀態;應填入所綁定值集中的其中一個代碼。

.... physicalType 0..1 CodeableConceptTW 地點的實體型別(通常是地點的層級—床位、房間、病房等)。
Binding: LocationType (example): 地點的實體型別;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... period 0..1 Period 病人出現在此地點的時段
... serviceProvider S 0..1 Reference(TW Core Organization) 負責這次就醫的機構
... partOf 0..1 Reference(TW Core Encounter) 此就醫是哪次就醫的一部份?

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet / CodeURI
Encounter.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
http://hl7.org/fhir/ValueSet/languages
from the FHIR Standard
Encounter.identifier.userequiredIdentifierUse
http://hl7.org/fhir/ValueSet/identifier-use|4.0.1
from the FHIR Standard
Encounter.identifier.typeextensibleIdentifier Type Codes
http://hl7.org/fhir/ValueSet/identifier-type
from the FHIR Standard
Encounter.statusrequiredFixed Value: finished
http://hl7.org/fhir/ValueSet/encounter-status|4.0.1
from the FHIR Standard
Encounter.statusHistory.statusrequiredEncounterStatus
http://hl7.org/fhir/ValueSet/encounter-status|4.0.1
from the FHIR Standard
Encounter.classextensibleFixed Value: AMB
http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
Encounter.classHistory.classextensibleActEncounterCode
http://terminology.hl7.org/ValueSet/v3-ActEncounterCode
Encounter.typeexampleEncounterType
http://hl7.org/fhir/ValueSet/encounter-type
from the FHIR Standard
Encounter.serviceTypeextensibleTWHealthDepartmentSCT
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/health-department-sct-tw
Encounter.priorityexampleActPriority
http://terminology.hl7.org/ValueSet/v3-ActPriority
Encounter.participant.typeextensibleParticipantType
http://hl7.org/fhir/ValueSet/encounter-participant-type
from the FHIR Standard
Encounter.reasonCodepreferredEncounterReasonCodes
http://hl7.org/fhir/ValueSet/encounter-reason
from the FHIR Standard
Encounter.diagnosis.usepreferredDiagnosisRole
http://hl7.org/fhir/ValueSet/diagnosis-role
from the FHIR Standard
Encounter.hospitalization.admitSourcepreferredAdmitSource
http://hl7.org/fhir/ValueSet/encounter-admit-source
from the FHIR Standard
Encounter.hospitalization.reAdmissionexampleHl7VSReAdmissionIndicator
http://terminology.hl7.org/ValueSet/v2-0092
Encounter.hospitalization.dietPreferenceexampleDiet
http://hl7.org/fhir/ValueSet/encounter-diet
from the FHIR Standard
Encounter.hospitalization.specialCourtesypreferredSpecialCourtesy
http://hl7.org/fhir/ValueSet/encounter-special-courtesy
from the FHIR Standard
Encounter.hospitalization.specialArrangementpreferredSpecialArrangements
http://hl7.org/fhir/ValueSet/encounter-special-arrangements
from the FHIR Standard
Encounter.hospitalization.dischargeDispositionexampleDischargeDisposition
http://hl7.org/fhir/ValueSet/encounter-discharge-disposition
from the FHIR Standard
Encounter.location.statusrequiredEncounterLocationStatus
http://hl7.org/fhir/ValueSet/encounter-location-status|4.0.1
from the FHIR Standard
Encounter.location.physicalTypeexampleLocationType
http://hl7.org/fhir/ValueSet/location-physical-type
from the FHIR Standard

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorEncounterIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorEncounterIf 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-4errorEncounterIf 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-5errorEncounterIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceEncounterA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()

This structure is derived from TWCoreEncounter

Summary

Mandatory: 6 elements
Must-Support: 1 element
Fixed: 4 elements

 

Other representations of profile: CSV, Excel, Schematron