臺灣核心實作指引(TW Core IG)
0.3.3 - 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.3 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/MOHW-TWCoreIG/cctwFHIRterm/ and changes regularly. See the Directory of published versions

Resource Profile: TW Core MedicationStatement

Official URL: https://twcore.mohw.gov.tw/ig/twcore/StructureDefinition/MedicationStatement-twcore Version: 0.3.3
Active as of 2025-11-21 Computable Name: TWCoreMedicationStatement

此臺灣核心-用藥聲明(TW Core MedicationStatement) Profile說明本IG如何進一步定義FHIR的MedicationStatement Resource以呈現用藥聲明的詳細資料。

Resource MedicationStatement - 內容

病人正在用藥的紀錄。一份用藥聲明 (MedicationStatement) 可能表明病人目前正在、曾經或將來會使用藥品。此資訊的來源可能是病人、重要他人(如家庭成員或配偶)或臨床醫生。病人就診或住院期間的病史記錄過程是獲取此類資訊的常見場景。藥品資訊可能來自病人的記憶、處方瓶或病人、臨床醫師或其他方維護的藥品清單。

用藥聲明 (medication statement) 與給藥(medication administration)之間的主要區別在於:給藥具有完整的用藥資訊,並且基於實際由給藥者提供的用藥資訊為基礎。相對而言,用藥聲明通常較為籠統,不會具體記錄用藥的日期或時間,實際上,我們只知道有來源報告說病人目前正在服用這種藥品,但關於用藥的時間、劑量、比例甚至藥物產品的詳細資訊可能不完整、缺失或不太精確。正如前面所提到的,用藥聲明的資訊可能來自病人的記憶、處方瓶或病人、臨床醫生或其他人維護的藥品清單。相比之下,給藥紀錄則更為正式,包含了詳細的用藥資訊。

範圍與使用

用藥聲明 (MedicationStatement) 的常見應用包括:

  • 記錄非處方藥及/或娛樂性藥品的使用。
  • 在病人入院時記錄其正使用的藥品清單。
  • 在病人檔案中總結其正使用的藥品 (active medications)。

用藥聲明 (MedicationStatement) 可用於記錄物質濫用(substance abuse)或其他作用劑(agents)的使用,例如:煙草或酒精。需要這類紀錄的情境是當這些物質需要被包含在臨床決策支援系統的檢核中—像是藥物相互作用的檢核,它將被視為正在服用的藥品清單的一部分。若目標是為了紀錄社交史並加入額外資訊,像是戒菸的願望、每日使用量、及負面的健康影響,則建議將這些資訊記錄為檢驗檢查 (Observation),以便於後續填入社交史中。

這個resource本身不直接產生藥品清單,但它可以產生個人的用藥聲明,這些聲明後續可在 List resource 中被用來構建不同類型的藥品清單。值得注意的是,其他類型的藥品清單也可透過其他Pharmacy resources,像是MedicationRequest、MedicationAdministration來建立。

用藥聲明不屬於「開立處方 -> 調劑 -> 給藥」過程中的一部分,而是病人、其重要他人或臨床醫生所報告的情況,指出開立處方、調劑或給藥的一個或多個動作已經發生,從而認為病人正在使用、已經使用或將要使用某種特定的藥品。

從FHIR工作流程的視角來看,MedicationStatement是一個事件類型的resource——詳見Workflow Event

界限與關聯

用藥聲明 (MedicationStatement) resource 用於記錄病人報告的藥品或物質使用情況,包括正在使用、未使用、過去使用過或未來可能使用的。它也可用於記錄從其他記錄(如MedicationRequest)中衍生的藥品使用情況。該聲明不用於開立醫令請求藥品、供應品或設備。當需要請求藥品、供應品或設備,且有關於其使用的病人或指示時,應使用藥品請求(MedicationRequest)、供應品請求(SupplyRequest) 或設備請求(DeviceRequest)。

藥品領域包括多個相關resources

Resource 說明
MedicationRequest(藥品請求) 一個關於供應藥品及病人服藥或用藥指示的醫令。
MedicationDispense(配藥或調劑藥品) 提供一批藥品,旨在隨後由病人使用或服用(通常是回應處方)。
MedicationAdministration(給藥) 當病人實際使用藥品或者以其他方式給予病人藥品時。
MedicationStatement (用藥聲明) 這是一項紀錄,記錄了病人服用藥品或藥品已經給予病人,其中紀錄是基於病人或另一位臨床醫生的報告。藥品聲明不是「處方開立->配藥->給藥」過程中的一部分,而是一個報告,表明這樣的過程(或至少其一部分)確實發生了,從而認為病人已經接受了特定的藥品。

這個 resource 與藥品請求(MedicationRequest)、配藥或調劑藥品(MedicationDispense) 和給藥( MedicationAdministration) 不同。這些 resources 分別指向特定的事件 — 處方、藥品的具體提供或給藥。用藥聲明 (MedicationStatement) 是一個更廣泛的聲明,涵蓋更長的時間範圍,且與特定事件無關。任何前述三種類型的 resource 實例的存在,都可以用來推斷一份用藥聲明。然而,用藥聲明也可以基於其他資訊來取得,包括病人或護理人員的聲明、實驗室檢驗的結果等。

這個 resource 被醫療不良事件(AdverseEvent)、目標(Goal)、用藥聲明(MedicationStatement)和檢驗檢查(Observation)參照。

Usages:

You can also check for usages in the FHIR IG Statistics

