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

This page is part of the 臺灣核心實作指引(TW Core IG) (v0.1.1: Releases) based on FHIR R4. This is the current published version in its permanent home (it will always be available at this URL). For a full list of available versions, see the Directory of published versions

Resource Profile: TW Core Medication

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/Medication-twcore Version: 0.1.1
Active as of 2023-08-30 Computable Name: TWCoreMedication

此臺灣核心-藥品(TW Core Medication) Profile說明本IG如何進一步定義FHIR的Medication Resource以呈現藥品的詳細資料 [FMM1]

Usage:

Formal Views of Profile Content

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

This structure is derived from Medication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*Medication藥品的定義
... id 0..1id不重複的ID用以識別儲存在特定FHIR Server中的Medication紀錄,通常又稱為邏輯性ID。
... meta 0..1Meta此Medication Resource的metadata
... implicitRules 0..1uri創建此內容所依據的一組規則
... text S0..1NarrativeMedication Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier 0..*Identifier此藥品的業務用識別碼
... code S0..1CodeableConceptTW指明這種藥品的代碼
Binding: SNOMEDCTMedicationCodes (example): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... Slices for coding 1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:fda-medication-tw S1..1CodingTW此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣藥品及醫療器材代碼值集 (required): 應填入臺灣藥品及醫療器材代碼值集值集中的其中一個代碼。

..... coding:nhi-medication-tw S0..1CodingTW此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保用藥品項代碼值集 (required): 應填入臺灣健保用藥品項代碼值集值集中的其中一個代碼。

..... coding:rxnorm-medication-us-core S0..1CodingTWRxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入RxNorm藥品代碼值集值集中的其中一個代碼。

..... coding:atc-medication-code S0..1CodingTWATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 藥品藥理治療分類ATC碼值集 (required): 應填入藥品藥理治療分類ATC碼值集值集中的其中一個代碼。

..... coding:snomedct-medication-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... text S0..1string概念的文字表示法
... status 0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required): 應填入Medication Status Codes值集中的其中一個代碼

... manufacturer 0..1Reference(TW Core Organization Company)此藥品的製造商
... form S0..1CodeableConceptTWpowder | tablets | capsule +此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (example): 可參考SNOMEDCTFormCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... Slices for coding 1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:v3-orderableDrugForm S1..1CodingTW此為HL7總會維護的代碼系統,可免費使用,可優先選用此代碼。
Binding: 藥品劑型值集 (required)
..... coding:snomed-sct-form-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (required)
.... text S0..1string概念的文字表示法
... amount 0..1Ratio每包裝的藥品數量或容量
... ingredient 0..*BackboneElement有使用或沒有使用的藥品成份
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... item[x] 1..1實際的成份或內容物
..... itemCodeableConceptCodeableConcept(CodeableConceptTW)
..... itemReferenceReference(TW Core Medication | Substance)
.... isActive 0..1boolean有效成份指標
.... strength 0..1Ratio所含成份的劑量
... batch 0..1BackboneElement關於包裝藥品的細節
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... lotNumber 0..1string藥品的批號
.... expirationDate 0..1dateTime有效期限

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Medication.codeexampleSNOMEDCTMedicationCodes
Medication.code.coding:fda-medication-twrequiredTWMedicationFDA
Medication.code.coding:nhi-medication-twrequiredTWMedicationNHI (a valid code from 臺灣健保用藥品項)
Medication.code.coding:rxnorm-medication-us-corerequiredTWMedicationRXNORM
Medication.code.coding:atc-medication-coderequiredTWMedcationATC
Medication.code.coding:snomedct-medication-codesrequiredSNOMEDCTMedicationCodes
Medication.statusrequiredMedication Status Codes
Medication.formexampleSNOMEDCTFormCodes
Medication.form.coding:v3-orderableDrugFormrequiredOrderableDrugForm
Medication.form.coding:snomed-sct-form-codesrequiredSNOMEDCTFormCodes
NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*Medication藥品的定義
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Medication紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此Medication Resource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativeMedication Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier Σ0..*Identifier此藥品的業務用識別碼
... code S0..1CodeableConceptTW指明這種藥品的代碼
Binding: SNOMEDCTMedicationCodes (example): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:fda-medication-tw S1..1CodingTW此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣藥品及醫療器材代碼值集 (required): 應填入臺灣藥品及醫療器材代碼值集值集中的其中一個代碼。


..... coding:nhi-medication-tw S0..1CodingTW此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保用藥品項代碼值集 (required): 應填入臺灣健保用藥品項代碼值集值集中的其中一個代碼。


