# Cấp phát thuốc VN Core — VN Core Medication Dispense Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Cấp phát thuốc VN Core — VN Core Medication Dispense Profile 

 
Profile MedicationDispense cho Việt Nam. Dùng để ghi nhận cấp phát thuốc trong chu trình đơn thuốc điện tử, điều trị nội trú/ngoại trú, bệnh án điện tử, và dữ liệu phục vụ thanh toán BHYT. Căn cứ pháp lý hiện hành: 
* **Luật Dược 105/2016/QH13 ngày 06/4/2016 Điều 74** — nguyên tắc kê đơn/cấp phát thuốc
* **Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36** — sửa đổi Điều 74 Luật Dược, giao Bộ Y tế quy định chi tiết đơn thuốc, ứng dụng CNTT, liên thông CSDL quốc gia về y tế
* **NĐ 163/2025/NĐ-CP ngày 29/6/2025** — hướng dẫn Luật Dược, thay thế hoàn toàn NĐ 54/2017/NĐ-CP từ 01/7/2025 theo Điều 129
* **TT 26/2025/TT-BYT** — kê đơn thuốc ngoại trú: Điều 5 về kê đơn ngoại trú và sau điều trị nội trú; Điều 10 về giá trị pháp lý của đơn thuốc điện tử; Điều 12 về liên thông Hệ thống đơn thuốc quốc gia và lĩnh thuốc trong 05 ngày từ ngày kê
* **TT 20/2022/TT-BYT + TT 37/2024/TT-BYT** — danh mục, tỷ lệ và điều kiện thanh toán thuốc hóa dược, sinh phẩm, thuốc phóng xạ và chất đánh dấu thuộc phạm vi BHYT
* **TT 27/2025/TT-BYT** — thuốc y học cổ truyền thuộc phạm vi BHYT, hiệu lực 01/9/2025
* **QĐ 3176/QĐ-BYT (29/10/2024)** — XML3: MA_THUOC, SO_DANG_KY, NGAY_YL
* **QĐ 697/QĐ-BYT (19/3/2026)** — mẫu bảng kê chi phí KCB, danh mục chi phí thuốc là 1/12 nhóm
* **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — thanh toán BHYT thuốc
* **NĐ 164/2025/NĐ-CP (29/6/2025)** — giao dịch điện tử/API Cổng BHXH
* **TT 13/2025/TT-BYT (06/6/2025)** — bệnh án điện tử ghi nhận thông tin cấp phát thuốc. Ghi chú: NĐ 54/2017/NĐ-CP chỉ là legacy reference và không được dùng làm current basis sau 01/7/2025. / VN Core MedicationDispense profile for recording medication dispensing events in Vietnamese EMR, ePrescription, inpatient/outpatient, and BHYT reimbursement workflows.
 

**Usages:**

* Examples for this Profile: [MedicationDispense/ExampleMedicationDispenseInpatientAntibiotic](MedicationDispense-ExampleMedicationDispenseInpatientAntibiotic.md) and [MedicationDispense/ExampleMedicationDispenseOutpatientBHYT](MedicationDispense-ExampleMedicationDispenseOutpatientBHYT.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.vn.core|current/StructureDefinition/vn-core-medication-dispense)

### Các dạng xem hình thức của nội dung hồ sơ

 [Mô tả profile, differential, snapshot và các biểu diễn liên quan](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

*  [Bảng phần tử chính](#tabs-key) 
*  [Bảng Differential](#tabs-diff) 
*  [Bảng Snapshot](#tabs-snap) 
*  [Thống kê/Tham chiếu](#tabs-summ) 
*  [Tất cả](#tabs-all) 

#### Terminology Bindings

#### Constraints

#### Terminology Bindings (Differential)

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 2 elements
 Must-Support: 16 elements

**Structures**

This structure refers to these other structures:

* [Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)](StructureDefinition-vn-core-patient.md)
* [Lượt khám/nhập viện VN Core — VN Core Encounter Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter)](StructureDefinition-vn-core-encounter.md)
* [Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)](StructureDefinition-vn-core-practitioner.md)
* [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)](StructureDefinition-vn-core-practitioner-role.md)
* [Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)](StructureDefinition-vn-core-organization.md)
* [Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location)](StructureDefinition-vn-core-location.md)
* [Đơn thuốc VN Core — VN Core MedicationRequest Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request)](StructureDefinition-vn-core-medication-request.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info](StructureDefinition-vn-ext-insurance-cost-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number](StructureDefinition-vn-ext-med-reg-number.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source](StructureDefinition-vn-ext-payment-source.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info](StructureDefinition-vn-ext-tender-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method](StructureDefinition-vn-ext-traditional-processing-method.md)

 **Dạng xem phần tử chính** 

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Terminology Bindings (Differential)

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 2 elements
 Must-Support: 16 elements

**Structures**

This structure refers to these other structures:

