臺灣核心-伺服端(TW Core Server) - 臺灣核心實作指引(TW Core IG) v0.3.1

臺灣核心實作指引(TW Core IG), published by 衛生福利部. This guide is not an authorized publication; it is the continuous build for version 0.3.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/cctwFHIRterm/MOHW_TWCoreIG_Build/ and changes regularly. See the Directory of published versions

CapabilityStatement: 臺灣核心-伺服端(TW Core Server)

Official URL: https://twcore.mohw.gov.tw/ig/twcore/CapabilityStatement/CapabilityStatementTWCoreServer				Version: 0.3.1
Active as of 2024-08-31				Computable Name: CapabilityStatementTWCoreServer

臺灣核心實作指引（TW Core IG）伺服端（Server）之能力聲明

Raw OpenAPI-Swagger Definition file | Download

臺灣核心-伺服端（TW Core Server）

實作指引版本：0.3.1
FHIR版本：4.0.1
支援格式：json, xml
發佈日：2024-08-31
發佈者：衛生福利部

Server的FHIR RESTful功能要求

模式：`server`

臺灣核心-伺服端（TW Core Server） 必須（SHALL）

可透過FHIR RESTful API查詢的Resources
根據FHIR規範實作RESTful
HTTP回傳狀態碼
- （Status 400）：無效參數（invalid parameter）
- （Status 401/4xx）：未經授權的請求（unauthorized request）
- （Status 403）：未充分授權的資料存取範圍（insufficient premission scope）
- （Status 404）：未知的resource（unknown resource）
Server提供的API操作皆支援JSON格式

臺灣核心-伺服端（TW Core Server） 建議應該（SHOULD）

Server提供的API操作皆支援XML格式
可識別每個新增到Server的實例（instance）之 meta.profile是否為TW Core Profiles Defining URL，並確認實例是否依循profile製作。【註：實例是指依據profile實作，將真實資料以JSON、XML或Turtle格式存放的檔案】
支援每個profile的查詢參數

安全性

Server必須（SHALL）透過回傳 HTTP 401「未授權」， HTTP 403「禁止」，或 HTTP 404 「未找到」，來拒絕任何未經授權的請求

系統互動能力：

可能可以（MAY）支援交易（transaction） interaction
可能可以（MAY）支援批次（batch） interaction
可能可以（MAY）支援查詢系統（search-system） interaction

Resources或Profiles的RESTful功能

Summary

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

✓ = 建議應該（SHOULD）
⚪ = 可能可以（MAY）

