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

臺灣電子處方箋與調劑單張實作指引(TW EMPD IG), published by NHI. This guide is not an authorized publication; it is the continuous build for version 0.2.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/TWNHIFHIR/empd/ and changes regularly. 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-08-28 Computable Name: EMPD

請注意:您目前所看到的IG為持續建置 (ci-build) 版,主要依據實作者及業務端需求即時調整,因而會比健保署 正式版 IG 內容新,僅供未來想以最新版本規格進行資料上傳的人員參考,於正式發布後才會調整健保署FHIR伺服器規格。

醫院實作時請以V0.1.0為主進行實例驗證,目前健保署端的伺服器採用V0.1.0版規格。


因考量實作需求,於2026/8/28異動以下內容:
  1. 確保實務上代碼使用的有效性,此版本IG繼承 TW Core 0.3.2 版本
  2. 新增代碼 ValueSet: NHI-電子處方箋-用藥品項:供Medication.code及MedicationRequest.medicationCodeableConcept使用
  3. 新增代碼 ValueSet: HL7 TimingAbbreviation + NHI-電子處方箋-藥品使用頻率值集:供MedicationRequest.dosageInstruction.timing使用
  4. 新增代碼 ValueSet: 無健保代碼之藥品:供無健保代碼藥物品項使用
  5. 新增代碼 ValueSet: 無健保代碼之特材:供無健保代碼特材使用
  6. 新增代碼 ValueSet: 部分負擔代碼值集:供Encounter.type使用
  7. 新增代碼 ValueSet: 就醫身分別值集:供Coverage.type.coding使用
  8. 新增 Extension: 給付類別(Extension-PaymentCategory)
    • Extension.url:固定 https://nhicore.nhi.gov.tw/empd/StructureDefinition/Extension-PaymentCategory
    • Extension.value[x]:必填CodeableConcept,required綁定 ValueSet: 給付類別值集
  9. 修改 Profile: 電子處方箋-Bundle(Bundle-EMPD)
    • Constraints: enc-nhi-1:就醫身分別為健保( 00 )時,健保卡就醫序號必填
    • Bundleempd-medreq-1):處方箋種類為管制藥(DEF)時,醫師證號與管制藥品執照皆必填
    • 因特材改於 MedicationRequest 填寫,Medication 可為非必填:
      • Bundle.entry:基數 9..*8..*
      • Bundle.entry:Medication:基數 1..*0..*
      • Bundle.entry:CoverageIdentifier:基數 1..*1..1
  10. 修改 Profile: 電子處方箋-Composition(Composition-EMPD)
    • Composition.date:語意改為處方箋有效期間迄
    • Composition.section:Coverage:基數1..*1..1
    • 因特材改於 MedicationRequest 填寫,Medication 可為非必填:
      • Composition.section:MedicationPrescribed.entry:基數2..*1..*
      • Composition.section:MedicationPrescribed.entry:Medication:基數1..*0..*
  11. 修改 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.class:binding 改為 ValueSet: NHI-健保案件分類值集
    • Encounter.type:原Condition.note之部分負擔代碼改至此欄位,並新增綁定部分負擔代碼值集
  12. 修改 Profile: 電子處方箋/調劑單張-就醫身分別(Coverage-EMR)
    • Coverage.type.coding:原Coverage.type.text之就醫身分別改至此欄位,並新增綁定 就醫身分別值集
    • Coverage.extension:PaymentCategory:原Coverage.type.coding之給付類別改至此欄位,並綁定 給付類別值集
  13. 修改 Profile: 電子處方箋-醫事機構基本資料(Organization-EMPD)
  14. 修改 Profile: 電子處方箋-病人基本資料(Patient-EMPD):新增constraint pat-id-1,病人之國民身分證統一編號/護照號碼/居留證號,至少需填寫一種
  15. 修改 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:原Practitioner.identifier.value之管制藥品使用執照改至此欄位;system固定https://cdmis.fda.gov.twvalue請填寫管制藥品使用執照號
  16. 修改 Profile: 電子處方箋-藥物處方內容(Medication-EMPD)
    • Medication.code.coding:nhi-medication:新增電子處方箋用藥品項 slice,綁定 ValueSet: NHI-電子處方箋-用藥品項值集,此值集將根據健保用藥品項定期更新。
    • Medication.code.coding:nonNHIMedication:新增無健保代碼藥物品項 slice,system固定填寫https://nhicore.nhi.gov.tw/empd/CodeSystem/NonNHIMedication-cs,value應為999999加院所自訂流水號4碼,共10碼
    • Medicationempd-med-1):自費藥品且無藥品許可證字號時,代碼須為999999+4碼流水號自行編碼
    • 配合FHIR Ratio資料型態定義,調整Medication.ingredient.strength之 numerator/denominator及其valuesystem(固定UCUM http://unitsofmeasure.org)、code皆改為必填
  17. 修改 Profile: 電子處方箋-處方內容(MedicationRequest-EMPD)
    • MedicationRequestempd-ord-1):醫令類別非特材(3)時,須有劑量/頻率/途徑/日數/總量等相關欄位
    • MedicationRequestempd-medreq-2):未使用medicationReference表示藥品時,應以medicationCodeableConcept填寫特材代碼
    • MedicationRequestempd-medreq-3):無健保代碼之特材暫編碼須符合編碼規則:共12碼,第1-2碼依現行特材代碼前2碼編碼原則、第3碼為大寫「Z」、第4-9碼為許可證號(6碼)、第10-12碼為流水號(3碼)
    • MedicationRequest.status:原MedicationRequest.note之處方箋註銷註記改至此欄位表示,限使用active表示處方箋有效、cancelled表示處方箋已註銷
    • MedicationRequest.category:orderType:基數0..11..1,醫令類別改為必填
    • MedicationRequest.medication[x]:medicationCodeableConcept:用以表示無健保代碼特材,system固定填寫https://nhicore.nhi.gov.tw/empd/CodeSystem/NonNHIMaterial-cs
    • MedicationRequest.note
      • 改為表示「須被合併之處方箋註記」
      • 原「處方箋註銷註記」改至 MedicationRequest.status
      • 原「自費註記」改至 MedicationRequest.category:selfpayStatus
    • MedicationRequest.dosageInstruction.timing.code:改為綁定ValueSet: HL7 TimingAbbreviation + NHI-電子處方箋-藥品使用頻率值集
    • MedicationRequest.dosageInstruction.doseAndRate.dose[x]doseQuantity:基數1..10..1,當為特材時可不填
  18. 修改 Profile: 電子處方箋-診斷(Condition-EMPD)
    • Condition.note
      • 改為表示「醫療評估內容註記」
      • 原「部分負擔代碼」改至 Encounter.type
  19. 修改 Profile: 調劑單張-Bundle(Bundle-DS)
    • Bundle.entry:最低筆數1211
    • Bundle.entry:ObservationBodyWeight:上限改為1
    • Bundle.entry:Coverage:基數1..*1..1
    • Bundle.entry:Media:基數1..*0..*(領藥簽章改選填)
  20. 修改 Profile: 調劑單張-Composition(Composition-DS)
    • Composition.section:Coverage:基數1..*1..1
    • Composition.section:Media:上限1*(配合領藥簽章改選填)
  21. 修改 Profile: 調劑單張-藥物處方內容(Medication-DS):新增Medication.code.coding:nhi-medication0..1,Must Support),required綁定NHIMedication-vs
  22. 修改 Profile: 調劑單張-處方內容(MedicationRequest-DS)
    • MedicationRequest.category:selfpayStatus:補充若自費註記為Y,無須檢核健保代碼
    • MedicationRequest.medication[x]:medicationCodeableConcept.coding:nhi-medication:新增0..1(Must Support),required綁定NHIMedication-vs
    • MedicationRequest.dosageInstruction.timing.code及其coding:required綁定NHIMedicationFrequency-HL7-vs
    • MedicationRequest.note:取消必填min=1;自費註記改由category承載
  23. 修改 Profile: 調劑單張-領藥者數位簽章(Media-DS)Media.note新增Must Support,供QR Code相關說明
請留意這些異動,以避免影響您的實作。

專案介紹

臺灣電子處方箋與調劑單張實作指引(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)V1.0.0版本,進一步定義適用於臺灣電子處方箋與調劑單張資料需求的Resources(類似資料表)、其中的資料項目(意即欄位)、基數(意即0..1、0..、1..1或1..)及資料類型(文字、日期時間、代碼等)等。

專案背景

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

為了延續「網路健康服務推動計畫(民國91至94年)」、「衛生局所網路便民服務計畫(民國92至95年)」等計畫之基礎,落實本部「全人健康照護」政策目標,推動「從出生前到老去健康資訊e化流通」發展策略,民國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網站