HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review Viet Nam cờ

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.8.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Số thẻ Bảo hiểm Y tế (BHYT) — Vietnam Health Insurance Card Number

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

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-bhyt-ns> a fhir:NamingSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-bhyt-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-bhyt-ns</b></p><a name=\"vn-bhyt-ns\"> </a><a name=\"hcvn-bhyt-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns</td></tr><tr><td>Version</td><td>0.8.0</td></tr><tr><td>Name</td><td>VNBHYT</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh MÃ SỐ Bảo hiểm Y tế, do BHXH Việt Nam cấp.\nNamespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):</p>\n<ul>\n<li>Mã số BHYT 10 chữ số (hiện hành, từ 01/4/2021) — TRÙNG GIÁ TRỊ với mã số BHXH</li>\n<li>Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy)\nCCCD/số định danh cá nhân KHÔNG thuộc namespace này: NĐ 188/2025/NĐ-CP (Mẫu số 3) tách cột\n'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHÓA TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB,\nbiểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ\nmatching sai giữa hai trục định danh.\nQUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace\ntồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt;\nsổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều\nkhi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP).\nCăn cứ:</li>\n<li><strong>Luật 51/2024/QH15</strong> — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025</li>\n<li><strong>NĐ 188/2025/NĐ-CP</strong> — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; Mẫu số 3 tách cột Mã số BHYT / Số CCCD</li>\n<li><strong>NĐ 164/2025/NĐ-CP</strong> — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD</li>\n<li><strong>QĐ 3176/QĐ-BYT</strong> — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH</li>\n<li>Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.</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.5 (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/bhyt</td><td>true</td></tr></table></div>"
  ] ;
  fhir:DomainResource.extension [
     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-bhyt-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.8.0" ]
  ] ;
  fhir:NamingSystem.name [ fhir:value "VNBHYT"] ;
  fhir:NamingSystem.status [ fhir:value "draft"] ;
  fhir:NamingSystem.kind [ fhir:value "identifier"] ;
  fhir:NamingSystem.date [ fhir:value "2026-07-16"^^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ảo hiểm Xã hội Việt Nam (BHXH VN)"] ;
  fhir:NamingSystem.description [ fhir:value "Hệ thống định danh MÃ SỐ Bảo hiểm Y tế, do BHXH Việt Nam cấp.\nNamespace này nhận đúng 2 format THẺ (0.8.0 — hậu kiểm toán Codex, thu hẹp từ 3):\n- Mã số BHYT 10 chữ số (hiện hành, từ 01/4/2021) — TRÙNG GIÁ TRỊ với mã số BHXH\n- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021 (legacy)\nCCCD/số định danh cá nhân KHÔNG thuộc namespace này: NĐ 188/2025/NĐ-CP (Mẫu số 3) tách cột\n'Mã số BHYT' và 'Số CCCD' riêng — CCCD chỉ là KHÓA TRA CỨU/XUẤT TRÌNH thay thẻ khi KCB,\nbiểu diễn bằng Patient.identifier[CCCD] (sid/cccd); trộn CCCD vào sid/bhyt gây nguy cơ\nmatching sai giữa hai trục định danh.\nQUAN HỆ VỚI sid/bhxh: giá trị 10 chữ số của mã số BHYT trùng mã số BHXH — hai namespace\ntồn tại song song theo NGỮ CẢNH NGHIỆP VỤ: số thẻ/quyền lợi BHYT (Coverage) dùng sid/bhyt;\nsổ/quá trình tham gia BHXH dùng sid/bhxh (xem vn-bhxh-ns). Không suy diễn tự động hai chiều\nkhi chưa xác minh qua Cổng BHXH (NĐ 164/2025/NĐ-CP).\nCăn cứ:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 188/2025/NĐ-CP** — ban hành 01/7/2025, hiệu lực 15/8/2025 — hướng dẫn thi hành Luật BHYT; Mẫu số 3 tách cột Mã số BHYT / Số CCCD\n- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử BHXH, tra cứu thẻ theo CCCD\n- **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu đầu ra KCB phục vụ BHXH\n- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử."] ;
  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 Patient.identifier[BHYT], Coverage.identifier[BHYT], Coverage.subscriberId. 2 format: mã số BHYT 10 số (hiện hành, trùng mã số BHXH) | 15 ký tự (legacy trước 01/4/2021). CCCD 12 số KHÔNG hợp lệ trong namespace này — dùng sid/cccd. FHIRPath: value.matches('^[0-9]{10}$') or value.matches('^[A-Z]{2}[0-9]{13}$')"] ;
  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/bhyt" ] ;
     fhir:NamingSystem.uniqueId.preferred [ fhir:value "true"^^xsd:boolean ]
  ] .

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

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