醫療院所-Organization TWSS Base - 臺灣社政領域基礎實作指引 v0.0.1

臺灣社政領域基礎實作指引, 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: 醫療院所-Organization TWSS Base

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

醫療院所資料使用獨立的 Organization 實體，以供相關服務 Encounter 參照。

Usages:

Refer to this Profile: 資料建立與修改歷程-Provenance TWSS Base
Examples for this Profile: 長庚醫院
CapabilityStatements using this Profile: TWSS Base IG 用戶端能力聲明 and TWSS Base IG 伺服端能力聲明

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

Key Elements Table
Differential Table
Snapshot Table
Statistics/References
All

Name	Flags	Card.	Type	Description & Constraints Filter: Bindings Constraints Obligations
Organization	C	0..*	OrganizationTWSSBase	具有共同目的的一群人或機構 Constraints: org-1
implicitRules	?!Σ	0..1	uri	創建此內容所依據的一組規則
Slices for extension				Content/Rules for all slices
extension:establishmentType	S	0..1	CodeableConceptTW	機構設立別。 URL: https://sfaa.gov.tw/base/StructureDefinition/twss-organization-establishment-type Binding: TWSS-機構設立別值集 (required)
extension:registrationDate	S	0..1	date	機構立案日期。 URL: https://sfaa.gov.tw/base/StructureDefinition/twss-organization-registration-date
extension:competentAuthority	S	0..1	Reference(機構資料-Organization TWSS Base)	機構主管機關。 URL: https://sfaa.gov.tw/base/StructureDefinition/twss-organization-competent-authority
extension:capacity	S	0..*	(Complex)	機構收容量能。 URL: https://sfaa.gov.tw/base/StructureDefinition/twss-organization-capacity
extension:usableArea	S	0..*	(Complex)	機構可使用面積。 URL: https://sfaa.gov.tw/base/StructureDefinition/twss-organization-usable-area
extension:statutoryStaffing	S	0..*	(Complex)	法定設置標準人數。 URL: https://sfaa.gov.tw/base/StructureDefinition/twss-organization-statutory-staffing
modifierExtension	?!	0..*	Extension	Extensions that cannot be ignored
Slices for identifier	SΣC	1..*	Identifier	機構統一編號、機構代碼或來源系統內部機構識別碼。 Slice: Unordered, Open by value:system
identifier:All Slices				Content/Rules for all slices
use	?!SΣ	0..1	code	usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果已知，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。
type	S	0..1	CodeableConceptTW	機構識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中的其中一個代碼。
system	SΣ	0..1	uri	機構識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。 Example General: http://www.acme.com/identifiers/patient
value	SΣ	0..1	string	唯一值 Example General: 123456
identifier:organizationCode	SΣC	1..1	Identifier	機構代碼。
use	?!SΣ	0..1	code	usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果已知，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。
type	S	0..1	CodeableConceptTW	機構識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中的其中一個代碼。
system	SΣ	1..1	uri	機構識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。 Required Pattern: https://sfaa.gov.tw/base/identifier/organization-code
value	SΣ	1..1	string	唯一值 Example General: 123456
identifier:licenseNumber	SΣC	0..1	Identifier	機構許可證字號。
use	?!SΣ	0..1	code	usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果已知，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。
type	S	0..1	CodeableConceptTW	機構識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中的其中一個代碼。
system	SΣ	1..1	uri	機構識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&type=0)申請或查詢命名系統。 Required Pattern: https://sfaa.gov.tw/base/identifier/organization-license-number
value	SΣ	1..1	string	唯一值 Example General: 123456
active	?!SΣ	0..1	boolean	此機構的紀錄是否仍在使用中
type	S	0..1	CodeableConceptTW	機構本身的業務類型；服務、安置或收托流程中的處所類型應由對應流程資料表達。 Binding: TWSS-機構類型值集 (extensible)
name	SΣC	1..1	string	醫療院所名稱
alias	S	0..*	string	此機構目前或過去已知的其他（多個）名稱
telecom	SC	0..*	ContactPoint	機構電話、傳真、電子郵件或其他聯絡方式。 Constraints: org-3
system	SΣC	0..1	code	phone \| fax \| email \| pager \| url \| sms \| other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value	SΣ	0..1	string	實際的聯絡方式之細節
use	?!SΣ	0..1	code	home \| work \| temp \| old \| mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
address	SC	0..*	AddressTWSSBase	機構地址。 Constraints: org-2
Slices for extension				Content/Rules for all slices
extension:room	S	0..1	string	室 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-room
extension:floor	S	0..1	string	樓 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-floor
extension:number	S	0..1	string	號 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-number
extension:alley	S	0..1	string	弄 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-alley
extension:lane	S	0..1	string	巷/衖 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-lane
extension:section	S	0..1	string	段 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-section
extension:neighborhood	S	0..1	string	鄰 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-neighborhood
extension:village	S	0..1	string	村(里) URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-village
use	?!SΣ	0..1	code	home ｜ work ｜ temp ｜ old ｜ billing －此地址的用途 Binding: AddressUse (required): 應填入AddressUse值集中的其中一個代碼 Example General: home
type	SΣ	0..1	code	postal ｜ physical ｜ both Binding: AddressType (required): 應填入AddressType值集中的其中一個代碼 Example General: both
text	SΣ	0..1	string	地址的文字表述 Example General: 137 Nowhere Street, Erewhon 9132
line	SΣ	0..1	string	路/街 This repeating element order: The order in which lines should appear in an address label Example General: 137 Nowhere Street
city	SΣ	0..1	string	鄉/鎮/市/區，定義上與國際的等級一致。原文為：Name of city, town etc.。 Example General: Erewhon
district	SΣ	0..1	string	縣市 Binding: TWSS-縣市碼值集 (extensible): 臺灣縣市行政區域代碼。 Example General: Madison Example TWSSCountyCityCode: 6300000000
postalCode	SΣ	0..1	string	郵遞區號 Example General: 9132
Slices for extension				Content/Rules for all slices
extension:PostalCode	S	0..1	(Complex)	臺灣郵遞區號 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-postal-code
extension		0..0		Extension Slice: Unordered, Open by value:url
url		1..1	uri	"https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/tw-postal-code"
value[x]	S	0..1	CodeableConceptTW	擴充的資料項目的內容值
Slices for coding	S	0..*	CodingTW	由專門術語系統（terminology system）定義的代碼 Slice: Unordered, Open by pattern:system
Slices for coding				Content/Rules for all slices
coding:PostalCode3	S	0..1	CodingTW	由專門術語系統（terminology system）定義的代碼 Binding: 臺灣中華郵政3碼郵遞區號值集 (required): 應填入所綁定值集中的其中一個代碼
system	SΣ	1..1	uri	專門術語系統（terminology system）的識別 Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/postal-code3-tw
code	SΣ	1..1	code	系統定義的語法之符號
display	SΣ	0..1	string	由系統定義的表示法
coding:PostalCode5	S	0..1	CodingTW	由專門術語系統（terminology system）定義的代碼 Binding: 臺灣中華郵政5碼郵遞區號值集 (required): 應填入所綁定值集中的其中一個代碼
system	SΣ	1..1	uri	專門術語系統（terminology system）的識別 Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/postal-code5-tw
code	SΣ	1..1	code	系統定義的語法之符號
display	SΣ	0..1	string	由系統定義的表示法
coding:PostalCode6	S	0..1	CodingTW	由專門術語系統（terminology system）定義的代碼 Binding: 臺灣中華郵政6碼郵遞區號值集 (required): 應填入所綁定值集中的其中一個代碼
system	SΣ	1..1	uri	專門術語系統（terminology system）的識別 Required Pattern: https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/postal-code6-tw
code	SΣ	1..1	code	系統定義的語法之符號
display	SΣ	0..1	string	由系統定義的表示法
text	SΣ	0..1	string	概念的文字表示法
country	SΣ	0..1	string	國家（例如：ISO 3166的2個或3個字母代碼）。
partOf	SΣ	0..1	Reference(機構資料-Organization TWSS Base)	上層機構或主管組織。
contact	S	0..*	BackboneElement	機構聯絡窗口或負責人摘要資料；若需獨立表示人員角色，建議使用 PractitionerRoleTWSSBase。
modifierExtension	?!Σ	0..*	Extension	此擴充的資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。
purpose	S	0..1	CodeableConceptTW	聯絡的型別 Binding: ContactEntityType (extensible): 你所聯絡之聯絡人的聯絡方式用途；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
name	S	0..1	HumanName	聯絡人名字
telecom	S	0..*	ContactPoint	聯絡人的詳細聯絡方式（例如：電話、電子郵件等）。
address	S	0..1	AddressTWSSBase	聯絡人的到訪或郵政地址
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:organizationCode.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:organizationCode.type	Base	extensible	IdentifierType + 臺灣衛福部資訊處識別碼類型值集	📦0.3.0	臺灣核心實作指引 v0.3
Organization.identifier:licenseNumber.use	Base	required	IdentifierUse	📍4.0.1	FHIR Std.
Organization.identifier:licenseNumber.type	Base	extensible	IdentifierType + 臺灣衛福部資訊處識別碼類型值集	📦0.3.0	臺灣核心實作指引 v0.3
Organization.type	Base	extensible	TWSS-機構類型值集	📦0.0.1	This IG
Organization.telecom.system	Base	required	ContactPointSystem	📍4.0.1	FHIR Std.
Organization.telecom.use	Base	required	ContactPointUse	📍4.0.1	FHIR Std.
Organization.address.use	Base	required	AddressUse	📍4.0.1	FHIR Std.
Organization.address.type	Base	required	AddressType	📍4.0.1	FHIR Std.
Organization.address.district	Base	extensible	TWSS-縣市碼值集	📦0.0.1	This IG
Organization.address.postalCode.extension:PostalCode.value[x].coding:PostalCode3	Base	required	臺灣中華郵政3碼郵遞區號值集	📦2015-01-22	臺灣核心實作指引 v0.3
Organization.address.postalCode.extension:PostalCode.value[x].coding:PostalCode5	Base	required	臺灣中華郵政5碼郵遞區號值集	📦2022-06-21	臺灣核心實作指引 v0.3
Organization.address.postalCode.extension:PostalCode.value[x].coding:PostalCode6	Base	required	臺灣中華郵政6碼郵遞區號值集	📦2020-10-22	臺灣核心實作指引 v0.3
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()`