HL7 Vietnam VN Core FHIR Implementation Guide

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 Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Local Development build (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Số đăng ký lưu hành thuốc — Vietnam Drug Marketing Authorisation Number

Draft tại thời điểm 2026-07-27

Bản thô ttl | Tải xuống


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/NamingSystem/vn-drug-registration-number-ns> a fhir:NamingSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-drug-registration-number-ns"] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.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>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "TT-12-2025" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "L-105-2016" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "VBHN-76-VPQH" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "QD-3176-2024" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "QD-1931-2026" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url" ] ;
     fhir:Extension.valueUri [ fhir:value "http://fhir.hl7.org.vn/core/NamingSystem/vn-drug-registration-number-ns" ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version" ] ;
     fhir:Extension.valueString [ fhir:value "0.9.0" ]
  ] ;
  fhir:NamingSystem.name [ fhir:value "VNDrugRegistrationNumber"] ;
  fhir:NamingSystem.status [ fhir:value "draft"] ;
  fhir:NamingSystem.kind [ fhir:value "identifier"] ;
  fhir:NamingSystem.date [ fhir:value "2026-07-27"^^xsd:date] ;
  fhir:NamingSystem.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:NamingSystem.contact [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://hl7.org.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech (OmiGroup)" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omihealthtech.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omigroup.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ] ;
  fhir:NamingSystem.responsible [ fhir:value "Bộ Y tế — Cục Quản lý Dược"] ;
  fhir:NamingSystem.description [ fhir: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).\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."] ;
  fhir:NamingSystem.jurisdiction [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
       fhir:Coding.code [ fhir:value "VN" ] ;
       fhir:Coding.display [ fhir:value "Viet Nam" ]
     ]
  ] ;
  fhir:NamingSystem.usage [ fhir: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."] ;
  fhir:NamingSystem.uniqueId [
     fhir:index -1 ;
     fhir:NamingSystem.uniqueId.type [ fhir:value "uri" ] ;
     fhir:NamingSystem.uniqueId.value [ fhir:value "http://fhir.hl7.org.vn/core/sid/so-dang-ky-thuoc" ] ;
     fhir:NamingSystem.uniqueId.preferred [ fhir:value "true"^^xsd:boolean ]
  ] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/NamingSystem/vn-drug-registration-number-ns.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/NamingSystem/vn-drug-registration-number-ns.ttl> .