臺灣電子處方箋與調劑單張實作指引(TW EMPD IG)
0.2.1 - trial-use

This page is part of the 臺灣電子處方箋與調劑單張實作指引(TW EMPD IG) (v0.2.1: Releases) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

應用說明

Official URL: https://nhicore.nhi.gov.tw/empd/ImplementationGuide/tw.gov.mohw.nhi.empd Version: 0.2.1
Active as of 2026-09-30 Computable Name: EMPD

因考量實作需求，於2026/9/28異動以下內容：
  1. 新增及調整專門術語（Terminology）：
  2. 新增 Extension: 給付類別（Extension-PaymentCategory）：
    • Extension.url：固定為 https://nhicore.nhi.gov.tw/empd/StructureDefinition/Extension-PaymentCategory。
    • Extension.value[x]：限用 CodeableConcept 且必填，required 綁定 ValueSet: 給付類別值集。
  3. 新增 Extension: 須被合併之處方箋註記（Extension-CombinedPrescriptionNote）：
    • Extension.value[x] 限用 boolean 且必填，以 valueBoolean 表示處方箋是否須與同次就醫紀錄之其他處方箋合併。
  4. 修改 Profile: 電子處方箋-Bundle（Bundle-EMPD）：
    • 新增 Constraint enc-nhi-1：就醫身分別為健保時，健保卡就醫序號必填。
    • 新增 Constraint empd-medreq-1：處方箋種類為第一、二、三級管制藥品專用處方箋（D／E／F）時，醫師證號及管制藥品使用執照皆必填。
    • 因特材改由 MedicationRequest 表示，Medication Resource 改為可選填：
      • Bundle.entry：基數 9..* → 8..*。
      • Bundle.entry:Medication：基數 1..* → 0..*。
      • Bundle.entry:CoverageIdentifier：基數 1..* → 1..1。
  5. 修改 Profile: 電子處方箋-Composition（Composition-EMPD）：
    • Composition.date：語意調整為「處方箋有效期間迄」。
    • Composition.section:Coverage：基數 1..* → 1..1。
    • 因特材改由 MedicationRequest 表示：
      • Composition.section:MedicationPrescribed.entry：基數 2..* → 1..*。
      • Composition.section:MedicationPrescribed.entry:Medication：基數 1..* → 0..*。
    • Composition.section:MedicationPrescribed.extension：原由 MedicationRequest.note 表示的「須被合併之處方箋註記」，改由 Extension-CombinedPrescriptionNote 的 valueBoolean 表示。
    • Composition.section:Coverage.code.coding.display：移除固定值。
    • Composition.section:ObservationBodyWeight.code.coding.display：移除固定值。
    • Composition.section:Condition.code.coding.display：移除固定值。
    • Composition.section:MedicationPrescribed.code.coding.display：移除固定值。
  6. 修改 Profile: 電子處方箋-病人基本資料（Patient-EMPD）：
    • 新增 Constraint pat-id-1：病人之國民身分證統一編號、護照號碼或居留證號，至少需填寫其中一種。
    • Patient.name:usual：改為必填（1..1），並須填寫 name:usual.text。
    • Patient.name:usual.text：長度限制 60。
    • Patient.identifier:medicalRecord.value：長度限制 10。
  7. 修改 Profile: 電子處方箋-體重（Observation-EMPD-BodyWeight）：
    • Observation.valueQuantity.value：數字限制 6,2（總長度不得超過 6 位數，小數不得超過 2 位，最大值為 9999.99；Constraint：empd-obs-bw-1）。
    • Observation.subject：參照目標調整為 Patient-EMPD。
  8. 修改 Profile: 電子處方箋-門診基本資料（Encounter-EMPD）：
    • Encounter.identifier:medical-encounter-identifier：新增「就醫識別碼」slice 且為必填，system 固定為 https://nhicore.nhi.gov.tw/empd/medical-encounter-identifier。
    • Encounter.identifier:func-sequence-number：新增「健保卡就醫序號」slice，符合健保就醫條件時必填，system 固定為 https://nhicore.nhi.gov.tw/empd/func-sequence-number。
    • Encounter.identifier:medical-encounter-identifier.value：長度限制 20。
    • Encounter.identifier:func-sequence-number.value：長度限制 4。
    • Encounter.class：綁定 ValueSet: NHI-健保案件分類值集。
    • Encounter.type：原由 Condition.note 表示之「部分負擔代碼」改至此欄位，並綁定 部分負擔代碼值集。
    • Encounter.subject：參照目標調整為 Patient-EMPD。
  9. 修改 Profile: 電子處方箋／調劑單張-就醫身分別（Coverage-EMR）：
    • Coverage.type.coding：原由 Coverage.type.text 表示之「就醫身分別」改至此欄位，並綁定 就醫身分別值集。
    • Coverage.extension:PaymentCategory：原由 Coverage.type.coding 表示之「給付類別」改由此 Extension 表示，並綁定 給付類別值集。
  10. 修改 Profile: 電子處方箋-醫事機構基本資料（Organization-EMPD）：
    • Organization.identifier：基數調整為 1..1，需使用健保特約醫事機構代碼或臺灣醫事司醫事機構代碼。
    • Organization.identifier:nhi-organization：新增健保特約醫事機構代碼 slice，綁定健保特約醫事機構值集。
    • Organization.identifier:twcore-organization：新增醫事司醫事機構代碼 slice，綁定 TW Core 醫事機構值集。
    • Organization.name：改為必填（1..1）。
  11. 修改 Profile: 電子處方箋-醫事人員基本資料（Practitioner-EMPD）：
    • 開立第一、二、三級管制藥品專用處方箋時，醫師證號及管制藥品使用執照皆必填。
    • Practitioner.identifier:medicalLicenseNumber：新增 slice，原由 Practitioner.qualification.identifier 表示之醫師證號改由此欄位表示，system 固定為 https://dep.mohw.gov.tw/DOMA。
    • Practitioner.qualification：基數 1..1 → 0..1。
    • Practitioner.qualification.identifier：用以表示管制藥品使用執照，system 固定為 https://cdmis.fda.gov.tw。
    • Practitioner.name：基數調整為 1..1。
    • Practitioner.name.text：基數調整為 1..1，長度限制 60。
    • Practitioner.telecom.value：長度限制 20。
    • Practitioner.identifier:medicalLicenseNumber.value：長度限制 30。
    • Practitioner.qualification.identifier.value：長度限制 30。
  12. 修改 Profile: 電子處方箋-藥物處方內容（Medication-EMPD）：
    • Medication.code.coding:nhi-medication：新增健保用藥品項 slice，綁定 NHI-電子處方箋-用藥品項值集。
    • Medication.code.coding:nonNHIMedication：新增無健保代碼藥物品項 slice。
    • 新增 Constraint empd-med-1：自費藥品且無藥品許可證字號時，代碼須使用 999999 加院所自訂 4 碼流水號，共 10 碼。
    • 配合 FHIR Ratio 資料型態定義，調整 Medication.ingredient.strength 之 numerator／denominator，其 value、system 及 code 改為必填，system 固定使用 UCUM http://unitsofmeasure.org。
    • Medication.code.text：長度限制 600。
  13. 修改 Profile: 電子處方箋-處方內容（MedicationRequest-EMPD）：
    • 新增 Constraint empd-ord-1：醫令類別非特殊材料時，須提供劑量、劑量單位、頻率、給藥途徑、給藥日數及給藥總量等相關資訊。
    • 新增 Constraint empd-medreq-2：未使用 medicationReference 表示藥品時，應以 medicationCodeableConcept 填寫特材代碼。
    • 新增 Constraint empd-medreq-3：無健保代碼之特材暫編碼須符合 12 碼編碼規則。
    • MedicationRequest.status：原由 MedicationRequest.note 表示之處方箋註銷註記改由此欄位表示，並 required 綁定 EMPD MedicationRequest 狀態值集，限使用 active 表示處方箋有效、cancelled 表示處方箋已註銷。
    • MedicationRequest.category:orderType：基數 0..1 → 1..1，醫令類別改為必填。
    • MedicationRequest.medication[x]:medicationCodeableConcept.coding:NHIMaterial：新增健保代碼特材 slice，綁定 NHI-電子處方箋-健保特材值集。
    • MedicationRequest.medication[x]:medicationCodeableConcept.coding:nonNHIMaterial：新增無健保代碼特材 slice。
    • MedicationRequest.note：
      • 原「處方箋註銷註記」改由 MedicationRequest.status 表示。
      • 原「自費註記」改由 MedicationRequest.category:selfpayStatus 表示。
      • 原「須被合併之處方箋註記」改由 Composition 的 Extension-CombinedPrescriptionNote 表示。
    • MedicationRequest.dosageInstruction.doseAndRate.dose[x] 及 doseQuantity：基數 1..1 → 0..1，當為特材時可不填。
    • MedicationRequest.dosageInstruction.timing.repeat.frequency：名稱由「頻率」調整為「藥品使用次數」，基數 1..1 → 0..1。
    • MedicationRequest.dosageInstruction.timing.code：名稱由「使用時間」調整為「藥品使用頻率及服用時間」，基數 0..1 → 1..1。
    • MedicationRequest.dosageInstruction.timing.code.coding：基數 0..* → 1..*，綁定 藥品使用頻率值集。
    • 「不得以其他廠牌藥品替代之理由」改以 MedicationRequest.substitution.reason.text 表示。
    • MedicationRequest.subject：參照目標調整為 Patient-EMPD。
    • MedicationRequest.identifier:PrescriptionNo.value：長度限制 64。
    • MedicationRequest.identifier:Item.value：長度限制 2。
    • MedicationRequest.extension:TotalMedicationDays.value[x]：給藥總日份不得超過 999。
    • MedicationRequest.dispenseRequest.numberOfRepeatsAllowed：處方可調劑次數不得超過 99。
    • MedicationRequest.dispenseRequest.expectedSupplyDuration：給藥日數不得超過 999 天，單位固定為天（d）。
    • MedicationRequest.dispenseRequest.quantity.value：數字限制 6,2（Constraint：empd-medreq-6）。
    • MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.value：數字限制 11,3（Constraint：empd-medreq-5）。
    • MedicationRequest.dosageInstruction.doseAndRate.doseQuantity.unit：長度限制 30。
    • MedicationRequest.dosageInstruction.method.text：長度限制 600。
    • MedicationRequest.substitution.reason.text：長度限制 800。
  14. 修改 Profile: 電子處方箋-診斷（Condition-EMPD）：
    • Condition.note：改為表示「醫療評估內容註記」。
    • 原「部分負擔代碼」改由 Encounter.type 表示。
    • Condition.note.text：長度限制 1000。
    • Condition.subject：參照目標調整為 Patient-EMPD。
  15. 修改調劑單張相關 Profiles：