..... coding:rxnorm-medication-us-core S0..1CodingTWRxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入RxNorm藥品代碼值集值集中的其中一個代碼。


..... coding:atc-medication-code S0..1CodingTWATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 藥品藥理治療分類ATC碼值集 (required): 應填入藥品藥理治療分類ATC碼值集值集中的其中一個代碼。


..... coding:snomedct-medication-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


.... text SΣ0..1string概念的文字表示法
... status ?!Σ0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required): 應填入Medication Status Codes值集中的其中一個代碼

... manufacturer Σ0..1Reference(TW Core Organization Company)此藥品的製造商
... form S0..1CodeableConceptTWpowder | tablets | capsule +此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (example): 可參考SNOMEDCTFormCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:v3-orderableDrugForm S1..1CodingTW此為HL7總會維護的代碼系統,可免費使用,可優先選用此代碼。
Binding: 藥品劑型值集 (required)
..... coding:snomed-sct-form-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (required)
.... text SΣ0..1string概念的文字表示法
... amount Σ0..1Ratio每包裝的藥品數量或容量
... ingredient 0..*BackboneElement有使用或沒有使用的藥品成份
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... item[x] 1..1實際的成份或內容物
..... itemCodeableConceptCodeableConcept(CodeableConceptTW)
..... itemReferenceReference(TW Core Medication | Substance)
.... isActive 0..1boolean有效成份指標
.... strength 0..1Ratio所含成份的劑量
... batch 0..1BackboneElement關於包裝藥品的細節
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... lotNumber 0..1string藥品的批號
.... expirationDate 0..1dateTime有效期限

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Medication.codeexampleSNOMEDCTMedicationCodes
Medication.code.coding:fda-medication-twrequiredTWMedicationFDA
Medication.code.coding:nhi-medication-twrequiredTWMedicationNHI (a valid code from 臺灣健保用藥品項)
Medication.code.coding:rxnorm-medication-us-corerequiredTWMedicationRXNORM
Medication.code.coding:atc-medication-coderequiredTWMedcationATC
Medication.code.coding:snomedct-medication-codesrequiredSNOMEDCTMedicationCodes
Medication.statusrequiredMedication Status Codes
Medication.formexampleSNOMEDCTFormCodes
Medication.form.coding:v3-orderableDrugFormrequiredOrderableDrugForm
Medication.form.coding:snomed-sct-form-codesrequiredSNOMEDCTFormCodes

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf 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-4errorMedicationIf 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-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA 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()
NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*Medication藥品的定義
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Medication紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此Medication Resource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativeMedication Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier Σ0..*Identifier此藥品的業務用識別碼
... code S0..1CodeableConceptTW指明這種藥品的代碼
Binding: SNOMEDCTMedicationCodes (example): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:fda-medication-tw S1..1CodingTW此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣藥品及醫療器材代碼值集 (required): 應填入臺灣藥品及醫療器材代碼值集值集中的其中一個代碼。


..... coding:nhi-medication-tw S0..1CodingTW此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保用藥品項代碼值集 (required): 應填入臺灣健保用藥品項代碼值集值集中的其中一個代碼。


..... coding:rxnorm-medication-us-core S0..1CodingTWRxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入RxNorm藥品代碼值集值集中的其中一個代碼。


..... coding:atc-medication-code S0..1CodingTWATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 藥品藥理治療分類ATC碼值集 (required): 應填入藥品藥理治療分類ATC碼值集值集中的其中一個代碼。


..... coding:snomedct-medication-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


.... text SΣ0..1string概念的文字表示法
... status ?!Σ0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required): 應填入Medication Status Codes值集中的其中一個代碼