Resource型別	Profile	Create	Read	VRead	Search	Update	Patch	Delete	支援的查詢參數	支援的Operation
AllergyIntolerance	臺灣核心-過敏或不耐症（TW Core AllergyIntolerance）	✓	✓	✓	✓	✓	✓	⚪	_id, clinical-status
Bundle	臺灣核心-資料交換基本單位（TW Core Bundle）支援的Profiles：臺灣核心-資料交換基本單位-文件（TW Core Bundle Document）臺灣核心-資料交換基本單位-訊息（TW Core Bundle Message）	✓	✓	✓	✓	✓	✓	⚪	_id, identifier
CarePlan	臺灣核心-照護計畫（TW Core CarePlan）	✓	✓	✓	✓	✓	✓	⚪	patient + category, patient + category + date, patient + category + status, patient + category + status + date
CareTeam	臺灣核心-照護團隊（TW Core CareTeam）	✓	✓	✓	✓	✓	✓	⚪	patient + status, patient + role
Composition	臺灣核心-臨床文件架構（TW Core Composition）	✓	✓	✓	✓	✓	✓	⚪	_id, status, type, subject
Condition	臺灣核心-病情、問題或診斷（TW Core Condition）	✓	✓	✓	✓	✓	✓	⚪	_id, clinical-status, code, subject, onset-date, abatement-date, severity
Coverage	臺灣核心-給付範圍（TW Core Coverage）	✓	✓	✓	✓	✓	✓	⚪	patient
Device	臺灣核心-植入式裝置（TW Core Implantable Device）	✓	✓	✓	✓	✓	✓	⚪	patient, patient + type, patient + status
DiagnosticReport	臺灣核心-診斷報告（TW Core DiagnosticReport）	✓	✓	✓	✓	✓	✓	⚪	_id, status, subject, category, code, date
DocumentReference	臺灣核心-文件參照（TW Core DocumentReference）	✓	✓	✓	✓	✓	✓	⚪	_id, status, subject
Encounter	臺灣核心-就醫事件（TW Core Encounter）	✓	✓	✓	✓	✓	✓	⚪	_id, class, date, identifier, location, subject, status
Goal	臺灣核心-目標（TW Core Goal）	✓	✓	✓	✓	✓	✓	⚪	patient, patient + lifecycle-status, patient + target-date, patient + description
ImagingStudy	臺灣核心-影像檢查（TW Core ImagingStudy）	✓	✓	✓	✓	✓	✓	⚪	_id, status, subject, encounter, started
Immunization	臺灣核心-疫苗接種（TW Core Immunization）	✓	✓	✓	✓	✓	✓	⚪	patient, patient + date, patient + status
Location	臺灣核心-地點（TW Core Location)	✓	✓	✓	✓	✓	✓	⚪	_id, address, name
Media	臺灣核心-多媒體（TW Core Media）	✓	✓	✓	✓	✓	✓	⚪	_id, status, subject
Medication	臺灣核心-藥品（TW Core Medication）	✓	✓	✓	✓	✓	✓	⚪	_id, code
MedicationRequest	臺灣核心-藥品請求（TW Core MedicationRequest）	✓	✓	✓	✓	✓	✓	⚪	_id, status, intent, subject, medication, encounter, authoredon
MedicationDispense	臺灣核心-配藥或藥品調劑（TW Core MedicationDispense）	✓	✓	✓	✓	✓	✓	⚪	_id, status, subject, medication
MedicationStatement	臺灣核心-用藥聲明（TW Core MedicationStatement）	✓	✓	✓	✓	✓	✓	⚪	_id, status, subject, medication
MessageHeader	臺灣核心-訊息表頭（TW Core MessageHeader）	✓	✓	✓	✓	✓	✓	⚪	_id, author, sender
Observation	支援的Profiles：臺灣核心-平均血壓（TW Core Observation Average Blood Pressure）臺灣核心-病人照護偏好註記（TW Core Observation Care Experience Preference）臺灣核心-臨床檢驗檢查（TW Core Observation Clinical Result）臺灣核心-實驗室檢驗檢查（TW Core Observation Laboratory Result）臺灣核心-職業（TW Core Observation Occupation）臺灣核心-妊娠計畫（TW Core Observation Pregnancy Intent）臺灣核心-妊娠狀態（TW Core Observation Pregnancy Status）臺灣核心-健康狀態篩檢與評估（TW Core Observation Screening Assessment）臺灣核心-性傾向（TW Core Observation Sexual Orientation）臺灣核心-通用檢驗檢查（TW Core Simple Observation）臺灣核心-吸菸狀態（TW Core Smoking Status Observation）臺灣核心-病人治療偏好註記（TW Core Observation Treatment Intervention Preference）臺灣核心-生命體徵（TW Core Observation Vital Signs）臺灣核心-兒童及青少年身體質量指數（TW Core Pediatric BMI for Age Observation）臺灣核心-血壓（TW Core Observation Blood Pressure）臺灣核心-身體質量指數（TW Core Observation BMI）臺灣核心-身高（TW Core Observation Body Height）臺灣核心-體溫（TW Core Observation Body Temperature）臺灣核心-體重（TW Core Observation Body Weight）臺灣核心-頭圍（TW Core Observation Head Circumference）臺灣核心-心率（TW Core Observation Heart Rate）臺灣核心-脈搏血氧飽和度（TW Core Observation Pulse Oximetry）臺灣核心-呼吸速率（TW Core Observation Respiratory Rate）臺灣核心-兒童頭圍百分位數（TW Core Observation Pediatric Head Occipital Frontal Circumference Percentile）	✓	✓	✓	✓	✓	✓	⚪	_id, category, code, date, performer, status, subject, patient + category, patient + code, patient + category + date, patient + category + status, patient + category + _lastUpdated, patient + code + date
Organization	臺灣核心-機構（TW Core Organization）支援的Profiles：臺灣核心-政府機構（TW Core Organization Government）臺灣核心-醫事機構（TW Core Organization Hospital Department）臺灣核心-公司行號（TW Core Organization Company）	✓	✓	✓	✓	✓	✓	⚪	_id, identifier, name, type
Patient	臺灣核心-病人（TW Core Patient）	✓	✓	✓	✓	✓	✓	⚪	_id, birthdate, gender, identifier, name	$everything
Practitioner	臺灣核心-健康照護服務提供者（TW Core Practitioner）	✓	✓	✓	✓	✓	✓	⚪	_id, identifier, name
PractitionerRole	臺灣核心-健康照護服務提供者角色（TW Core PractitionerRole）	✓	✓	✓	✓	✓	✓	⚪	_id, identifier, specialty
Procedure	臺灣核心-處置或手術（TW Core Procedure）	✓	✓	✓	✓	✓	✓	⚪	_id, code, status, subject, date
Provenance	臺灣核心-出處（TW Core Provenance）	✓	✓	✓	✓	✓	✓	⚪
QuestionnaireResponse	臺灣核心-問卷題目回覆（TW Core QuestionnaireResponse）	✓	✓	✓	✓	✓	✓	⚪	_id, patient, patient + status, patient + authored, patient + questionnaire
RelatedPerson	臺灣核心-相關人士（TW Core RelatedPerson）	✓	✓	✓	✓	✓	✓	⚪	_id, patient, patient + name
ServiceRequest	臺灣核心-服務請求（TW Core ServiceRequest）	✓	✓	✓	✓	✓	✓	⚪	_id, patient, patient + category, patient + category + authored, patient + status, patient + code + authored
Specimen	臺灣核心-檢體（TW Core Specimen）	✓	✓	✓	✓	✓	✓	⚪	_id, status, identifier, subject