請留意這些異動，以避免影響您的實作。

專案介紹

臺灣電子處方箋與調劑單張實作指引（Taiwan Electronic Medication Prescription and Dispense Implementation Guide，簡稱TW EMPD IG），採用HL7® FHIR® standard（Fast Healthcare Interoperability Resources）IG建置方法，在FHIR R4.0.1之標準基礎上，繼承臺灣核心實作指引（Taiwan Core Implementation Guide，簡稱TW core IG）V0.3.2版本，進一步定義適用於臺灣電子處方箋與調劑單張資料需求的Resources（類似資料表）、其中的資料項目（意即欄位）、基數（意即0..1、0..、1..1或1..）及資料類型（文字、日期時間、代碼等）等。

專案背景

民國94年12月進行「醫療院所病歷電子化現況調查」之結果顯示：國內醫院病歷電子化發展已相當普及，共計約有5成醫院病歷資料已進行電腦化，約3成醫院病歷電子化已進展至院內整合階段並逐漸邁向院際之分享與交換應用，顯示過去幾年推動病歷電子化之發展已具初步成效，應順勢大力推展。

為了延續「網路健康服務推動計畫（民國91至94年）」、「衛生局所網路便民服務計畫（民國92至95年）」等計畫之基礎，落實本部「全人健康照護」政策目標，推動「從出生前到老去健康資訊ｅ化流通」發展策略，民國93年10月開始規劃「國民健康資訊建設計畫（National Health Informatics Project，NHIP）」，並於民國94及95年提出計畫申請，於民國96年8月14日核定通過，由政府扮演推動角色，營造國家健康資訊發展環境，推動衛生醫療資訊之重要基礎建設，其中，「推動實施電子病歷」與「建立及營運醫事憑證管理中心 (Healthcare Certification Authority，HCA )」即為NHIP之兩大分項計畫。

