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

臺灣健保事前審查實作指引, published by 衛生福利部中央健康保險署. This guide is not an authorized publication; it is the continuous build for version 1.1.0 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: 病人資訊-Patient TWPAS

Official URL: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas | Version: 1.1.0
Active as of 2025-12-17 | Computable Name: PatientTWPAS

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

Usages:

- Use this Profile: 免疫製劑事前審查-Bundle Immunologic Aagent TWPAS and 癌藥事前審查-Bundle TWPAS
- Refer to this Profile: 過敏史-AllergyIntolerance TWPAS, 計畫-CarePlan TWPAS, 免疫製劑事前審查-Claim Immunologic Aagent TWPAS, 癌藥事前審查-Claim TWPAS... Show 24 more, 自主審查-ClaimResponse Self Assessment TWPAS, 事前審查回覆-ClaimResponse TWPAS, 評估-ClinicalImpression TWPAS, 診斷-Condition TWPAS, 健保事前審查計畫-Coverage TWPAS, 影像報告-DiagnosticReport Image TWPAS, 檢查報告-DiagnosticReport TWPAS, 文件參照-DocumentReference TWPAS, 門診病歷-Encounter OPD TWPAS, 就醫科別-Encounter TWPAS, DICOM影像-ImagingStudy TWPAS, 非DICOM影像-Media TWPAS, 事前審查品項-MedicationRequest Apply TWPAS, 用藥品項-MedicationRequest Treat TWPAS, 血型-Observation Blood Group TWPAS, 癌症分期量表-Observation Cancer Stage TWPAS, 基因資訊-Observation Diagnostic TWPAS, 檢驗檢查-Observation Laboratory Result TWPAS, 客觀描述-Observation Objective TWPAS, 病人狀態評估-Observation Patient Assessment TWPAS, 主觀描述-Observation Subjective TWPAS, 治療後疾病狀態評估-Observation Treatment Assessment TWPAS, 放射/照光治療-Procedure TWPAS and 基因檢測檢體-Specimen TWPAS
- Examples for this Profile: Patient/pat-min and Patient/pat-resident
- CapabilityStatements using this Profile: 臺灣事前審查-用戶端(TWPAS Client) and 臺灣事前審查-伺服端(TWPAS Server)

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
--- | --- | --- | --- | ---
Patient | C | 0..* | TWCorePatient | 接受健康照護服務的個人或動物之資訊 Constraints: patient-gender-match
meta | Σ | 1..1 | Meta | 此Patient Resource的metadata
profile | Σ | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則
Slices for extension |  |  |  | Content/Rules for all slices
extension:age | S | 0..1 | Age | 年齡 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/person-age
extension:nationality | S | 0..1 | (Complex) | 病人所屬國籍 URL: http://hl7.org/fhir/StructureDefinition/patient-nationality
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
Slices for identifier | S Σ | 1..2 | Identifier | 病人的身份識別碼（identifier），通常為業務目的所使用的識別碼，例如病歷號。 Slice: Unordered, Closed by value:type.coding.code, value:type.coding.system
identifier:idCardNumber | S Σ C | 0..1 | Identifier | 身分證號，被保險人國民身分證統一編號。 Constraints: id-card-number
use | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: NNxxx
Slices for extension |  |  |  | Content/Rules for all slices
extension:identifier-suffix | S | 0..1 | (Complex) | 識別碼後綴詞 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/identifier-suffix
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：身分證字號='http://www.moi.gov.tw' Required Pattern: http://www.moi.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：身分證字號為A123456789。[應填入於醫學影像報告身分證號ID Number] Example General: 123456
identifier:residentNumber | S Σ C | 0..1 | Identifier | 居留證號。 Constraints: resident-number
use | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: PRC
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：居留證號='http://www.immigration.gov.tw'。 Required Pattern: http://www.immigration.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：居留證號碼為A912345678 Example General: 123456
identifier:medicalRecord | S Σ | 0..1 | Identifier | 病歷號 (參與醫院必須註冊命名系統)，由醫院自行填寫。
use | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: MR
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&amp;type=0)申請或查詢命名系統。 Example General: http://www.acme.com/identifiers/patient
value | S Σ | 0..1 | string | 唯一值。 例如：病歷號為8862168。[應填入於醫學影像報告病歷號碼Chart No.] Example General: 123456
active | ?!S Σ | 0..1 | boolean | 病人的紀錄是否「使用中（true）」
Slices for name | Σ C | 1..1 | HumanName | 病人的姓名 Slice: Unordered, Open by pattern:use Constraints: pat-name
name:usual | S Σ C | 1..1 | HumanName | 病人所屬國籍的真實姓名 Constraints: tw-core-1
use | ?!S Σ | 1..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: usual
text | S Σ C | 1..1 | string | 病人所屬國籍的真實姓名。[應填入於醫學影像報告姓名Name] Example General: 陳加玲
family | S Σ C | 0..1 | string | 若所屬國籍可區分family及given，填入所屬國籍之姓（family） Example General: 陳
given | S Σ C | 0..* | string | 若所屬國籍可區分family及given，填入所屬國籍之名（given） This repeating element order: Given Names appear in the correct order for presenting the name Example General: 加玲
telecom | S Σ | 0..* | ContactPoint | 病人的聯絡資訊（例如：電話、電子郵件等）
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
period | S Σ | 0..1 | Period | 此聯絡方式的使用效期
gender | S Σ | 1..1 | code | male:男性 ｜ female:女性 ｜ other:其他 ｜ unknown:未知 Binding: AdministrativeGender (required): 病人性別；應填入所綁定值集中的其中一個代碼。
birthDate | S Σ | 1..1 | date | 出生日期，YYYY-MM-DD，西元年月日。
deceased[x] | ?!Σ | 0..1 |  | 病人是否過世
deceasedBoolean |  |  | boolean |
deceasedDateTime |  |  | dateTime |
address | S | 0..* | AddressTW | 病人聯絡地址 pat-cnt-2or3-char：如果有國家名，則必須（SHALL）從[ISO Country Alpha-2](http://hl7.org/fhir/valueset/iso3166-1-2)找出相對代碼作呈現。 如果未在ISO Country Alpha-2 中找到此一國家的代碼，則可能可以（MAY）從[ISO Country Alpha-3](http://hl7.org/fhir/valueset/iso3166-1-3)找出相對代碼作呈現。
maritalStatus | S | 0..1 | CodeableConceptTW | 病人的婚姻狀態 Binding: Marital Status Codes (extensible): 病人的婚姻狀態；應填入 Marital Status Codes 值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
photo | S | 0..* | Attachment | 病人的影像（照片）
contact | S C | 0..* | BackboneElement | 病人的聯絡人，例如：監護人、伴侶、朋友等。 Constraints: pat-1
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
relationship | S | 0..* | CodeableConceptTW | 概念（Concept）－參照一個專門術語或只是文字表述 Binding: PatientRelationshipType (required): 應填入所綁定值集中的其中一個代碼。
name | S | 0..1 | HumanName | 聯絡人姓名
use | ?!S Σ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。
text | S Σ | 0..1 | string | 完整的中文姓名
family | S Σ | 0..1 | string | 英文姓
given | S Σ | 0..* | string | 英文名 This repeating element order: Given Names appear in the correct order for presenting the name
telecom | S | 0..* | ContactPoint | 聯絡人的詳細聯絡資訊
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
period | S | 0..1 | Period | 聯絡人或其可聯絡機構之可聯絡期（時間區間）
communication | S | 0..* | BackboneElement | 向病人說明健康狀態時所使用的語言
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
language | S | 1..1 | CodeableConceptTW | 向病人說明健康狀況時所使用的語言 Binding: CommonLanguages (preferred): 應填入所綁定值集中的其中一個代碼。
Additional Bindings | Purpose
AllLanguages | Max Binding
Example Value: zh-TW
managingOrganization | S Σ | 0..1 | Reference(TW Core Organization) | 此紀錄的保管機構
link | ?!Σ | 0..* | BackboneElement | 連結至此病人的其他Patient Resource
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
other | Σ | 1..1 | Reference(TW Core Patient | TW Core RelatedPerson) | 連結至其他Patient或RelatedPerson Resource
type | Σ | 1..1 | code | replaced-by ｜ replaces ｜ refer ｜ seealso Binding: LinkType (required): 連結的型別；應填入所綁定值集中的其中一個代碼。
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Patient.identifier:idCardNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:idCardNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:passportNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:passportNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:residentNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:residentNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:medicalRecord.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:medicalRecord.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.name:official.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:usual.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:temp.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:anonymous.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.telecom.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.telecom.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
Patient.maritalStatus | Base | extensible | MaritalStatus | 📦4.0.1 | FHIR Std.
Patient.contact.relationship | Base | required | Patient relationship type | 📦4.0.1 | FHIR Std.
Patient.contact.name.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.communication.​language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Patient | 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 | Patient | 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 | Patient | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Patient | 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()`
id-card-number | error | Patient.identifier:idCardNumber | 身分證號共十碼，首碼以英文字母代表直轄市、縣（市）別，第二碼至第十碼為數字碼。 | `value.matches('^[A-Za-z][0-9]{9}$')`
pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization | `name.exists() or telecom.exists() or address.exists() or organization.exists()`
pat-name | error | Patient.name | 病人姓名有誤 ，超過40字 | `text.length() <= 40`
patient-gender-match | error | Patient | gender依據identifier:idCardNumber第二位字符檢核男性與女性代碼 (1=male, 2=female) | `identifier.where(system = 'http://www.moi.gov.tw').value.exists() implies (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '1' implies gender = 'male') and (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '2' implies gender = 'female')`
resident-number | error | Patient.identifier:residentNumber | 居留證號格式為：「1碼英文+9碼數字」或「2碼英文+8碼數字」。 | `value.matches('^([A-Za-z][0-9]{9}|[A-Za-z]{2}[0-9]{8})$')`
tw-core-1 | error | Patient.name:usual | Patient.name.text or Patient.name.family or both SHALL be present | `text.exists() or family.exists()`

This structure is derived from TWCorePatient

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Patient | C | 0..* | TWCorePatient | 接受健康照護服務的個人或動物之資訊 Constraints: patient-gender-match
meta |  | 1..1 | Meta | 此Patient Resource的metadata
profile |  | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas
Slices for identifier |  | 1..2 | Identifier | 病人的身份識別碼（identifier），通常為業務目的所使用的識別碼，例如病歷號。 Slice: Unordered, Closed by value:type.coding.code, value:type.coding.system
identifier:idCardNumber |  | 0..1 | Identifier | 身分證號，被保險人國民身分證統一編號。
identifier:passportNumber |  | 0..0 |  | 適用護照號碼
identifier:residentNumber | C | 0..1 | Identifier | 居留證號。 Constraints: resident-number
identifier:medicalRecord |  | 0..1 | Identifier | 病歷號 (參與醫院必須註冊命名系統)，由醫院自行填寫。
name | C | 1..1 | HumanName | 病人的姓名 Constraints: pat-name
Slices for name |  |  |  | Content/Rules for all slices
name:official |  | 0..0 |  | 病人的護照姓名
name:usual |  | 1..1 | HumanName | 病人所屬國籍的真實姓名
text |  | 1..1 | string | 病人所屬國籍的真實姓名。[應填入於醫學影像報告姓名Name]
name:temp |  | 0..0 |  | 新生兒姓名，緊急救護未知病人姓名時亦可用。
name:anonymous |  | 0..0 |  | 匿名供研究使用
gender |  | 1..1 | code | male:男性 ｜ female:女性 ｜ other:其他 ｜ unknown:未知
birthDate |  | 1..1 | date | 出生日期，YYYY-MM-DD，西元年月日。
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
pat-name | error | Patient.name | 病人姓名有誤 ，超過40字 | `text.length() <= 40`
patient-gender-match | error | Patient | gender依據identifier:idCardNumber第二位字符檢核男性與女性代碼 (1=male, 2=female) | `identifier.where(system = 'http://www.moi.gov.tw').value.exists() implies (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '1' implies gender = 'male') and (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '2' implies gender = 'female')`
resident-number | error | Patient.identifier:residentNumber | 居留證號格式為：「1碼英文+9碼數字」或「2碼英文+8碼數字」。 | `value.matches('^([A-Za-z][0-9]{9}|[A-Za-z]{2}[0-9]{8})$')`

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Patient | C | 0..* | TWCorePatient | 接受健康照護服務的個人或動物之資訊 Constraints: patient-gender-match
id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Patient紀錄，通常又稱為邏輯性ID。
meta | Σ | 1..1 | Meta | 此Patient Resource的metadata
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
versionId | Σ | 0..1 | id | Version specific identifier
lastUpdated | Σ | 0..1 | instant | When the resource version last changed
source | Σ | 0..1 | uri | Identifies where the resource comes from
profile | Σ | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas
security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag | Σ | 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".
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則
language |  | 0..1 | code | 用以表述Patient Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Additional Bindings | Purpose
AllLanguages | Max Binding
Example Value: zh-TW
text |  | 0..1 | Narrative | Patient Resource之內容摘要以供人閱讀 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:age | S | 0..1 | Age | 年齡 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/person-age
extension:nationality | S | 0..1 | (Complex) | 病人所屬國籍 URL: http://hl7.org/fhir/StructureDefinition/patient-nationality
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
Slices for identifier | S Σ | 1..2 | Identifier | 病人的身份識別碼（identifier），通常為業務目的所使用的識別碼，例如病歷號。 Slice: Unordered, Closed by value:type.coding.code, value:type.coding.system
identifier:idCardNumber | S Σ C | 0..1 | Identifier | 身分證號，被保險人國民身分證統一編號。 Constraints: id-card-number
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 | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: NNxxx
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:identifier-suffix | S | 0..1 | (Complex) | 識別碼後綴詞 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/identifier-suffix
value |  | 0..1 | string | Primitive value for code
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：身分證字號='http://www.moi.gov.tw' Required Pattern: http://www.moi.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：身分證字號為A123456789。[應填入於醫學影像報告身分證號ID Number] Example General: 123456
period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期
assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述）
identifier:residentNumber | S Σ C | 0..1 | Identifier | 居留證號。 Constraints: resident-number
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 | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: PRC
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：居留證號='http://www.immigration.gov.tw'。 Required Pattern: http://www.immigration.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：居留證號碼為A912345678 Example General: 123456
period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期
assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述）
identifier:medicalRecord | 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 | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: MR
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&amp;type=0)申請或查詢命名系統。 Example General: http://www.acme.com/identifiers/patient
value | S Σ | 0..1 | string | 唯一值。 例如：病歷號為8862168。[應填入於醫學影像報告病歷號碼Chart No.] Example General: 123456
period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期
assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述）
active | ?!S Σ | 0..1 | boolean | 病人的紀錄是否「使用中（true）」
Slices for name | Σ C | 1..1 | HumanName | 病人的姓名 Slice: Unordered, Open by pattern:use Constraints: pat-name
name:usual | S Σ C | 1..1 | HumanName | 病人所屬國籍的真實姓名 Constraints: tw-core-1
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 | ?!S Σ | 1..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: usual
text | S Σ C | 1..1 | string | 病人所屬國籍的真實姓名。[應填入於醫學影像報告姓名Name] Example General: 陳加玲
family | S Σ C | 0..1 | string | 若所屬國籍可區分family及given，填入所屬國籍之姓（family） Example General: 陳
given | S Σ C | 0..* | string | 若所屬國籍可區分family及given，填入所屬國籍之名（given） This repeating element order: Given Names appear in the correct order for presenting the name Example General: 加玲
prefix | Σ | 0..* | string | 姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。 This repeating element order: Prefixes appear in the correct order for presenting the name
suffix | Σ | 0..* | string | 姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。 This repeating element order: Suffixes appear in the correct order for presenting the name
period | Σ | 0..1 | Period | 此姓名的使用效期
telecom | S Σ | 0..* | ContactPoint | 病人的聯絡資訊（例如：電話、電子郵件等）
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
rank | Σ | 0..1 | positiveInt | 具體說明偏好的使用順序（1=最高優先順序）
period | S Σ | 0..1 | Period | 此聯絡方式的使用效期
gender | S Σ | 1..1 | code | male:男性 ｜ female:女性 ｜ other:其他 ｜ unknown:未知 Binding: AdministrativeGender (required): 病人性別；應填入所綁定值集中的其中一個代碼。
birthDate | S Σ | 1..1 | date | 出生日期，YYYY-MM-DD，西元年月日。
deceased[x] | ?!Σ | 0..1 |  | 病人是否過世
deceasedBoolean |  |  | boolean |
deceasedDateTime |  |  | dateTime |
address | S | 0..* | AddressTW | 病人聯絡地址 pat-cnt-2or3-char：如果有國家名，則必須（SHALL）從[ISO Country Alpha-2](http://hl7.org/fhir/valueset/iso3166-1-2)找出相對代碼作呈現。 如果未在ISO Country Alpha-2 中找到此一國家的代碼，則可能可以（MAY）從[ISO Country Alpha-3](http://hl7.org/fhir/valueset/iso3166-1-3)找出相對代碼作呈現。
maritalStatus | S | 0..1 | CodeableConceptTW | 病人的婚姻狀態 Binding: Marital Status Codes (extensible): 病人的婚姻狀態；應填入 Marital Status Codes 值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
multipleBirth[x] |  | 0..1 |  | 病人是否為多胞胎；或多胞胎出生順序。
multipleBirthBoolean |  |  | boolean |
multipleBirthInteger |  |  | integer |
photo | S | 0..* | Attachment | 病人的影像（照片）
contact | S C | 0..* | BackboneElement | 病人的聯絡人，例如：監護人、伴侶、朋友等。 Constraints: pat-1
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
relationship | S | 0..* | CodeableConceptTW | 概念（Concept）－參照一個專門術語或只是文字表述 Binding: PatientRelationshipType (required): 應填入所綁定值集中的其中一個代碼。
name | S | 0..1 | HumanName | 聯絡人姓名
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 | ?!S Σ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。
text | S Σ | 0..1 | string | 完整的中文姓名
family | S Σ | 0..1 | string | 英文姓
given | S Σ | 0..* | string | 英文名 This repeating element order: Given Names appear in the correct order for presenting the name
prefix | Σ | 0..* | string | 姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。 This repeating element order: Prefixes appear in the correct order for presenting the name
suffix | Σ | 0..* | string | 姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。 This repeating element order: Suffixes appear in the correct order for presenting the name
period | Σ | 0..1 | Period | 此姓名的使用效期
telecom | S | 0..* | ContactPoint | 聯絡人的詳細聯絡資訊
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
rank | Σ | 0..1 | positiveInt | 具體說明偏好的使用順序（1=最高優先順序）
period | Σ | 0..1 | Period | 此聯絡方式的使用效期
address |  | 0..1 | AddressTW | 聯絡人的地址
gender |  | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 聯絡人的性別；應填入所綁定值集中的其中一個代碼。
organization | C | 0..1 | Reference(TW Core Organization) | 可聯絡到聯絡人的機構
period | S | 0..1 | Period | 聯絡人或其可聯絡機構之可聯絡期（時間區間）
communication | S | 0..* | BackboneElement | 向病人說明健康狀態時所使用的語言
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
language | S | 1..1 | CodeableConceptTW | 向病人說明健康狀況時所使用的語言 Binding: CommonLanguages (preferred): 應填入所綁定值集中的其中一個代碼。
Additional Bindings | Purpose
AllLanguages | Max Binding
Example Value: zh-TW
preferred |  | 0..1 | boolean | 病人是否偏好使用此語言
generalPractitioner |  | 0..* | Reference(TW Core Organization | TW Core Practitioner | TW Core PractitionerRole) | 照護此病人的機構、照護服務提供者、或健康照護服務提供者的角色
managingOrganization | S Σ | 0..1 | Reference(TW Core Organization) | 此紀錄的保管機構
link | ?!Σ | 0..* | BackboneElement | 連結至此病人的其他Patient Resource
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
other | Σ | 1..1 | Reference(TW Core Patient | TW Core RelatedPerson) | 連結至其他Patient或RelatedPerson Resource
type | Σ | 1..1 | code | replaced-by ｜ replaces ｜ refer ｜ seealso Binding: LinkType (required): 連結的型別；應填入所綁定值集中的其中一個代碼。
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Patient.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std.
Patient.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std.
Patient.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Patient.identifier:idCardNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:idCardNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:passportNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:passportNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:residentNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:residentNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:medicalRecord.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:medicalRecord.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.name:official.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:usual.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:temp.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:anonymous.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.telecom.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.telecom.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
Patient.maritalStatus | Base | extensible | MaritalStatus | 📦4.0.1 | FHIR Std.
Patient.contact.relationship | Base | required | Patient relationship type | 📦4.0.1 | FHIR Std.
Patient.contact.name.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.contact.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
Patient.communication.​language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Patient | 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 | Patient | 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 | Patient | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Patient | 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()`
id-card-number | error | Patient.identifier:idCardNumber | 身分證號共十碼，首碼以英文字母代表直轄市、縣（市）別，第二碼至第十碼為數字碼。 | `value.matches('^[A-Za-z][0-9]{9}$')`
pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization | `name.exists() or telecom.exists() or address.exists() or organization.exists()`
pat-name | error | Patient.name | 病人姓名有誤 ，超過40字 | `text.length() <= 40`
patient-gender-match | error | Patient | gender依據identifier:idCardNumber第二位字符檢核男性與女性代碼 (1=male, 2=female) | `identifier.where(system = 'http://www.moi.gov.tw').value.exists() implies (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '1' implies gender = 'male') and (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '2' implies gender = 'female')`
resident-number | error | Patient.identifier:residentNumber | 居留證號格式為：「1碼英文+9碼數字」或「2碼英文+8碼數字」。 | `value.matches('^([A-Za-z][0-9]{9}|[A-Za-z]{2}[0-9]{8})$')`
tw-core-1 | error | Patient.name:usual | Patient.name.text or Patient.name.family or both SHALL be present | `text.exists() or family.exists()`

This structure is derived from TWCorePatient

Summary

Mandatory: 5 elements
Prohibited: 4 elements

Slices

This structure defines the following Slices:

- The element 2 is sliced based on the values of Patient.identifier (Closed)

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Patient | C | 0..* | TWCorePatient | 接受健康照護服務的個人或動物之資訊 Constraints: patient-gender-match
meta | Σ | 1..1 | Meta | 此Patient Resource的metadata
profile | Σ | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則
Slices for extension |  |  |  | Content/Rules for all slices
extension:age | S | 0..1 | Age | 年齡 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/person-age
extension:nationality | S | 0..1 | (Complex) | 病人所屬國籍 URL: http://hl7.org/fhir/StructureDefinition/patient-nationality
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
Slices for identifier | S Σ | 1..2 | Identifier | 病人的身份識別碼（identifier），通常為業務目的所使用的識別碼，例如病歷號。 Slice: Unordered, Closed by value:type.coding.code, value:type.coding.system
identifier:idCardNumber | S Σ C | 0..1 | Identifier | 身分證號，被保險人國民身分證統一編號。 Constraints: id-card-number
use | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: NNxxx
Slices for extension |  |  |  | Content/Rules for all slices
extension:identifier-suffix | S | 0..1 | (Complex) | 識別碼後綴詞 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/identifier-suffix
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：身分證字號='http://www.moi.gov.tw' Required Pattern: http://www.moi.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：身分證字號為A123456789。[應填入於醫學影像報告身分證號ID Number] Example General: 123456
identifier:residentNumber | S Σ C | 0..1 | Identifier | 居留證號。 Constraints: resident-number
use | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: PRC
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：居留證號='http://www.immigration.gov.tw'。 Required Pattern: http://www.immigration.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：居留證號碼為A912345678 Example General: 123456
identifier:medicalRecord | S Σ | 0..1 | Identifier | 病歷號 (參與醫院必須註冊命名系統)，由醫院自行填寫。
use | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
coding | Σ | 1..* | Coding | Code defined by a terminology system
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: MR
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&amp;type=0)申請或查詢命名系統。 Example General: http://www.acme.com/identifiers/patient
value | S Σ | 0..1 | string | 唯一值。 例如：病歷號為8862168。[應填入於醫學影像報告病歷號碼Chart No.] Example General: 123456
active | ?!S Σ | 0..1 | boolean | 病人的紀錄是否「使用中（true）」
Slices for name | Σ C | 1..1 | HumanName | 病人的姓名 Slice: Unordered, Open by pattern:use Constraints: pat-name
name:usual | S Σ C | 1..1 | HumanName | 病人所屬國籍的真實姓名 Constraints: tw-core-1
use | ?!S Σ | 1..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: usual
text | S Σ C | 1..1 | string | 病人所屬國籍的真實姓名。[應填入於醫學影像報告姓名Name] Example General: 陳加玲
family | S Σ C | 0..1 | string | 若所屬國籍可區分family及given，填入所屬國籍之姓（family） Example General: 陳
given | S Σ C | 0..* | string | 若所屬國籍可區分family及given，填入所屬國籍之名（given） This repeating element order: Given Names appear in the correct order for presenting the name Example General: 加玲
telecom | S Σ | 0..* | ContactPoint | 病人的聯絡資訊（例如：電話、電子郵件等）
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
period | S Σ | 0..1 | Period | 此聯絡方式的使用效期
gender | S Σ | 1..1 | code | male:男性 ｜ female:女性 ｜ other:其他 ｜ unknown:未知 Binding: AdministrativeGender (required): 病人性別；應填入所綁定值集中的其中一個代碼。
birthDate | S Σ | 1..1 | date | 出生日期，YYYY-MM-DD，西元年月日。
deceased[x] | ?!Σ | 0..1 |  | 病人是否過世
deceasedBoolean |  |  | boolean |
deceasedDateTime |  |  | dateTime |
address | S | 0..* | AddressTW | 病人聯絡地址 pat-cnt-2or3-char：如果有國家名，則必須（SHALL）從[ISO Country Alpha-2](http://hl7.org/fhir/valueset/iso3166-1-2)找出相對代碼作呈現。 如果未在ISO Country Alpha-2 中找到此一國家的代碼，則可能可以（MAY）從[ISO Country Alpha-3](http://hl7.org/fhir/valueset/iso3166-1-3)找出相對代碼作呈現。
maritalStatus | S | 0..1 | CodeableConceptTW | 病人的婚姻狀態 Binding: Marital Status Codes (extensible): 病人的婚姻狀態；應填入 Marital Status Codes 值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
photo | S | 0..* | Attachment | 病人的影像（照片）
contact | S C | 0..* | BackboneElement | 病人的聯絡人，例如：監護人、伴侶、朋友等。 Constraints: pat-1
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
relationship | S | 0..* | CodeableConceptTW | 概念（Concept）－參照一個專門術語或只是文字表述 Binding: PatientRelationshipType (required): 應填入所綁定值集中的其中一個代碼。
name | S | 0..1 | HumanName | 聯絡人姓名
use | ?!S Σ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。
text | S Σ | 0..1 | string | 完整的中文姓名
family | S Σ | 0..1 | string | 英文姓
given | S Σ | 0..* | string | 英文名 This repeating element order: Given Names appear in the correct order for presenting the name
telecom | S | 0..* | ContactPoint | 聯絡人的詳細聯絡資訊
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
period | S | 0..1 | Period | 聯絡人或其可聯絡機構之可聯絡期（時間區間）
communication | S | 0..* | BackboneElement | 向病人說明健康狀態時所使用的語言
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
language | S | 1..1 | CodeableConceptTW | 向病人說明健康狀況時所使用的語言 Binding: CommonLanguages (preferred): 應填入所綁定值集中的其中一個代碼。
Additional Bindings | Purpose
AllLanguages | Max Binding
Example Value: zh-TW
managingOrganization | S Σ | 0..1 | Reference(TW Core Organization) | 此紀錄的保管機構
link | ?!Σ | 0..* | BackboneElement | 連結至此病人的其他Patient Resource
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
other | Σ | 1..1 | Reference(TW Core Patient | TW Core RelatedPerson) | 連結至其他Patient或RelatedPerson Resource
type | Σ | 1..1 | code | replaced-by ｜ replaces ｜ refer ｜ seealso Binding: LinkType (required): 連結的型別；應填入所綁定值集中的其中一個代碼。
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Patient.identifier:idCardNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:idCardNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:passportNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:passportNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:residentNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:residentNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:medicalRecord.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:medicalRecord.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.name:official.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:usual.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:temp.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:anonymous.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.telecom.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.telecom.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
Patient.maritalStatus | Base | extensible | MaritalStatus | 📦4.0.1 | FHIR Std.
Patient.contact.relationship | Base | required | Patient relationship type | 📦4.0.1 | FHIR Std.
Patient.contact.name.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.communication.​language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Patient | 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 | Patient | 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 | Patient | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Patient | 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()`
id-card-number | error | Patient.identifier:idCardNumber | 身分證號共十碼，首碼以英文字母代表直轄市、縣（市）別，第二碼至第十碼為數字碼。 | `value.matches('^[A-Za-z][0-9]{9}$')`
pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization | `name.exists() or telecom.exists() or address.exists() or organization.exists()`
pat-name | error | Patient.name | 病人姓名有誤 ，超過40字 | `text.length() <= 40`
patient-gender-match | error | Patient | gender依據identifier:idCardNumber第二位字符檢核男性與女性代碼 (1=male, 2=female) | `identifier.where(system = 'http://www.moi.gov.tw').value.exists() implies (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '1' implies gender = 'male') and (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '2' implies gender = 'female')`
resident-number | error | Patient.identifier:residentNumber | 居留證號格式為：「1碼英文+9碼數字」或「2碼英文+8碼數字」。 | `value.matches('^([A-Za-z][0-9]{9}|[A-Za-z]{2}[0-9]{8})$')`
tw-core-1 | error | Patient.name:usual | Patient.name.text or Patient.name.family or both SHALL be present | `text.exists() or family.exists()`

Differential View

This structure is derived from TWCorePatient

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Patient | C | 0..* | TWCorePatient | 接受健康照護服務的個人或動物之資訊 Constraints: patient-gender-match
meta |  | 1..1 | Meta | 此Patient Resource的metadata
profile |  | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas
Slices for identifier |  | 1..2 | Identifier | 病人的身份識別碼（identifier），通常為業務目的所使用的識別碼，例如病歷號。 Slice: Unordered, Closed by value:type.coding.code, value:type.coding.system
identifier:idCardNumber |  | 0..1 | Identifier | 身分證號，被保險人國民身分證統一編號。
identifier:passportNumber |  | 0..0 |  | 適用護照號碼
identifier:residentNumber | C | 0..1 | Identifier | 居留證號。 Constraints: resident-number
identifier:medicalRecord |  | 0..1 | Identifier | 病歷號 (參與醫院必須註冊命名系統)，由醫院自行填寫。
name | C | 1..1 | HumanName | 病人的姓名 Constraints: pat-name
Slices for name |  |  |  | Content/Rules for all slices
name:official |  | 0..0 |  | 病人的護照姓名
name:usual |  | 1..1 | HumanName | 病人所屬國籍的真實姓名
text |  | 1..1 | string | 病人所屬國籍的真實姓名。[應填入於醫學影像報告姓名Name]
name:temp |  | 0..0 |  | 新生兒姓名，緊急救護未知病人姓名時亦可用。
name:anonymous |  | 0..0 |  | 匿名供研究使用
gender |  | 1..1 | code | male:男性 ｜ female:女性 ｜ other:其他 ｜ unknown:未知
birthDate |  | 1..1 | date | 出生日期，YYYY-MM-DD，西元年月日。
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
pat-name | error | Patient.name | 病人姓名有誤 ，超過40字 | `text.length() <= 40`
patient-gender-match | error | Patient | gender依據identifier:idCardNumber第二位字符檢核男性與女性代碼 (1=male, 2=female) | `identifier.where(system = 'http://www.moi.gov.tw').value.exists() implies (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '1' implies gender = 'male') and (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '2' implies gender = 'female')`
resident-number | error | Patient.identifier:residentNumber | 居留證號格式為：「1碼英文+9碼數字」或「2碼英文+8碼數字」。 | `value.matches('^([A-Za-z][0-9]{9}|[A-Za-z]{2}[0-9]{8})$')`

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
Patient | C | 0..* | TWCorePatient | 接受健康照護服務的個人或動物之資訊 Constraints: patient-gender-match
id | Σ | 0..1 | id | 不重複的ID用以識別儲存在特定FHIR Server中的Patient紀錄，通常又稱為邏輯性ID。
meta | Σ | 1..1 | Meta | 此Patient Resource的metadata
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
versionId | Σ | 0..1 | id | Version specific identifier
lastUpdated | Σ | 0..1 | instant | When the resource version last changed
source | Σ | 0..1 | uri | Identifies where the resource comes from
profile | Σ | 1..1 | canonical(StructureDefinition) | Profiles this resource claims to conform to Required Pattern: https://nhicore.nhi.gov.tw/pas/StructureDefinition/Patient-twpas
security | Σ | 0..* | Coding | Security Labels applied to this resource Binding: All Security Labels (extensible): Security Labels from the Healthcare Privacy and Security Classification System.
tag | Σ | 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".
implicitRules | ?!Σ | 0..1 | uri | 創建此內容所依據的一組規則
language |  | 0..1 | code | 用以表述Patient Resource內容的語言。 Binding: CommonLanguages (preferred): 人類語言；鼓勵使用CommonLanguages代碼表中的代碼，但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Additional Bindings | Purpose
AllLanguages | Max Binding
Example Value: zh-TW
text |  | 0..1 | Narrative | Patient Resource之內容摘要以供人閱讀 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:age | S | 0..1 | Age | 年齡 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/person-age
extension:nationality | S | 0..1 | (Complex) | 病人所屬國籍 URL: http://hl7.org/fhir/StructureDefinition/patient-nationality
modifierExtension | ?! | 0..* | Extension | Extensions that cannot be ignored
Slices for identifier | S Σ | 1..2 | Identifier | 病人的身份識別碼（identifier），通常為業務目的所使用的識別碼，例如病歷號。 Slice: Unordered, Closed by value:type.coding.code, value:type.coding.system
identifier:idCardNumber | S Σ C | 0..1 | Identifier | 身分證號，被保險人國民身分證統一編號。 Constraints: id-card-number
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 | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: NNxxx
id |  | 0..1 | string | xml:id (or equivalent in JSON)
Slices for extension |  | 0..* | Extension | Extension Slice: Unordered, Open by value:url
extension:identifier-suffix | S | 0..1 | (Complex) | 識別碼後綴詞 URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/identifier-suffix
value |  | 0..1 | string | Primitive value for code
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：身分證字號='http://www.moi.gov.tw' Required Pattern: http://www.moi.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：身分證字號為A123456789。[應填入於醫學影像報告身分證號ID Number] Example General: 123456
period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期
assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述）
identifier:residentNumber | S Σ C | 0..1 | Identifier | 居留證號。 Constraints: resident-number
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 | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: PRC
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace） 例如：居留證號='http://www.immigration.gov.tw'。 Required Pattern: http://www.immigration.gov.tw
value | S Σ | 0..1 | string | 唯一值。 例如：居留證號碼為A912345678 Example General: 123456
period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期
assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述）
identifier:medicalRecord | 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 | ?!S Σ | 0..1 | code | usual ｜ official ｜ temp ｜ secondary ｜ old （如果知道） Binding: IdentifierUse (required): 如果知道，請說明此識別碼的目的；應填入所綁定值集中的其中一個代碼。 Required Pattern: official
type | S Σ | 1..1 | CodeableConcept | 身份識別碼（identifier）的型別說明 Binding: IdentifierType + 臺灣衛福部資訊處識別碼類型值集 (extensible): 識別碼的型別，用於決定特定目的所適用的識別碼；應填入所綁定值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
coding | Σ | 1..* | Coding | Code defined by a terminology system
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | Σ | 1..1 | uri | Identity of the terminology system Required Pattern: http://terminology.hl7.org/CodeSystem/v2-0203
version | Σ | 0..1 | string | Version of the system - if relevant
code | Σ | 1..1 | code | Symbol in syntax defined by the system Required Pattern: MR
display | Σ | 0..1 | string | Representation defined by the system
userSelected | Σ | 0..1 | boolean | If this coding was chosen directly by the user
text | Σ | 0..1 | string | Plain text representation of the concept
system | S Σ | 0..1 | uri | 身份識別碼（identifier）的命名空間（namespace），可至[twTerminology](https://fhir.mohw.gov.tw/ts/namingsystem.jsp?status=active&amp;type=0)申請或查詢命名系統。 Example General: http://www.acme.com/identifiers/patient
value | S Σ | 0..1 | string | 唯一值。 例如：病歷號為8862168。[應填入於醫學影像報告病歷號碼Chart No.] Example General: 123456
period | Σ | 0..1 | Period | 此身份識別碼（identifier）的使用效期
assigner | Σ | 0..1 | Reference(TW Core Organization) | 簽發identifier的機構（可以只是文字表述）
active | ?!S Σ | 0..1 | boolean | 病人的紀錄是否「使用中（true）」
Slices for name | Σ C | 1..1 | HumanName | 病人的姓名 Slice: Unordered, Open by pattern:use Constraints: pat-name
name:usual | S Σ C | 1..1 | HumanName | 病人所屬國籍的真實姓名 Constraints: tw-core-1
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 | ?!S Σ | 1..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。 Required Pattern: usual
text | S Σ C | 1..1 | string | 病人所屬國籍的真實姓名。[應填入於醫學影像報告姓名Name] Example General: 陳加玲
family | S Σ C | 0..1 | string | 若所屬國籍可區分family及given，填入所屬國籍之姓（family） Example General: 陳
given | S Σ C | 0..* | string | 若所屬國籍可區分family及given，填入所屬國籍之名（given） This repeating element order: Given Names appear in the correct order for presenting the name Example General: 加玲
prefix | Σ | 0..* | string | 姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。 This repeating element order: Prefixes appear in the correct order for presenting the name
suffix | Σ | 0..* | string | 姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。 This repeating element order: Suffixes appear in the correct order for presenting the name
period | Σ | 0..1 | Period | 此姓名的使用效期
telecom | S Σ | 0..* | ContactPoint | 病人的聯絡資訊（例如：電話、電子郵件等）
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
rank | Σ | 0..1 | positiveInt | 具體說明偏好的使用順序（1=最高優先順序）
period | S Σ | 0..1 | Period | 此聯絡方式的使用效期
gender | S Σ | 1..1 | code | male:男性 ｜ female:女性 ｜ other:其他 ｜ unknown:未知 Binding: AdministrativeGender (required): 病人性別；應填入所綁定值集中的其中一個代碼。
birthDate | S Σ | 1..1 | date | 出生日期，YYYY-MM-DD，西元年月日。
deceased[x] | ?!Σ | 0..1 |  | 病人是否過世
deceasedBoolean |  |  | boolean |
deceasedDateTime |  |  | dateTime |
address | S | 0..* | AddressTW | 病人聯絡地址 pat-cnt-2or3-char：如果有國家名，則必須（SHALL）從[ISO Country Alpha-2](http://hl7.org/fhir/valueset/iso3166-1-2)找出相對代碼作呈現。 如果未在ISO Country Alpha-2 中找到此一國家的代碼，則可能可以（MAY）從[ISO Country Alpha-3](http://hl7.org/fhir/valueset/iso3166-1-3)找出相對代碼作呈現。
maritalStatus | S | 0..1 | CodeableConceptTW | 病人的婚姻狀態 Binding: Marital Status Codes (extensible): 病人的婚姻狀態；應填入 Marital Status Codes 值集中適合的代碼，確定無適合的代碼才可以使用其他值集的代碼來表示。
multipleBirth[x] |  | 0..1 |  | 病人是否為多胞胎；或多胞胎出生順序。
multipleBirthBoolean |  |  | boolean |
multipleBirthInteger |  |  | integer |
photo | S | 0..* | Attachment | 病人的影像（照片）
contact | S C | 0..* | BackboneElement | 病人的聯絡人，例如：監護人、伴侶、朋友等。 Constraints: pat-1
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
relationship | S | 0..* | CodeableConceptTW | 概念（Concept）－參照一個專門術語或只是文字表述 Binding: PatientRelationshipType (required): 應填入所綁定值集中的其中一個代碼。
name | S | 0..1 | HumanName | 聯絡人姓名
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 | ?!S Σ | 0..1 | code | usual | official | temp | nickname | anonymous | old | maiden Binding: NameUse (required): 人名的使用情況；應填入所綁定值集中的其中一個代碼。
text | S Σ | 0..1 | string | 完整的中文姓名
family | S Σ | 0..1 | string | 英文姓
given | S Σ | 0..* | string | 英文名 This repeating element order: Given Names appear in the correct order for presenting the name
prefix | Σ | 0..* | string | 姓名前面的頭銜 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名開頭。 This repeating element order: Prefixes appear in the correct order for presenting the name
suffix | Σ | 0..* | string | 姓名後面的稱謂 由於學術，法律，職業或貴族身份等原因而獲得頭銜，出現在姓名之後。 This repeating element order: Suffixes appear in the correct order for presenting the name
period | Σ | 0..1 | Period | 此姓名的使用效期
telecom | S | 0..* | ContactPoint | 聯絡人的詳細聯絡資訊
id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
system | S Σ C | 1..1 | code | phone | fax | email | pager | url | sms | other Binding: ContactPointSystem (required): 應填入所綁定值集中的其中一個代碼。
value | S Σ | 1..1 | string | 實際的聯絡方式之細節
use | ?!S Σ | 0..1 | code | home | work | temp | old | mobile－此聯絡方式的用途 Binding: ContactPointUse (required): 應填入所綁定值集中的其中一個代碼。
rank | Σ | 0..1 | positiveInt | 具體說明偏好的使用順序（1=最高優先順序）
period | Σ | 0..1 | Period | 此聯絡方式的使用效期
address |  | 0..1 | AddressTW | 聯絡人的地址
gender |  | 0..1 | code | male ｜ female ｜ other ｜ unknown Binding: AdministrativeGender (required): 聯絡人的性別；應填入所綁定值集中的其中一個代碼。
organization | C | 0..1 | Reference(TW Core Organization) | 可聯絡到聯絡人的機構
period | S | 0..1 | Period | 聯絡人或其可聯絡機構之可聯絡期（時間區間）
communication | S | 0..* | BackboneElement | 向病人說明健康狀態時所使用的語言
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
language | S | 1..1 | CodeableConceptTW | 向病人說明健康狀況時所使用的語言 Binding: CommonLanguages (preferred): 應填入所綁定值集中的其中一個代碼。
Additional Bindings | Purpose
AllLanguages | Max Binding
Example Value: zh-TW
preferred |  | 0..1 | boolean | 病人是否偏好使用此語言
generalPractitioner |  | 0..* | Reference(TW Core Organization | TW Core Practitioner | TW Core PractitionerRole) | 照護此病人的機構、照護服務提供者、或健康照護服務提供者的角色
managingOrganization | S Σ | 0..1 | Reference(TW Core Organization) | 此紀錄的保管機構
link | ?!Σ | 0..* | BackboneElement | 連結至此病人的其他Patient Resource
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
other | Σ | 1..1 | Reference(TW Core Patient | TW Core RelatedPerson) | 連結至其他Patient或RelatedPerson Resource
type | Σ | 1..1 | code | replaced-by ｜ replaces ｜ refer ｜ seealso Binding: LinkType (required): 連結的型別；應填入所綁定值集中的其中一個代碼。
Documentation for this format

#### Terminology Bindings

Path | Status | Usage | ValueSet | Version | Source
Patient.meta.security | Base | extensible | SecurityLabels | 📍4.0.1 | FHIR Std.
Patient.meta.tag | Base | example | Common Tags | 📍4.0.1 | FHIR Std.
Patient.language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Patient.identifier:idCardNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:idCardNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:passportNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:passportNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:residentNumber.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:residentNumber.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.identifier:medicalRecord.​use | Base | required | IdentifierUse | 📍4.0.1 | FHIR Std.
Patient.identifier:medicalRecord.​type | Base | extensible | IdentifierType + 臺灣衛福部資訊處識別碼類型值集 | 📦0.3.0 | 臺灣核心實作指引 v0.3
Patient.name:official.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:usual.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:temp.use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.name:anonymous.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.telecom.system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.telecom.use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
Patient.maritalStatus | Base | extensible | MaritalStatus | 📦4.0.1 | FHIR Std.
Patient.contact.relationship | Base | required | Patient relationship type | 📦4.0.1 | FHIR Std.
Patient.contact.name.​use | Base | required | NameUse | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​system | Base | required | ContactPointSystem | 📍4.0.1 | FHIR Std.
Patient.contact.telecom.​use | Base | required | ContactPointUse | 📍4.0.1 | FHIR Std.
Patient.contact.gender | Base | required | AdministrativeGender | 📍4.0.1 | FHIR Std.
Patient.communication.​language | Base | preferred | Common Languages | 📦4.0.1 | FHIR Std.
Patient.link.type | Base | required | LinkType | 📍4.0.1 | FHIR Std.

#### Constraints

Id | Grade | Path(s) | Description | Expression
dom-2 | error | Patient | If the resource is contained in another resource, it SHALL NOT contain nested Resources | `contained.contained.empty()`
dom-3 | error | Patient | 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 | Patient | 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 | Patient | If a resource is contained in another resource, it SHALL NOT have a security label | `contained.meta.security.empty()`
dom-6 | best practice | Patient | 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()`
id-card-number | error | Patient.identifier:idCardNumber | 身分證號共十碼，首碼以英文字母代表直轄市、縣（市）別，第二碼至第十碼為數字碼。 | `value.matches('^[A-Za-z][0-9]{9}$')`
pat-1 | error | Patient.contact | SHALL at least contain a contact's details or a reference to an organization | `name.exists() or telecom.exists() or address.exists() or organization.exists()`
pat-name | error | Patient.name | 病人姓名有誤 ，超過40字 | `text.length() <= 40`
patient-gender-match | error | Patient | gender依據identifier:idCardNumber第二位字符檢核男性與女性代碼 (1=male, 2=female) | `identifier.where(system = 'http://www.moi.gov.tw').value.exists() implies (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '1' implies gender = 'male') and (identifier.where(system = 'http://www.moi.gov.tw').value.substring(1, 1) = '2' implies gender = 'female')`
resident-number | error | Patient.identifier:residentNumber | 居留證號格式為：「1碼英文+9碼數字」或「2碼英文+8碼數字」。 | `value.matches('^([A-Za-z][0-9]{9}|[A-Za-z]{2}[0-9]{8})$')`
tw-core-1 | error | Patient.name:usual | Patient.name.text or Patient.name.family or both SHALL be present | `text.exists() or family.exists()`

This structure is derived from TWCorePatient

Summary

Mandatory: 5 elements
Prohibited: 4 elements

Slices

This structure defines the following Slices:

- The element 2 is sliced based on the values of Patient.identifier (Closed)

Other representations of profile: CSV, Excel, Schematron

### Notes:

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

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

1. 必須（SHALL） 支援透過查詢參數 `name` 查詢所有Patient：
   (如何透過string查詢)
   `GET [base]/Patient?name=[string]`

   例子：
   (1) GET [base]/Patient?name=王大明

2. 必須（SHALL） 支援透過查詢參數 `identifier` 查詢所有Patient：
   (如何透過token查詢)
   `GET [base]/Patient?identifier=[code]`

   例子：
   (1) GET [base]/Patient?identifier=A123456789