# Đơn thuốc VN Core — VN Core MedicationRequest Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Đơn thuốc VN Core — VN Core MedicationRequest Profile 

 
Profile MedicationRequest cho Việt Nam. Dùng cho đơn thuốc điện tử (ePrescription). Hỗ trợ đơn thuốc ngoại trú, nội trú, cấp cứu. Liên kết với BHYT qua Coverage/Claim. Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (trường MA_THUOC trong chuẩn dữ liệu BHXH), Luật Dược 2016 Điều 74 (kê đơn thuốc). Căn cứ bổ sung: 
* **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025
* **TT 26/2025/TT-BYT** — 30/6/2025 — kê đơn thuốc hóa dược, sinh phẩm trong điều trị ngoại trú; hiệu lực 01/7/2025
* **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số và dữ liệu đơn thuốc trong CSDL quốc gia về y tế. / VN Core MedicationRequest profile for electronic prescriptions (ePrescription). Supports outpatient, inpatient, and emergency prescriptions. Links to insurance via Coverage/Claim. Per TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field), Pharmaceutical Law 2016 Art.74 and amended by Law 44/2024/QH15; TT 26/2025/TT-BYT for outpatient/electronic prescribing.
 

**Usages:**

* Refer to this Profile: [Bệnh án điện tử VN Core — VN Core Composition Profile](StructureDefinition-vn-core-composition.md) and [Cấp phát thuốc VN Core — VN Core Medication Dispense Profile](StructureDefinition-vn-core-medication-dispense.md)
* Examples for this Profile: [MedicationRequest/ExampleMedicationRequestAmoxicillin](MedicationRequest-ExampleMedicationRequestAmoxicillin.md), [MedicationRequest/ExampleMedicationRequestHypertension](MedicationRequest-ExampleMedicationRequestHypertension.md) and [MedicationRequest/ExampleMedicationRequestYHCT](MedicationRequest-ExampleMedicationRequestYHCT.md)
* CapabilityStatements using this Profile: [VN Core EMR Server CapabilityStatement](CapabilityStatement-vn-core-emr-server.md) and [VN Core Server CapabilityStatement](CapabilityStatement-vn-core-server.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-request)