「智慧醫療服務計畫」為行政院98年4月30日核定之「健康照護升值白金方案－加值產業」項下四大方案之一，該方案項下包含「推動遠距健康照護計畫」、「推動電子病歷及醫療影像傳輸計畫」、「健保IC卡改善計畫」、「醫院安全關懷RFID計畫」、「健康資料庫加值應用計畫」五大計畫。

後續，本部除繼續推動醫療院所實施電子病歷及互通外，並擬規劃台灣健康雲計畫，發展電子病歷雲端服務，增加國內醫療院所推動電子病歷之意願。

電子處方箋與調劑單張之規範由衛生福利部2022年3月招標之「111年度智慧健康雲專案辦公室營運案專案」經費支應下建置。

如何閱讀這個實作指引(IG)


EMPD IG目錄


  • 首頁：EMPD IG介紹及背景說明。
  • 視覺化邏輯模型：EMPD IG邏輯模型架構視覺化圖。
  • 規範文件
    • 能力聲明 ：應用EMPD IG於建置業務目的使用的FHIR Server時，該FHIR Server必須及建議應該支援的資料存取功能。
    • 查詢參數與操作定義：查詢FHIR Server的Profiles時，針對各Profiles可使用的查詢參數及操作定義。
    • 邏輯模型 ：EMPD IG的所有邏輯模型(Logical Models)，邏輯模型會定義相應情境下使用的所有資料欄位。為了便於實作者快速理解，資料欄位會使用易於理解的命名，實作者再透過邏輯模型中的功能頁籤「Mappings」瞭解各資料欄位實際使用本IG的哪個Profiles的哪個資料項目(element)。
    • FHIR Profiles及Extensions：
      • EMPD IG的所有Profiles之定義與範例。
      • 各資料項目不同實作強制程度的Terminology。
    • 專門術語 ：EMPD IG所使用的專門術語，包括代碼系統（Code Systems）及值集（Value Sets）。
  • 範例檔：符合EMPD IG所定義Profiles之範例檔。
  • 結構定義與範例檔下載：實作者若不偏好使用FHIR RESTful API驗證資料是否符合Profiles，可直接下載所需的格式驗證檔，包括XML、JSON及Turtle三種格式，亦可於此下載完整範例檔。
  • 安全性：主要說明採用EMPD IG網站進行實作時，有關資料存取授權的作法。
  • 版本異動：若EMPD IG網站的版本有所異動，皆可透過異動說明頁得以瞭解版本間的異動差異

