臺灣核心實作指引(TW Core IG)
0.3.2 - Ci-Build Trial Use

臺灣核心實作指引(TW Core IG), published by 衛生福利部. This guide is not an authorized publication; it is the continuous build for version 0.3.2 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

Resource Profile: TW Core ServiceRequest

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/ServiceRequest-twcore Version: 0.3.2
Active as of 2025-02-04 Computable Name: TWCoreServiceRequest

此臺灣核心-服務請求(TW Core ServiceRequest) Profile說明本IG如何進一步定義FHIR的ServiceRequest Resource以呈現服務請求資料。

Usage:

Formal Views of Profile Content

Description of Profiles, Differentials, Snapshots and how the different presentations work.

NameFlagsCard.TypeDescription & Constraintsdoco
.. ServiceRequest C 0..* ServiceRequest A request for a service to be performed
dom-2: If the resource is contained in another resource, it SHALL NOT contain nested Resources
dom-3: If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
dom-4: If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
dom-5: If a resource is contained in another resource, it SHALL NOT have a security label
dom-6: A resource should have narrative for robust management
prr-1: orderDetail SHALL only be present if code is present
... implicitRules ?!Σ 0..1 uri A set of rules under which this content was created
ele-1: All FHIR elements must have a @value or children
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
ele-1: All FHIR elements must have a @value or children
ext-1: Must have either extensions or value[x], not both
... basedOn Σ 0..* Reference(TW Core CarePlan | TW Core ServiceRequest | TW Core MedicationRequest) What request fulfills
ele-1: All FHIR elements must have a @value or children
... status ?!SΣ 1..1 code draft | active | on-hold | revoked | completed | entered-in-error | unknown
Binding: RequestStatus (required): The status of a service order.


ele-1: All FHIR elements must have a @value or children
... intent ?!SΣ 1..1 code proposal | plan | directive | order | original-order | reflex-order | filler-order | instance-order | option
Binding: RequestIntent (required): The kind of service request.


ele-1: All FHIR elements must have a @value or children
... Slices for category SΣ 0..* CodeableConceptTW Classification of service
Slice: Unordered, Open by pattern:$this
Binding: ServiceRequestCategoryCodes (example): Classification of the requested service.


ele-1: All FHIR elements must have a @value or children
.... category:twcore SΣ 0..* CodeableConcept Classification of service
Binding: 臺灣衛福部資訊處ServiceRequest類型值集 (required): 此slice綁定的值集之綁定強度雖為最高強度「要求使用(Requird)」,但因slice之特性,其不會限制僅能填此值集中的代碼,故在實作時也可使用其他值集的代碼。


ele-1: All FHIR elements must have a @value or children
... doNotPerform ?!Σ 0..1 boolean True if service/procedure should not be performed
ele-1: All FHIR elements must have a @value or children
... code SΣ 1..1 CodeableConceptTW What is being requested/ordered
Binding: ProcedureCodes(SNOMEDCT) (example): 此資料項目實作者可視實務專案需求只綁定以下slices中的任一值集。