Formal Views of Profile Content

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

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationStatement 0..* MedicationStatement 病人正在服用的藥品紀錄
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此MedicationStatement Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative MedicationStatement Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 用藥聲明的外部識別碼
... basedOn Σ 0..* Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) 此用藥聲明是為了達成或實現哪個計劃、提案或醫令
... partOf Σ 0..* Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) 參照事件的一部分
... status ?!SΣ 1..1 code active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼
... statusReason 0..* CodeableConceptTW 當前狀態的原因
Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... category SΣ 0..1 CodeableConceptTW 藥品使用的類型
Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... Slices for medication[x] SΣ 1..1 所提供的藥品
Slice: Unordered, Closed by type:$this
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
.... medicationCodeableConcept CodeableConcept(CodeableConceptTW)
.... medicationReference Reference(TW Core Medication)
.... medication[x]:medicationReference Σ 0..1 Reference(TW Core Medication) What medication was taken
.... medication[x]:medicationCodeableConcept Σ 0..1 CodeableConceptTW 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
..... Slices for coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
...... coding:fda-medication-tw SΣ 0..1 CodingTW 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-ch-herb-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:rxnorm-medication-us-core SΣ 0..1 CodingTW RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:atc-medication-code SΣ 0..1 CodingTW ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:snomedct-medication-codes SΣ 0..1 CodingTW 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... text SΣ 0..1 string 概念的文字表示法
... subject SΣ 1..1 Reference(TW Core Patient | Group) 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。
... context SΣ 0..1 Reference(TW Core Encounter | EpisodeOfCare) 與此用藥聲明相關的就醫事件(Encounter / Episode)
... effective[x] SΣ 0..1 用藥的日期/時間或間隔
.... effectiveDateTime dateTime
.... effectivePeriod Period
... dateAsserted Σ 0..1 dateTime 此聲明是何時提出的?
... informationSource 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) 提供有關服用此藥品資訊的個人或機構
... derivedFrom 0..* Reference(Resource) 額外的補充資料
... reasonCode 0..* CodeableConceptTW 指明目前正在使用的藥品
Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... reasonReference 0..* Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) 證明目前正在/曾經用藥原因之Condition或Observation
... note 0..* Annotation 有關此聲明的更多資訊
... dosage S 0..* Dosage 藥品目前正被/曾經被服用或應該如何服用的細節
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... sequence SΣ 0..1 integer 劑量指示的順序
.... text SΣ 0..1 string 純文字表述的劑量指示,例如:SIG。
.... additionalInstruction Σ 0..* CodeableConceptTW 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」
Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... patientInstruction SΣ 0..1 string 以病人或消費者為導向的指示
.... timing SΣ 0..1 Timing 應該何時給藥;時間的寫法請參照Timimg datatype。
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... event Σ 0..* dateTime 事件發生的時間
..... repeat SΣC 0..1 Element 事件定期重複發生的時間
Constraints: tim-1, tim-2, tim-4, tim-5, tim-6, tim-7, tim-8, tim-9, tim-10
...... bounds[x] Σ 0..1 時間或期間長度/長度範圍,或(開始和/或結束)限制
....... boundsDuration Duration
....... boundsRange Range
....... boundsPeriod Period
...... count SΣ 0..1 positiveInt 重複的次數
...... countMax Σ 0..1 positiveInt 重複的最大次數
...... duration SΣ 0..1 decimal 此事件持續多久時間
...... durationMax Σ 0..1 decimal 此事件持續多久時間 (最長時間/最大值)
...... durationUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... frequency SΣ 0..1 positiveInt 此事件於每一期間的發生頻率
...... frequencyMax Σ 0..1 positiveInt 此事件於每一期間的最大發生頻率
...... period SΣ 0..1 decimal 此事件於特定時間區間所發生的頻率
...... periodMax Σ 0..1 decimal 時間區間的上限(3-4小時)
...... periodUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... dayOfWeek SΣ 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼
...... timeOfDay SΣ 0..* time 一天中的活動時間
...... when Σ 0..* code 事件發生的時間區間之代碼
Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼
...... offset Σ 0..1 unsignedInt 事件的分鐘數(之前或之後)
..... code SΣ 0..1 CodeableConceptTW BID | TID | QID | AM | PM | QD | QOD | +
Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。
...... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
...... text SΣ 0..1 string 概念的文字標記法
.... asNeeded[x] Σ 0..1 「根據(對x的)需要」服用 Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... asNeededBoolean boolean
..... asNeededCodeableConcept CodeableConcept
.... site Σ 0..1 CodeableConcept 用藥之身體部位
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... route SΣ 0..1 CodeableConceptTW 藥品應如何進入體內
Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.
..... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... text SΣ 0..1 string 概念的文字標記法
.... method Σ 0..1 CodeableConceptTW 用藥的技術
Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... doseAndRate Σ 0..* Element 用藥量
..... type Σ 0..1 CodeableConceptTW 特定劑量或比率種類
Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... dose[x] SΣ 0..1 每一劑量的藥量
...... doseRange Range
...... doseQuantity Quantity(SimpleQuantity)
..... rate[x] SΣ 0..1 每時間單位內的用藥量
...... rateRatio Ratio
...... rateRange Range
...... rateQuantity Quantity(SimpleQuantity)
.... maxDosePerPeriod Σ 0..1 Ratio 每時間單位內用藥的上限
.... maxDosePerAdministration Σ 0..1 SimpleQuantity(4.0.1) 每次用藥的上限
.... maxDosePerLifetime Σ 0..1 SimpleQuantity(4.0.1) 病人一生中用藥的上限

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationStatement.​language Base preferred Common Languages 📦4.0.1 FHIR Std.
MedicationStatement.​status Base required Medication status codes 📍4.0.1 FHIR Std.
MedicationStatement.​statusReason Base extensible SNOMED CT Drug Therapy Status codes 📦4.0.1 FHIR Std.
MedicationStatement.​category Base preferred Medication usage category codes 📦4.0.1 FHIR Std.
MedicationStatement.​medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:fda-medication-tw Base required 臺灣食藥署藥品及醫療器材代碼值集 📦0.3.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-tw Base required 臺灣健保署用藥品項代碼值集 📦2022-07-28 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-ch-herb-tw Base required 臺灣健保署中藥用藥品項值集 📦2024-05-31 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:rxnorm-medication-us-core Base required RxNorm藥品代碼值集 📦3.0.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:atc-medication-code Base required 臺灣食藥署藥品藥理治療分類ATC碼值集 📦2022-10-24 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:snomedct-medication-codes Base required SNOMED CT Medication Codes 📦4.0.1 FHIR Std.
MedicationStatement.​reasonCode Base extensible Condition/Problem/Diagnosis Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.additionalInstruction Base extensible SNOMED CT Additional Dosage Instructions 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​durationUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​periodUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​dayOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​when Base required EventTiming 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code Base preferred TimingAbbreviation 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code.coding Base extensible HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 📦0.3.0 This IG
MedicationStatement.​dosage.asNeeded[x] Base extensible SNOMED CT Medication As Needed Reason Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.site Base extensible SNOMED CT Anatomical Structure for Administration Site Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.route Base example SNOMED CT Route Codes 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.route.coding Base extensible SNOMED CT + 臺灣健保署給藥途徑值集 📦0.3.0 This IG
MedicationStatement.​dosage.method Base extensible SNOMED CT Administration Method Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.doseAndRate.type Base example DoseAndRateType 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationStatement If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationStatement 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 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-4 error MedicationStatement If 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-5 error MedicationStatement If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationStatement A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
tim-1 error MedicationStatement.dosage.timing.repeat if there's a duration, there needs to be duration units duration.empty() or durationUnit.exists()
tim-2 error MedicationStatement.dosage.timing.repeat if there's a period, there needs to be period units period.empty() or periodUnit.exists()
tim-4 error MedicationStatement.dosage.timing.repeat duration SHALL be a non-negative value duration.exists() implies duration >= 0
tim-5 error MedicationStatement.dosage.timing.repeat period SHALL be a non-negative value period.exists() implies period >= 0
tim-6 error MedicationStatement.dosage.timing.repeat If there's a periodMax, there must be a period periodMax.empty() or period.exists()
tim-7 error MedicationStatement.dosage.timing.repeat If there's a durationMax, there must be a duration durationMax.empty() or duration.exists()
tim-8 error MedicationStatement.dosage.timing.repeat If there's a countMax, there must be a count countMax.empty() or count.exists()
tim-9 error MedicationStatement.dosage.timing.repeat If there's an offset, there must be a when (and not C, CM, CD, CV) offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))
tim-10 error MedicationStatement.dosage.timing.repeat If there's a timeOfDay, there cannot be a when, or vice versa timeOfDay.empty() or when.empty()

