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

: Mã cơ sở khám chữa bệnh (CSKCB) — Vietnam Healthcare Facility Code

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

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-ma-cskcb-ns> a fhir:NamingSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-ma-cskcb-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-ma-cskcb-ns</b></p><a name=\"vn-ma-cskcb-ns\"> </a><a name=\"hcvn-ma-cskcb-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-ma-cskcb-ns</td></tr><tr><td>Version</td><td>0.9.0</td></tr><tr><td>Name</td><td>VNCSKCB</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống mã cơ sở khám chữa bệnh (5 chữ số): 2 ký tự đầu là mã tỉnh/TP, 3 ký tự sau là số thứ tự cơ sở trong tỉnh (mã 97 = cơ sở thuộc Bộ Quốc phòng, 98 = Bộ Công an).\nCấp mã: Sở Y tế (địa phương) / Cục Quân y (BQP) / Cục Y tế (BCA) theo nguyên tắc tại QĐ 384/QĐ-BYT (30/01/2019); Cục Quản lý Khám, chữa bệnh — Bộ Y tế là đầu mối tổng hợp, công bố danh mục. Dùng để định danh cơ sở y tế trong giám định/thanh toán BHYT (Cổng tiếp nhận dữ liệu giám định BHXH) và liên thông Sổ SKĐT VNeID (QĐ 2733/QĐ-BYT Phụ lục 01 Điều 3).\nĐính chính 23/07/2026: trước ghi 'do BHXH Việt Nam cấp' — không đúng cơ quan cấp mã theo QĐ 384/QĐ-BYT.\nCăn cứ: QĐ 384/QĐ-BYT (30/01/2019, hiệu lực 01/02/2019 — lưu ý QĐ 2733/QĐ-BYT trích là 'ngày 01/02/2019'), Luật KCB 2023 (15/2023/QH15).\nLưu ý giai đoạn: mã tỉnh 2 ký tự đặt theo danh mục hành chính trước 01/07/2025; sau sáp nhập 34 tỉnh CHƯA có văn bản cấp lại hệ mã (xác minh 23/07/2026) — nguyên tắc chuyển tiếp: cơ sở giữ mã cũ đến khi được cấp mã mới (TT 53/2025/TT-BYT sửa TT 43/2025/TT-BYT về Trạm Y tế xã; NĐ 188/2025/NĐ-CP Điều 69 khoản 8 điểm đ cho thẻ/thông tin tiếp tục sử dụng); theo dõi watch-list.</p>\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.20 (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/ma-cskcb</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 "QD-384-2019" ]
     ]
  ], [
     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-2733-BYT" ]
     ]
  ], [
     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-15-2023" ]
     ]
  ], [
     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-ma-cskcb-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 "VNCSKCB"] ;
  fhir:NamingSystem.status [ fhir:value "draft"] ;
  fhir:NamingSystem.kind [ fhir:value "identifier"] ;
  fhir:NamingSystem.date [ fhir:value "2026-07-23"^^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ý Khám, chữa bệnh) — Sở Y tế/Cục Quân y/Cục Y tế cấp mã theo QĐ 384/QĐ-BYT"] ;
  fhir:NamingSystem.description [ fhir:value "Hệ thống mã cơ sở khám chữa bệnh (5 chữ số): 2 ký tự đầu là mã tỉnh/TP, 3 ký tự sau là số thứ tự cơ sở trong tỉnh (mã 97 = cơ sở thuộc Bộ Quốc phòng, 98 = Bộ Công an).\nCấp mã: Sở Y tế (địa phương) / Cục Quân y (BQP) / Cục Y tế (BCA) theo nguyên tắc tại QĐ 384/QĐ-BYT (30/01/2019); Cục Quản lý Khám, chữa bệnh — Bộ Y tế là đầu mối tổng hợp, công bố danh mục. Dùng để định danh cơ sở y tế trong giám định/thanh toán BHYT (Cổng tiếp nhận dữ liệu giám định BHXH) và liên thông Sổ SKĐT VNeID (QĐ 2733/QĐ-BYT Phụ lục 01 Điều 3).\nĐính chính 23/07/2026: trước ghi 'do BHXH Việt Nam cấp' — không đúng cơ quan cấp mã theo QĐ 384/QĐ-BYT.\nCăn cứ: QĐ 384/QĐ-BYT (30/01/2019, hiệu lực 01/02/2019 — lưu ý QĐ 2733/QĐ-BYT trích là 'ngày 01/02/2019'), Luật KCB 2023 (15/2023/QH15).\nLưu ý giai đoạn: mã tỉnh 2 ký tự đặt theo danh mục hành chính trước 01/07/2025; sau sáp nhập 34 tỉnh CHƯA có văn bản cấp lại hệ mã (xác minh 23/07/2026) — nguyên tắc chuyển tiếp: cơ sở giữ mã cũ đến khi được cấp mã mới (TT 53/2025/TT-BYT sửa TT 43/2025/TT-BYT về Trạm Y tế xã; NĐ 188/2025/NĐ-CP Điều 69 khoản 8 điểm đ cho thẻ/thông tin tiếp tục sử dụng); theo dõi watch-list."] ;
  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 Organization.identifier. Format: 5 chữ số. FHIRPath: value.matches('^[0-9]{5}$')"] ;
  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/ma-cskcb" ] ;
     fhir:NamingSystem.uniqueId.preferred [ fhir:value "true"^^xsd:boolean ]
  ] .

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

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