預期的遵從度：建議應該（SHOULD）AllergyIntolerance

Base System Profile
臺灣核心-過敏或不耐症（TW Core AllergyIntolerance）

支援的參照政策（Reference policy）
resolves，Server會嘗試將邏輯參照（logical reference）解析為文字參照，意即轉換Reference.identifier為Reference.reference（但如果解析失敗，Server仍然會接收這個resource，請參閱 logical）。

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/AllergyIntolerance?_id=[id]`, `GET [base]/AllergyIntolerance/[id]`
建議應該（SHOULD）	clinical-status	token	`GET [base]/AllergyIntolerance?clinical-status=[code]`

預期的遵從度：建議應該（SHOULD） Bundle

Base System Profile
臺灣核心-資料交換基本單位（TW Core Bundle）

支援的Profiles

臺灣核心-資料交換基本單位-文件（TW Core Bundle Document）
臺灣核心-資料交換基本單位-訊息（TW Core Bundle Message）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Bundle?_id=[id]`, `GET [base]/Bundle/[id]`
建議應該（SHOULD）	identifier	token	`GET [base]/Bundle?identifier={system\|}[code]`

預期的遵從度：建議應該（SHOULD） CarePlan

Base System Profile
臺灣核心-照護計畫（TW Core CarePlan）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	patient + category	`reference` + `token`	`GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy\|assess-plan`
建議應該（SHOULD）	patient + category + date	`reference` + `token` + `date`	`GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy\|assess-plan&date={gt\|lt\|ge\|le}[date]{&date={gt\|lt\|ge\|le}[date]&...}`
建議應該（SHOULD）	patient + category + status	`reference` + `token`	`GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy\|assess-plan&status={system\|}[code]{,{system\|}[code],...}`
建議應該（SHOULD）	patient + category + status + date	`reference` + `token` + `date`	`GET [base]/CarePlan?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/careplan-category-twy\|assess-plan&status={system\|}[code]{,{system\|}[code],...}&date={gt\|lt\|ge\|le}[date]{&date={gt\|lt\|ge\|le}[date]&...}`

預期的遵從度：建議應該（SHOULD） CareTeam

Base System Profile
臺灣核心-照護團隊（TW Core CareTeam）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	patient + status	`reference` + `token`	`GET [base]/CareTeam?patient={Type/}[id]&status={system\|}[code]{,{system\|}[code],...}`
建議應該（SHOULD）	patient + role	`reference` + `token`	`GET [base]/CareTeam?patient={Type/}[id]&role={system\|}[code]{,{system\|}[code],...}`

預期的遵從度：建議應該（SHOULD） Composition