... manufacturer Σ0..1Reference(TW Core Organization Company)此藥品的製造商
... form S0..1CodeableConceptTWpowder | tablets | capsule +此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (example): 可參考SNOMEDCTFormCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:v3-orderableDrugForm S1..1CodingTW此為HL7總會維護的代碼系統,可免費使用,可優先選用此代碼。
Binding: 藥品劑型值集 (required)
..... coding:snomed-sct-form-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (required)
.... text SΣ0..1string概念的文字表示法
... amount Σ0..1Ratio每包裝的藥品數量或容量
... ingredient 0..*BackboneElement有使用或沒有使用的藥品成份
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... item[x] 1..1實際的成份或內容物
..... itemCodeableConceptCodeableConcept(CodeableConceptTW)
..... itemReferenceReference(TW Core Medication | Substance)
.... isActive 0..1boolean有效成份指標
.... strength 0..1Ratio所含成份的劑量
... batch 0..1BackboneElement關於包裝藥品的細節
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... lotNumber 0..1string藥品的批號
.... expirationDate 0..1dateTime有效期限

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Medication.codeexampleSNOMEDCTMedicationCodes
Medication.code.coding:fda-medication-twrequiredTWMedicationFDA
Medication.code.coding:nhi-medication-twrequiredTWMedicationNHI (a valid code from 臺灣健保用藥品項)
Medication.code.coding:rxnorm-medication-us-corerequiredTWMedicationRXNORM
Medication.code.coding:atc-medication-coderequiredTWMedcationATC
Medication.code.coding:snomedct-medication-codesrequiredSNOMEDCTMedicationCodes
Medication.statusrequiredMedication Status Codes
Medication.formexampleSNOMEDCTFormCodes
Medication.form.coding:v3-orderableDrugFormrequiredOrderableDrugForm
Medication.form.coding:snomed-sct-form-codesrequiredSNOMEDCTFormCodes

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf 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-4errorMedicationIf 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-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA 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()

This structure is derived from Medication

Summary

Mandatory: 0 element (4 nested mandatory elements)
Must-Support: 12 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Medication.code.coding is sliced based on the value of pattern:$this
  • The element Medication.form.coding is sliced based on the value of pattern:$this

Differential View

This structure is derived from Medication

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*Medication藥品的定義
... id 0..1id不重複的ID用以識別儲存在特定FHIR Server中的Medication紀錄,通常又稱為邏輯性ID。
... meta 0..1Meta此Medication Resource的metadata
... implicitRules 0..1uri創建此內容所依據的一組規則
... text S0..1NarrativeMedication Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier 0..*Identifier此藥品的業務用識別碼
... code S0..1CodeableConceptTW指明這種藥品的代碼
Binding: SNOMEDCTMedicationCodes (example): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... Slices for coding 1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:fda-medication-tw S1..1CodingTW此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣藥品及醫療器材代碼值集 (required): 應填入臺灣藥品及醫療器材代碼值集值集中的其中一個代碼。

..... coding:nhi-medication-tw S0..1CodingTW此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保用藥品項代碼值集 (required): 應填入臺灣健保用藥品項代碼值集值集中的其中一個代碼。

..... coding:rxnorm-medication-us-core S0..1CodingTWRxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入RxNorm藥品代碼值集值集中的其中一個代碼。

..... coding:atc-medication-code S0..1CodingTWATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 藥品藥理治療分類ATC碼值集 (required): 應填入藥品藥理治療分類ATC碼值集值集中的其中一個代碼。

..... coding:snomedct-medication-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... text S0..1string概念的文字表示法
... status 0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required): 應填入Medication Status Codes值集中的其中一個代碼

... manufacturer 0..1Reference(TW Core Organization Company)此藥品的製造商
... form S0..1CodeableConceptTWpowder | tablets | capsule +此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (example): 可參考SNOMEDCTFormCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... Slices for coding 1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:v3-orderableDrugForm S1..1CodingTW此為HL7總會維護的代碼系統,可免費使用,可優先選用此代碼。
Binding: 藥品劑型值集 (required)
..... coding:snomed-sct-form-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (required)
.... text S0..1string概念的文字表示法
... amount 0..1Ratio每包裝的藥品數量或容量
... ingredient 0..*BackboneElement有使用或沒有使用的藥品成份
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... item[x] 1..1實際的成份或內容物
..... itemCodeableConceptCodeableConcept(CodeableConceptTW)
..... itemReferenceReference(TW Core Medication | Substance)
.... isActive 0..1boolean有效成份指標
.... strength 0..1Ratio所含成份的劑量
... batch 0..1BackboneElement關於包裝藥品的細節
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension 0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... lotNumber 0..1string藥品的批號
.... expirationDate 0..1dateTime有效期限

doco Documentation for this format

Terminology Bindings (Differential)

PathConformanceValueSet
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Medication.codeexampleSNOMEDCTMedicationCodes
Medication.code.coding:fda-medication-twrequiredTWMedicationFDA
Medication.code.coding:nhi-medication-twrequiredTWMedicationNHI (a valid code from 臺灣健保用藥品項)
Medication.code.coding:rxnorm-medication-us-corerequiredTWMedicationRXNORM
Medication.code.coding:atc-medication-coderequiredTWMedcationATC
Medication.code.coding:snomedct-medication-codesrequiredSNOMEDCTMedicationCodes
Medication.statusrequiredMedication Status Codes
Medication.formexampleSNOMEDCTFormCodes
Medication.form.coding:v3-orderableDrugFormrequiredOrderableDrugForm
Medication.form.coding:snomed-sct-form-codesrequiredSNOMEDCTFormCodes

