臺灣社政領域基礎實作指引
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/sfaassn2025-source/base/ and changes regularly. See the Directory of published versions

CapabilityStatement: TWSS Base IG 伺服端能力聲明

Official URL: https://sfaa.gov.tw/base/CapabilityStatement/CapabilityStatementTWSSBaseServer Version: 0.0.1
Draft as of 2026-07-14 Computable Name: CapabilityStatementTWSSBaseServer

TWSS Base IG 伺服端能力聲明。

Raw OpenAPI-Swagger Definition file | Download

臺灣社會服務基礎實作指引-伺服端(TWSS Base Server)

  • 實作指引版本:0.0.1
  • FHIR版本:4.0.1
  • 支援格式:jsonxml
  • 發布單位:衛生福利部社會及家庭署

建議應該(SHOULD)實作的IGs

server FHIR RESTful功能要求

模式:server

臺灣社會服務基礎-伺服端(TWSS Base 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 permission scope)
  ⑤(Status 404):未知的resource(unknown resource)
(4)Server提供的API操作支援JSON格式
(5)可識別每個新增到Server的實例(instance)之meta.profile是否為TWSS Base Profiles Defining URL,並確認實例是否依循Profile製作。
【註:實例是指依據Profile實作,將真實資料以JSON、XML或Turtle格式存放的檔案】

臺灣社會服務基礎-伺服端(TWSS Base Server)建議應該(SHOULD):Server提供的API操作支援XML格式。

Resources或Profiles的RESTful功能

Summary

下列列出本能力聲明所涵蓋的Resources、支援的Profiles、RESTful互動,以及可能可以支援的FHIR R4原生查詢參數。

評估相關的支援範圍另包含評估結果、CMS等級、關係人職業與心理諮商 Observation,以及個案基本與家庭、服務人任職、關係人基本、職業訓練、學校適應、情緒行為、人際互動、發展遲緩、就業、安置與結案安置 Questionnaire Profiles;完整清單請參閱FHIR Profiles與Extensions

Resource名稱ProfileCreateReadVReadDeleteUpdate可能可以支援的查詢參數
CarePlan支援的Profiles
  個案服務計畫-CarePlan TWSS Base
yyy查看 CarePlan 查詢參數
Claim支援的Profiles
  補助申請或核付明細-Claim TWSS Base
yyyy查看 Claim 查詢參數
ClaimResponse支援的Profiles
  補助審核或核付結果-ClaimResponse TWSS Base
yyyy查看 ClaimResponse 查詢參數
Condition支援的Profiles
  健康與障礙狀況-Condition TWSS Base
yyyy查看 Condition 查詢參數
Coverage支援的Profiles
  補助資格或補助案件-Coverage TWSS Base
yyyy查看 Coverage 查詢參數
DocumentReference支援的Profiles
  共用公文-DocumentReference TWSS Base
yyy查看 DocumentReference 查詢參數
Encounter支援的Profiles
  安置服務-Encounter TWSS Base
  個案評估或服務接觸-Encounter TWSS Base
  個案會談-Encounter TWSS Base
  個案會議-Encounter TWSS Base
  個案實際服務-Encounter TWSS Base
yyyy查看 Encounter 查詢參數
EpisodeOfCare支援的Profiles
  個案服務案件-EpisodeOfCare TWSS Base
yyyy查看 EpisodeOfCare 查詢參數
Location支援的Profiles
  服務地點及托育地址-Location TWSS Base
yyyy查看 Location 查詢參數
Observation支援的Profiles
  心理諮商現況-Observation TWSS Base
  關係人職業-Observation TWSS Base
    Assessment Result-Observation TWSS Base
  CMS Level-Observation TWSS Base
  視力檢查-Observation TWSS Base
  
yyyy查看 Observation 查詢參數
Organization支援的Profiles
  機構資料-Organization TWSS Base
  醫療院所-Organization TWSS Base
  轉介機構-Organization TWSS Base
