Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review
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
| Draft tại thời điểm 2026-07-16 |
{
"resourceType" : "NamingSystem",
"id" : "vn-bhyt-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-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>"
},
"extension" : [
{
"url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url",
"valueUri" : "http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns"
},
{
"url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version",
"valueString" : "0.8.0"
}
],
"name" : "VNBHYT",
"status" : "draft",
"kind" : "identifier",
"date" : "2026-07-16",
"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" : "info@hl7.org.vn"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "info@hl7.org.vn"
}
]
}
],
"responsible" : "Bảo hiểm Xã hội Việt Nam (BHXH VN)",
"description" : "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ử.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"usage" : "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}$')",
"uniqueId" : [
{
"type" : "uri",
"value" : "http://fhir.hl7.org.vn/core/sid/bhyt",
"preferred" : true
}
]
}