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 - Local Development build (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-23 |
{
"resourceType" : "NamingSystem",
"id" : "vn-ma-cskcb-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-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>"
},
"extension" : [
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-384-2019"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "QD-2733-BYT"
}
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
"valueCoding" : {
"system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
"code" : "L-15-2023"
}
},
{
"url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url",
"valueUri" : "http://fhir.hl7.org.vn/core/NamingSystem/vn-ma-cskcb-ns"
},
{
"url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version",
"valueString" : "0.9.0"
}
],
"name" : "VNCSKCB",
"status" : "draft",
"kind" : "identifier",
"date" : "2026-07-23",
"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ộ 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",
"description" : "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.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"usage" : "Dùng cho Organization.identifier. Format: 5 chữ số. FHIRPath: value.matches('^[0-9]{5}$')",
"uniqueId" : [
{
"type" : "uri",
"value" : "http://fhir.hl7.org.vn/core/sid/ma-cskcb",
"preferred" : true
}
]
}