ele-1: All FHIR elements must have a @value or children
.... Slices for coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
ele-1: All FHIR elements must have a @value or children
..... coding:icd10-pcs-2023 SΣ 0..1 CodingTW 由專門術語系統(terminology system)定義的代碼
Binding: 臺灣健保署2023年中文版ICD-10-PCS值集 (required)
ele-1: All FHIR elements must have a @value or children
..... coding:icd10-pcs-2021 SΣ 0..1 CodingTW 由專門術語系統(terminology system)定義的代碼
Binding: 臺灣健保署2021年中文版ICD-10-PCS值集 (required)
ele-1: All FHIR elements must have a @value or children
..... coding:icd10-pcs-2014 SΣ 0..1 CodingTW 由專門術語系統(terminology system)定義的代碼
Binding: 臺灣健保署2014年中文版ICD-10-PCS值集 (required)
ele-1: All FHIR elements must have a @value or children
..... coding:medical-service-payment SΣ 0..1 CodingTW 由專門術語系統(terminology system)定義的代碼
Binding: 臺灣健保署醫療服務給付項目-處置或手術值集 (required)
ele-1: All FHIR elements must have a @value or children
..... coding:sct-procedures SΣ 0..1 CodingTW 由專門術語系統(terminology system)定義的代碼
Binding: ProcedureCodes(SNOMEDCT) (required)
ele-1: All FHIR elements must have a @value or children
..... coding:loinc-procedures SΣ 0..1 CodingTW 由專門術語系統(terminology system)定義的代碼
Binding: LOINCCodes (required)
ele-1: All FHIR elements must have a @value or children
.... text SΣ 0..1 string 概念的文字表示法
ele-1: All FHIR elements must have a @value or children
... subject SΣ 1..1 Reference(TW Core Patient) Individual or Entity the service is ordered for
ele-1: All FHIR elements must have a @value or children
... encounter Σ 0..1 Reference(TW Core Encounter) Encounter in which the request was created
ele-1: All FHIR elements must have a @value or children
... occurrence[x] SΣ 0..1 When service should occur
ele-1: All FHIR elements must have a @value or children
.... occurrenceDateTime dateTime
... authoredOn SΣ 0..1 dateTime Date request signed
ele-1: All FHIR elements must have a @value or children
... requester SΣ 0..1 Reference(TW Core Practitioner) Who/what is requesting service
ele-1: All FHIR elements must have a @value or children
... performer Σ 0..* Reference(TW Core Practitioner | TW Core PractitionerRole | TW Core Organization | TW Core CareTeam | HealthcareService | TW Core Patient | Device | TW Core RelatedPerson) Requested performer
ele-1: All FHIR elements must have a @value or children
... locationReference Σ 0..* Reference(TW Core Location) Requested location
ele-1: All FHIR elements must have a @value or children
... reasonCode Σ 0..* CodeableConcept Explanation/Justification for procedure or service
Binding: SNOMED CT診斷代碼值集 (extensible)
ele-1: All FHIR elements must have a @value or children
... reasonReference Σ 0..* Reference(TW Core Condition | TW Core Observation Clinical Result | TW Core DiagnosticReport | TW Core DocumentReference) Explanation/Justification for service or service
ele-1: All FHIR elements must have a @value or children
... insurance 0..* Reference(TW Core Coverage | ClaimResponse) Associated insurance coverage
ele-1: All FHIR elements must have a @value or children
... specimen Σ 0..* Reference(TW Core Specimen) Procedure Samples
ele-1: All FHIR elements must have a @value or children

doco Documentation for this format

Terminology Bindings

