臺灣健保署基礎實作指引
0.0.1 - ci-build

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

## Logical Model: 臺灣健保署基礎(Base)資料模型

Official URL: https://nhicore.nhi.gov.tw/base/StructureDefinition/BaseModel | Version: 0.0.1
Draft as of 2025-10-29 | Computable Name: BaseModel

臺灣健保署基礎(Base)資料模型，此邏輯模型為定義臺灣健保署基礎情境下使用的所有資料欄位。 為了便於實作者快速理解，資料欄位會使用易於理解的命名，實作者再透過邏輯模型中的功能頁籤「Mappings」 瞭解各資料欄位實際使用本IG的哪個Profiles的哪個資料項目（element）。亦可配合 [視覺化邏輯模型圖]進行欄位對應。

Usages:

- This Logical Model is not used by any profiles in this Implementation Guide

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
--- | --- | --- | --- | ---
BaseModel |  | 0..* | Base | 臺灣健保署基礎(Base)資料模型
hosp |  | 1..1 | BackboneElement | 院所資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
hospId |  | 1..1 | string | 醫事機構代碼
applType |  | 1..1 | CodeableConcept | 申報類別
applDate |  | 1..1 | dateTime | 申請日期
patient |  | 1..1 | BackboneElement | 病人資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
patId |  | 0..1 | string | 病歷號
name |  | 1..1 | HumanName | 姓名
idCard |  | 1..1 | string | 身分證號
birthday |  | 1..1 | date | 出生日期
gender |  | 1..1 | code | 病人性別
diagnosis |  | 1..1 | BackboneElement | 疾病資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
icd10cmCode |  | 1..1 | code | 國際疾病分類代碼 (sequence=1)，共病症 (sequence>=2)
diagDate |  | 0..* | date | 診斷日期
diagCurrentStatus |  | 1..1 | code | 簡要病摘。連結院內HIS系統之簡要病摘，或填寫原基因定序檢測之申請理由。
gene |  | 0..* | BackboneElement | 基因資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
genTestCode |  | 0..* | CodeableConcept | 基因檢測代碼
mutationType |  | 0..* | CodeableConcept | 基因突變類型
specimenType |  | 0..* | CodeableConcept | 基因檢測檢體類型
genMethod |  | 0..* | CodeableConcept | 基因檢測方法
genDate |  | 0..* | dateTime | 基因檢測日期
genOrg |  | 0..* | string | 基因檢測機構
genResult |  | 0..* | CodeableConcept | 基因檢測分析結果
genInterpretation |  | 0..* | CodeableConcept | 基因臨床判讀結果
genPdf |  | 0..* | base64Binary | 基因報告（檔案路徑）
genPdfTitle |  | 0..* | string | 基因報告名稱
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from Base

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
BaseModel |  | 0..* | Base | 臺灣健保署基礎(Base)資料模型
hosp |  | 1..1 | BackboneElement | 院所資訊
hospId |  | 1..1 | string | 醫事機構代碼
applType |  | 1..1 | CodeableConcept | 申報類別
applDate |  | 1..1 | dateTime | 申請日期
patient |  | 1..1 | BackboneElement | 病人資訊
patId |  | 0..1 | string | 病歷號
name |  | 1..1 | HumanName | 姓名
idCard |  | 1..1 | string | 身分證號
birthday |  | 1..1 | date | 出生日期
gender |  | 1..1 | code | 病人性別
diagnosis |  | 1..1 | BackboneElement | 疾病資訊
icd10cmCode |  | 1..1 | code | 國際疾病分類代碼 (sequence=1)，共病症 (sequence>=2)
diagDate |  | 0..* | date | 診斷日期
diagCurrentStatus |  | 1..1 | code | 簡要病摘。連結院內HIS系統之簡要病摘，或填寫原基因定序檢測之申請理由。
gene |  | 0..* | BackboneElement | 基因資訊
genTestCode |  | 0..* | CodeableConcept | 基因檢測代碼
mutationType |  | 0..* | CodeableConcept | 基因突變類型
specimenType |  | 0..* | CodeableConcept | 基因檢測檢體類型
genMethod |  | 0..* | CodeableConcept | 基因檢測方法
genDate |  | 0..* | dateTime | 基因檢測日期
genOrg |  | 0..* | string | 基因檢測機構
genResult |  | 0..* | CodeableConcept | 基因檢測分析結果
genInterpretation |  | 0..* | CodeableConcept | 基因臨床判讀結果
genPdf |  | 0..* | base64Binary | 基因報告（檔案路徑）
genPdfTitle |  | 0..* | string | 基因報告名稱
Documentation for this format

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
BaseModel |  | 0..* | Base | 臺灣健保署基礎(Base)資料模型
hosp |  | 1..1 | BackboneElement | 院所資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
hospId |  | 1..1 | string | 醫事機構代碼
applType |  | 1..1 | CodeableConcept | 申報類別
applDate |  | 1..1 | dateTime | 申請日期
patient |  | 1..1 | BackboneElement | 病人資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
patId |  | 0..1 | string | 病歷號
name |  | 1..1 | HumanName | 姓名
idCard |  | 1..1 | string | 身分證號
birthday |  | 1..1 | date | 出生日期
gender |  | 1..1 | code | 病人性別
diagnosis |  | 1..1 | BackboneElement | 疾病資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
icd10cmCode |  | 1..1 | code | 國際疾病分類代碼 (sequence=1)，共病症 (sequence>=2)
diagDate |  | 0..* | date | 診斷日期
diagCurrentStatus |  | 1..1 | code | 簡要病摘。連結院內HIS系統之簡要病摘，或填寫原基因定序檢測之申請理由。
gene |  | 0..* | BackboneElement | 基因資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
genTestCode |  | 0..* | CodeableConcept | 基因檢測代碼
mutationType |  | 0..* | CodeableConcept | 基因突變類型
specimenType |  | 0..* | CodeableConcept | 基因檢測檢體類型
genMethod |  | 0..* | CodeableConcept | 基因檢測方法
genDate |  | 0..* | dateTime | 基因檢測日期
genOrg |  | 0..* | string | 基因檢測機構
genResult |  | 0..* | CodeableConcept | 基因檢測分析結果
genInterpretation |  | 0..* | CodeableConcept | 基因臨床判讀結果
genPdf |  | 0..* | base64Binary | 基因報告（檔案路徑）
genPdfTitle |  | 0..* | string | 基因報告名稱
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from Base