This structure is derived from MedicationStatement

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationStatement 0..* MedicationStatement 病人正在服用的藥品紀錄
... id 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。
... meta 0..1 Meta 此MedicationStatement Resource的metadata
... implicitRules 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative MedicationStatement Resource之內容摘要以供人閱讀
... identifier S 0..* Identifier 用藥聲明的外部識別碼
... basedOn 0..* Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) 此用藥聲明是為了達成或實現哪個計劃、提案或醫令
... partOf 0..* Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) 參照事件的一部分
... status S 1..1 code active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼
... statusReason 0..* CodeableConceptTW 當前狀態的原因
Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... category S 0..1 CodeableConceptTW 藥品使用的類型
Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... Slices for medication[x] S 1..1 所提供的藥品
Slice: Unordered, Open by type:$this
.... medicationCodeableConcept CodeableConcept(CodeableConceptTW)
.... medicationReference Reference(TW Core Medication)
.... medication[x]:medicationReference 0..1 Reference(TW Core Medication) What medication was taken
.... medication[x]:medicationCodeableConcept 0..1 CodeableConceptTW 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
..... Slices for coding 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
...... coding:fda-medication-tw S 0..1 CodingTW 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-tw S 0..1 CodingTW 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-ch-herb-tw 0..1 CodingTW 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:rxnorm-medication-us-core S 0..1 CodingTW RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:atc-medication-code S 0..1 CodingTW ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:snomedct-medication-codes S 0..1 CodingTW 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... subject S 1..1 Reference(TW Core Patient | Group) 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。
... context S 0..1 Reference(TW Core Encounter | EpisodeOfCare) 與此用藥聲明相關的就醫事件(Encounter / Episode)
... effective[x] S 0..1 dateTime, Period 用藥的日期/時間或間隔
... dateAsserted 0..1 dateTime 此聲明是何時提出的?
... informationSource 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) 提供有關服用此藥品資訊的個人或機構
... derivedFrom 0..* Reference(Resource) 額外的補充資料
... reasonCode 0..* CodeableConceptTW 指明目前正在使用的藥品
Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... reasonReference 0..* Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) 證明目前正在/曾經用藥原因之Condition或Observation
... note 0..* Annotation 有關此聲明的更多資訊
... dosage S 0..* Dosage 藥品目前正被/曾經被服用或應該如何服用的細節
.... sequence S 0..1 integer 劑量指示的順序
.... text S 0..1 string 純文字表述的劑量指示,例如:SIG。
.... additionalInstruction 0..* CodeableConceptTW 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」
Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... patientInstruction S 0..1 string 以病人或消費者為導向的指示
.... timing S 0..1 Timing 應該何時給藥;時間的寫法請參照Timimg datatype。
..... event 0..* dateTime 事件發生的時間
..... repeat S 0..1 Element 事件定期重複發生的時間
...... bounds[x] 0..1 Duration, Range, Period 時間或期間長度/長度範圍,或(開始和/或結束)限制
...... count S 0..1 positiveInt 重複的次數
...... countMax 0..1 positiveInt 重複的最大次數
...... duration S 0..1 decimal 此事件持續多久時間
...... durationMax 0..1 decimal 此事件持續多久時間 (最長時間/最大值)
...... durationUnit S 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... frequency S 0..1 positiveInt 此事件於每一期間的發生頻率
...... frequencyMax 0..1 positiveInt 此事件於每一期間的最大發生頻率
...... period S 0..1 decimal 此事件於特定時間區間所發生的頻率
...... periodMax 0..1 decimal 時間區間的上限(3-4小時)
...... periodUnit S 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... dayOfWeek S 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼
...... timeOfDay S 0..* time 一天中的活動時間
...... when 0..* code 事件發生的時間區間之代碼
Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼
...... offset 0..1 unsignedInt 事件的分鐘數(之前或之後)
..... code S 0..1 CodeableConceptTW BID | TID | QID | AM | PM | QD | QOD | +
Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。
...... coding 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
...... text S 0..1 string 概念的文字標記法
.... asNeeded[x] 0..1 boolean, CodeableConcept 「根據(對x的)需要」服用 Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... site 0..1 CodeableConcept 用藥之身體部位
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... route S 0..1 CodeableConceptTW 藥品應如何進入體內
..... coding 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... text S 0..1 string 概念的文字標記法
.... method 0..1 CodeableConceptTW 用藥的技術
Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... doseAndRate 0..* Element 用藥量
..... type 0..1 CodeableConceptTW 特定劑量或比率種類
Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... dose[x] S 0..1 Range, SimpleQuantity(4.0.1) 每一劑量的藥量
..... rate[x] S 0..1 Ratio, Range, SimpleQuantity(4.0.1) 每時間單位內的用藥量
.... maxDosePerPeriod 0..1 Ratio 每時間單位內用藥的上限
.... maxDosePerAdministration 0..1 SimpleQuantity(4.0.1) 每次用藥的上限
.... maxDosePerLifetime 0..1 SimpleQuantity(4.0.1) 病人一生中用藥的上限

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
MedicationStatement.​language Base preferred Common Languages 📦4.0.1 FHIR Std.
MedicationStatement.​status Base required Medication status codes 📍4.0.1 FHIR Std.
MedicationStatement.​statusReason Base extensible SNOMED CT Drug Therapy Status codes 📦4.0.1 FHIR Std.
MedicationStatement.​category Base preferred Medication usage category codes 📦4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:fda-medication-tw Base required 臺灣食藥署藥品及醫療器材代碼值集 📦0.3.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-tw Base required 臺灣健保署用藥品項代碼值集 📦2022-07-28 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-ch-herb-tw Base required 臺灣健保署中藥用藥品項值集 📦2024-05-31 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:rxnorm-medication-us-core Base required RxNorm藥品代碼值集 📦3.0.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:atc-medication-code Base required 臺灣食藥署藥品藥理治療分類ATC碼值集 📦2022-10-24 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:snomedct-medication-codes Base required SNOMED CT Medication Codes 📦4.0.1 FHIR Std.
MedicationStatement.​reasonCode Base extensible Condition/Problem/Diagnosis Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.additionalInstruction Base extensible SNOMED CT Additional Dosage Instructions 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​durationUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​periodUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​dayOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​when Base required EventTiming 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code Base preferred TimingAbbreviation 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code.coding Base extensible HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 📦0.3.0 This IG
MedicationStatement.​dosage.asNeeded[x] Base extensible SNOMED CT Medication As Needed Reason Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.site Base extensible SNOMED CT Anatomical Structure for Administration Site Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.route.coding Base extensible SNOMED CT + 臺灣健保署給藥途徑值集 📦0.3.0 This IG
MedicationStatement.​dosage.method Base extensible SNOMED CT Administration Method Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.doseAndRate.type Base example DoseAndRateType 📦4.0.1 FHIR Std.
NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationStatement 0..* MedicationStatement 病人正在服用的藥品紀錄
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此MedicationStatement Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative MedicationStatement Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 用藥聲明的外部識別碼
... basedOn Σ 0..* Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) 此用藥聲明是為了達成或實現哪個計劃、提案或醫令
... partOf Σ 0..* Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) 參照事件的一部分
... status ?!SΣ 1..1 code active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼
... statusReason 0..* CodeableConceptTW 當前狀態的原因
Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... category SΣ 0..1 CodeableConceptTW 藥品使用的類型
Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... Slices for medication[x] SΣ 1..1 所提供的藥品
Slice: Unordered, Closed by type:$this
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
.... medicationCodeableConcept CodeableConcept(CodeableConceptTW)
.... medicationReference Reference(TW Core Medication)
.... medication[x]:medicationReference Σ 0..1 Reference(TW Core Medication) What medication was taken
.... medication[x]:medicationCodeableConcept Σ 0..1 CodeableConceptTW 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
..... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
..... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
..... Slices for coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
...... coding:fda-medication-tw SΣ 0..1 CodingTW 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-ch-herb-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:rxnorm-medication-us-core SΣ 0..1 CodingTW RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:atc-medication-code SΣ 0..1 CodingTW ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:snomedct-medication-codes SΣ 0..1 CodingTW 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... text SΣ 0..1 string 概念的文字表示法
... subject SΣ 1..1 Reference(TW Core Patient | Group) 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。
... context SΣ 0..1 Reference(TW Core Encounter | EpisodeOfCare) 與此用藥聲明相關的就醫事件(Encounter / Episode)
... effective[x] SΣ 0..1 用藥的日期/時間或間隔
.... effectiveDateTime dateTime
.... effectivePeriod Period
... dateAsserted Σ 0..1 dateTime 此聲明是何時提出的?
... informationSource 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) 提供有關服用此藥品資訊的個人或機構
... derivedFrom 0..* Reference(Resource) 額外的補充資料
... reasonCode 0..* CodeableConceptTW 指明目前正在使用的藥品
Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... reasonReference 0..* Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) 證明目前正在/曾經用藥原因之Condition或Observation
... note 0..* Annotation 有關此聲明的更多資訊
... dosage S 0..* Dosage 藥品目前正被/曾經被服用或應該如何服用的細節
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... sequence SΣ 0..1 integer 劑量指示的順序
.... text SΣ 0..1 string 純文字表述的劑量指示,例如:SIG。
.... additionalInstruction Σ 0..* CodeableConceptTW 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」
Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... patientInstruction SΣ 0..1 string 以病人或消費者為導向的指示
.... timing SΣ 0..1 Timing 應該何時給藥;時間的寫法請參照Timimg datatype。
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... event Σ 0..* dateTime 事件發生的時間
..... repeat SΣC 0..1 Element 事件定期重複發生的時間
Constraints: tim-1, tim-2, tim-4, tim-5, tim-6, tim-7, tim-8, tim-9, tim-10
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... bounds[x] Σ 0..1 時間或期間長度/長度範圍,或(開始和/或結束)限制
....... boundsDuration Duration
....... boundsRange Range
....... boundsPeriod Period
...... count SΣ 0..1 positiveInt 重複的次數
...... countMax Σ 0..1 positiveInt 重複的最大次數
...... duration SΣ 0..1 decimal 此事件持續多久時間
...... durationMax Σ 0..1 decimal 此事件持續多久時間 (最長時間/最大值)
...... durationUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... frequency SΣ 0..1 positiveInt 此事件於每一期間的發生頻率
...... frequencyMax Σ 0..1 positiveInt 此事件於每一期間的最大發生頻率
...... period SΣ 0..1 decimal 此事件於特定時間區間所發生的頻率
...... periodMax Σ 0..1 decimal 時間區間的上限(3-4小時)
...... periodUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... dayOfWeek SΣ 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼
...... timeOfDay SΣ 0..* time 一天中的活動時間
...... when Σ 0..* code 事件發生的時間區間之代碼
Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼
...... offset Σ 0..1 unsignedInt 事件的分鐘數(之前或之後)
..... code SΣ 0..1 CodeableConceptTW BID | TID | QID | AM | PM | QD | QOD | +
Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。
...... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
...... text SΣ 0..1 string 概念的文字標記法
.... asNeeded[x] Σ 0..1 「根據(對x的)需要」服用 Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... asNeededBoolean boolean
..... asNeededCodeableConcept CodeableConcept
.... site Σ 0..1 CodeableConcept 用藥之身體部位
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... route SΣ 0..1 CodeableConceptTW 藥品應如何進入體內
Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.
..... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
..... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
..... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... text SΣ 0..1 string 概念的文字標記法
.... method Σ 0..1 CodeableConceptTW 用藥的技術
Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... doseAndRate Σ 0..* Element 用藥量
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... type Σ 0..1 CodeableConceptTW 特定劑量或比率種類
Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... dose[x] SΣ 0..1 每一劑量的藥量
...... doseRange Range
...... doseQuantity Quantity(SimpleQuantity)
..... rate[x] SΣ 0..1 每時間單位內的用藥量
...... rateRatio Ratio
...... rateRange Range
...... rateQuantity Quantity(SimpleQuantity)
.... maxDosePerPeriod Σ 0..1 Ratio 每時間單位內用藥的上限
.... maxDosePerAdministration Σ 0..1 SimpleQuantity(4.0.1) 每次用藥的上限
.... maxDosePerLifetime Σ 0..1 SimpleQuantity(4.0.1) 病人一生中用藥的上限

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationStatement.​language Base preferred Common Languages 📦4.0.1 FHIR Std.
MedicationStatement.​status Base required Medication status codes 📍4.0.1 FHIR Std.
MedicationStatement.​statusReason Base extensible SNOMED CT Drug Therapy Status codes 📦4.0.1 FHIR Std.
MedicationStatement.​category Base preferred Medication usage category codes 📦4.0.1 FHIR Std.
MedicationStatement.​medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:fda-medication-tw Base required 臺灣食藥署藥品及醫療器材代碼值集 📦0.3.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-tw Base required 臺灣健保署用藥品項代碼值集 📦2022-07-28 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-ch-herb-tw Base required 臺灣健保署中藥用藥品項值集 📦2024-05-31 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:rxnorm-medication-us-core Base required RxNorm藥品代碼值集 📦3.0.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:atc-medication-code Base required 臺灣食藥署藥品藥理治療分類ATC碼值集 📦2022-10-24 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:snomedct-medication-codes Base required SNOMED CT Medication Codes 📦4.0.1 FHIR Std.
MedicationStatement.​reasonCode Base extensible Condition/Problem/Diagnosis Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.additionalInstruction Base extensible SNOMED CT Additional Dosage Instructions 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​durationUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​periodUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​dayOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​when Base required EventTiming 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code Base preferred TimingAbbreviation 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code.coding Base extensible HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 📦0.3.0 This IG
MedicationStatement.​dosage.asNeeded[x] Base extensible SNOMED CT Medication As Needed Reason Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.site Base extensible SNOMED CT Anatomical Structure for Administration Site Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.route Base example SNOMED CT Route Codes 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.route.coding Base extensible SNOMED CT + 臺灣健保署給藥途徑值集 📦0.3.0 This IG
MedicationStatement.​dosage.method Base extensible SNOMED CT Administration Method Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.doseAndRate.type Base example DoseAndRateType 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationStatement If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationStatement 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 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-4 error MedicationStatement If 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-5 error MedicationStatement If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationStatement A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
tim-1 error MedicationStatement.dosage.timing.repeat if there's a duration, there needs to be duration units duration.empty() or durationUnit.exists()
tim-2 error MedicationStatement.dosage.timing.repeat if there's a period, there needs to be period units period.empty() or periodUnit.exists()
tim-4 error MedicationStatement.dosage.timing.repeat duration SHALL be a non-negative value duration.exists() implies duration >= 0
tim-5 error MedicationStatement.dosage.timing.repeat period SHALL be a non-negative value period.exists() implies period >= 0
tim-6 error MedicationStatement.dosage.timing.repeat If there's a periodMax, there must be a period periodMax.empty() or period.exists()
tim-7 error MedicationStatement.dosage.timing.repeat If there's a durationMax, there must be a duration durationMax.empty() or duration.exists()
tim-8 error MedicationStatement.dosage.timing.repeat If there's a countMax, there must be a count countMax.empty() or count.exists()
tim-9 error MedicationStatement.dosage.timing.repeat If there's an offset, there must be a when (and not C, CM, CD, CV) offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))
tim-10 error MedicationStatement.dosage.timing.repeat If there's a timeOfDay, there cannot be a when, or vice versa timeOfDay.empty() or when.empty()

