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 |
<NamingSystem xmlns="http://hl7.org/fhir">
<id value="vn-drug-registration-number-ns"/>
<language value="vi"/>
<text>
<status value="generated"/>
<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).
Hai định dạng cùng tồn tại:</p>
<ul>
<li><strong>Định dạng hiện hành</strong>: 12 chữ số theo TT 12/2025/TT-BYT.</li>
<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.
Số đă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>.
Căn cứ:</li>
<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>
<li><strong>Luật 105/2016/QH13</strong> — Luật Dược (đọc hợp nhất theo VBHN 76/VBHN-VPQH)</li>
<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>
</ul>
</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>
</text>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="TT-12-2025"/>
</valueCoding>
</extension>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="L-105-2016"/>
</valueCoding>
</extension>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="VBHN-76-VPQH"/>
</valueCoding>
</extension>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="QD-3176-2024"/>
</valueCoding>
</extension>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="QD-1931-2026"/>
</valueCoding>
</extension>
<extension
url="http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url">
<valueUri
value="http://fhir.hl7.org.vn/core/NamingSystem/vn-drug-registration-number-ns"/>
</extension>
<extension
url="http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version">
<valueString value="0.9.0"/>
</extension>
<name value="VNDrugRegistrationNumber"/>
<status value="draft"/>
<kind value="identifier"/>
<date value="2026-07-27"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="[email protected]"/>
</telecom>
</contact>
<responsible value="Bộ Y tế — Cục Quản lý Dược"/>
<description
value="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).
Hai định dạng cùng tồn tại:
- **Định dạng hiện hành**: 12 chữ số theo TT 12/2025/TT-BYT.
- **Đị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.
Số đă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`.
Căn cứ:
- **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ũ
- **Luật 105/2016/QH13** — Luật Dược (đọc hợp nhất theo VBHN 76/VBHN-VPQH)
- **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 value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<usage
value="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 value="uri"/>
<value value="http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc"/>
<preferred value="true"/>
</uniqueId>
</NamingSystem>