yyyy查看 Organization 查詢參數
OrganizationAffiliation支援的Profiles
  機構關係-OrganizationAffiliation TWSS Base
yyyy查看 OrganizationAffiliation 查詢參數
Patient支援的Profiles
  個案資料-Patient TWSS Base
yyyy查看 Patient 查詢參數
Practitioner支援的Profiles
  人員資料-Practitioner TWSS Base
yyyy查看 Practitioner 查詢參數
PractitionerRole支援的Profiles
  人員角色-PractitionerRole TWSS Base
yyyy查看 PractitionerRole 查詢參數
Provenance支援的Profiles
  資料建立與修改歷程-Provenance TWSS Base
yyyy查看 Provenance 查詢參數
Questionnaire支援的Profiles
  日常生活功能 ADL 評估-Questionnaire TWSS Base
  危機事件地點-Questionnaire TWSS Base
  身心障礙狀況-Questionnaire TWSS Base
  居住狀況評估-Questionnaire TWSS Base
  社福表單-Questionnaire TWSS Base
  家庭身障人口狀況-Questionnaire TWSS Base
  家庭評估-Questionnaire TWSS Base
  健康與疾病狀況-Questionnaire TWSS Base
  訪視紀錄-Questionnaire TWSS Base
  福利與經濟現況-Questionnaire TWSS Base
  輔具使用狀況-Questionnaire TWSS Base
  關係人風險狀況-Questionnaire TWSS Base
  個案基本與家庭資訊-Questionnaire TWSS Base
  教育資訊-Questionnaire TWSS Base
  醫療服務現況-Questionnaire TWSS Base
  機構行政與營運資訊-Questionnaire TWSS Base
  個案服務行政資訊-Questionnaire TWSS Base
  服務人基本與任職資訊-Questionnaire TWSS Base
  服務人受訓課程-Questionnaire TWSS Base
  關係人基本資訊-Questionnaire TWSS Base
  關係人角色評估-Questionnaire TWSS Base
  職業訓練狀況-Questionnaire TWSS Base
  學校適應狀況-Questionnaire TWSS Base
  情緒與行為狀況-Questionnaire TWSS Base
  人際互動狀況-Questionnaire TWSS Base
  發展遲緩類別-Questionnaire TWSS Base
  就業資訊-Questionnaire TWSS Base
  安置資訊-Questionnaire TWSS Base
  結案與安置資訊-Questionnaire TWSS Base
y查看 Questionnaire 查詢參數
QuestionnaireResponse支援的Profiles
社福表單回覆-QuestionnaireResponse TWSS Base
  個案服務評估回覆-QuestionnaireResponse TWSS Base
yyy查看 QuestionnaireResponse 查詢參數
RelatedPerson支援的Profiles
  關係人資料-RelatedPerson TWSS Base
yyyy查看 RelatedPerson 查詢參數
ServiceRequest支援的Profiles
  申請或服務請求-ServiceRequest TWSS Base
  個案通報-ServiceRequest TWSS Base
  個案轉介-ServiceRequest TWSS Base
  Case Transition-ServiceRequest TWSS Base
yyyy查看 ServiceRequest 查詢參數
Task支援的Profiles
  個案受理與評估-Task TWSS Base
  個案服務評估審核-Task TWSS Base
  個案轉介受理-Task TWSS Base
  個案轉介處理-Task TWSS Base
查看 Task 查詢參數

CarePlan

Resource或Profiles的RESTful功能
Core FHIR Resource
CarePlan
Search Parameters
可能可以(MAY)支援FHIR R4 CarePlan 所定義之查詢參數。
查看 CarePlan 查詢參數

Claim

Resource或Profiles的RESTful功能
Core FHIR Resource
Claim
Search Parameters
可能可以(MAY)支援FHIR R4 Claim 所定義之查詢參數。
查看 Claim 查詢參數

ClaimResponse