This structure is derived from MedicationStatement

Summary

Must-Support: 32 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of MedicationStatement.medication[x]
  • The element 1 is sliced based on the value of MedicationStatement.medication[x].coding

Key Elements View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationStatement 0..* MedicationStatement 病人正在服用的藥品紀錄
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此MedicationStatement Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative MedicationStatement Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 用藥聲明的外部識別碼
... basedOn Σ 0..* Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) 此用藥聲明是為了達成或實現哪個計劃、提案或醫令
... partOf Σ 0..* Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) 參照事件的一部分
... status ?!SΣ 1..1 code active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼
... statusReason 0..* CodeableConceptTW 當前狀態的原因
Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... category SΣ 0..1 CodeableConceptTW 藥品使用的類型
Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... Slices for medication[x] SΣ 1..1 所提供的藥品
Slice: Unordered, Closed by type:$this
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
.... medicationCodeableConcept CodeableConcept(CodeableConceptTW)
.... medicationReference Reference(TW Core Medication)
.... medication[x]:medicationReference Σ 0..1 Reference(TW Core Medication) What medication was taken
.... medication[x]:medicationCodeableConcept Σ 0..1 CodeableConceptTW 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
..... Slices for coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
...... coding:fda-medication-tw SΣ 0..1 CodingTW 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-ch-herb-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:rxnorm-medication-us-core SΣ 0..1 CodingTW RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:atc-medication-code SΣ 0..1 CodingTW ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:snomedct-medication-codes SΣ 0..1 CodingTW 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... text SΣ 0..1 string 概念的文字表示法
... subject SΣ 1..1 Reference(TW Core Patient | Group) 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。
... context SΣ 0..1 Reference(TW Core Encounter | EpisodeOfCare) 與此用藥聲明相關的就醫事件(Encounter / Episode)
... effective[x] SΣ 0..1 用藥的日期/時間或間隔
.... effectiveDateTime dateTime
.... effectivePeriod Period
... dateAsserted Σ 0..1 dateTime 此聲明是何時提出的?
... informationSource 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) 提供有關服用此藥品資訊的個人或機構
... derivedFrom 0..* Reference(Resource) 額外的補充資料
... reasonCode 0..* CodeableConceptTW 指明目前正在使用的藥品
Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... reasonReference 0..* Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) 證明目前正在/曾經用藥原因之Condition或Observation
... note 0..* Annotation 有關此聲明的更多資訊
... dosage S 0..* Dosage 藥品目前正被/曾經被服用或應該如何服用的細節
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... sequence SΣ 0..1 integer 劑量指示的順序
.... text SΣ 0..1 string 純文字表述的劑量指示,例如:SIG。
.... additionalInstruction Σ 0..* CodeableConceptTW 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」
Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... patientInstruction SΣ 0..1 string 以病人或消費者為導向的指示
.... timing SΣ 0..1 Timing 應該何時給藥;時間的寫法請參照Timimg datatype。
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... event Σ 0..* dateTime 事件發生的時間
..... repeat SΣC 0..1 Element 事件定期重複發生的時間
Constraints: tim-1, tim-2, tim-4, tim-5, tim-6, tim-7, tim-8, tim-9, tim-10
...... bounds[x] Σ 0..1 時間或期間長度/長度範圍,或(開始和/或結束)限制
....... boundsDuration Duration
....... boundsRange Range
....... boundsPeriod Period
...... count SΣ 0..1 positiveInt 重複的次數
...... countMax Σ 0..1 positiveInt 重複的最大次數
...... duration SΣ 0..1 decimal 此事件持續多久時間
...... durationMax Σ 0..1 decimal 此事件持續多久時間 (最長時間/最大值)
...... durationUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... frequency SΣ 0..1 positiveInt 此事件於每一期間的發生頻率
...... frequencyMax Σ 0..1 positiveInt 此事件於每一期間的最大發生頻率
...... period SΣ 0..1 decimal 此事件於特定時間區間所發生的頻率
...... periodMax Σ 0..1 decimal 時間區間的上限(3-4小時)
...... periodUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... dayOfWeek SΣ 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼
...... timeOfDay SΣ 0..* time 一天中的活動時間
...... when Σ 0..* code 事件發生的時間區間之代碼
Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼
...... offset Σ 0..1 unsignedInt 事件的分鐘數(之前或之後)
..... code SΣ 0..1 CodeableConceptTW BID | TID | QID | AM | PM | QD | QOD | +
Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。
...... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
...... text SΣ 0..1 string 概念的文字標記法
.... asNeeded[x] Σ 0..1 「根據(對x的)需要」服用 Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... asNeededBoolean boolean
..... asNeededCodeableConcept CodeableConcept
.... site Σ 0..1 CodeableConcept 用藥之身體部位
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... route SΣ 0..1 CodeableConceptTW 藥品應如何進入體內
Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.
..... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... text SΣ 0..1 string 概念的文字標記法
.... method Σ 0..1 CodeableConceptTW 用藥的技術
Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... doseAndRate Σ 0..* Element 用藥量
..... type Σ 0..1 CodeableConceptTW 特定劑量或比率種類
Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... dose[x] SΣ 0..1 每一劑量的藥量
...... doseRange Range
...... doseQuantity Quantity(SimpleQuantity)
..... rate[x] SΣ 0..1 每時間單位內的用藥量
...... rateRatio Ratio
...... rateRange Range
...... rateQuantity Quantity(SimpleQuantity)
.... maxDosePerPeriod Σ 0..1 Ratio 每時間單位內用藥的上限
.... maxDosePerAdministration Σ 0..1 SimpleQuantity(4.0.1) 每次用藥的上限
.... maxDosePerLifetime Σ 0..1 SimpleQuantity(4.0.1) 病人一生中用藥的上限

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationStatement.​language Base preferred Common Languages 📦4.0.1 FHIR Std.
MedicationStatement.​status Base required Medication status codes 📍4.0.1 FHIR Std.
MedicationStatement.​statusReason Base extensible SNOMED CT Drug Therapy Status codes 📦4.0.1 FHIR Std.
MedicationStatement.​category Base preferred Medication usage category codes 📦4.0.1 FHIR Std.
MedicationStatement.​medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:fda-medication-tw Base required 臺灣食藥署藥品及醫療器材代碼值集 📦0.3.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-tw Base required 臺灣健保署用藥品項代碼值集 📦2022-07-28 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-ch-herb-tw Base required 臺灣健保署中藥用藥品項值集 📦2024-05-31 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:rxnorm-medication-us-core Base required RxNorm藥品代碼值集 📦3.0.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:atc-medication-code Base required 臺灣食藥署藥品藥理治療分類ATC碼值集 📦2022-10-24 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:snomedct-medication-codes Base required SNOMED CT Medication Codes 📦4.0.1 FHIR Std.
MedicationStatement.​reasonCode Base extensible Condition/Problem/Diagnosis Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.additionalInstruction Base extensible SNOMED CT Additional Dosage Instructions 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​durationUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​periodUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​dayOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​when Base required EventTiming 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code Base preferred TimingAbbreviation 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code.coding Base extensible HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 📦0.3.0 This IG
MedicationStatement.​dosage.asNeeded[x] Base extensible SNOMED CT Medication As Needed Reason Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.site Base extensible SNOMED CT Anatomical Structure for Administration Site Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.route Base example SNOMED CT Route Codes 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.route.coding Base extensible SNOMED CT + 臺灣健保署給藥途徑值集 📦0.3.0 This IG
MedicationStatement.​dosage.method Base extensible SNOMED CT Administration Method Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.doseAndRate.type Base example DoseAndRateType 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationStatement If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationStatement 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 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-4 error MedicationStatement If 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-5 error MedicationStatement If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationStatement A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
tim-1 error MedicationStatement.dosage.timing.repeat if there's a duration, there needs to be duration units duration.empty() or durationUnit.exists()
tim-2 error MedicationStatement.dosage.timing.repeat if there's a period, there needs to be period units period.empty() or periodUnit.exists()
tim-4 error MedicationStatement.dosage.timing.repeat duration SHALL be a non-negative value duration.exists() implies duration >= 0
tim-5 error MedicationStatement.dosage.timing.repeat period SHALL be a non-negative value period.exists() implies period >= 0
tim-6 error MedicationStatement.dosage.timing.repeat If there's a periodMax, there must be a period periodMax.empty() or period.exists()
tim-7 error MedicationStatement.dosage.timing.repeat If there's a durationMax, there must be a duration durationMax.empty() or duration.exists()
tim-8 error MedicationStatement.dosage.timing.repeat If there's a countMax, there must be a count countMax.empty() or count.exists()
tim-9 error MedicationStatement.dosage.timing.repeat If there's an offset, there must be a when (and not C, CM, CD, CV) offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))
tim-10 error MedicationStatement.dosage.timing.repeat If there's a timeOfDay, there cannot be a when, or vice versa timeOfDay.empty() or when.empty()

