臺灣健保事前審查實作指引
1.2.8 - ci-build

臺灣健保事前審查實作指引, published by 衛生福利部中央健康保險署. This guide is not an authorized publication; it is the continuous build for version 1.2.8 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/TWNHIFHIR/pas/ and changes regularly. See the Directory of published versions

Resource Profile: 醫事機構-Organization TWPAS

Official URL: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas Version: 1.2.8
Active as of 2026-10-14 Computable Name: OrganizationTWPAS

此醫事機構-Organization TWPAS Profile說明本IG如何進一步定義臺灣核心-機構(TW Core Organization) Profile以呈現事前審查之醫事機構基本資料

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: doco
Organization C 0..* TWCoreOrganization 具有共同目的的一群人或機構
Constraints: org-1
Organization.meta This element is included in summaries. 1..1 Meta 此Organization Resource的metadata
Organization.meta.profile This element is included in summaries. 1..1 canonical(StructureDefinition) Profiles this resource claims to conform to

Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas
Organization.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri 創建此內容所依據的一組規則
Organization.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Organization.identifier This element must be supported. This element is included in summaries. C 1..1 Identifier 醫事機構代碼
Organization.identifier.use This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果已知,請說明此識別碼的目的;應填入所綁定值集中的其中一個代碼。
Organization.identifier.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構識別碼(identifier)的型別說明
Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入所綁定值集中的其中一個代碼。
Organization.identifier.system This element must be supported. This element is included in summaries. 1..1 uri 機構識別碼(identifier)的命名空間(namespace),可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。
Required Pattern: https://nhicore.nhi.gov.tw/pas/CodeSystem/organization-identifier-tw
Organization.identifier.value This element must be supported. This element is included in summaries. 1..1 string 唯一值
Binding: NHI-健保事前審查-特約醫事機構值集 (required)
Example General: 123456
Example General: 0101090517
Organization.active This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 boolean 此機構的紀錄是否仍在使用中
Organization.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構的型別
Binding: OrganizationType (example): 用於分類機構;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Organization.name This element must be supported. This element is included in summaries. C 0..1 string 機構的名稱
Organization.telecom This element must be supported. C 0..* ContactPoint 此機構的詳細聯絡方式。 org-3:一個機構的通訊永遠不可能是「家用」,意即不可能使用「home」。
Constraints: org-3
Organization.telecom.system This element must be supported. This element is included in summaries. C 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
Organization.telecom.value This element must be supported. This element is included in summaries. 0..1 string 實際的聯絡方式之細節
Organization.telecom.use This element is a modifier element. This element is included in summaries. 0..1 code home | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Organization.identifier.​type Base extensible IdentifierType + 臺灣衛福部資訊處識別碼類型值集 📦0.3.0 臺灣核心實作指引 v0.3
Organization.identifier.​value Base required NHI-健保事前審查-特約醫事機構值集 📦2024-08-19 This IG
Organization.type Base example Organization type 📦4.0.1 FHIR Std.
Organization.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Organization.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization 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 Organization 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 Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization 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()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()

This structure is derived from TWCoreOrganization

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Organization TWCoreOrganization
Organization.meta 1..1 Meta 此Organization Resource的metadata
Organization.meta.profile 1..1 canonical(StructureDefinition) Profiles this resource claims to conform to
Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas
Organization.identifier 1..1 Identifier 醫事機構代碼
Organization.identifier.system 1..1 uri 機構識別碼(identifier)的命名空間(namespace),可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。
Required Pattern: https://nhicore.nhi.gov.tw/pas/CodeSystem/organization-identifier-tw
Organization.identifier.value 1..1 string 唯一值
Binding: NHI-健保事前審查-特約醫事機構值集 (required)
Example General: 0101090517

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Organization.identifier.​value Base required NHI-健保事前審查-特約醫事機構值集 📦2024-08-19 This IG
NameFlagsCard.TypeDescription & Constraints    Filter: doco
Organization C 0..* TWCoreOrganization 具有共同目的的一群人或機構
Constraints: org-1
Organization.id This element is included in summaries. 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Organization紀錄,通常又稱為邏輯性ID。
Organization.meta This element is included in summaries. 1..1 Meta 此Organization Resource的metadata
Organization.meta.id 0..1 string Unique id for inter-element referencing
Organization.meta.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Organization.meta.versionId This element is included in summaries. 0..1 id Version specific identifier
Organization.meta.lastUpdated This element is included in summaries. 0..1 instant When the resource version last changed
Organization.meta.source This element is included in summaries. 0..1 uri Identifies where the resource comes from
Organization.meta.profile This element is included in summaries. 1..1 canonical(StructureDefinition) Profiles this resource claims to conform to

Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas
Organization.meta.security This element is included in summaries. 0..* Coding Security Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
Organization.meta.tag This element is included in summaries. 0..* Coding Tags applied to this resource
Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
Organization.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri 創建此內容所依據的一組規則
Organization.language 0..1 code 用以表述Organization Resource內容的語言。
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Additional BindingsPurpose
AllLanguages Max Binding