Base System Profile
臺灣核心-臨床文件架構（TW Core Composition）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Composition?_id=[id]`, `GET [base]/Composition/[id]`
建議應該（SHOULD）	status	token	`GET [base]/Composition?status=[code]`
建議應該（SHOULD）	type	token	`GET [base]/Composition?type=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/Composition?subject=[subject]`

預期的遵從度：建議應該（SHOULD） Condition

Base System Profile
臺灣核心-病情、問題或診斷（TW Core Condition）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Condition?_id=[id]`, `GET [base]/Condition/[id]`
建議應該（SHOULD）	clinical-status	token	`GET [base]/Condition?clinical-status=[code]`
建議應該（SHOULD）	code	token	`GET [base]/Condition?code={system\|}[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/Condition?subject={Type/}[id]`
建議應該（SHOULD）	onset-date	date	`GET [base]/Condition?onset-date={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	abatement-date	date	`GET [base]/Condition?abatement-date={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	severity	token	`GET [base]/Condition?severity={system\|}[code]`

預期的遵從度：建議應該（SHOULD） Coverage

Base System Profile
臺灣核心-給付範圍（TW Core Coverage）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	patient	`reference`	`GET [base]/Coverage?patient={Type/}[id]`

預期的遵從度：建議應該（SHOULD） Device

Base System Profile
臺灣核心-植入式裝置（TW Core Implantable Device）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	patient	`reference`	`GET [base]/Device?patient={Type/}[id]`
建議應該（SHOULD）	patient + type	`reference` + `token`	`GET [base]/Device?patient={Type/}[id]&type={system\|}[code]`
建議應該（SHOULD）	patient + status	`reference` + `token`	`GET [base]/Device?patient={Type/}[id]&status=[code]`

預期的遵從度：建議應該（SHOULD）DiagnosticReport

Base System Profile
臺灣核心-診斷報告（TW Core DiagnosticReport）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/DiagnosticReport?_id=[id]`, `GET [base]/DiagnosticReport/[id]`
建議應該（SHOULD）	status	token	`GET [base]/DiagnosticReport?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/DiagnosticReport?subject={Type/}[id]`
建議應該（SHOULD）	category	token	`GET [base]/DiagnosticReport?category={system\|}[code]`
建議應該（SHOULD）	code	token	`GET [base]/DiagnosticReport?code={system\|}[code]`
建議應該（SHOULD）	date	date	`GET [base]/DiagnosticReport?date={gt\|lt\|ge\|le}[date]`

預期的遵從度：建議應該（SHOULD）DocumentReference

Base System Profile
臺灣核心-文件參照（TW Core DocumentReference）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/DocumentReference?_id=[id]`, `GET [base]/DocumentReference/[id]`
建議應該（SHOULD）	status	token	`GET [base]/DocumentReference?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/DocumentReference?subject={Type/}[id]`

預期的遵從度：建議應該（SHOULD） Encounter

Base System Profile
臺灣核心-就醫事件（TW Core Encounter）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Encounter?_id=[id]`, `GET [base]/Encounter/[id]`
建議應該（SHOULD）	class	token	`GET [base]/Encounter?class=[code]`
建議應該（SHOULD）	date	date	`GET [base]/Encounter?date={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	identifier	token	`GET [base]/Encounter?identifier={system\|}[code]`
建議應該（SHOULD）	location	reference	`GET [base]/Encounter?location={Type/}[id]`
建議應該（SHOULD）	subject	reference	`GET [base]/Encounter?subject={Type/}[id]`
建議應該（SHOULD）	status	token	`GET [base]/Encounter?status=[code]`

預期的遵從度：建議應該（SHOULD） Goal

Base System Profile
臺灣核心-目標（TW Core Goal）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	patient	`reference`	`GET [base]/Goal?patient={Type/}[id]`
建議應該（SHOULD）	patient + lifecycle-status	`reference` + `token`	`GET [base]/Goal?patient={Type/}[id]&lifecycle-status={system\|}[code]`
建議應該（SHOULD）	patient + target-date	`reference` + `date`	`GET [base]/Goal?patient={Type/}[id]&target-date={gt\|lt\|ge\|le}[date]{&target-date={gt\|lt\|ge\|le}[date]&...}`
建議應該（SHOULD）	patient + description	`reference` + `token`	`GET [base]/Goal?patient={Type/}[id]&description={system\|}[code]`

預期的遵從度：建議應該（SHOULD） ImagingStudy

Base System Profile
臺灣核心-影像檢查（TW Core ImagingStudy）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/ImagingStudy?_id=[id]`, `GET [base]/ImagingStudy/[id]`
建議應該（SHOULD）	status	token	`GET [base]/ImagingStudy?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/ImagingStudy?subject={Type/}[id]`
建議應該（SHOULD）	encounter	reference	`GET [base]/ImagingStudy?encounter={Type/}[id]`
建議應該（SHOULD）	started	date	`GET [base]/ImagingStudy?started={gt\|lt\|ge\|le}[date]`

預期的遵從度：建議應該（SHOULD） Immunization

Base System Profile
臺灣核心-疫苗接種（TW Core Immunization）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	patient	`reference`	`GET [base]/Immunization?patient={Type/}[id]`
建議應該（SHOULD）	patient + date	`reference` + `date`	`GET [base]/Immunization?patient={Type/}[id]&date={gt\|lt\|ge\|le}[date]{&date={gt\|lt\|ge\|le}[date]&...}`
建議應該（SHOULD）	patient + status	`reference` + `token`	`GET [base]/Immunization?patient={Type/}[id]&status={system\|}[code]`

預期的遵從度：建議應該（SHOULD） Location

Base System Profile
臺灣核心-地點（TW Core Location)

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Location?_id=[id]`, `GET [base]/Location/[id]`
建議應該（SHOULD）	address	string	`GET [base]/Location?address=[string]`
建議應該（SHOULD）	name	string	`GET [base]/Location?name=[string]`

預期的遵從度：建議應該（SHOULD） Media

Base System Profile
臺灣核心-多媒體（TW Core Media）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Media?_id=[id]`, `GET [base]/Media/[id]`
建議應該（SHOULD）	status	token	`GET [base]/Media?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/Media?subject={Type/}[id]`

預期的遵從度：建議應該（SHOULD） Medication

Base System Profile
臺灣核心-藥品（TW Core Medication）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Medication?_id=[id]`, `GET [base]/Medication/[id]`
建議應該（SHOULD）	code	token	`GET [base]/Medication?code={system\|}[code]`

預期的遵從度：建議應該（SHOULD）MedicationRequest

Base System Profile
臺灣核心-藥品請求（TW Core MedicationRequest）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/MedicationRequest?_id=[id]`, `GET [base]/MedicationRequest/[id]`
建議應該（SHOULD）	status	token	`GET [base]/MedicationRequest?status=[code]`
建議應該（SHOULD）	intent	token	`GET [base]/MedicationRequest?intent={system\|}[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/MedicationRequest?subject={Type/}[id]`
建議應該（SHOULD）	medication	reference	`GET [base]/MedicationRequest?medication={Type/}[id]`
建議應該（SHOULD）	encounter	reference	`GET [base]/MedicationRequest?encounter={Type/}[id]`
建議應該（SHOULD）	authoredon	date	`GET [base]/MedicationRequest?authoredon={gt\|lt\|ge\|le}[date]`

預期的遵從度：建議應該（SHOULD）MedicationDispense

Base System Profile
臺灣核心-配藥或藥品調劑（TW Core MedicationDispense）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/MedicationDispense?_id=[id]`, `GET [base]/MedicationDispense/[id]`
建議應該（SHOULD）	status	token	`GET [base]/MedicationDispense?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/MedicationDispense?subject={Type/}[id]`
建議應該（SHOULD）	medication	reference	`GET [base]/MedicationDispense?medication={Type/}[id]`

預期的遵從度：建議應該（SHOULD）MedicationStatement

Base System Profile
臺灣核心-用藥聲明（TW Core MedicationStatement）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/MedicationStatement?_id=[id]`, `GET [base]/MedicationStatement/[id]`
建議應該（SHOULD）	status	token	`GET [base]/MedicationStatement?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/MedicationStatement?subject={Type/}[id]`
建議應該（SHOULD）	medication	reference	`GET [base]/MedicationStatement?medication={Type/}[id]`

預期的遵從度：建議應該（SHOULD）MessageHeader

Base System Profile
臺灣核心-訊息表頭（TW Core MessageHeader）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/MessageHeader?_id=[id]`, `GET [base]/MessageHeader/[id]`
建議應該（SHOULD）	author	reference	`GET [base]/MessageHeader?author={Type/}[id]`
建議應該（SHOULD）	sender	reference	`GET [base]/MessageHeader?sender={Type/}[id]`

預期的遵從度：建議應該（SHOULD） Observation

Core FHIR Resource
Observation

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

支援的Profiles

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Observation?_id=[id]`, `GET [base]/Observation/[id]`
建議應該（SHOULD）	category	token	`GET [base]/Observation?category={system\|}[code]`
建議應該（SHOULD）	code	token	`GET [base]/Observation?code={system\|}[code]`
建議應該（SHOULD）	date	date	`GET [base]/Observation?date={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	performer	reference	`GET [base]/Observation?performer={Type/}[id]`
建議應該（SHOULD）	status	token	`GET [base]/Observation?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/Observation?subject={Type/}[id]`
必須（SHALL）	patient + category	reference+token	`GET [base]/Observation?patient={Type/}[id]&category={system\|}[code]`
必須（SHALL）	patient + code	reference+token	`GET [base]/Observation?patient={Type/}[id]&code={system\|}[code]`
必須（SHALL）	patient + category + date	reference+token+date	`GET [base]/Observation?patient={Type/}[id]&category={system\|}[code]&date={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	patient + category + status	reference+token	`GET [base]/Observation?patient={Type/}[id]&category={system\|}[code]&status=[code]`
建議應該（SHOULD）	patient + category + _lastUpdated	reference+token+date	`GET [base]/Observation?patient={Type/}[id]&category={system\|}[code]&_lastUpdated={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	patient + code + date	reference+token+date	`GET [base]/Observation?patient={Type/}[id]&code={system\|}[code]&date={gt\|lt\|ge\|le}[date]`

預期的遵從度：建議應該（SHOULD） Organization

Base System Profile
臺灣核心-機構（TW Core Organization）

支援的Profiles

臺灣核心-政府機構（TW Core Organization Government）
臺灣核心-醫事機構（TW Core Organization Hospital Department）
臺灣核心-公司行號（TW Core Organization Company）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Organization?_id=[id]`, `GET [base]/Organization/[id]`
建議應該（SHOULD）	identifier	token	`GET [base]/Organization?identifier={system\|}[code]`
建議應該（SHOULD）	name	string	`GET [base]/Organization?name=[name]`
建議應該（SHOULD）	type	token	`GET [base]/Organization?type={system\|}[code]`

預期的遵從度：建議應該（SHOULD） Patient

Base System Profile
臺灣核心-病人（TW Core Patient）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Patient?_id=[id]`, `GET [base]/Patient/[id]`
建議應該（SHOULD）	birthdate	date	`GET [base]/Patient?birthdate={gt\|lt\|ge\|le}[date]`
建議應該（SHOULD）	gender	token	`GET [base]/Patient?gender=[code]`
建議應該（SHOULD）	identifier	token	`GET [base]/Patient?identifier={system\|}[code]`
建議應該（SHOULD）	name	string	`GET [base]/Patient?name=[name]`

Operation

遵從度	參數	範例
建議應該（SHOULD）	$everything	`GET [base]/Patient/$everything`, `GET [base]/Patient/[id]/$everything`

預期的遵從度：建議應該（SHOULD） Practitioner

Base System Profile
臺灣核心-健康照護服務提供者（TW Core Practitioner）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Practitioner?_id=[id]`, `GET [base]/Practitioner/[id]`
建議應該（SHOULD）	identifier	token	`GET [base]/Practitioner?identifier={system\|}[code]`
建議應該（SHOULD）	name	string	`GET [base]/Practitioner?name=[name]`

預期的遵從度：建議應該（SHOULD）PractitionerRole

Base System Profile
臺灣核心-健康照護服務提供者角色（TW Core PractitionerRole）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/PractitionerRole?_id=[id]`, `GET [base]/PractitionerRole/[id]`
建議應該（SHOULD）	identifier	token	`GET [base]/PractitionerRole?identifier={system\|}[code]`
建議應該（SHOULD）	specialty	token	`GET [base]/PractitionerRole?specialty={system\|}[code]`

預期的遵從度：建議應該（SHOULD） Procedure

Base System Profile
臺灣核心-處置或手術（TW Core Procedure）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Procedure?_id=[id]`, `GET [base]/Procedure/[id]`
建議應該（SHOULD）	code	token	`GET [base]/Procedure?code={system\|}[code]`
建議應該（SHOULD）	status	token	`GET [base]/Procedure?status=[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/Procedure?subject={Type/}[id]`
建議應該（SHOULD）	date	date	`GET [base]/Procedure?date={gt\|lt\|ge\|le}[date]`

預期的遵從度：建議應該（SHOULD） Provenance

Base System Profile
臺灣核心-出處（TW Core Provenance）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

Resource Conformance: SHOULD QuestionnaireResponse

Base System Profile
臺灣核心-問卷題目回覆（TW Core QuestionnaireResponse）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	_id	`token`	`GET [base]/QuestionnaireResponse?_id=[id]`, `GET [base]/QuestionnaireResponse/[id]`
必須（SHALL）	patient	`reference`	`GET [base]/QuestionnaireResponse?patient={Type/}[id]`
建議應該（SHOULD）	patient + status	`reference` + `token`	`GET [base]/QuestionnaireResponse?patient={Type/}[id]&status={system\|}[code]{,{system\|}[code],...}`
建議應該（SHOULD）	patient + authored	`reference` + `date`	`GET [base]/QuestionnaireResponse?patient={Type/}[id]&authored={gt\|lt\|ge\|le}[date]{&authored={gt\|lt\|ge\|le}[date]&...}`
建議應該（SHOULD）	patient + questionnaire	`reference`	`GET [base]/QuestionnaireResponse?patient={Type/}[id]&questionnaire={Type/}[id]`

預期的遵從度：建議應該（SHOULD）RelatedPerson

Base System Profile
臺灣核心-相關人士（TW Core RelatedPerson）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	_id	`token`	`GET [base]/RelatedPerson?_id=[id]`, `GET [base]/RelatedPerson/[id]`
建議應該（SHOULD）	patient	`reference`	`GET [base]/RelatedPerson?patient={Type/}[id]`
建議應該（SHOULD）	patient + name	`reference` + `string`	`GET [base]/RelatedPerson?patient={Type/}[id]&name=[string]`

預期的遵從度：建議應該（SHOULD）ServiceRequest

Base System Profile
臺灣核心-服務請求（TW Core ServiceRequest）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
必須（SHALL）	_id	`token`	`GET [base]/ServiceRequest?_id=[id]`, `GET [base]/ServiceRequest/[id]`
必須（SHALL）	patient	`reference`	`GET [base]/ServiceRequest?patient={Type/}[id]`
必須（SHALL）	patient + category	`reference` + `token`	`GET [base]/ServiceRequest?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/serviceRequest-category\|sdoh`
必須（SHALL）	patient + category + authored	`reference` + `token` + `date`	`GET [base]/ServiceRequest?patient={Type/}[id]&category={system\|}[code]&authored={gt\|lt\|ge\|le}[date]{&authored={gt\|lt\|ge\|le}[date]&...}`
建議應該（SHOULD）	patient + status	`reference` + `token`	`GET [base]/ServiceRequest?patient={Type/}[id]&status={system\|}[code]{,{system\|}[code],...}`
建議應該（SHOULD）	patient + code + authored	`reference` + `token` + `date`	`GET [base]/ServiceRequest?patient={Type/}[id]&code={system\|}[code]{,{system\|}[code],...}&authored={gt\|lt\|ge\|le}[date]{&authored={gt\|lt\|ge\|le}[date]&...}`

預期的遵從度：建議應該（SHOULD） Specimen

Base System Profile
臺灣核心-檢體（TW Core Specimen）

能力摘要

建議應該（SHOULD）支援 search-type、 read、 vread、 create、 update、 delete
可能可以（MAY）支援 patch

查詢參數摘要

遵從度	參數	類型	範例
建議應該（SHOULD）	_id	token	`GET [base]/Specimen?_id=[id]`, `GET [base]/Specimen/[id]`
建議應該（SHOULD）	status	token	`GET [base]/Specimen?status=[code]`
建議應該（SHOULD）	identifier	token	`GET [base]/Specimen?identifier={system\|}[code]`
建議應該（SHOULD）	subject	reference	`GET [base]/Specimen?subject={Type/}[id]`

CapabilityStatement: 臺灣核心-伺服端(TW Core Server)

臺灣核心-伺服端（TW Core Server）

Server的FHIR RESTful功能要求

模式：server

Resources或Profiles的RESTful功能

Summary

預期的遵從度： 建議應該（SHOULD）AllergyIntolerance

預期的遵從度： 建議應該（SHOULD） Bundle

預期的遵從度： 建議應該（SHOULD） CarePlan

預期的遵從度： 建議應該（SHOULD） CareTeam

預期的遵從度： 建議應該（SHOULD） Composition

預期的遵從度： 建議應該（SHOULD） Condition

預期的遵從度： 建議應該（SHOULD） Coverage

預期的遵從度： 建議應該（SHOULD） Device

預期的遵從度： 建議應該（SHOULD）DiagnosticReport

預期的遵從度： 建議應該（SHOULD）DocumentReference

預期的遵從度： 建議應該（SHOULD） Encounter

預期的遵從度： 建議應該（SHOULD） Goal

預期的遵從度： 建議應該（SHOULD） ImagingStudy

預期的遵從度： 建議應該（SHOULD） Immunization

預期的遵從度： 建議應該（SHOULD） Location

預期的遵從度： 建議應該（SHOULD） Media

預期的遵從度： 建議應該（SHOULD） Medication

預期的遵從度： 建議應該（SHOULD）MedicationRequest

預期的遵從度： 建議應該（SHOULD）MedicationDispense

預期的遵從度： 建議應該（SHOULD）MedicationStatement

預期的遵從度： 建議應該（SHOULD）MessageHeader

預期的遵從度： 建議應該（SHOULD） Observation

預期的遵從度： 建議應該（SHOULD） Organization

預期的遵從度： 建議應該（SHOULD） Patient

預期的遵從度： 建議應該（SHOULD） Practitioner

預期的遵從度： 建議應該（SHOULD）PractitionerRole

預期的遵從度： 建議應該（SHOULD） Procedure

預期的遵從度： 建議應該（SHOULD） Provenance

Resource Conformance: SHOULD QuestionnaireResponse

預期的遵從度： 建議應該（SHOULD）RelatedPerson

預期的遵從度： 建議應該（SHOULD）ServiceRequest

預期的遵從度： 建議應該（SHOULD） Specimen

模式：`server`

預期的遵從度：建議應該（SHOULD）AllergyIntolerance

預期的遵從度：建議應該（SHOULD） Bundle

預期的遵從度：建議應該（SHOULD） CarePlan

預期的遵從度：建議應該（SHOULD） CareTeam

預期的遵從度：建議應該（SHOULD） Composition

預期的遵從度：建議應該（SHOULD） Condition

預期的遵從度：建議應該（SHOULD） Coverage

預期的遵從度：建議應該（SHOULD） Device

預期的遵從度：建議應該（SHOULD）DiagnosticReport

預期的遵從度：建議應該（SHOULD）DocumentReference

預期的遵從度：建議應該（SHOULD） Encounter

預期的遵從度：建議應該（SHOULD） Goal

預期的遵從度：建議應該（SHOULD） ImagingStudy

預期的遵從度：建議應該（SHOULD） Immunization

預期的遵從度：建議應該（SHOULD） Location

預期的遵從度：建議應該（SHOULD） Media

預期的遵從度：建議應該（SHOULD） Medication

預期的遵從度：建議應該（SHOULD）MedicationRequest

預期的遵從度：建議應該（SHOULD）MedicationDispense

預期的遵從度：建議應該（SHOULD）MedicationStatement

預期的遵從度：建議應該（SHOULD）MessageHeader

預期的遵從度：建議應該（SHOULD） Observation

預期的遵從度：建議應該（SHOULD） Organization

預期的遵從度：建議應該（SHOULD） Patient

預期的遵從度：建議應該（SHOULD） Practitioner

預期的遵從度：建議應該（SHOULD）PractitionerRole

預期的遵從度：建議應該（SHOULD） Procedure

預期的遵從度：建議應該（SHOULD） Provenance

預期的遵從度：建議應該（SHOULD）RelatedPerson

預期的遵從度：建議應該（SHOULD）ServiceRequest

預期的遵從度：建議應該（SHOULD） Specimen