專有名詞定義

本實作指引基於TW Core IG規則，敘述如下：

Profiles相關

英文名 中文名 說明
Name 名稱 resource的資料項目名稱(意即XML元素名稱；JSON或RDF屬性名稱)。有些名稱末端為[x]，圖示為，意即可以選擇適用的資料類型以因應對照的資料項目內容，故需依據資料來源類型填入適當的內容值，例如Patient.deceased[x]。
Patient.deceased[x]範例
如原始資料謹紀錄病人存活或死亡，應選用Boolean類型，存活為0、死亡為1；如原始資料紀錄病人死亡時間，應選用dateTime類型，並填入時間，表示病人以死亡。
Flags 標記 一組有關影響實作者如何操作資料項目的資訊，範例如下。
A MustSupport image 必須支援(MustSupport)，表示伺服器必須有能力接收這個資料項目。詳可參閱MustSupport。
A modifier image 必須支援，表示此資料項目可能會完全修正或改變其他資料項目的意涵，需特別留意。詳可參閱Modifier。
A summary searches image 表示此資料項目為摘要的一部分，詳可參閱Summary searches。
A contraint image 表示此資料項目受規範設定的限制(constraints)影響，例如：Patient.name的限制為「name.text(完整中文姓名)」或name.family(英文姓)或者兩者必須填寫」，詳可參閱Constraints。
Card. 基數 此資料項目允許出現在這個resource的最小至最大次數，意即例如某一資料項目的基數若為0..1，表示可不填寫或至多填入1筆；若為1..1，表示必須(只能)填入1筆；若為0..*，表示可不填寫或填入多筆(不限筆數)；若為1..*，表示至少要填入1筆或填入多筆(不限筆數)。
Type 資料型別 資料項目的資料型別(可超連結至該型別的定義)，例如：boolean、integer、dateTime等。
Description &Constraints 描述與限制 此資料項目的描述及詳細的限制，並說明原始CDM資料來源、是否需進行轉換、或依照CDM譯碼簿設計填入對應的說明/文字。並說明其編碼的資料項目可使用何種代碼填寫，如需綁定特定代碼，則以Binding陳述並連結到該值集。
如Patient.birthDate說明: 出生年月日。【TOTFA.d11/TOTFB.d6】，表示資料為出生年月日之資料，資料來源為TOTFA的d11欄位或是TOTFB的d6欄位陳述。

綁定值集(value set)的強度

英文名 中文名 說明
Required 要求使用 應填入代碼表中的其中一個代碼
Preferred 鼓勵使用 鼓勵使用代碼表中的代碼， 但不強制一定要使用此代碼表，你也可使用其他代碼表的代碼或單純以文字表示。
Example 範例 可參考代碼表，但此代碼表只是針對這個欄位的一個可能值的示例，不預期也不鼓勵使用者一定要使用此代碼表的代碼。
Extensible 可擴充 應填入代碼表中適合的代碼，確定無適合的代碼才可以使用其他代碼中的代碼來表示。
如下圖所示，telecom.system應使用ContactPointSystem代碼表(或稱代碼系統)中的其中一個代碼，telecom.use及gender也都有應該搭配使用的代碼表，否則以此IG驗證格式時會出現錯誤訊息。
required examples

其餘詳細規則請詳閱TW Core IG網站