Key Elements View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*Medication藥品的定義
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Medication紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此Medication Resource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativeMedication Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier Σ0..*Identifier此藥品的業務用識別碼
... code S0..1CodeableConceptTW指明這種藥品的代碼
Binding: SNOMEDCTMedicationCodes (example): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:fda-medication-tw S1..1CodingTW此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣藥品及醫療器材代碼值集 (required): 應填入臺灣藥品及醫療器材代碼值集值集中的其中一個代碼。


..... coding:nhi-medication-tw S0..1CodingTW此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保用藥品項代碼值集 (required): 應填入臺灣健保用藥品項代碼值集值集中的其中一個代碼。


..... coding:rxnorm-medication-us-core S0..1CodingTWRxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入RxNorm藥品代碼值集值集中的其中一個代碼。


..... coding:atc-medication-code S0..1CodingTWATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 藥品藥理治療分類ATC碼值集 (required): 應填入藥品藥理治療分類ATC碼值集值集中的其中一個代碼。


..... coding:snomedct-medication-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


.... text SΣ0..1string概念的文字表示法
... status ?!Σ0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required): 應填入Medication Status Codes值集中的其中一個代碼

... manufacturer Σ0..1Reference(TW Core Organization Company)此藥品的製造商
... form S0..1CodeableConceptTWpowder | tablets | capsule +此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (example): 可參考SNOMEDCTFormCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:v3-orderableDrugForm S1..1CodingTW此為HL7總會維護的代碼系統,可免費使用,可優先選用此代碼。
Binding: 藥品劑型值集 (required)
..... coding:snomed-sct-form-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (required)
.... text SΣ0..1string概念的文字表示法
... amount Σ0..1Ratio每包裝的藥品數量或容量
... ingredient 0..*BackboneElement有使用或沒有使用的藥品成份
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... item[x] 1..1實際的成份或內容物
..... itemCodeableConceptCodeableConcept(CodeableConceptTW)
..... itemReferenceReference(TW Core Medication | Substance)
.... isActive 0..1boolean有效成份指標
.... strength 0..1Ratio所含成份的劑量
... batch 0..1BackboneElement關於包裝藥品的細節
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... lotNumber 0..1string藥品的批號
.... expirationDate 0..1dateTime有效期限

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Medication.codeexampleSNOMEDCTMedicationCodes
Medication.code.coding:fda-medication-twrequiredTWMedicationFDA
Medication.code.coding:nhi-medication-twrequiredTWMedicationNHI (a valid code from 臺灣健保用藥品項)
Medication.code.coding:rxnorm-medication-us-corerequiredTWMedicationRXNORM
Medication.code.coding:atc-medication-coderequiredTWMedcationATC
Medication.code.coding:snomedct-medication-codesrequiredSNOMEDCTMedicationCodes
Medication.statusrequiredMedication Status Codes
Medication.formexampleSNOMEDCTFormCodes
Medication.form.coding:v3-orderableDrugFormrequiredOrderableDrugForm
Medication.form.coding:snomed-sct-form-codesrequiredSNOMEDCTFormCodes

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf 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-4errorMedicationIf 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-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA 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()

Snapshot View

NameFlagsCard.TypeDescription & Constraintsdoco
.. Medication 0..*Medication藥品的定義
... id Σ0..1id不重複的ID用以識別儲存在特定FHIR Server中的Medication紀錄,通常又稱為邏輯性ID。
... meta Σ0..1Meta此Medication Resource的metadata
... implicitRules ?!Σ0..1uri創建此內容所依據的一組規則
... text S0..1NarrativeMedication Resource之內容摘要以供人閱讀
... contained 0..*Resource內嵌的(contained)、行內的Resources
... extension 0..*Extension擴充的資料項目
... modifierExtension ?!0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
... identifier Σ0..*Identifier此藥品的業務用識別碼
... code S0..1CodeableConceptTW指明這種藥品的代碼
Binding: SNOMEDCTMedicationCodes (example): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:fda-medication-tw S1..1CodingTW此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣藥品及醫療器材代碼值集 (required): 應填入臺灣藥品及醫療器材代碼值集值集中的其中一個代碼。


..... coding:nhi-medication-tw S0..1CodingTW此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保用藥品項代碼值集 (required): 應填入臺灣健保用藥品項代碼值集值集中的其中一個代碼。


