Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-07-27 |
{
"resourceType" : "NamingSystem",
"id" : "vn-drug-registration-number-ns",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: NamingSystem vn-drug-registration-number-ns</b></p><a name=\"vn-drug-registration-number-ns\"> </a><a name=\"hcvn-drug-registration-number-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-drug-registration-number-ns</td></tr><tr><td>Version</td><td>0.9.0</td></tr><tr><td>Name</td><td>VNDrugRegistrationNumber</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh số đăng ký lưu hành (giấy phép lưu hành, GPLH) của thuốc và nguyên liệu làm thuốc tại Việt Nam — tầng 1 trong mô hình định danh thuốc của VN Core (analysis/62 #3).\nHai định dạng cùng tồn tại:</p>\n<ul>\n<li><strong>Định dạng hiện hành</strong>: 12 chữ số theo TT 12/2025/TT-BYT.</li>\n<li><strong>Định dạng legacy</strong>: dạng chữ-số như <code>VD-12345-15</code>, <code>VN-12345-16</code>, <code>QLĐB-123-45</code> — tiếp tục có giá trị theo quy tắc chuyển tiếp của TT 12/2025/TT-BYT cho tới khi được cấp lại.\nSố đăng ký là ĐỊNH DANH của một sản phẩm được cấp phép, không phải mã phân loại: dùng ở <code>Medication.identifier</code>, KHÔNG dùng làm <code>Medication.code</code>.\nCăn cứ:</li>\n<li><strong>TT 12/2025/TT-BYT</strong> (ban hành 16/05/2025, hiệu lực 01/07/2025) — đăng ký lưu hành thuốc, nguyên liệu làm thuốc; cấu trúc số đăng ký 12 chữ số và quy tắc chuyển tiếp số cũ</li>\n<li><strong>Luật 105/2016/QH13</strong> — Luật Dược (đọc hợp nhất theo VBHN 76/VBHN-VPQH)</li>\n<li><strong>QĐ 3176/QĐ-BYT</strong> — trường <code>SO_DANG_KY</code> trong dữ liệu đầu ra KCB; <strong>QĐ 1931/QĐ-BYT</strong> bổ sung quy ước <code>UBND.YYYY.X.S</code> cho thuốc hiếm được UBND cấp tỉnh cấp phép nhập khẩu.</li>\n</ul>\n</div></td></tr><tr><td>Publisher</td><td>Omi HealthTech / VN Core FHIR Community Initiative</td></tr><tr><td>OID</td><td>2.25.161089673617632664299011809196868855799.31.11 (for OID based terminology systems)</td></tr></table><h3>Identifiers</h3><table class=\"grid\"><tr><td><b>Type</b></td><td><b>Value</b></td><td><b>Preferred</b></td></tr><tr><td>URI</td><td>http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc</td><td>true</td></tr></table></div>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "TT-12-2025"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "L-105-2016"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "VBHN-76-VPQH"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-3176-2024"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-1931-2026"
}
},
{
"url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url",
"valueUri" : "http://fhir.hl7.org.vn/core/NamingSystem/vn-drug-registration-number-ns"
},
{
"url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version",
"valueString" : "0.9.0"
}
],
"name" : "VNDrugRegistrationNumber",
"status" : "draft",
"kind" : "identifier",
"date" : "2026-07-27",
"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" : "[email protected]"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
}
],
"responsible" : "Bộ Y tế — Cục Quản lý Dược",
"description" : "Hệ thống định danh số đăng ký lưu hành (giấy phép lưu hành, GPLH) của thuốc và nguyên liệu làm thuốc tại Việt Nam — tầng 1 trong mô hình định danh thuốc của VN Core (analysis/62 #3).\nHai định dạng cùng tồn tại:\n- **Định dạng hiện hành**: 12 chữ số theo TT 12/2025/TT-BYT.\n- **Định dạng legacy**: dạng chữ-số như `VD-12345-15`, `VN-12345-16`, `QLĐB-123-45` — tiếp tục có giá trị theo quy tắc chuyển tiếp của TT 12/2025/TT-BYT cho tới khi được cấp lại.\nSố đăng ký là ĐỊNH DANH của một sản phẩm được cấp phép, không phải mã phân loại: dùng ở `Medication.identifier`, KHÔNG dùng làm `Medication.code`.\nCăn cứ:\n- **TT 12/2025/TT-BYT** (ban hành 16/05/2025, hiệu lực 01/07/2025) — đăng ký lưu hành thuốc, nguyên liệu làm thuốc; cấu trúc số đăng ký 12 chữ số và quy tắc chuyển tiếp số cũ\n- **Luật 105/2016/QH13** — Luật Dược (đọc hợp nhất theo VBHN 76/VBHN-VPQH)\n- **QĐ 3176/QĐ-BYT** — trường `SO_DANG_KY` trong dữ liệu đầu ra KCB; **QĐ 1931/QĐ-BYT** bổ sung quy ước `UBND.YYYY.X.S` cho thuốc hiếm được UBND cấp tỉnh cấp phép nhập khẩu.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"usage" : "Dùng cho Medication.identifier. Không dùng làm Medication.code (định danh sản phẩm, không phải mã phân loại). Extension vn-ext-med-reg-number giữ lại cho dữ liệu legacy trong dòng 0.9 và dự kiến gỡ ở 1.0.",
"uniqueId" : [
{
"type" : "uri",
"value" : "http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc",
"preferred" : true
}
]
}