Example Value: zh-TW
Organization.text 0..1 Narrative Organization Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Organization.contained 0..* Resource Contained, inline Resources
Organization.extension 0..* Extension Additional content defined by implementations
Organization.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Organization.identifier This element must be supported. This element is included in summaries. C 1..1 Identifier 醫事機構代碼
Organization.identifier.id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
Organization.identifier.extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
Organization.identifier.use This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果已知,請說明此識別碼的目的;應填入所綁定值集中的其中一個代碼。
Organization.identifier.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構識別碼(identifier)的型別說明
Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入所綁定值集中的其中一個代碼。
Organization.identifier.system This element must be supported. This element is included in summaries. 1..1 uri 機構識別碼(identifier)的命名空間(namespace),可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。
Required Pattern: https://nhicore.nhi.gov.tw/pas/CodeSystem/organization-identifier-tw
Organization.identifier.value This element must be supported. This element is included in summaries. 1..1 string 唯一值
Binding: NHI-健保事前審查-特約醫事機構值集 (required)
Example General: 123456
Example General: 0101090517
Organization.identifier.period This element is included in summaries. 0..1 Period 此機構識別碼(identifier)的使用效期
Organization.identifier.assigner This element is included in summaries. 0..1 Reference(TW Core Organization) 簽發identifier的機構(可以只是文字表述)
Organization.active This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 boolean 此機構的紀錄是否仍在使用中
Organization.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構的型別
Binding: OrganizationType (example): 用於分類機構;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Organization.name This element must be supported. This element is included in summaries. C 0..1 string 機構的名稱
Organization.alias 0..* string 此機構目前或過去已知的其他(多個)名稱
Organization.telecom This element must be supported. C 0..* ContactPoint 此機構的詳細聯絡方式。 org-3:一個機構的通訊永遠不可能是「家用」,意即不可能使用「home」。
Constraints: org-3
Organization.telecom.id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
Organization.telecom.extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
Organization.telecom.system This element must be supported. This element is included in summaries. C 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
Organization.telecom.value This element must be supported. This element is included in summaries. 0..1 string 實際的聯絡方式之細節
Organization.telecom.use This element is a modifier element. This element is included in summaries. 0..1 code home | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
Organization.telecom.rank This element is included in summaries. 0..1 positiveInt 具體說明偏好的使用順序(1=最高優先順序)
Organization.telecom.period This element is included in summaries. 0..1 Period 此聯絡方式的使用效期
Organization.address C 0..* AddressTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 此機構的地址。 org-2:一個機構的地址永遠不可能是「家用」,意即不可能使用「home」。
Constraints: org-2
Organization.partOf This element is included in summaries. 0..1 Reference(TW Core Organization) 此機構屬於哪個更高層次機構的一部分
Organization.contact 0..* BackboneElement 某一用途的機構聯絡方式
Organization.contact.id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
Organization.contact.extension 0..* Extension 擴充的資料項目
Organization.contact.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
Organization.contact.purpose 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 聯絡的型別
Binding: ContactEntityType (extensible): 你所聯絡之聯絡人的聯絡方式用途;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
Organization.contact.name 0..1 HumanName 聯絡人名字
Organization.contact.telecom 0..* ContactPoint 聯絡人的詳細聯絡方式(例如:電話、電子郵件等)。
Organization.contact.address 0..1 AddressTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 聯絡人的到訪或郵政地址
Organization.endpoint 0..* Reference(Endpoint) 存取此Organization的技術服務的終端(endpoints)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.meta.security Base extensible SecurityLabels 📍4.0.1 FHIR Std.
Organization.meta.tag Base example Common Tags 📍4.0.1 FHIR Std.
Organization.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Organization.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Organization.identifier.​type Base extensible IdentifierType + 臺灣衛福部資訊處識別碼類型值集 📦0.3.0 臺灣核心實作指引 v0.3
Organization.identifier.​value Base required NHI-健保事前審查-特約醫事機構值集 📦2024-08-19 This IG
Organization.type Base example Organization type 📦4.0.1 FHIR Std.
Organization.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Organization.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.
Organization.contact.​purpose Base extensible Contact entity type 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization 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 Organization 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 Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization 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()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-2 error Organization.address An address of an organization can never be of use 'home' where(use = 'home').empty()
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()

