Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.1 - Draft for Community Review
VN
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.1) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Active tại thời điểm 2025-04-11 |
{
"resourceType" : "CodeSystem",
"id" : "vn-loinc-cs",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem vn-loinc-cs</b></p><a name=\"vn-loinc-cs\"> </a><a name=\"hcvn-loinc-cs\"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs</code> defines codes, but no codes are represented here</p></div>"
},
"url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs",
"version" : "0.5.1",
"name" : "VNLOINCCS",
"title" : "LOINC Việt Nam — Vietnam LOINC CodeSystem",
"status" : "active",
"experimental" : false,
"date" : "2025-04-11",
"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" : "healthtech@omigroup.vn"
}
]
}
],
"description" : "Bảng mã xét nghiệm quốc tế LOINC (Logical Observation Identifiers Names and Codes)\nphiên bản Việt Nam. 66.077 mã LOINC unique với bản dịch tên thành phần (component) tiếng Việt.\nTrong đó ~59.000 mã có bản dịch tiếng Việt, ~7.000 mã chỉ có tên tiếng Anh.\n\nCăn cứ pháp lý:\n- QĐ 1227/QĐ-BYT (11/04/2025) — Ban hành bộ mã CLS (cận lâm sàng) quốc gia,\n ánh xạ mã CLS VN ↔ LOINC. VN có bộ mã CLS riêng, MAPPING sang LOINC.\n- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm)\n\nVietnam LOINC translation, published by Cục KCB — MOH in collaboration with\nRegenstrief Institute (USA). Contains 66,077 unique LOINC codes with Vietnamese\ncomponent translations. Source: https://loinc.whiteneuron.com\n(Deduplicated from original 108,526 entries which included duplicates, CLS VN codes,\nand EMR form field entries.)\n\n**Dữ liệu hiện có trong lớp chuẩn hóa:**\n`number` (mã LOINC chuẩn), `long_common_name` (tên tiếng Anh đầy đủ), `component` (bản dịch tiếng Việt khi có), `shortname`, `property`, `time_aspect`, `system`, `scale_type`, `method_type`, và `common_test_rank` để hỗ trợ ưu tiên các mã dùng nhiều. Dataset đã loại bỏ bản ghi trùng, mã CLS VN nội bộ, và các field biểu mẫu không phải mã LOINC chuẩn.\n\n**Nhóm dữ liệu thường gặp:** mã xét nghiệm và chỉ số định lượng/định tính; panel/order set phục vụ chỉ định và trả kết quả; report/document identifiers dùng trong Composition/DocumentReference khi phù hợp; survey/questionnaire items có trong LOINC gốc nhưng không phải mọi triển khai VN Core đều cần nạp toàn bộ.\n\n**Cách dùng trong VN Core:** Khi coding trong FHIR, dùng `system = http://loinc.org`. Với xét nghiệm cận lâm sàng trong nước, dùng cùng `vn-cls-cs` và `ConceptMap/vn-cm-cls-to-loinc`. Dùng artifact này khi cần biết lớp dữ liệu LOINC VN đã được chuẩn hóa đến mức nào trước khi import vào terminology server nội bộ.\n\n**Cách lấy artifact:** Validator/FHIR server dùng file FHIR JSON đầy đủ `CodeSystem-vn-loinc-cs.full.json` trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem [trang tải xuống](downloads.html#loinc-fhir-json) để lấy liên kết trực tiếp và gói `hl7.fhir.vn.terminology.clinical-0.3.0.tgz`. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ thông qua package/download surface và nguồn chuẩn hóa đi kèm. Các serialization XML/TTL trên public IG chỉ phản ánh metadata wrapper hiện hành; riêng route canonical `.json` được trỏ sang full JSON download.\n\nNote: MOH publishes a separate national lab code system (QĐ 1227/2025) that MAPS to LOINC.\nWhen coding in FHIR, use system = http://loinc.org with LOINC number from the mapping table.",
"jurisdiction" : [
{
"coding" : [
{
"system" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"copyright" : "Nguồn dữ liệu chuẩn hóa: loinc.whiteneuron.com.\nBản dịch tiếng Việt: Cục KCB — BYT Việt Nam.\nQĐ 1227/QĐ-BYT (11/04/2025) — Bộ mã CLS quốc gia ánh xạ LOINC.\nArtifact này được công bố như metadata wrapper trong gói hl7.fhir.vn.terminology.clinical.",
"caseSensitive" : true,
"content" : "not-present",
"count" : 66077
}