* [Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)](StructureDefinition-vn-core-patient.md)
* [Lượt khám/nhập viện VN Core — VN Core Encounter Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter)](StructureDefinition-vn-core-encounter.md)
* [Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)](StructureDefinition-vn-core-practitioner.md)
* [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)](StructureDefinition-vn-core-practitioner-role.md)
* [Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)](StructureDefinition-vn-core-organization.md)
* [Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location)](StructureDefinition-vn-core-location.md)
* [Đơn thuốc VN Core — VN Core MedicationRequest Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request)](StructureDefinition-vn-core-medication-request.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info](StructureDefinition-vn-ext-insurance-cost-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number](StructureDefinition-vn-ext-med-reg-number.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source](StructureDefinition-vn-ext-payment-source.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info](StructureDefinition-vn-ext-tender-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method](StructureDefinition-vn-ext-traditional-processing-method.md)

 

Biểu diễn khác của hồ sơ: [CSV](../StructureDefinition-vn-core-medication-dispense.csv), [Excel](../StructureDefinition-vn-core-medication-dispense.xlsx), [Schematron](../StructureDefinition-vn-core-medication-dispense.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-medication-dispense",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense",
  "version" : "0.5.0",
  "name" : "VNCoreMedicationDispense",
  "title" : "Cấp phát thuốc VN Core — VN Core Medication Dispense Profile",
  "status" : "draft",
  "date" : "2026-04-14",
  "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
  "contact" : [{
    "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.org.vn"
    },
    {
      "system" : "email",
      "value" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Profile MedicationDispense cho Việt Nam. Dùng để ghi nhận cấp phát thuốc trong chu trình đơn thuốc điện tử, điều trị nội trú/ngoại trú, bệnh án điện tử, và dữ liệu phục vụ thanh toán BHYT.\nCăn cứ pháp lý hiện hành:\n- **Luật Dược 105/2016/QH13 ngày 06/4/2016 Điều 74** — nguyên tắc kê đơn/cấp phát thuốc\n- **Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36** — sửa đổi Điều 74 Luật Dược, giao Bộ Y tế quy định chi tiết đơn thuốc, ứng dụng CNTT, liên thông CSDL quốc gia về y tế\n- **NĐ 163/2025/NĐ-CP ngày 29/6/2025** — hướng dẫn Luật Dược, thay thế hoàn toàn NĐ 54/2017/NĐ-CP từ 01/7/2025 theo Điều 129\n- **TT 26/2025/TT-BYT** — kê đơn thuốc ngoại trú: Điều 5 về kê đơn ngoại trú và sau điều trị nội trú; Điều 10 về giá trị pháp lý của đơn thuốc điện tử; Điều 12 về liên thông Hệ thống đơn thuốc quốc gia và lĩnh thuốc trong 05 ngày từ ngày kê\n- **TT 20/2022/TT-BYT + TT 37/2024/TT-BYT** — danh mục, tỷ lệ và điều kiện thanh toán thuốc hóa dược, sinh phẩm, thuốc phóng xạ và chất đánh dấu thuộc phạm vi BHYT\n- **TT 27/2025/TT-BYT** — thuốc y học cổ truyền thuộc phạm vi BHYT, hiệu lực 01/9/2025\n- **QĐ 3176/QĐ-BYT (29/10/2024)** — XML3: MA_THUOC, SO_DANG_KY, NGAY_YL\n- **QĐ 697/QĐ-BYT (19/3/2026)** — mẫu bảng kê chi phí KCB, danh mục chi phí thuốc là 1/12 nhóm\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — thanh toán BHYT thuốc\n- **NĐ 164/2025/NĐ-CP (29/6/2025)** — giao dịch điện tử/API Cổng BHXH\n- **TT 13/2025/TT-BYT (06/6/2025)** — bệnh án điện tử ghi nhận thông tin cấp phát thuốc.\nGhi chú: NĐ 54/2017/NĐ-CP chỉ là legacy reference và không được dùng làm current basis sau 01/7/2025.\n/\nVN Core MedicationDispense profile for recording medication dispensing events in Vietnamese EMR, ePrescription, inpatient/outpatient, and BHYT reimbursement workflows.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "copyright" : "Căn cứ pháp lý Việt Nam: Luật Dược 105/2016/QH13 ngày 06/04/2016 Điều 74; Luật 44/2024/QH15 ngày 21/11/2024 Điều 1 khoản 36; NĐ 163/2025/NĐ-CP ngày 29/06/2025, hiệu lực 01/07/2025 và thay thế NĐ 54/2017/NĐ-CP theo Điều 129; TT 26/2025/TT-BYT; TT 20/2022/TT-BYT; TT 37/2024/TT-BYT; TT 27/2025/TT-BYT; QĐ 3176/QĐ-BYT ngày 29/10/2024; QĐ 697/QĐ-BYT ngày 19/03/2026; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025; NĐ 164/2025/NĐ-CP ngày 29/06/2025; TT 13/2025/TT-BYT ngày 06/06/2025.",
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "rx-dispense-rmim",
    "uri" : "http://www.hl7.org/v3/PORX_RM020070UV",
    "name" : "V3 Pharmacy Dispense RMIM"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "MedicationDispense",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/MedicationDispense",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "MedicationDispense",
      "path" : "MedicationDispense"
    },
    {
      "id" : "MedicationDispense.extension",
      "path" : "MedicationDispense.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "MedicationDispense.extension:insuranceCostInfo",
      "path" : "MedicationDispense.extension",
      "sliceName" : "insuranceCostInfo",
      "short" : "Thông tin BHYT: phạm vi, tỷ lệ thanh toán, mức hưởng",
      "definition" : "Thông tin chi phí BHYT cấp item thuốc. Reuse extension đang dùng trên MedicationRequest/Claim.item để giữ chuỗi kê đơn → cấp phát → thanh toán.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.extension:registrationNumber",
      "path" : "MedicationDispense.extension",
      "sliceName" : "registrationNumber",
      "short" : "Số đăng ký thuốc (SO_DANG_KY)",
      "definition" : "Số đăng ký lưu hành thuốc, mapping QĐ 3176/QĐ-BYT XML3 trường SO_DANG_KY.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.extension:paymentSource",
      "path" : "MedicationDispense.extension",
      "sliceName" : "paymentSource",
      "short" : "Nguồn chi trả cho dòng thuốc (NGUON_CTRA)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source"]
      }]
    },
    {
      "id" : "MedicationDispense.extension:tenderInfo",
      "path" : "MedicationDispense.extension",
      "sliceName" : "tenderInfo",
      "short" : "Thông tin thầu (TT_THAU)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info"]
      }]
    },
    {
      "id" : "MedicationDispense.extension:processingMethod",
      "path" : "MedicationDispense.extension",
      "sliceName" : "processingMethod",
      "short" : "Phương pháp chế biến YHCT (MA_PP_CHEBIEN)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method"]
      }]
    },
    {
      "id" : "MedicationDispense.status",
      "path" : "MedicationDispense.status",
      "short" : "Trạng thái cấp phát thuốc",
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.category",
      "path" : "MedicationDispense.category",
      "short" : "Bối cảnh cấp phát: inpatient, outpatient, community, discharge",
      "definition" : "Phân loại bối cảnh cấp phát thuốc. Dùng các mã FHIR R4 medicationdispense-category tại http://terminology.hl7.org/fhir/CodeSystem/medicationdispense-category: inpatient, outpatient, community, discharge.",
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.medication[x]",
      "path" : "MedicationDispense.medication[x]",
      "short" : "Thuốc được cấp phát",
      "definition" : "Thuốc được cấp phát. Ưu tiên ATC, SNOMED CT, mã thuốc quốc gia khi có, hoặc text tên thuốc/quy cách. Thiết kế nhất quán với VNCoreMedicationRequest khi chưa có VNMedicationCodeVS chính thức.",
      "type" : [{
        "code" : "CodeableConcept"
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.subject",
      "path" : "MedicationDispense.subject",
      "short" : "Bệnh nhân nhận thuốc",
      "min" : 1,
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.context",
      "path" : "MedicationDispense.context",
      "short" : "Lượt khám/điều trị liên quan",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.performer",
      "path" : "MedicationDispense.performer",
      "short" : "Người hoặc đơn vị cấp phát",
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.performer.actor",
      "path" : "MedicationDispense.performer.actor",
      "short" : "Dược sĩ, vai trò hành nghề, hoặc khoa Dược/cơ sở cấp phát",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.location",
      "path" : "MedicationDispense.location",
      "short" : "Địa điểm cấp phát thuốc",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.authorizingPrescription",
      "path" : "MedicationDispense.authorizingPrescription",
      "short" : "Đơn thuốc/y lệnh cho lần cấp phát",
      "definition" : "Liên kết MedicationDispense với VNCoreMedicationRequest để bảo toàn chuỗi BHYT: kê đơn → cấp phát → Claim/EOB.",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.quantity",
      "path" : "MedicationDispense.quantity",
      "short" : "Số lượng thuốc đã cấp",
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.daysSupply",
      "path" : "MedicationDispense.daysSupply",
      "short" : "Số ngày thuốc đã cấp",
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.whenHandedOver",
      "path" : "MedicationDispense.whenHandedOver",
      "short" : "Ngày giờ giao thuốc cho người bệnh",
      "definition" : "Ngày giờ thuốc được giao cho người bệnh hoặc khoa điều trị. Mapping XML3/QĐ 3176: NGAY_CAP khi hệ thống nguồn có trường này; trong dữ liệu y lệnh, đối chiếu thêm NGAY_YL.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.dosageInstruction",
      "path" : "MedicationDispense.dosageInstruction",
      "short" : "Hướng dẫn dùng thuốc khi cấp phát",
      "mustSupport" : true
    },
    {
      "id" : "MedicationDispense.dosageInstruction.route",
      "path" : "MedicationDispense.dosageInstruction.route",
      "short" : "Đường dùng thuốc",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-medication-route-vs"
      }
    }]
  }
}

```