Summary

Mandatory: 0 element(12 nested mandatory elements)

Key Elements View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
BaseModel |  | 0..* | Base | 臺灣健保署基礎(Base)資料模型
hosp |  | 1..1 | BackboneElement | 院所資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
hospId |  | 1..1 | string | 醫事機構代碼
applType |  | 1..1 | CodeableConcept | 申報類別
applDate |  | 1..1 | dateTime | 申請日期
patient |  | 1..1 | BackboneElement | 病人資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
patId |  | 0..1 | string | 病歷號
name |  | 1..1 | HumanName | 姓名
idCard |  | 1..1 | string | 身分證號
birthday |  | 1..1 | date | 出生日期
gender |  | 1..1 | code | 病人性別
diagnosis |  | 1..1 | BackboneElement | 疾病資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
icd10cmCode |  | 1..1 | code | 國際疾病分類代碼 (sequence=1)，共病症 (sequence>=2)
diagDate |  | 0..* | date | 診斷日期
diagCurrentStatus |  | 1..1 | code | 簡要病摘。連結院內HIS系統之簡要病摘，或填寫原基因定序檢測之申請理由。
gene |  | 0..* | BackboneElement | 基因資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
genTestCode |  | 0..* | CodeableConcept | 基因檢測代碼
mutationType |  | 0..* | CodeableConcept | 基因突變類型
specimenType |  | 0..* | CodeableConcept | 基因檢測檢體類型
genMethod |  | 0..* | CodeableConcept | 基因檢測方法
genDate |  | 0..* | dateTime | 基因檢測日期
genOrg |  | 0..* | string | 基因檢測機構
genResult |  | 0..* | CodeableConcept | 基因檢測分析結果
genInterpretation |  | 0..* | CodeableConcept | 基因臨床判讀結果
genPdf |  | 0..* | base64Binary | 基因報告（檔案路徑）
genPdfTitle |  | 0..* | string | 基因報告名稱
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

Differential View