Differential View

This structure is derived from MedicationStatement

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationStatement 0..* MedicationStatement 病人正在服用的藥品紀錄
... id 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。
... meta 0..1 Meta 此MedicationStatement Resource的metadata
... implicitRules 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative MedicationStatement Resource之內容摘要以供人閱讀
... identifier S 0..* Identifier 用藥聲明的外部識別碼
... basedOn 0..* Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) 此用藥聲明是為了達成或實現哪個計劃、提案或醫令
... partOf 0..* Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) 參照事件的一部分
... status S 1..1 code active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼
... statusReason 0..* CodeableConceptTW 當前狀態的原因
Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... category S 0..1 CodeableConceptTW 藥品使用的類型
Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... Slices for medication[x] S 1..1 所提供的藥品
Slice: Unordered, Open by type:$this
.... medicationCodeableConcept CodeableConcept(CodeableConceptTW)
.... medicationReference Reference(TW Core Medication)
.... medication[x]:medicationReference 0..1 Reference(TW Core Medication) What medication was taken
.... medication[x]:medicationCodeableConcept 0..1 CodeableConceptTW 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
..... Slices for coding 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
...... coding:fda-medication-tw S 0..1 CodingTW 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-tw S 0..1 CodingTW 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-ch-herb-tw 0..1 CodingTW 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:rxnorm-medication-us-core S 0..1 CodingTW RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:atc-medication-code S 0..1 CodingTW ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:snomedct-medication-codes S 0..1 CodingTW 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
... subject S 1..1 Reference(TW Core Patient | Group) 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。
... context S 0..1 Reference(TW Core Encounter | EpisodeOfCare) 與此用藥聲明相關的就醫事件(Encounter / Episode)
... effective[x] S 0..1 dateTime, Period 用藥的日期/時間或間隔
... dateAsserted 0..1 dateTime 此聲明是何時提出的?
... informationSource 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) 提供有關服用此藥品資訊的個人或機構
... derivedFrom 0..* Reference(Resource) 額外的補充資料
... reasonCode 0..* CodeableConceptTW 指明目前正在使用的藥品
Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... reasonReference 0..* Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) 證明目前正在/曾經用藥原因之Condition或Observation
... note 0..* Annotation 有關此聲明的更多資訊
... dosage S 0..* Dosage 藥品目前正被/曾經被服用或應該如何服用的細節
.... sequence S 0..1 integer 劑量指示的順序
.... text S 0..1 string 純文字表述的劑量指示,例如:SIG。
.... additionalInstruction 0..* CodeableConceptTW 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」
Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... patientInstruction S 0..1 string 以病人或消費者為導向的指示
.... timing S 0..1 Timing 應該何時給藥;時間的寫法請參照Timimg datatype。
..... event 0..* dateTime 事件發生的時間
..... repeat S 0..1 Element 事件定期重複發生的時間
...... bounds[x] 0..1 Duration, Range, Period 時間或期間長度/長度範圍,或(開始和/或結束)限制
...... count S 0..1 positiveInt 重複的次數
...... countMax 0..1 positiveInt 重複的最大次數
...... duration S 0..1 decimal 此事件持續多久時間
...... durationMax 0..1 decimal 此事件持續多久時間 (最長時間/最大值)
...... durationUnit S 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... frequency S 0..1 positiveInt 此事件於每一期間的發生頻率
...... frequencyMax 0..1 positiveInt 此事件於每一期間的最大發生頻率
...... period S 0..1 decimal 此事件於特定時間區間所發生的頻率
...... periodMax 0..1 decimal 時間區間的上限(3-4小時)
...... periodUnit S 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... dayOfWeek S 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼
...... timeOfDay S 0..* time 一天中的活動時間
...... when 0..* code 事件發生的時間區間之代碼
Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼
...... offset 0..1 unsignedInt 事件的分鐘數(之前或之後)
..... code S 0..1 CodeableConceptTW BID | TID | QID | AM | PM | QD | QOD | +
Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。
...... coding 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
...... text S 0..1 string 概念的文字標記法
.... asNeeded[x] 0..1 boolean, CodeableConcept 「根據(對x的)需要」服用 Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... site 0..1 CodeableConcept 用藥之身體部位
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... route S 0..1 CodeableConceptTW 藥品應如何進入體內
..... coding 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... text S 0..1 string 概念的文字標記法
.... method 0..1 CodeableConceptTW 用藥的技術
Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... doseAndRate 0..* Element 用藥量
..... type 0..1 CodeableConceptTW 特定劑量或比率種類
Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... dose[x] S 0..1 Range, SimpleQuantity(4.0.1) 每一劑量的藥量
..... rate[x] S 0..1 Ratio, Range, SimpleQuantity(4.0.1) 每時間單位內的用藥量
.... maxDosePerPeriod 0..1 Ratio 每時間單位內用藥的上限
.... maxDosePerAdministration 0..1 SimpleQuantity(4.0.1) 每次用藥的上限
.... maxDosePerLifetime 0..1 SimpleQuantity(4.0.1) 病人一生中用藥的上限

