臺灣事前審查-伺服端(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.
臺灣健保事前審查實作指引(TWPAS IG)伺服端(Server)之能力聲明
臺灣事前審查-伺服端(TWPAS Server)必須(SHALL)：(1)支援本實作指引中所有profiles (2)根據FHIR規範實作RESTful (3)回傳狀態碼-①(Status 400)：無效參數(invalid parameter)、②(Status 401/4xx)：未經授權的請求(unauthorized request)、③(Status 403)：未充分授權的資料存取範圍(insufficient premission scope)、④(Status 404)：未知的resource(unknown resource) (4)支援JSON格式 (5)可識別每個新增到Server的實例(instance)之meta.profile是否為臺灣事前審查Profiles Defining URL，並確認實例是否依循Profile製作。臺灣事前審查-伺服端建議應該(SHOULD)：(1)支援XML格式。
Server必須(SHALL)透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求。