This structure is derived from TWCoreOrganization

Summary

Mandatory: 5 elements

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Organization C 0..* TWCoreOrganization 具有共同目的的一群人或機構
Constraints: org-1
Organization.meta This element is included in summaries. 1..1 Meta 此Organization Resource的metadata
Organization.meta.profile This element is included in summaries. 1..1 canonical(StructureDefinition) Profiles this resource claims to conform to

Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas
Organization.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri 創建此內容所依據的一組規則
Organization.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Organization.identifier This element must be supported. This element is included in summaries. C 1..1 Identifier 醫事機構代碼
Organization.identifier.use This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果已知,請說明此識別碼的目的;應填入所綁定值集中的其中一個代碼。
Organization.identifier.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構識別碼(identifier)的型別說明
Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入所綁定值集中的其中一個代碼。
Organization.identifier.system This element must be supported. This element is included in summaries. 1..1 uri 機構識別碼(identifier)的命名空間(namespace),可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。
Required Pattern: https://nhicore.nhi.gov.tw/pas/CodeSystem/organization-identifier-tw
Organization.identifier.value This element must be supported. This element is included in summaries. 1..1 string 唯一值
Binding: NHI-健保事前審查-特約醫事機構值集 (required)
Example General: 123456
Example General: 0101090517
Organization.active This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 boolean 此機構的紀錄是否仍在使用中
Organization.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構的型別
Binding: OrganizationType (example): 用於分類機構;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Organization.name This element must be supported. This element is included in summaries. C 0..1 string 機構的名稱
Organization.telecom This element must be supported. C 0..* ContactPoint 此機構的詳細聯絡方式。 org-3:一個機構的通訊永遠不可能是「家用」,意即不可能使用「home」。
Constraints: org-3
Organization.telecom.system This element must be supported. This element is included in summaries. C 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
Organization.telecom.value This element must be supported. This element is included in summaries. 0..1 string 實際的聯絡方式之細節
Organization.telecom.use This element is a modifier element. This element is included in summaries. 0..1 code home | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Organization.identifier.​type Base extensible IdentifierType + 臺灣衛福部資訊處識別碼類型值集 📦0.3.0 臺灣核心實作指引 v0.3
Organization.identifier.​value Base required NHI-健保事前審查-特約醫事機構值集 📦2024-08-19 This IG
Organization.type Base example Organization type 📦4.0.1 FHIR Std.
Organization.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Organization.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization 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 Organization 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 Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization 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()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()

Differential View

