TWSS Base IG 用戶端能力聲明 發布日期：2026-07-14 版本：0.0.1 狀態：draft Publisher：衛生福利部社會及家庭署 臺灣社家署基礎－用戶端（TWSS Base Client）建議應該（SHOULD）： 依本能力聲明使用 TWSS Base Server 提供的 FHIR RESTful API。 使用本能力聲明列出的 Resources、Profiles 與查詢參數進行讀取及查詢。 新增或更新實例時，於 meta.profile 宣告所遵循的 TWSS Base Profile。 以 JSON 或 XML 格式交換 FHIR 資料。 Resources或Profiles的RESTful功能 Summary 共有20類Resources支援查詢，查詢參數如表列： Resource型別 Profile Create Read VRead Delete Update 支援的查詢參數 Claim 支援的Profiles 補助申請或核付明細-Claim TWSS Base y y y y _id, identifier, patient, created ClaimResponse 支援的Profiles 補助審核或核付結果-ClaimResponse TWSS Base y y y y _id, identifier, patient, request, created Condition 支援的Profiles 健康與障礙狀況-Condition TWSS Base y y y y _id, patient, code, severity, recorded-date Coverage 支援的Profiles 補助資格或補助案件-Coverage TWSS Base y y y y _id, identifier, patient, type DocumentReference 支援的Profiles 共用公文-DocumentReference TWSS Base y y y _id, patient, type, date EpisodeOfCare 支援的Profiles 個案服務案件-EpisodeOfCare TWSS Base y y y y _id, identifier, patient, status, type, date Location 支援的Profiles 服務地點及托育地址-Location TWSS Base y y y y _id, name Observation 支援的Profiles 身心障礙證明狀態 Observation TWSS Base 機構查核結果 Observation TWSS Base 裁罰法規依據 Observation TWSS Base 服務人教育經歷 Observation TWSS Base 服務人受訓課程 Observation TWSS Base 裁定日期 Observation TWSS Base y y y y _id, patient, code, date Organization 支援的Profiles 醫療院所 Organization TWSS Base 機構資料-Organization TWSS Base y y y y _id, identifier, name, type Patient 支援的Profiles 個案資料-Patient TWSS Base y y y y _id, identifier, name Practitioner 支援的Profiles 人員資料-Practitioner TWSS Base y y y y _id, identifier, name PractitionerRole 支援的Profiles 人員角色-PractitionerRole TWSS Base y y y y _id, practitioner, organization, role RelatedPerson 支援的Profiles 關係人資料-RelatedPerson TWSS Base y y y y _id, patient, identifier, name ServiceRequest 支援的Profiles 申請或服務請求-ServiceRequest TWSS Base 個案通報-ServiceRequest TWSS Base 個案轉介-ServiceRequest TWSS Base y y y y _id, identifier, patient, status, category, code, authored Task 支援的Profiles 個案服務評估審核-Task TWSS Base 個案受理與評估-Task TWSS Base 個案轉介受理-Task TWSS Base 個案轉介處理-Task TWSS Base y y y y _id, patient, status, business-status Encounter 支援的Profiles 個案實際服務-Encounter TWSS Base 個案評估或服務接觸-Encounter TWSS Base 個案會談-Encounter TWSS Base 個案會議-Encounter TWSS Base 安置服務-Encounter TWSS Base y y y y _id, patient, status, date CarePlan 支援的Profiles 個案服務計畫-CarePlan TWSS Base y y y _id, patient, status QuestionnaireResponse 支援的Profiles 社福評估回覆-QuestionnaireResponse TWSS Base y y y _id, patient, status, questionnaire, authored Questionnaire 支援的Profiles 社福評估表單-Questionnaire TWSS Base y Provenance 支援的Profiles 資料建立與修改歷程-Provenance TWSS Base y y y y _id, target, recorded, agent 預期的遵從度：建議應該（SHOULD）Claim Core FHIR Resource Claim 支援的參照政策（Reference policy） resolves 支援的Profiles 補助申請或核付明細-Claim TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, patient, created。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Claim/[id] 建議應該（SHOULD） identifier token GET [base]/Claim?identifier=[value] 建議應該（SHOULD） patient reference GET [base]/Claim?patient=[value] 建議應該（SHOULD） created date GET [base]/Claim?created=[value] 預期的遵從度：建議應該（SHOULD）ClaimResponse Core FHIR Resource ClaimResponse 支援的參照政策（Reference policy） resolves 支援的Profiles 補助審核或核付結果-ClaimResponse TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, patient, request, created。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/ClaimResponse/[id] 建議應該（SHOULD） identifier token GET [base]/ClaimResponse?identifier=[value] 建議應該（SHOULD） patient reference GET [base]/ClaimResponse?patient=[value] 建議應該（SHOULD） request reference GET [base]/ClaimResponse?request=[value] 建議應該（SHOULD） created date GET [base]/ClaimResponse?created=[value] 預期的遵從度：建議應該（SHOULD）Condition Core FHIR Resource Condition 支援的參照政策（Reference policy） resolves 支援的Profiles 健康與障礙狀況-Condition TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, patient, code, severity, recorded-date。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Condition/[id] 建議應該（SHOULD） patient reference GET [base]/Condition?patient=[value] 建議應該（SHOULD） code token GET [base]/Condition?code=[value] 建議應該（SHOULD） severity token GET [base]/Condition?severity=[value] 建議應該（SHOULD） recorded-date date GET [base]/Condition?recorded-date=[value] 預期的遵從度：建議應該（SHOULD）Coverage Core FHIR Resource Coverage 支援的參照政策（Reference policy） resolves 支援的Profiles 補助資格或補助案件-Coverage TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, patient, type。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Coverage/[id] 建議應該（SHOULD） identifier token GET [base]/Coverage?identifier=[value] 建議應該（SHOULD） patient reference GET [base]/Coverage?patient=[value] 建議應該（SHOULD） type token GET [base]/Coverage?type=[value] 預期的遵從度：建議應該（SHOULD）EpisodeOfCare Core FHIR Resource EpisodeOfCare 支援的參照政策（Reference policy） resolves 支援的Profiles 個案服務案件-EpisodeOfCare TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, patient, status, type, date。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/EpisodeOfCare/[id] 建議應該（SHOULD） identifier token GET [base]/EpisodeOfCare?identifier=[value] 建議應該（SHOULD） patient reference GET [base]/EpisodeOfCare?patient=[value] 建議應該（SHOULD） status token GET [base]/EpisodeOfCare?status=[value] 建議應該（SHOULD） type token GET [base]/EpisodeOfCare?type=[value] 建議應該（SHOULD） date date GET [base]/EpisodeOfCare?date=[value] 預期的遵從度：建議應該（SHOULD）Location Core FHIR Resource Location 支援的參照政策（Reference policy） resolves 支援的Profiles 服務地點及托育地址-Location TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, name。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Location/[id] 建議應該（SHOULD） name string GET [base]/Location?name=[value] 預期的遵從度：建議應該（SHOULD）Observation Core FHIR Resource Observation 支援的參照政策（Reference policy） resolves 支援的Profiles 身心障礙證明狀態 Observation TWSS Base 機構查核結果 Observation TWSS Base 裁罰法規依據 Observation TWSS Base 服務人教育經歷 Observation TWSS Base 服務人受訓課程 Observation TWSS Base 裁定日期 Observation TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, patient, code, date。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Observation/[id] 建議應該（SHOULD） patient reference GET [base]/Observation?patient=[value] 建議應該（SHOULD） code token GET [base]/Observation?code=[value] 建議應該（SHOULD） date date GET [base]/Observation?date=[value] 預期的遵從度：建議應該（SHOULD）Organization Core FHIR Resource Organization 支援的參照政策（Reference policy） resolves 支援的Profiles 醫療院所 Organization TWSS Base 機構資料-Organization TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, name, type。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Organization/[id] 建議應該（SHOULD） identifier token GET [base]/Organization?identifier=[value] 建議應該（SHOULD） name string GET [base]/Organization?name=[value] 建議應該（SHOULD） type token GET [base]/Organization?type=[value] 預期的遵從度：建議應該（SHOULD）Patient Core FHIR Resource Patient 支援的參照政策（Reference policy） resolves 支援的Profiles 個案資料-Patient TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, name。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Patient/[id] 建議應該（SHOULD） identifier token GET [base]/Patient?identifier=[value] 建議應該（SHOULD） name string GET [base]/Patient?name=[value] 預期的遵從度：建議應該（SHOULD）Practitioner Core FHIR Resource Practitioner 支援的參照政策（Reference policy） resolves 支援的Profiles 人員資料-Practitioner TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, name。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Practitioner/[id] 建議應該（SHOULD） identifier token GET [base]/Practitioner?identifier=[value] 建議應該（SHOULD） name string GET [base]/Practitioner?name=[value] 預期的遵從度：建議應該（SHOULD）PractitionerRole Core FHIR Resource PractitionerRole 支援的參照政策（Reference policy） resolves 支援的Profiles 人員角色-PractitionerRole TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, practitioner, organization, role。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/PractitionerRole/[id] 建議應該（SHOULD） practitioner reference GET [base]/PractitionerRole?practitioner=[value] 建議應該（SHOULD） organization reference GET [base]/PractitionerRole?organization=[value] 建議應該（SHOULD） role token GET [base]/PractitionerRole?role=[value] 預期的遵從度：建議應該（SHOULD）RelatedPerson Core FHIR Resource RelatedPerson 支援的參照政策（Reference policy） resolves 支援的Profiles 關係人資料-RelatedPerson TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, patient, identifier, name。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/RelatedPerson/[id] 建議應該（SHOULD） patient reference GET [base]/RelatedPerson?patient=[value] 建議應該（SHOULD） identifier token GET [base]/RelatedPerson?identifier=[value] 建議應該（SHOULD） name string GET [base]/RelatedPerson?name=[value] 預期的遵從度：建議應該（SHOULD）ServiceRequest Core FHIR Resource ServiceRequest 支援的參照政策（Reference policy） resolves 支援的Profiles 申請或服務請求-ServiceRequest TWSS Base 個案通報-ServiceRequest TWSS Base 個案轉介-ServiceRequest TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, identifier, patient, status, category, code, authored。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/ServiceRequest/[id] 建議應該（SHOULD） identifier token GET [base]/ServiceRequest?identifier=[value] 建議應該（SHOULD） patient reference GET [base]/ServiceRequest?patient=[value] 建議應該（SHOULD） status token GET [base]/ServiceRequest?status=[value] 建議應該（SHOULD） category token GET [base]/ServiceRequest?category=[value] 建議應該（SHOULD） code token GET [base]/ServiceRequest?code=[value] 建議應該（SHOULD） authored date GET [base]/ServiceRequest?authored=[value] 預期的遵從度：建議應該（SHOULD）Task Core FHIR Resource Task 支援的參照政策（Reference policy） resolves 支援的Profiles 個案服務評估審核-Task TWSS Base 個案受理與評估-Task TWSS Base 個案轉介受理-Task TWSS Base 個案轉介處理-Task TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, patient, status, business-status。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Task/[id] 建議應該（SHOULD） patient reference GET [base]/Task?patient=[value] 建議應該（SHOULD） status token GET [base]/Task?status=[value] 建議應該（SHOULD） business-status token GET [base]/Task?business-status=[value] 預期的遵從度：建議應該（SHOULD）Encounter Core FHIR Resource Encounter 支援的參照政策（Reference policy） resolves 支援的Profiles 個案實際服務-Encounter TWSS Base 個案評估或服務接觸-Encounter TWSS Base 個案會談-Encounter TWSS Base 個案會議-Encounter TWSS Base 安置服務-Encounter TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, patient, status, date。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Encounter/[id] 建議應該（SHOULD） patient reference GET [base]/Encounter?patient=[value] 建議應該（SHOULD） status token GET [base]/Encounter?status=[value] 建議應該（SHOULD） date date GET [base]/Encounter?date=[value] 預期的遵從度：建議應該（SHOULD）CarePlan Core FHIR Resource CarePlan 支援的參照政策（Reference policy） 未宣告 支援的Profiles 個案服務計畫-CarePlan TWSS Base 能力摘要 支援 create, read, update 操作；查詢參數：_id, patient, status。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/CarePlan/[id] 建議應該（SHOULD） patient reference GET [base]/CarePlan?patient=[value] 建議應該（SHOULD） status token GET [base]/CarePlan?status=[value] 預期的遵從度：建議應該（SHOULD）QuestionnaireResponse Core FHIR Resource QuestionnaireResponse 支援的參照政策（Reference policy） 未宣告 支援的Profiles 社福評估回覆-QuestionnaireResponse TWSS Base 能力摘要 支援 create, read, update 操作；查詢參數：_id, patient, status, questionnaire, authored。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/QuestionnaireResponse/[id] 建議應該（SHOULD） patient reference GET [base]/QuestionnaireResponse?patient=[value] 建議應該（SHOULD） status token GET [base]/QuestionnaireResponse?status=[value] 建議應該（SHOULD） questionnaire reference GET [base]/QuestionnaireResponse?questionnaire=[value] 建議應該（SHOULD） authored date GET [base]/QuestionnaireResponse?authored=[value] 預期的遵從度：建議應該（SHOULD）Questionnaire Core FHIR Resource Questionnaire 支援的參照政策（Reference policy） 未宣告 支援的Profiles 社福評估表單-Questionnaire TWSS Base 能力摘要 支援 read 操作；查詢參數：未定義。 Search Parameters 遵從度 參數 類型 範例 此 Resource 未定義查詢參數。 預期的遵從度：建議應該（SHOULD）DocumentReference Core FHIR Resource DocumentReference 支援的Profiles 共用公文-DocumentReference TWSS Base 能力摘要 支援 create、read、update 操作；查詢參數：_id、patient、type、date。 預期的遵從度：建議應該（SHOULD）Provenance Core FHIR Resource Provenance 支援的參照政策（Reference policy） resolves 支援的Profiles 資料建立與修改歷程-Provenance TWSS Base 能力摘要 支援 create, read, vread, update 操作；查詢參數：_id, target, recorded, agent。 Search Parameters 遵從度 參數 類型 範例 建議應該（SHOULD） _id token GET [base]/Provenance/[id] 建議應該（SHOULD） target reference GET [base]/Provenance?target=[value] 建議應該（SHOULD） recorded date GET [base]/Provenance?recorded=[value] 建議應該（SHOULD） agent reference GET [base]/Provenance?agent=[value]
TWSS Base IG 用戶端應依本能力聲明所列資源與 Profile 使用 FHIR RESTful API。
安全性要求請參閱本 IG 的安全性頁面。