doco Documentation for this format

Terminology Bindings (Differential)

Path Status Usage ValueSet Version Source
MedicationStatement.​language Base preferred Common Languages 📦4.0.1 FHIR Std.
MedicationStatement.​status Base required Medication status codes 📍4.0.1 FHIR Std.
MedicationStatement.​statusReason Base extensible SNOMED CT Drug Therapy Status codes 📦4.0.1 FHIR Std.
MedicationStatement.​category Base preferred Medication usage category codes 📦4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:fda-medication-tw Base required 臺灣食藥署藥品及醫療器材代碼值集 📦0.3.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-tw Base required 臺灣健保署用藥品項代碼值集 📦2022-07-28 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-ch-herb-tw Base required 臺灣健保署中藥用藥品項值集 📦2024-05-31 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:rxnorm-medication-us-core Base required RxNorm藥品代碼值集 📦3.0.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:atc-medication-code Base required 臺灣食藥署藥品藥理治療分類ATC碼值集 📦2022-10-24 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:snomedct-medication-codes Base required SNOMED CT Medication Codes 📦4.0.1 FHIR Std.
MedicationStatement.​reasonCode Base extensible Condition/Problem/Diagnosis Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.additionalInstruction Base extensible SNOMED CT Additional Dosage Instructions 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​durationUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​periodUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​dayOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​when Base required EventTiming 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code Base preferred TimingAbbreviation 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code.coding Base extensible HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 📦0.3.0 This IG
MedicationStatement.​dosage.asNeeded[x] Base extensible SNOMED CT Medication As Needed Reason Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.site Base extensible SNOMED CT Anatomical Structure for Administration Site Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.route.coding Base extensible SNOMED CT + 臺灣健保署給藥途徑值集 📦0.3.0 This IG
MedicationStatement.​dosage.method Base extensible SNOMED CT Administration Method Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.doseAndRate.type Base example DoseAndRateType 📦4.0.1 FHIR Std.

Snapshot View