This structure is derived from TWCoreOrganization

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Organization TWCoreOrganization
Organization.meta 1..1 Meta 此Organization Resource的metadata
Organization.meta.profile 1..1 canonical(StructureDefinition) Profiles this resource claims to conform to
Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas
Organization.identifier 1..1 Identifier 醫事機構代碼
Organization.identifier.system 1..1 uri 機構識別碼(identifier)的命名空間(namespace),可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。
Required Pattern: https://nhicore.nhi.gov.tw/pas/CodeSystem/organization-identifier-tw
Organization.identifier.value 1..1 string 唯一值
Binding: NHI-健保事前審查-特約醫事機構值集 (required)
Example General: 0101090517

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
Organization.identifier.​value Base required NHI-健保事前審查-特約醫事機構值集 📦2024-08-19 This IG

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: doco
Organization C 0..* TWCoreOrganization 具有共同目的的一群人或機構
Constraints: org-1
Organization.id This element is included in summaries. 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的Organization紀錄,通常又稱為邏輯性ID。
Organization.meta This element is included in summaries. 1..1 Meta 此Organization Resource的metadata
Organization.meta.id 0..1 string Unique id for inter-element referencing
Organization.meta.extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
Organization.meta.versionId This element is included in summaries. 0..1 id Version specific identifier
Organization.meta.lastUpdated This element is included in summaries. 0..1 instant When the resource version last changed
Organization.meta.source This element is included in summaries. 0..1 uri Identifies where the resource comes from
Organization.meta.profile This element is included in summaries. 1..1 canonical(StructureDefinition) Profiles this resource claims to conform to

Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Organization-twpas
Organization.meta.security This element is included in summaries. 0..* Coding Security Labels applied to this resource
Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
Organization.meta.tag This element is included in summaries. 0..* Coding Tags applied to this resource
Binding: CommonTags (example): Codes that represent various types of tags, commonly workflow-related; e.g. "Needs review by Dr. Jones".
Organization.implicitRules This element is a modifier element. This element is included in summaries. 0..1 uri 創建此內容所依據的一組規則
Organization.language 0..1 code 用以表述Organization Resource內容的語言。
Binding: CommonLanguages (preferred): 人類語言;鼓勵使用CommonLanguages代碼表中的代碼,但不強制一定要使用此代碼表,你也可使用其他代碼表的代碼或單純以文字表示。
Additional BindingsPurpose
AllLanguages Max Binding

