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

## Hồ sơ tài nguyên: Thuốc VN Core — VN Core Medication Profile 

 
Profile Medication cho Việt Nam. Thông tin chi tiết thuốc: mã, tên, dạng bào chế, hàm lượng, số đăng ký. Liên kết với MedicationRequest (đơn thuốc) và Claim (thanh toán BHYT). Căn cứ: 
* **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025
* Luật Dược 2016 — nền tảng quản lý thuốc
* **TT 37/2024/TT-BYT** — 16/11/2024 — danh mục thuốc hóa dược/sinh phẩm thuộc phạm vi BHYT
* **TT 27/2025/TT-BYT** — 01/7/2025 — thuốc dược liệu, thuốc cổ truyền thuộc phạm vi BHYT
* Dược điển VN — chuẩn chất lượng thuốc
* **QĐ 3176/QĐ-BYT** — 29/10/2024 — trường MA_THUOC, TEN_THUOC trong dữ liệu BHXH
* **NĐ 102/2025/NĐ-CP** — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế. Nguồn thiết kế: OHP Data Processor (Medication mapper).
 

**Usages:**

* Refer to this Profile: [Bệnh án điện tử VN Core — VN Core Composition Profile](StructureDefinition-vn-core-composition.md)
* Examples for this Profile: [Medication/ExampleMedicationAmlodipine](Medication-ExampleMedicationAmlodipine.md), [Medication/ExampleMedicationAmoxicillin](Medication-ExampleMedicationAmoxicillin.md), [Medication/ExampleMedicationInsulin](Medication-ExampleMedicationInsulin.md) and [Medication/ExampleMedicationYHCTHerbal](Medication-ExampleMedicationYHCTHerbal.md)
* CapabilityStatements using this Profile: [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)

### 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

#### Constraints

** Summary **

Mandatory: 1 element
 Must-Support: 5 elements

**Extensions**

This structure refers to these extensions:

* [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-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** 

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 1 element
 Must-Support: 5 elements

**Extensions**

This structure refers to these extensions:

* [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-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.csv), [Excel](../StructureDefinition-vn-core-medication.xlsx), [Schematron](../StructureDefinition-vn-core-medication.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-medication",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication",
  "version" : "0.5.0",
  "name" : "VNCoreMedication",
  "title" : "Thuốc VN Core — VN Core Medication 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 Medication cho Việt Nam. Thông tin chi tiết thuốc: mã, tên, dạng bào chế, hàm lượng, số đăng ký.\nLiên kết với MedicationRequest (đơn thuốc) và Claim (thanh toán BHYT).\nCăn cứ:\n- **Luật 44/2024/QH15** — 21/11/2024 — sửa đổi Luật Dược, hiệu lực 01/7/2025\n- Luật Dược 2016 — nền tảng quản lý thuốc\n- **TT 37/2024/TT-BYT** — 16/11/2024 — danh mục thuốc hóa dược/sinh phẩm thuộc phạm vi BHYT\n- **TT 27/2025/TT-BYT** — 01/7/2025 — thuốc dược liệu, thuốc cổ truyền thuộc phạm vi BHYT\n- Dược điển VN — chuẩn chất lượng thuốc\n- **QĐ 3176/QĐ-BYT** — 29/10/2024 — trường MA_THUOC, TEN_THUOC trong dữ liệu BHXH\n- **NĐ 102/2025/NĐ-CP** — 13/5/2025 — dữ liệu thuốc trong CSDL quốc gia về y tế.\nNguồn thiết kế: OHP Data Processor (Medication mapper).",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "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" : "Medication",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Medication",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Medication",
      "path" : "Medication"
    },
    {
      "id" : "Medication.extension",
      "path" : "Medication.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Medication.extension:registrationNumber",
      "path" : "Medication.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" : "Medication.extension:tenderInfo",
      "path" : "Medication.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" : "Medication.extension:processingMethod",
      "path" : "Medication.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" : "Medication.code",
      "path" : "Medication.code",
      "short" : "Mã thuốc (ATC / mã nội bộ / SNOMED CT / YHCT dược liệu)",
      "definition" : "Mã thuốc. Ưu tiên ATC (WHO). Nếu chưa có mã chuẩn, dùng mã nội bộ BV hoặc text tên thuốc.\nVới dược liệu YHCT: dùng mã từ VNYHCTHerbCS (442 dược liệu per QĐ 3080/QĐ-BYT, PL V).",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Medication.form",
      "path" : "Medication.form",
      "short" : "Dạng bào chế (viên nén, dung dịch, bột...)",
      "mustSupport" : true
    },
    {
      "id" : "Medication.amount",
      "path" : "Medication.amount",
      "short" : "Hàm lượng / nồng độ"
    },
    {
      "id" : "Medication.ingredient",
      "path" : "Medication.ingredient",
      "short" : "Thành phần hoạt chất / dược liệu YHCT",
      "definition" : "Thành phần hoạt chất của thuốc. Với thuốc Tây y: hoạt chất chính + phụ. Với bài thuốc YHCT: từng vị thuốc (dược liệu) kèm trọng lượng gram/thang. Mã dược liệu YHCT dùng VNYHCTHerbCS (442 mã per QĐ 3080/QĐ-BYT, PL V).",
      "mustSupport" : true
    },
    {
      "id" : "Medication.ingredient.item[x]",
      "path" : "Medication.ingredient.item[x]",
      "short" : "Hoạt chất / dược liệu (mã hoặc tên)",
      "mustSupport" : true
    },
    {
      "id" : "Medication.ingredient.isActive",
      "path" : "Medication.ingredient.isActive",
      "short" : "Hoạt chất chính (true) hay phụ (false)"
    },
    {
      "id" : "Medication.ingredient.strength",
      "path" : "Medication.ingredient.strength",
      "short" : "Hàm lượng / trọng lượng (VD: 500mg, 12g/thang)",
      "definition" : "Hàm lượng hoạt chất hoặc trọng lượng dược liệu YHCT. Đơn vị: mg/g cho Tây y, g hoặc g/thang cho YHCT.",
      "mustSupport" : true
    },
    {
      "id" : "Medication.batch",
      "path" : "Medication.batch",
      "short" : "Lô sản xuất"
    },
    {
      "id" : "Medication.batch.lotNumber",
      "path" : "Medication.batch.lotNumber",
      "short" : "Số lô"
    },
    {
      "id" : "Medication.batch.expirationDate",
      "path" : "Medication.batch.expirationDate",
      "short" : "Hạn sử dụng"
    }]
  }
}

```