This structure is derived from Base

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
BaseModel |  | 0..* | Base | 臺灣健保署基礎(Base)資料模型
hosp |  | 1..1 | BackboneElement | 院所資訊
hospId |  | 1..1 | string | 醫事機構代碼
applType |  | 1..1 | CodeableConcept | 申報類別
applDate |  | 1..1 | dateTime | 申請日期
patient |  | 1..1 | BackboneElement | 病人資訊
patId |  | 0..1 | string | 病歷號
name |  | 1..1 | HumanName | 姓名
idCard |  | 1..1 | string | 身分證號
birthday |  | 1..1 | date | 出生日期
gender |  | 1..1 | code | 病人性別
diagnosis |  | 1..1 | BackboneElement | 疾病資訊
icd10cmCode |  | 1..1 | code | 國際疾病分類代碼 (sequence=1)，共病症 (sequence>=2)
diagDate |  | 0..* | date | 診斷日期
diagCurrentStatus |  | 1..1 | code | 簡要病摘。連結院內HIS系統之簡要病摘，或填寫原基因定序檢測之申請理由。
gene |  | 0..* | BackboneElement | 基因資訊
genTestCode |  | 0..* | CodeableConcept | 基因檢測代碼
mutationType |  | 0..* | CodeableConcept | 基因突變類型
specimenType |  | 0..* | CodeableConcept | 基因檢測檢體類型
genMethod |  | 0..* | CodeableConcept | 基因檢測方法
genDate |  | 0..* | dateTime | 基因檢測日期
genOrg |  | 0..* | string | 基因檢測機構
genResult |  | 0..* | CodeableConcept | 基因檢測分析結果
genInterpretation |  | 0..* | CodeableConcept | 基因臨床判讀結果
genPdf |  | 0..* | base64Binary | 基因報告（檔案路徑）
genPdfTitle |  | 0..* | string | 基因報告名稱
Documentation for this format

Snapshot View

Name | Flags | Card. | Type | Description & Constraints Filter: Bindings Constraints Obligations
--- | --- | --- | --- | ---
BaseModel |  | 0..* | Base | 臺灣健保署基礎(Base)資料模型
hosp |  | 1..1 | BackboneElement | 院所資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
hospId |  | 1..1 | string | 醫事機構代碼
applType |  | 1..1 | CodeableConcept | 申報類別
applDate |  | 1..1 | dateTime | 申請日期
patient |  | 1..1 | BackboneElement | 病人資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
patId |  | 0..1 | string | 病歷號
name |  | 1..1 | HumanName | 姓名
idCard |  | 1..1 | string | 身分證號
birthday |  | 1..1 | date | 出生日期
gender |  | 1..1 | code | 病人性別
diagnosis |  | 1..1 | BackboneElement | 疾病資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
icd10cmCode |  | 1..1 | code | 國際疾病分類代碼 (sequence=1)，共病症 (sequence>=2)
diagDate |  | 0..* | date | 診斷日期
diagCurrentStatus |  | 1..1 | code | 簡要病摘。連結院內HIS系統之簡要病摘，或填寫原基因定序檢測之申請理由。
gene |  | 0..* | BackboneElement | 基因資訊
@id |  | 0..1 | string | Unique id for inter-element referencing
extension |  | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url
modifierExtension | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized
genTestCode |  | 0..* | CodeableConcept | 基因檢測代碼
mutationType |  | 0..* | CodeableConcept | 基因突變類型
specimenType |  | 0..* | CodeableConcept | 基因檢測檢體類型
genMethod |  | 0..* | CodeableConcept | 基因檢測方法
genDate |  | 0..* | dateTime | 基因檢測日期
genOrg |  | 0..* | string | 基因檢測機構
genResult |  | 0..* | CodeableConcept | 基因檢測分析結果
genInterpretation |  | 0..* | CodeableConcept | 基因臨床判讀結果
genPdf |  | 0..* | base64Binary | 基因報告（檔案路徑）
genPdfTitle |  | 0..* | string | 基因報告名稱
Documentation for this format

#### Constraints

Id | Grade | Path(s) | Description | Expression
ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children | `hasValue() or (children().count() > id.count())`
ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both | `extension.exists() != value.exists()`

This structure is derived from Base

Summary

Mandatory: 0 element(12 nested mandatory elements)

Other representations of profile: CSV, Excel