| Left: | Thuốc VN Core — VN Core Medication Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication) |
| Right: | Thuốc VN Core — VN Core Medication Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication) |
| Error | StructureDefinition.version | Values for version differ: '0.8.0' vs '0.9.0' |
| Information | StructureDefinition.short | Values for short differ: 'Business identifier for this medication' vs 'Định danh thuốc: số đăng ký lưu hành, GTIN bao gói' |
| Warning | Medication.identifier | Elements differ in definition for mustSupport: 'false' vs 'true' |
| Information | StructureDefinition.short | Values for short differ: 'Mã thuốc (ATC / mã nội bộ / SNOMED CT / YHCT dược liệu)' vs 'Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại)' |
| Information | StructureDefinition.definition | Values for definition differ: '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. Với dược liệu YHCT: dùng mã từ VNYHCTHerbCS (442 dược liệu theo QĐ 3080/QĐ-BYT, PL V).' vs 'Mã thuốc ở tầng SẢN PHẨM hoặc clinical drug (hoạt chất + hàm lượng + dạng bào chế). Khi có mã sản phẩm quốc gia thì dùng mã đó; nếu chưa có, dùng SNOMED CT clinical drug, mã nội bộ cơ sở, hoặc text tên thuốc kèm quy cách. ATC (WHO) là hệ thống PHÂN LOẠI giải phẫu-điều trị-hóa học, KHÔNG định danh sản phẩm — chỉ dùng làm coding phụ trong `code.coding`, không dùng làm coding duy nhất khi cần truy vết sản phẩm cụ thể. Số đăng ký lưu hành KHÔNG thuộc `code`: đó là định danh, đặt ở `Medication.identifier` với NamingSystem VNDrugRegistrationNumberNS (analysis/62 #3 tầng 1). Với dược liệu YHCT: dùng mã từ VNYHCTHerbCS (442 dược liệu theo QĐ 3080/QĐ-BYT, PL V).' |
| Information | StructureDefinition.short | Values for short differ: 'Hàm lượng / nồng độ' vs 'Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng' |
| Information | StructureDefinition.definition | Values for definition differ: 'Specific amount of the drug in the packaged product. For example, when specifying a product that has the same strength (For example, Insulin glargine 100 unit per mL solution for injection), this attribute provides additional clarification of the package amount (For example, 3 mL, 10mL, etc.).' vs 'Tổng lượng thuốc chứa trong một đơn vị đóng gói được mô tả bởi resource này. Hàm lượng hoạt chất và nồng độ đặt ở `ingredient.strength`, không đặt ở đây.' |
| Name | Value | Comments | |
|---|---|---|---|
abstract | false | ||
baseDefinition | http://hl7.org/fhir/StructureDefinition/Medication | ||
copyright | |||
date | 2026-05-10 | ||
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ý. 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** — ban hành 01/7/2025, hiệu lực 01/9/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). | ||
experimental | |||
fhirVersion | 4.0.1 | ||
jurisdiction | |||
![]() jurisdiction[0] | urn:iso:std:iso:3166#VN | ||
kind | resource | ||
name | VNCoreMedication | ||
publisher | Omi HealthTech / VN Core FHIR Community Initiative | ||
purpose | |||
status | draft | ||
title | Thuốc VN Core — VN Core Medication Profile | ||
type | Medication | ||
url | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication | ||
version | 0.8.0 | 0.9.0 |
|
| Name | L Flags | L Card. | L Type | L Description & Constraints | R Flags | R Card. | R Type | R Description & Constraints | Comments![]() | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
![]() | 0..* | Medication | Definition of a Medication | 0..* | Medication | Definition of a Medication | |||||||||||
![]() ![]() | Σ | 0..1 | id | Logical id of this artifact | Σ | 0..1 | id | Logical id of this artifact | |||||||||
![]() ![]() | Σ | 0..1 | Meta | Metadata about the resource | Σ | 0..1 | Meta | Metadata about the resource | |||||||||
![]() ![]() | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||
![]() ![]() | 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| |||||||||||
![]() ![]() | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||||
![]() ![]() | 0..* | Resource | Contained, inline Resources | 0..* | Resource | Contained, inline Resources | |||||||||||
![]() ![]() | 0..* | Extension | Extension Slice: Unordered, Open by value:url | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored | ?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||
![]() ![]() | Σ | 0..* | Identifier | Business identifier for this medication | SΣ | 0..* | Identifier | Định danh thuốc: số đăng ký lưu hành, GTIN bao gói Slice: Unordered, Open by value:system |
| ||||||||
![]() ![]() | SΣ | 1..1 | CodeableConcept | Mã thuốc (ATC / mã nội bộ / SNOMED CT / YHCT dược liệu) Binding: ?? (example): A coded concept that defines the type of a medication. | SΣ | 1..1 | CodeableConcept | Mã thuốc — mã sản phẩm hoặc clinical drug; ATC chỉ là coding phụ (phân loại) Binding: ?? (example): A coded concept that defines the type of a medication. | |||||||||
![]() ![]() | ?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: ?? (required): A coded concept defining if the medication is in active use. | ?!Σ | 0..1 | code | active | inactive | entered-in-error Binding: ?? (required): A coded concept defining if the medication is in active use. | |||||||||
![]() ![]() | Σ | 0..1 | Reference(Organization) | Manufacturer of the item | Σ | 0..1 | Reference(Organization) | Manufacturer of the item | |||||||||
![]() ![]() | S | 0..1 | CodeableConcept | Dạng bào chế (viên nén, dung dịch, bột...) Binding: ?? (example): A coded concept defining the form of a medication. | S | 0..1 | CodeableConcept | Dạng bào chế (viên nén, dung dịch, bột...) Binding: ?? (example): A coded concept defining the form of a medication. | |||||||||
![]() ![]() | Σ | 0..1 | Ratio | Hàm lượng / nồng độ | Σ | 0..1 | Ratio | Lượng thuốc trong một đơn vị đóng gói (vd 20 viên/hộp, 3 mL/bút) — KHÔNG phải hàm lượng | |||||||||
![]() ![]() | S | 0..* | BackboneElement | Thành phần hoạt chất / dược liệu YHCT | S | 0..* | BackboneElement | Thành phần hoạt chất / dược liệu YHCT | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | S | 1..1 | CodeableConcept, Reference(Substance | Medication) | Hoạt chất / dược liệu (mã hoặc tên) | S | 1..1 | CodeableConcept, Reference(Substance | Medication) | Hoạt chất / dược liệu (mã hoặc tên) | |||||||||
![]() ![]() ![]() | 0..1 | boolean | Hoạt chất chính (true) hay phụ (false) | 0..1 | boolean | Hoạt chất chính (true) hay phụ (false) | |||||||||||
![]() ![]() ![]() | S | 0..1 | Ratio | Hàm lượng / trọng lượng (VD: 500mg, 12g/thang) | S | 0..1 | Ratio | Hàm lượng / trọng lượng (VD: 500mg, 12g/thang) | |||||||||
![]() ![]() | S | 0..1 | BackboneElement | Lô sản xuất (truy xuất nguồn gốc, thu hồi) | S | 0..1 | BackboneElement | Lô sản xuất (truy xuất nguồn gốc, thu hồi) | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | S | 0..1 | string | Số lô (SO_LO) | S | 0..1 | string | Số lô (SO_LO) | |||||||||
![]() ![]() ![]() | S | 0..1 | dateTime | Hạn sử dụng (HAN_DUNG) | S | 0..1 | dateTime | Hạn sử dụng (HAN_DUNG) | |||||||||
Documentation for this format | |||||||||||||||||