Example Value: zh-TW
Organization.text 0..1 Narrative Organization Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
Organization.contained 0..* Resource Contained, inline Resources
Organization.extension 0..* Extension Additional content defined by implementations
Organization.modifierExtension This element is a modifier element. 0..* Extension Extensions that cannot be ignored
Organization.identifier This element must be supported. This element is included in summaries. C 1..1 Identifier 醫事機構代碼
Organization.identifier.id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
Organization.identifier.extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
Organization.identifier.use This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 code usual | official | temp | secondary | old (如果知道)
Binding: IdentifierUse (required): 如果已知,請說明此識別碼的目的;應填入所綁定值集中的其中一個代碼。
Organization.identifier.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構識別碼(identifier)的型別說明
Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別,用於決定特定目的所適用的識別碼;應填入所綁定值集中的其中一個代碼。
Organization.identifier.system This element must be supported. This element is included in summaries. 1..1 uri 機構識別碼(identifier)的命名空間(namespace),可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。
Required Pattern: https://nhicore.nhi.gov.tw/pas/CodeSystem/organization-identifier-tw
Organization.identifier.value This element must be supported. This element is included in summaries. 1..1 string 唯一值
Binding: NHI-健保事前審查-特約醫事機構值集 (required)
Example General: 123456
Example General: 0101090517
Organization.identifier.period This element is included in summaries. 0..1 Period 此機構識別碼(identifier)的使用效期
Organization.identifier.assigner This element is included in summaries. 0..1 Reference(TW Core Organization) 簽發identifier的機構(可以只是文字表述)
Organization.active This element is a modifier element. This element must be supported. This element is included in summaries. 0..1 boolean 此機構的紀錄是否仍在使用中
Organization.type This element must be supported. 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 機構的型別
Binding: OrganizationType (example): 用於分類機構;可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Organization.name This element must be supported. This element is included in summaries. C 0..1 string 機構的名稱
Organization.alias 0..* string 此機構目前或過去已知的其他(多個)名稱
Organization.telecom This element must be supported. C 0..* ContactPoint 此機構的詳細聯絡方式。 org-3:一個機構的通訊永遠不可能是「家用」,意即不可能使用「home」。
Constraints: org-3
Organization.telecom.id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
Organization.telecom.extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
Organization.telecom.system This element must be supported. This element is included in summaries. C 0..1 code phone | fax | email | pager | url | sms | other
Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
Organization.telecom.value This element must be supported. This element is included in summaries. 0..1 string 實際的聯絡方式之細節
Organization.telecom.use This element is a modifier element. This element is included in summaries. 0..1 code home | work | temp | old | mobile-此聯絡方式的用途
Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
Organization.telecom.rank This element is included in summaries. 0..1 positiveInt 具體說明偏好的使用順序(1=最高優先順序)
Organization.telecom.period This element is included in summaries. 0..1 Period 此聯絡方式的使用效期
Organization.address C 0..* AddressTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 此機構的地址。 org-2:一個機構的地址永遠不可能是「家用」,意即不可能使用「home」。
Constraints: org-2
Organization.partOf This element is included in summaries. 0..1 Reference(TW Core Organization) 此機構屬於哪個更高層次機構的一部分
Organization.contact 0..* BackboneElement 某一用途的機構聯絡方式
Organization.contact.id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
Organization.contact.extension 0..* Extension 擴充的資料項目
Organization.contact.modifierExtension This element is a modifier element. This element is included in summaries. 0..* Extension 此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
Organization.contact.purpose 0..1 CodeableConceptTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 聯絡的型別
Binding: ContactEntityType (extensible): 你所聯絡之聯絡人的聯絡方式用途;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
Organization.contact.name 0..1 HumanName 聯絡人名字
Organization.contact.telecom 0..* ContactPoint 聯絡人的詳細聯絡方式(例如:電話、電子郵件等)。
Organization.contact.address 0..1 AddressTW The snapshot does not say whether the constraints on the root of this type profile have been applied to this element, so assume they have not. Check the type profile directly as well 聯絡人的到訪或郵政地址
Organization.endpoint 0..* Reference(Endpoint) 存取此Organization的技術服務的終端(endpoints)

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
Organization.meta.security Base extensible SecurityLabels 📍4.0.1 FHIR Std.
Organization.meta.tag Base example Common Tags 📍4.0.1 FHIR Std.
Organization.language Base preferred Common Languages 📦4.0.1 FHIR Std.
Organization.identifier.​use Base required IdentifierUse 📍4.0.1 FHIR Std.
Organization.identifier.​type Base extensible IdentifierType + 臺灣衛福部資訊處識別碼類型值集 📦0.3.0 臺灣核心實作指引 v0.3
Organization.identifier.​value Base required NHI-健保事前審查-特約醫事機構值集 📦2024-08-19 This IG
Organization.type Base example Organization type 📦4.0.1 FHIR Std.
Organization.telecom.​system Base required ContactPointSystem 📍4.0.1 FHIR Std.
Organization.telecom.​use Base required ContactPointUse 📍4.0.1 FHIR Std.
Organization.contact.​purpose Base extensible Contact entity type 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error Organization If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error Organization 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 Organization 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 Organization If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice Organization 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()
org-1 error Organization The organization SHALL at least have a name or an identifier, and possibly more than one (identifier.count() + name.count()) > 0
org-2 error Organization.address An address of an organization can never be of use 'home' where(use = 'home').empty()
org-3 error Organization.telecom The telecom of an organization can never be of use 'home' where(use = 'home').empty()

This structure is derived from TWCoreOrganization

Summary

Mandatory: 5 elements

 

Other representations of profile: CSV, Excel, Schematron

Notes:

以下概述了此Profile所需的RESTful FHIR互動功能。有關TWPAS支援的RESTful互動功能的完整清單,請參閱TWPAS Server能力聲明。

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

  1. 必須(SHALL) 支援透過查詢參數 identifier 查詢所有Organization:
    (如何透過token查詢)
    GET [base]/Organization?identifier=[code]

    例子:
    (1) GET [base]/Organization?identifier=0101090517