..... coding:rxnorm-medication-us-core S0..1CodingTWRxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入RxNorm藥品代碼值集值集中的其中一個代碼。


..... coding:atc-medication-code S0..1CodingTWATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 藥品藥理治療分類ATC碼值集 (required): 應填入藥品藥理治療分類ATC碼值集值集中的其中一個代碼。


..... coding:snomedct-medication-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考SNOMEDCTMedicationCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。


.... text SΣ0..1string概念的文字表示法
... status ?!Σ0..1codeactive | inactive | entered-in-error
Binding: Medication Status Codes (required): 應填入Medication Status Codes值集中的其中一個代碼

... manufacturer Σ0..1Reference(TW Core Organization Company)此藥品的製造商
... form S0..1CodeableConceptTWpowder | tablets | capsule +此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (example): 可參考SNOMEDCTFormCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。

.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
Slice: Unordered, Open by value:url
.... Slices for coding S1..*CodingTW由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
..... coding:v3-orderableDrugForm S1..1CodingTW此為HL7總會維護的代碼系統,可免費使用,可優先選用此代碼。
Binding: 藥品劑型值集 (required)
..... coding:snomed-sct-form-codes S0..1CodingTW此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTFormCodes (required)
.... text SΣ0..1string概念的文字表示法
... amount Σ0..1Ratio每包裝的藥品數量或容量
... ingredient 0..*BackboneElement有使用或沒有使用的藥品成份
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... item[x] 1..1實際的成份或內容物
..... itemCodeableConceptCodeableConcept(CodeableConceptTW)
..... itemReferenceReference(TW Core Medication | Substance)
.... isActive 0..1boolean有效成份指標
.... strength 0..1Ratio所含成份的劑量
... batch 0..1BackboneElement關於包裝藥品的細節
.... id 0..1string唯一可識別ID,以供資料項目間相互參照。
.... extension 0..*Extension擴充的資料項目
.... modifierExtension ?!Σ0..*Extension此擴充的資料項目可能會完全修正或改變其他資料項目的意涵,需特別留意。
.... lotNumber 0..1string藥品的批號
.... expirationDate 0..1dateTime有效期限

doco Documentation for this format

Terminology Bindings

PathConformanceValueSet
Medication.languagepreferredCommonLanguages
Additional Bindings Purpose
AllLanguages Max Binding
Medication.codeexampleSNOMEDCTMedicationCodes
Medication.code.coding:fda-medication-twrequiredTWMedicationFDA
Medication.code.coding:nhi-medication-twrequiredTWMedicationNHI (a valid code from 臺灣健保用藥品項)
Medication.code.coding:rxnorm-medication-us-corerequiredTWMedicationRXNORM
Medication.code.coding:atc-medication-coderequiredTWMedcationATC
Medication.code.coding:snomedct-medication-codesrequiredSNOMEDCTMedicationCodes
Medication.statusrequiredMedication Status Codes
Medication.formexampleSNOMEDCTFormCodes
Medication.form.coding:v3-orderableDrugFormrequiredOrderableDrugForm
Medication.form.coding:snomed-sct-form-codesrequiredSNOMEDCTFormCodes

Constraints

IdGradePath(s)DetailsRequirements
dom-2errorMedicationIf the resource is contained in another resource, it SHALL NOT contain nested Resources
: contained.contained.empty()
dom-3errorMedicationIf 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-4errorMedicationIf 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-5errorMedicationIf a resource is contained in another resource, it SHALL NOT have a security label
: contained.meta.security.empty()
dom-6best practiceMedicationA 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()

This structure is derived from Medication

Summary

Mandatory: 0 element (4 nested mandatory elements)
Must-Support: 12 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element Medication.code.coding is sliced based on the value of pattern:$this
  • The element Medication.form.coding is sliced based on the value of pattern:$this

 

Other representations of profile: CSV, Excel, Schematron

Notes:

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

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

  1. 建議應該(SHOULD) 支援透過查詢參數 _id 查詢所有Medication:
    (如何透過token查詢)
    GET [base]/Medication?_id=[id]
    GET [base]/Medication/[id]

    例子:
    (1) GET [base]/Medication?_id=0621
    (2) GET [base]/Medication/0621

  2. 建議應該(SHOULD) 支援透過查詢參數 code 查詢所有Medication:
    (如何透過token查詢)
    GET [base]/Medication?code={system|}[code]

    例子:
    (1) GET [base]/Medication?code=https://twcore.mohw.gov.tw/ig/twcore/CodeSystem/medication-fda-tw|衛署藥輸字第025485號