PathConformanceValueSetURI
ServiceRequest.statusrequiredRequestStatus
http://hl7.org/fhir/ValueSet/request-status|4.0.1
from the FHIR Standard
ServiceRequest.intentrequiredRequestIntent
http://hl7.org/fhir/ValueSet/request-intent|4.0.1
from the FHIR Standard
ServiceRequest.categoryexampleServiceRequestCategoryCodes
http://hl7.org/fhir/ValueSet/servicerequest-category
from the FHIR Standard
ServiceRequest.category:twcorerequiredTWServiceRequestCategory
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/serviceRequest-category
from this IG
ServiceRequest.codeexampleProcedureCodes(SNOMEDCT)
http://hl7.org/fhir/ValueSet/procedure-code
from the FHIR Standard
ServiceRequest.code.coding:icd10-pcs-2023requiredTW2023ICD10PCS
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/icd-10-pcs-2023-tw
from this IG
ServiceRequest.code.coding:icd10-pcs-2021requiredTW2021ICD10PCS (a valid code from 臺灣健保署2021年中文版ICD-10-PCS)
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/icd-10-pcs-2021-tw
from this IG
ServiceRequest.code.coding:icd10-pcs-2014requiredTW2014ICD10PCS (a valid code from 臺灣健保署2014年中文版ICD-10-PCS)
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/icd-10-pcs-2014-tw
from this IG
ServiceRequest.code.coding:medical-service-paymentrequiredTWMedicalServicePayment
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/procedure-tw
from this IG
ServiceRequest.code.coding:sct-proceduresrequiredProcedureCodes(SNOMEDCT)
http://hl7.org/fhir/ValueSet/procedure-code
from the FHIR Standard
ServiceRequest.code.coding:loinc-proceduresrequiredLOINCCodes (a valid code from LOINC)
http://hl7.org/fhir/ValueSet/observation-codes
from the FHIR Standard
ServiceRequest.reasonCodeextensibleTWConditionCodeSCT
https://twcore.mohw.gov.tw/ig/twcore/ValueSet/condition-code-sct-tw
from this IG

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorServiceRequestIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorServiceRequestIf the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource
: contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
dom-4errorServiceRequestIf a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated
: contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
dom-5errorServiceRequestIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceServiceRequestA resource should have narrative for robust management
: text.`div`.exists()
ele-1error**ALL** elementsAll FHIR elements must have a @value or children
: hasValue() or (children().count() > id.count())
ext-1error**ALL** extensionsMust have either extensions or value[x], not both
: extension.exists() != value.exists()
prr-1errorServiceRequestorderDetail SHALL only be present if code is present
: orderDetail.empty() or code.exists()

 

Other representations of profile: CSV, Excel, Schematron

Notes:

以下概述了此Profile所需的RESTful FHIR互動功能。有關TW Core IG支援的RESTful互動功能的完整清單,請參閱TW Core Server能力聲明

必須支援以下查詢參數:

  1. 必須(SHALL) 支援透過查詢參數 _id 查詢所有ServiceRequest:
    (如何透過token查詢)

    GET [base]/ServiceRequest?_id=[id]
    GET [base]/ServiceRequest/[id]

    例子:
    (1) GET [base]/ServiceRequest?_id=ser-example
    (2) GET [base]/ServiceRequest/ser-example

  2. 必須(SHALL) 支援透過查詢參數 patient 查詢所有ServiceRequest:
    (如何透過reference查詢)

    GET [base]/ServiceRequest?patient={Type/}[id]

    例子:
    (1) GET [base]/Observation?patient=Patient/pat-example

  3. 必須(SHALL) 支援透過查詢參數 patientcategory 查詢所有ServiceRequest:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/ServiceRequest?patient={Type/}[id]&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/serviceRequest-category|sdoh

    例子:
    (1) GET [base]/ServiceRequest?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/serviceRequest-category|sdoh

  4. 必須(SHALL) 支援透過查詢參數 patientcategoryauthored 查詢所有ServiceRequest:
    (如何透過reference查詢)
    (如何透過token查詢)
    (如何透過date查詢)
    GET [base]/ServiceRequest?patient={Type/}[id]&category={system|}[code]&authored={gt|lt|ge|le}[date]{&authored={gt|lt|ge|le}[date]&...}

    例子:
    (1) GET [base]/ServiceRequest?patient=Patient/pat-example&category=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/serviceRequest-category|sdoh&authored=ge2024-01-01T00:00:00Z

建議應該支援以下查詢參數:

  1. 建議應該(SHOULD) 支援透過查詢參數 patientstatus 查詢所有ServiceRequest:
    (如何透過reference查詢)
    (如何透過token查詢)
    GET [base]/ServiceRequest?patient={Type/}[id]&status={system|}[code]{,{system|}[code],...}

    例子:
    (1) GET [base]/ServiceRequest?patient=Patient/pat-example&status=final

  2. 建議應該(SHOULD) 支援透過查詢參數 patientcodeauthored 查詢所有ServiceRequest:
    (如何透過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]&...}

    例子:
    (1) GET [base]/ServiceRequest?Patient/pat-example&code=http://snomed.info/sct|35637008&date=ge2019-01-14T00:00:00Z