臺灣健保事前審查實作指引
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

## CapabilityStatement: 臺灣事前審查-伺服端(TWPAS Server)

Official URL: https://nhicore.nhi.gov.tw/pas/CapabilityStatement/CapabilityStatementTWPASServer | Version: 1.1.0
Active as of 2025-10-01 | Computable Name: CapabilityStatementTWPASServer

臺灣健保事前審查實作指引(TWPAS IG)伺服端(Server)之能力聲明

Raw OpenAPI-Swagger Definition file | Download

## 臺灣事前審查-伺服端(TWPAS Server)

- 實作指引版本：1.1.0
- FHIR版本：4.0.1
- 支援格式：`json`
- 發佈日：2025-10-01
- 發佈者：衛生福利部中央健康保險署

### 必須（SHALL）支援以下實作指引

- 臺灣健保事前審查實作指引(TWPAS IG)

## Server的FHIR RESTful功能要求

### 模式: `server`

臺灣事前審查-伺服端(TWPAS Server)必須(SHALL)：
(1)可透過FHIR RESTful API查詢、新增及刪除Resources
(2)根據FHIR規範實作RESTful API
(3)HTTP回傳狀態碼
①(Status 2xx)：請求成功
②(Status 400)：無效參數（invalid parameter）
③(Status 401/4xx)：未經授權的請求（unauthorized request）
④(Status 403)：未充分授權的資料存取範圍（insufficient premission scope）
⑤(Status 404)：未知的resource（unknown resource）
(4)Server提供的API操作皆支援JSON格式
(5)可識別每個新增到Server的實例（instance）之meta.profile是否為TWPAS Profiles Defining URL，並確認實例是否依循Profile製作。
【註：實例是指依據Profile實作，將真實資料以JSON、XML或Turtle格式存放的檔案】

臺灣事前審查-伺服端(TWPAS Server)建議應該(SHOULD)：
(1)Server提供的API操作皆支援XML格式

安全性：
(1)Server必須(SHALL)透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求。

### Resources或Profiles的RESTful功能

#### Summary

共有二十二類Resources支援查詢，查詢參數如表列：

Resource型別 | Profile | Create | Read | VRead | Delete | Update | 支援的查詢參數
--- | --- | --- | --- | --- | --- | --- | ---
Bundle | 支援的Profiles 癌藥事前審查-Bundle TWPAS 事前審查回覆-Bundle Response TWPAS 免疫製劑事前審查-Bundle Immunologic Aagent TWPAS | y | y | y |  | y | _id
Claim | 支援的Profiles 癌藥事前審查-Claim TWPAS 免疫製劑事前審查-Claim Immunologic Aagent TWPAS | y | y | y |  | y | identifier, patient, func-type
ClaimResponse | 支援的Profiles 事前審查回覆-ClaimResponse TWPAS 自主審查-ClaimResponse Self Assessment TWPAS | y | y | y |  | y | adjudication-reason, request.patient.name, request.patient.identifier, request.identifier, request.func-type.service-type, created, disposition
AllergyIntolerance | 過敏史-AllergyIntolerance TWPAS | y | y | y |  | y |
Organization | 支援的Profiles 機構-Organization TWPAS 基因檢測機構-Organization Genetic Testing TWPAS TW Core Organization Government | y | y | y |  | y |
Encounter | 支援的Profiles 就醫科別-Encounter TWPAS 門診病歷-Encounter OPD TWPAS | y | y | y |  | y | service-type
Patient | 病人資訊-Patient TWPAS | y | y | y |  | y | name, identifier
Practitioner | 醫事人員-Practitioner TWPAS | y | y | y |  | y |
ImagingStudy | DICOM影像-ImagingStudy TWPAS | y | y | y |  | y |
Media | 非DICOM影像-Media TWPAS | y | y | y |  | y |
DiagnosticReport | 支援的Profiles 影像報告-DiagnosticReport Image TWPAS (疾病資訊) 檢查報告-DiagnosticReport TWPAS (疾病資訊) | y | y | y |  | y |
Observation | 支援的Profiles 癌症分期量表-Observation Cancer Stage TWPAS (疾病資訊) 基因資訊-Observation Diagnostic TWPAS 檢驗檢查-Observation Laboratory Result TWPAS (評估資訊) 病人狀態評估-Observation Patient Assessment TWPAS (評估資訊) 治療後疾病狀態評估-Observation Treatment Assessment TWPAS (結果資訊) 血型-Observation Blood Group TWPAS (病人資訊) 主觀描述-Observation Subjective TWPAS (門診病歷) 客觀描述-Observation Objective TWPAS (門診病歷) | y | y | y |  | y |
ClinicalImpression | 評估-ClinicalImpression TWPAS (門診病歷) | y | y | y |  | y |
CarePlan | 計畫-CarePlan TWPAS (門診病歷) | y | y | y |  | y |
Condition | 診斷-Condition TWPAS (門診病歷) | y | y | y |  | y |
MedicationRequest | 支援的Profiles 用藥品項-MedicationRequest Treat TWPAS (治療資訊) 事前審查品項-MedicationRequest Apply TWPAS (申請項目) | y | y | y |  | y |
Procedure | 放射/照光治療-Procedure TWPAS | y | y | y |  | y |
Substance | 放射/照光治療總劑量-Substance TWPAS | y | y | y |  | y |
Specimen | 基因檢測檢體-Specimen TWPAS | y | y | y |  | y |
DocumentReference | 文件參照-DocumentReference | y | y | y |  | y |
Coverage | 健保事前審查計畫-Coverage | y | y | y |  | y |
OperationOutcome | 系統回應訊息-OperationOutcome TWPAS | y | y | y |  | y |

#### 預期的遵從度： 必須（SHALL）Bundle