NameFlagsCard.TypeDescription & Constraints    Filter: Filtersdoco
.. MedicationStatement 0..* MedicationStatement 病人正在服用的藥品紀錄
... id Σ 0..1 id 不重複的ID用以識別儲存在特定FHIR Server中的MedicationStatement紀錄,通常又稱為邏輯性ID。
... meta Σ 0..1 Meta 此MedicationStatement Resource的metadata
... implicitRules ?!Σ 0..1 uri 創建此內容所依據的一組規則
... text 0..1 Narrative MedicationStatement Resource之內容摘要以供人閱讀
This profile does not constrain the narrative in regard to content, language, or traceability to data elements
... contained 0..* Resource Contained, inline Resources
... extension 0..* Extension Additional content defined by implementations
... modifierExtension ?! 0..* Extension Extensions that cannot be ignored
... identifier SΣ 0..* Identifier 用藥聲明的外部識別碼
... basedOn Σ 0..* Reference(TW Core MedicationRequest | TW Core CarePlan | TW Core ServiceRequest) 此用藥聲明是為了達成或實現哪個計劃、提案或醫令
... partOf Σ 0..* Reference(MedicationAdministration | TW Core MedicationDispense | TW Core MedicationStatement | TW Core Procedure | TW Core Observation Laboratory Result) 參照事件的一部分
... status ?!SΣ 1..1 code active | completed | entered-in-error | intended | stopped | on-hold | unknown | not-taken
Binding: Medication Status Codes (required): 指明用藥聲明的當前狀態;應填入所綁定值集中的其中一個代碼
... statusReason 0..* CodeableConceptTW 當前狀態的原因
Binding: SNOMEDCTDrugTherapyStatusCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... category SΣ 0..1 CodeableConceptTW 藥品使用的類型
Binding: Medication usage category codes (preferred): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... Slices for medication[x] SΣ 1..1 所提供的藥品
Slice: Unordered, Closed by type:$this
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
.... medicationCodeableConcept CodeableConcept(CodeableConceptTW)
.... medicationReference Reference(TW Core Medication)
.... medication[x]:medicationReference Σ 0..1 Reference(TW Core Medication) What medication was taken
.... medication[x]:medicationCodeableConcept Σ 0..1 CodeableConceptTW 所提供的藥品。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMEDCTMedicationCodes (example): A coded concept identifying the substance or product being taken.
..... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
..... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
..... Slices for coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼
Slice: Unordered, Open by pattern:$this
...... coding:fda-medication-tw SΣ 0..1 CodingTW 此為臺灣食品藥物管理署(TFDA)維護之藥品代碼,涵蓋範圍相對完整,可免費使用,可優先選用此代碼。
Binding: 臺灣食藥署藥品及醫療器材代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署用藥品項代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:nhi-medication-ch-herb-tw SΣ 0..1 CodingTW 此為中央健康保險署(NHI)維護之中藥藥品代碼,主要針對申報使用,更新頻率相對頻繁,可免費使用,可依情境選用此代碼。
Binding: 臺灣健保署中藥用藥品項值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:rxnorm-medication-us-core SΣ 0..1 CodingTW RxNorm為美國Unified Medical Language System®中的藥品代碼,取得UMLS®授權即可免費使用,可依情境選用此代碼。
Binding: RxNorm藥品代碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:atc-medication-code SΣ 0..1 CodingTW ATC代碼的版權為世界衛生組織(WHO)Collaborating Centre for Drug Statistics Methodology,可免費使用,可依情境選用此代碼。
Binding: 臺灣食藥署藥品藥理治療分類ATC碼值集 (required): 應填入所綁定值集中的其中一個代碼。
...... coding:snomedct-medication-codes SΣ 0..1 CodingTW 此為SNOMED CT代碼,若機構已有購買相關授權,亦可使用。
Binding: SNOMEDCTMedicationCodes (required): 可參考所綁定值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... text SΣ 0..1 string 概念的文字表示法
... subject SΣ 1..1 Reference(TW Core Patient | Group) 指明目前正在使用的藥品。這可能是一個連結到代表藥品詳細資訊的resource,或者是一個帶有代碼的簡單屬性,從已知藥品清單中表明藥品的代碼。
... context SΣ 0..1 Reference(TW Core Encounter | EpisodeOfCare) 與此用藥聲明相關的就醫事件(Encounter / Episode)
... effective[x] SΣ 0..1 用藥的日期/時間或間隔
.... effectiveDateTime dateTime
.... effectivePeriod Period
... dateAsserted Σ 0..1 dateTime 此聲明是何時提出的?
... informationSource 0..1 Reference(TW Core Patient | TW Core Practitioner | TW Core PractitionerRole | TW Core RelatedPerson | TW Core Organization) 提供有關服用此藥品資訊的個人或機構
... derivedFrom 0..* Reference(Resource) 額外的補充資料
... reasonCode 0..* CodeableConceptTW 指明目前正在使用的藥品
Binding: Condition/Problem/DiagnosisCodes (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
... reasonReference 0..* Reference(TW Core Condition | TW Core Observation Laboratory Result | TW Core DiagnosticReport) 證明目前正在/曾經用藥原因之Condition或Observation
... note 0..* Annotation 有關此聲明的更多資訊
... dosage S 0..* Dosage 藥品目前正被/曾經被服用或應該如何服用的細節
.... id 0..1 string Unique id for inter-element referencing
.... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
.... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
.... sequence SΣ 0..1 integer 劑量指示的順序
.... text SΣ 0..1 string 純文字表述的劑量指示,例如:SIG。
.... additionalInstruction Σ 0..* CodeableConceptTW 對病人的補充指示或警告-例如:「隨餐服用」,「可能引起嗜睡」
Binding: SNOMEDCTAdditionalDosageInstructions (extensible): 一個編碼的概念,確定額外的指示,如「與水一起服用」或「避免操作重型機器」;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... patientInstruction SΣ 0..1 string 以病人或消費者為導向的指示
.... timing SΣ 0..1 Timing 應該何時給藥;時間的寫法請參照Timimg datatype。
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... modifierExtension ?!Σ 0..* Extension Extensions that cannot be ignored even if unrecognized
..... event Σ 0..* dateTime 事件發生的時間
..... repeat SΣC 0..1 Element 事件定期重複發生的時間
Constraints: tim-1, tim-2, tim-4, tim-5, tim-6, tim-7, tim-8, tim-9, tim-10
...... id 0..1 string Unique id for inter-element referencing
...... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
...... bounds[x] Σ 0..1 時間或期間長度/長度範圍,或(開始和/或結束)限制
....... boundsDuration Duration
....... boundsRange Range
....... boundsPeriod Period
...... count SΣ 0..1 positiveInt 重複的次數
...... countMax Σ 0..1 positiveInt 重複的最大次數
...... duration SΣ 0..1 decimal 此事件持續多久時間
...... durationMax Σ 0..1 decimal 此事件持續多久時間 (最長時間/最大值)
...... durationUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... frequency SΣ 0..1 positiveInt 此事件於每一期間的發生頻率
...... frequencyMax Σ 0..1 positiveInt 此事件於每一期間的最大發生頻率
...... period SΣ 0..1 decimal 此事件於特定時間區間所發生的頻率
...... periodMax Σ 0..1 decimal 時間區間的上限(3-4小時)
...... periodUnit SΣ 0..1 code s | min | h | d | wk | mo | a - 單位時間 (unit of time,UCUM)
Binding: UnitsOfTime (required): 時間的單位(單位來自UCUM);應填入UnitsOfTime值集中的其中一個代碼
...... dayOfWeek SΣ 0..* code mon | tue | wed | thu | fri | sat | sun
Binding: DaysOfWeek (required): 應填入DaysOfWeek值集中的其中一個代碼
...... timeOfDay SΣ 0..* time 一天中的活動時間
...... when Σ 0..* code 事件發生的時間區間之代碼
Binding: EventTiming (required): 與時程表有關的真實世界事件;應填入EventTiming值集中的其中一個代碼
...... offset Σ 0..1 unsignedInt 事件的分鐘數(之前或之後)
..... code SΣ 0..1 CodeableConceptTW BID | TID | QID | AM | PM | QD | QOD | +
Binding: TimingAbbreviation (preferred): 已知/確定的時間模式之代碼;鼓勵使用TimingAbbreviation值集中的代碼,但不強制一定要使用此值集,你也可使用其他值集的代碼或單純以文字表示。
...... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
...... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
...... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
...... text SΣ 0..1 string 概念的文字標記法
.... asNeeded[x] Σ 0..1 「根據(對x的)需要」服用 Binding:一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;可參考SNOMEDCTMedicationAsNeededReasonCodes值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
Binding: SNOMEDCTMedicationAsNeededReasonCodes (extensible): 一個編碼概念,指明在服用或用藥之前應滿足或評估的先決條件。例如:「疼痛」、「性行為前30分鐘」、「發作時」等;應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... asNeededBoolean boolean
..... asNeededCodeableConcept CodeableConcept
.... site Σ 0..1 CodeableConcept 用藥之身體部位
Binding: SNOMEDCTAnatomicalStructureForAdministrationSiteCodes (extensible): 一個編碼概念,描述藥品進入或在身體上的位置;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... route SΣ 0..1 CodeableConceptTW 藥品應如何進入體內
Binding: SNOMEDCTRouteCodes (example): A coded concept describing the route or physiological path of administration of a therapeutic agent into or onto the body of a subject.
..... id 0..1 string 唯一可識別ID,以供資料項目間相互參照。
..... extension 0..* Extension 擴充的資料項目
Slice: Unordered, Open by value:url
..... coding SΣ 0..* CodingTW 由專門術語系統(terminology system)定義的代碼。此資料項目為可擴充綁定預設國際標準值集,但實作者可視實務專案需求只綁定以下slices中的任一值集。目前未只限定綁定預設值集是因為尚無slice值集與預設國際標準值集的代碼對應表,待後續有相對的代碼對應表後將建議採用國際標準值集作為唯一綁定值集並針對該值集進行擴充與管理,以利進行跨國與跨系統之資料交換。
Binding: SNOMED CT + 臺灣健保署給藥途徑值集 (extensible): 應填入所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
..... text SΣ 0..1 string 概念的文字標記法
.... method Σ 0..1 CodeableConceptTW 用藥的技術
Binding: SNOMEDCTAdministrationMethodCodes (extensible): 一個編碼概念,描述用藥的技術;可參考所綁定值集中適合的代碼,確定無適合的代碼才可以使用其他值集的代碼來表示。
.... doseAndRate Σ 0..* Element 用藥量
..... id 0..1 string Unique id for inter-element referencing
..... extension 0..* Extension Additional content defined by implementations
Slice: Unordered, Open by value:url
..... type Σ 0..1 CodeableConceptTW 特定劑量或比率種類
Binding: DoseAndRateType (example): 可參考DoseAndRateType值集,但此值集只是針對這個欄位的一個可能值的範例,不預期也不鼓勵使用者一定要使用此值集的代碼。
..... dose[x] SΣ 0..1 每一劑量的藥量
...... doseRange Range
...... doseQuantity Quantity(SimpleQuantity)
..... rate[x] SΣ 0..1 每時間單位內的用藥量
...... rateRatio Ratio
...... rateRange Range
...... rateQuantity Quantity(SimpleQuantity)
.... maxDosePerPeriod Σ 0..1 Ratio 每時間單位內用藥的上限
.... maxDosePerAdministration Σ 0..1 SimpleQuantity(4.0.1) 每次用藥的上限
.... maxDosePerLifetime Σ 0..1 SimpleQuantity(4.0.1) 病人一生中用藥的上限

doco Documentation for this format

Terminology Bindings

Path Status Usage ValueSet Version Source
MedicationStatement.​language Base preferred Common Languages 📦4.0.1 FHIR Std.
MedicationStatement.​status Base required Medication status codes 📍4.0.1 FHIR Std.
MedicationStatement.​statusReason Base extensible SNOMED CT Drug Therapy Status codes 📦4.0.1 FHIR Std.
MedicationStatement.​category Base preferred Medication usage category codes 📦4.0.1 FHIR Std.
MedicationStatement.​medication[x] Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept Base example SNOMED CT Medication Codes 📍4.0.1 FHIR Std.
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:fda-medication-tw Base required 臺灣食藥署藥品及醫療器材代碼值集 📦0.3.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-tw Base required 臺灣健保署用藥品項代碼值集 📦2022-07-28 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:nhi-medication-ch-herb-tw Base required 臺灣健保署中藥用藥品項值集 📦2024-05-31 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:rxnorm-medication-us-core Base required RxNorm藥品代碼值集 📦3.0.0 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:atc-medication-code Base required 臺灣食藥署藥品藥理治療分類ATC碼值集 📦2022-10-24 This IG
MedicationStatement.​medication[x]:medicationCodeableConcept.​coding:snomedct-medication-codes Base required SNOMED CT Medication Codes 📦4.0.1 FHIR Std.
MedicationStatement.​reasonCode Base extensible Condition/Problem/Diagnosis Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.additionalInstruction Base extensible SNOMED CT Additional Dosage Instructions 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​durationUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​periodUnit Base required UnitsOfTime 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​dayOfWeek Base required DaysOfWeek 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.repeat.​when Base required EventTiming 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code Base preferred TimingAbbreviation 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.timing.code.coding Base extensible HL7 TimingAbbreviation + 臺灣健保署藥品使用頻率值集 📦0.3.0 This IG
MedicationStatement.​dosage.asNeeded[x] Base extensible SNOMED CT Medication As Needed Reason Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.site Base extensible SNOMED CT Anatomical Structure for Administration Site Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.route Base example SNOMED CT Route Codes 📍4.0.1 FHIR Std.
MedicationStatement.​dosage.route.coding Base extensible SNOMED CT + 臺灣健保署給藥途徑值集 📦0.3.0 This IG
MedicationStatement.​dosage.method Base extensible SNOMED CT Administration Method Codes 📦4.0.1 FHIR Std.
MedicationStatement.​dosage.doseAndRate.type Base example DoseAndRateType 📦4.0.1 FHIR Std.

Constraints

Id Grade Path(s) Description Expression
dom-2 error MedicationStatement If the resource is contained in another resource, it SHALL NOT contain nested Resources contained.contained.empty()
dom-3 error MedicationStatement 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 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-4 error MedicationStatement If 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-5 error MedicationStatement If a resource is contained in another resource, it SHALL NOT have a security label contained.meta.security.empty()
dom-6 best practice MedicationStatement A resource should have narrative for robust management text.`div`.exists()
ele-1 error **ALL** elements All FHIR elements must have a @value or children hasValue() or (children().count() > id.count())
ext-1 error **ALL** extensions Must have either extensions or value[x], not both extension.exists() != value.exists()
tim-1 error MedicationStatement.dosage.timing.repeat if there's a duration, there needs to be duration units duration.empty() or durationUnit.exists()
tim-2 error MedicationStatement.dosage.timing.repeat if there's a period, there needs to be period units period.empty() or periodUnit.exists()
tim-4 error MedicationStatement.dosage.timing.repeat duration SHALL be a non-negative value duration.exists() implies duration >= 0
tim-5 error MedicationStatement.dosage.timing.repeat period SHALL be a non-negative value period.exists() implies period >= 0
tim-6 error MedicationStatement.dosage.timing.repeat If there's a periodMax, there must be a period periodMax.empty() or period.exists()
tim-7 error MedicationStatement.dosage.timing.repeat If there's a durationMax, there must be a duration durationMax.empty() or duration.exists()
tim-8 error MedicationStatement.dosage.timing.repeat If there's a countMax, there must be a count countMax.empty() or count.exists()
tim-9 error MedicationStatement.dosage.timing.repeat If there's an offset, there must be a when (and not C, CM, CD, CV) offset.empty() or (when.exists() and ((when in ('C' | 'CM' | 'CD' | 'CV')).not()))
tim-10 error MedicationStatement.dosage.timing.repeat If there's a timeOfDay, there cannot be a when, or vice versa timeOfDay.empty() or when.empty()

This structure is derived from MedicationStatement

Summary

Must-Support: 32 elements

Structures

This structure refers to these other structures:

Slices

This structure defines the following Slices:

  • The element 1 is sliced based on the value of MedicationStatement.medication[x]
  • The element 1 is sliced based on the value of MedicationStatement.medication[x].coding

 

Other representations of profile: CSV, Excel, Schematron

Notes:

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

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

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

    例子:
    (1) GET [base]/MedicationStatement?_id=med-sta-example (2) GET [base]/MedicationStatement/med-sta-example

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

    例子:
    (1) GET [base]/MedicationStatement?status=active

  3. 建議應該(SHOULD) 支援透過查詢參數 medication 查詢所有MedicationStatement:
    (如何透過reference查詢)
    GET [base]/MedicationStatement?medication={Type/}[id]

    例子:
    (1) GET [base]/MedicationStatement?medication=Medication/med-example

  4. 建議應該(SHOULD) 支援透過查詢參數 subject 查詢所有MedicationStatement:
    (如何透過reference查詢)
    GET [base]/MedicationRequest?subject={Type/}[id]

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