### 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: 14 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)
* [Thẻ BHYT VN Core — VN Core Coverage Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage)](StructureDefinition-vn-core-coverage.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-order-date](StructureDefinition-vn-ext-order-date.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: 14 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)
* [Thẻ BHYT VN Core — VN Core Coverage Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage)](StructureDefinition-vn-core-coverage.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-order-date](StructureDefinition-vn-ext-order-date.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-request.csv), [Excel](../StructureDefinition-vn-core-medication-request.xlsx), [Schematron](../StructureDefinition-vn-core-medication-request.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-medication-request",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request",
  "version" : "0.5.0",
  "name" : "VNCoreMedicationRequest",
  "title" : "Đơn thuốc VN Core — VN Core MedicationRequest Profile",
  "status" : "draft",
  "date" : "2026-03-21",
  "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 MedicationRequest cho Việt Nam. Dùng cho đơn thuốc điện tử (ePrescription).\nHỗ trợ đơn thuốc ngoại trú, nội trú, cấp cứu. Liên kết với BHYT qua Coverage/Claim.\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 130/QĐ-BYT sửa đổi bởi QĐ 3176/QĐ-BYT (trường MA_THUOC trong chuẩn dữ liệu BHXH),\nLuật Dược 2016 Điều 74 (kê đơn thuốc).\nCăn cứ bổ sung:\n- **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025\n- **TT 26/2025/TT-BYT** — 30/6/2025 — kê đơn thuốc hóa dược, sinh phẩm trong điều trị ngoại trú; hiệu lực 01/7/2025\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — quản lý dữ liệu y tế số và dữ liệu đơn thuốc trong CSDL quốc gia về y tế. /\nVN Core MedicationRequest profile for electronic prescriptions (ePrescription).\nSupports outpatient, inpatient, and emergency prescriptions. Links to insurance via Coverage/Claim.\nPer TT 13/2025/TT-BYT (EMR), QĐ 3176/QĐ-BYT (BHXH data standard — MA_THUOC field),\nPharmaceutical Law 2016 Art.74 and amended by Law 44/2024/QH15; TT 26/2025/TT-BYT for outpatient/electronic prescribing.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "script10.6",
    "uri" : "http://ncpdp.org/SCRIPT10_6",
    "name" : "Mapping to NCPDP SCRIPT 10.6"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "MedicationRequest",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/MedicationRequest",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "MedicationRequest",
      "path" : "MedicationRequest"
    },
    {
      "id" : "MedicationRequest.extension",
      "path" : "MedicationRequest.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "MedicationRequest.extension:insuranceCostInfo",
      "path" : "MedicationRequest.extension",
      "sliceName" : "insuranceCostInfo",
      "short" : "Thông tin BHYT: phạm vi (PHAM_VI), tỷ lệ TT (TYLE_TT), mức hưởng (MUC_HUONG)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"]
      }]
    },
    {
      "id" : "MedicationRequest.extension:registrationNumber",
      "path" : "MedicationRequest.extension",
      "sliceName" : "registrationNumber",
      "short" : "Số đăng ký thuốc (SO_DANG_KY)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-med-reg-number"]
      }]
    },
    {
      "id" : "MedicationRequest.extension:orderDate",
      "path" : "MedicationRequest.extension",
      "sliceName" : "orderDate",
      "short" : "Ngày y lệnh (NGAY_YL)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-order-date"]
      }]
    },
    {
      "id" : "MedicationRequest.extension:paymentSource",
      "path" : "MedicationRequest.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" : "MedicationRequest.extension:tenderInfo",
      "path" : "MedicationRequest.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" : "MedicationRequest.extension:processingMethod",
      "path" : "MedicationRequest.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" : "MedicationRequest.status",
      "path" : "MedicationRequest.status",
      "short" : "Trạng thái đơn thuốc",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.intent",
      "path" : "MedicationRequest.intent",
      "short" : "Ý định: order (kê đơn) | proposal | plan",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.category",
      "path" : "MedicationRequest.category",
      "short" : "Loại đơn thuốc: ngoại trú (outpatient), nội trú (inpatient), cấp cứu",
      "definition" : "Phân loại bối cảnh kê đơn. Đơn thuốc ngoại trú và đơn thuốc điện tử tham chiếu TT 26/2025/TT-BYT; đơn nội trú/cấp cứu gắn với bệnh án điện tử theo TT 13/2025/TT-BYT.",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.medication[x]",
      "path" : "MedicationRequest.medication[x]",
      "short" : "Thuốc được kê (ATC/SNOMED CT/tên thuốc / bài thuốc YHCT)",
      "definition" : "Thuốc được kê đơn. Ưu tiên mã hóa bằng ATC (WHO) hoặc SNOMED CT.\nNếu chưa có mã, sử dụng text (tên thương mại hoặc tên hoạt chất).\nVới bài thuốc YHCT: dùng mã từ VNYHCTPrescriptionCS (522 bài thuốc per QĐ 3080/QĐ-BYT, PL VI).\nLưu ý: VN chưa có bộ mã thuốc quốc gia dạng FHIR — sẽ bổ sung khi BYT/Dược điển VN publish.",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.subject",
      "path" : "MedicationRequest.subject",
      "short" : "Bệnh nhân được kê đơn",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.encounter",
      "path" : "MedicationRequest.encounter",
      "short" : "Lượt khám liên quan",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter"]
      }]
    },
    {
      "id" : "MedicationRequest.authoredOn",
      "path" : "MedicationRequest.authoredOn",
      "short" : "Ngày kê đơn",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.requester",
      "path" : "MedicationRequest.requester",
      "short" : "Bác sĩ kê đơn",
      "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" : "MedicationRequest.reasonCode",
      "path" : "MedicationRequest.reasonCode",
      "short" : "Lý do kê đơn (mã ICD-10)",
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs"
      }
    },
    {
      "id" : "MedicationRequest.insurance",
      "path" : "MedicationRequest.insurance",
      "short" : "Thẻ BHYT (nếu đơn BHYT)",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"]
      }]
    },
    {
      "id" : "MedicationRequest.note",
      "path" : "MedicationRequest.note",
      "short" : "Ghi chú bổ sung"
    },
    {
      "id" : "MedicationRequest.dosageInstruction",
      "path" : "MedicationRequest.dosageInstruction",
      "short" : "Hướng dẫn liều dùng",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.dosageInstruction.text",
      "path" : "MedicationRequest.dosageInstruction.text",
      "short" : "Hướng dẫn dạng text (VD: Uống 500mg, 3 lần/ngày, sau ăn)",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.dosageInstruction.timing",
      "path" : "MedicationRequest.dosageInstruction.timing",
      "short" : "Lịch dùng thuốc (tần suất, thời điểm)",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.dosageInstruction.route",
      "path" : "MedicationRequest.dosageInstruction.route",
      "short" : "Đường dùng (uống, tiêm, bôi...) — 55 mã per Dược điển VN",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-medication-route-vs"
      }
    },
    {
      "id" : "MedicationRequest.dosageInstruction.doseAndRate",
      "path" : "MedicationRequest.dosageInstruction.doseAndRate",
      "short" : "Liều lượng và tốc độ",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.dispenseRequest",
      "path" : "MedicationRequest.dispenseRequest",
      "short" : "Yêu cầu cấp phát",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.dispenseRequest.quantity",
      "path" : "MedicationRequest.dispenseRequest.quantity",
      "short" : "Tổng số lượng cấp phát",
      "mustSupport" : true
    },
    {
      "id" : "MedicationRequest.dispenseRequest.expectedSupplyDuration",
      "path" : "MedicationRequest.dispenseRequest.expectedSupplyDuration",
      "short" : "Số ngày cung cấp"
    },
    {
      "id" : "MedicationRequest.substitution",
      "path" : "MedicationRequest.substitution",
      "short" : "Thay thế thuốc"
    }]
  }
}

```