Resource或Profiles的RESTful功能
Core FHIR Resource
ClaimResponse
Search Parameters
可能可以(MAY)支援FHIR R4 ClaimResponse 所定義之查詢參數。
查看 ClaimResponse 查詢參數

Condition

Resource或Profiles的RESTful功能
Core FHIR Resource
Condition
Search Parameters
可能可以(MAY)支援FHIR R4 Condition 所定義之查詢參數。
查看 Condition 查詢參數

Coverage

Resource或Profiles的RESTful功能
Core FHIR Resource
Coverage
Search Parameters
可能可以(MAY)支援FHIR R4 Coverage 所定義之查詢參數。
查看 Coverage 查詢參數

DocumentReference

Resource或Profiles的RESTful功能
Core FHIR Resource
DocumentReference
Search Parameters
可能可以(MAY)支援FHIR R4 DocumentReference 所定義之查詢參數。
查看 DocumentReference 查詢參數

Encounter

Resource或Profiles的RESTful功能

EpisodeOfCare

Resource或Profiles的RESTful功能
Core FHIR Resource
EpisodeOfCare
Search Parameters
可能可以(MAY)支援FHIR R4 EpisodeOfCare 所定義之查詢參數。
查看 EpisodeOfCare 查詢參數

Location

Resource或Profiles的RESTful功能
Core FHIR Resource
Location
Search Parameters
可能可以(MAY)支援FHIR R4 Location 所定義之查詢參數。
查看 Location 查詢參數

Observation

Resource或Profiles的RESTful功能

Organization

Resource或Profiles的RESTful功能
Core FHIR Resource
Organization
Search Parameters
可能可以(MAY)支援FHIR R4 Organization 所定義之查詢參數。
查看 Organization 查詢參數

OrganizationAffiliation

Resource或Profiles的RESTful功能
Core FHIR Resource
OrganizationAffiliation
Search Parameters
可能可以(MAY)支援FHIR R4 OrganizationAffiliation 所定義之查詢參數。
查看 OrganizationAffiliation 查詢參數

Patient

Resource或Profiles的RESTful功能
Core FHIR Resource
Patient
Search Parameters
可能可以(MAY)支援FHIR R4 Patient 所定義之查詢參數。
查看 Patient 查詢參數

Practitioner

Resource或Profiles的RESTful功能
Core FHIR Resource
Practitioner
Search Parameters
可能可以(MAY)支援FHIR R4 Practitioner 所定義之查詢參數。
查看 Practitioner 查詢參數

PractitionerRole

Resource或Profiles的RESTful功能
Core FHIR Resource
PractitionerRole
Search Parameters
可能可以(MAY)支援FHIR R4 PractitionerRole 所定義之查詢參數。
查看 PractitionerRole 查詢參數

Provenance

Resource或Profiles的RESTful功能
Core FHIR Resource
Provenance
Search Parameters
可能可以(MAY)支援FHIR R4 Provenance 所定義之查詢參數。
查看 Provenance 查詢參數

Questionnaire

QuestionnaireResponse

Resource或Profiles的RESTful功能
Core FHIR Resource
QuestionnaireResponse
Search Parameters
可能可以(MAY)支援FHIR R4 QuestionnaireResponse 所定義之查詢參數。
查看 QuestionnaireResponse 查詢參數

RelatedPerson

Resource或Profiles的RESTful功能
Core FHIR Resource
RelatedPerson
Search Parameters
可能可以(MAY)支援FHIR R4 RelatedPerson 所定義之查詢參數。
查看 RelatedPerson 查詢參數

ServiceRequest

Resource或Profiles的RESTful功能
Core FHIR Resource
ServiceRequest
Search Parameters
可能可以(MAY)支援FHIR R4 ServiceRequest 所定義之查詢參數。
查看 ServiceRequest 查詢參數

Task

Resource或Profiles的RESTful功能
Core FHIR Resource
Task
Search Parameters
可能可以(MAY)支援FHIR R4 Task 所定義之查詢參數。
查看 Task 查詢參數