Core FHIR Resource
Bundle
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

癌藥事前審查-Bundle TWPAS
事前審查回覆-Bundle Response TWPAS
免疫製劑事前審查-Bundle Immunologic Aagent TWPAS

Search Parameters

遵從度 | 參數 | 類型 | 範例
--- | --- | --- | ---
必須（SHALL） | _id | `token` | `GET [base]/Bundle?_id=[id]` `GET [base]/Bundle/[id]`

#### 預期的遵從度： 必須（SHALL）Claim

Core FHIR Resource
Claim
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

癌藥事前審查-Claim TWPAS
免疫製劑事前審查-Claim Immunologic Aagent TWPAS

Search Parameters

遵從度 | 參數 | 類型 | 範例
--- | --- | --- | ---
必須（SHALL） | identifier | `token` | `GET [base]/Claim?identifier=[code]` 實作請參考查詢參數
必須（SHALL） | patient | `token` | `GET [base]/Claim?patient={Type/}[id]` 實作請參考查詢參數
必須（SHALL） | func-type | `reference` | `GET [base]/Claim?func-type={system|}[code]` 實作請參考查詢參數

#### 預期的遵從度： 必須（SHALL）ClaimResponse

Core FHIR Resource
ClaimResponse
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

自主審查-ClaimResponse Self Assessment TWPAS
事前審查結果-ClaimResponse TWPAS

Search Parameters

遵從度 | 參數 | 類型 | 範例
--- | --- | --- | ---
必須（SHALL） | adjudication-reason | `token` | `GET [base]/ClaimResponse?adjudication-reason=[code]` 實作請參考查詢參數
必須（SHALL） | request.patient.name | `reference, string` | `GET [base]/ClaimResponse?request.patient.name=[string]` 實作請參考查詢參數
必須（SHALL） | request.patient.identifier | `reference, token` | `GET [base]/ClaimResponse?request.patient.identifier=[code]` 實作請參考查詢參數
必須（SHALL） | request.identifier | `reference, token` | `GET [base]/ClaimResponse?request.identifier=[code]` 實作請參考查詢參數
必須（SHALL） | request.func-type | `reference, token` | `GET [base]/ClaimResponse?request.func-type={system|}[code]` 實作請參考查詢參數
必須（SHALL） | created + disposition | `date, string` | `GET [base]/ClaimResponse?created={gt|lt|ge|le}[date]{&created={gt|lt|ge|le}[date]}&disposition=[已受理|審畢結果]` 實作請參考查詢參數

#### 預期的遵從度： 必須（SHALL）AllergyIntolerance

Profile
過敏史-AllergyIntolerance TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Organization

Core FHIR Resource
Organization
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

機構-Organization TWPAS
基因檢測機構-Organization Genetic Testing TWPAS
TW Core Organization Government

#### 預期的遵從度： 必須（SHALL）Encounter

Core FHIR Resource
Encounter
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

就醫科別-Encounter TWPAS
門診病歷-Encounter OPD TWPAS (門診病歷)

Search Parameters

遵從度 | 參數 | 類型 | 範例
--- | --- | --- | ---
必須（SHALL） | service-type | `token` | `GET [base]/Encounter?service-type={system|}[code]` 實作請參考查詢參數

#### 預期的遵從度： 必須（SHALL）Patient

Profile
病人資訊-Patient TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

Search Parameters

遵從度 | 參數 | 類型 | 範例
--- | --- | --- | ---
必須（SHALL） | name | `string` | `GET [base]/Patient?name=[string]` 實作請參考查詢參數
必須（SHALL） | identifier | `token` | `GET [base]/Patient?identifier=[code]` 實作請參考查詢參數

#### 預期的遵從度： 必須（SHALL）Practitioner

Profile
醫事人員-Practitioner TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）ImagingStudy

Profile
DICOM影像-ImagingStudy TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Media

Profile
非DICOM影像-Media TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）DiagnosticReport

Core FHIR Resource
DiagnosticReport
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

影像報告-DiagnosticReport Image TWPAS
檢查報告-DiagnosticReport TWPAS

#### 預期的遵從度： 必須（SHALL）Observation

Core FHIR Resource
Observation
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

癌症分期量表-Observation Cancer Stage TWPAS
基因資訊-Observation Diagnostic TWPAS
檢驗檢查-Observation Laboratory Result TWPAS
病人狀態評估-Observation Patient Assessment TWPAS
治療後疾病狀態評估-Observation Treatment Assessment TWPAS
血型-Observation Blood Group TWPAS
主觀描述-Observation Subjective TWPAS
客觀描述-Observation Objective TWPAS

#### 預期的遵從度： 必須（SHALL）ClinicalImpression

Profile
評估-ClinicalImpression TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）CarePlan

Profile
計畫-CarePlan TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Condition

Profile
診斷-Condition TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）MedicationRequest

Core FHIR Resource
MedicationRequest
支援的參照政策（Reference policy）
`resolves`
能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

支援的Profiles

用藥品項-MedicationRequest Treat TWPAS
事前審查品項-MedicationRequest Apply TWPAS

#### 預期的遵從度： 必須（SHALL）Procedure

Profile
放射/照光治療-Procedure TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Substance

Profile
放射/照光治療總劑量-Substance TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Specimen

Profile
基因檢測檢體-Specimen TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）DocumentReference

Profile
文件參照-DocumentReference TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Coverage

Profile
健保事前審查計畫-Coverage TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.

#### 預期的遵從度： 必須（SHALL）Operationoutcome

Profile
系統回應訊息-OperationOutcome TWPAS
支援的參照政策（Reference policy）
`resolves`

能力摘要

- 必須（SHALL）支援 `create`, `read`, `vread`, `update`.