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
| Active tại thời điểm 2026-07-15 |
<CodeSystem xmlns="http://hl7.org/fhir">
<id value="vn-loinc-cs"/>
<language value="vi"/>
<text>
<status value="generated"/>
<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 code system supplement <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs</code> defines features on the following codes:</p><table class="codes"><tr><td style="white-space:nowrap"><b>Code</b></td></tr></table></div>
</text>
<extension
url="http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis">
<valueCoding>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs"/>
<code value="QD-1227-2025"/>
</valueCoding>
</extension>
<url value="http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value
value="urn:oid:2.25.161089673617632664299011809196868855799.16.106"/>
</identifier>
<version value="0.8.0"/>
<name value="VNLOINCCS"/>
<title
value="LOINC Việt Nam (bản dịch bổ sung) — Vietnam LOINC Vietnamese Supplement"/>
<status value="active"/>
<experimental value="false"/>
<date value="2026-07-15"/>
<publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<contact>
<name value="Omi HealthTech / VN Core FHIR Community Initiative"/>
<telecom>
<system value="url"/>
<value value="https://hl7.org.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="info@hl7.org.vn"/>
</telecom>
</contact>
<contact>
<name value="Omi HealthTech (OmiGroup)"/>
<telecom>
<system value="url"/>
<value value="https://omihealthtech.vn"/>
</telecom>
<telecom>
<system value="url"/>
<value value="https://omigroup.vn"/>
</telecom>
<telecom>
<system value="email"/>
<value value="info@hl7.org.vn"/>
</telecom>
</contact>
<description
value="CodeSystem **supplement** bổ sung bản dịch tiếng Việt (`designation.language = vi`) cho bảng mã xét nghiệm quốc tế LOINC (Logical Observation Identifiers Names and Codes). Đây KHÔNG phải một hệ mã độc lập — khi coding trong FHIR luôn dùng `system = http://loinc.org`; supplement này chỉ gắn thêm tên tiếng Việt cho các mã LOINC.
Phạm vi: **104.054 mã LOINC** (khớp phiên bản **LOINC 2.78**; không phải LOINC hiện hành — LOINC 2.82 có 109.325 mã), trong đó **89.470 mã (86%)** có bản dịch tên thành phần (component) tiếng Việt và được đưa vào supplement này dưới dạng `designation[vi]`. Nguồn bản dịch chính thức của Bộ Y tế, host trên website đối tác `loinc.whiteneuron.com` (đã lọc bỏ mã CLS VN nội bộ và field biểu mẫu EMR khỏi 108.527 bản ghi thô).
Căn cứ pháp lý (khung sử dụng LOINC tại VN):
- QĐ 1227/QĐ-BYT (11/04/2025) — Bộ mã chỉ số cận lâm sàng quốc gia, ánh xạ CLS VN ↔ LOINC (xem `vn-cls-cs` + `ConceptMap/vn-cm-cls-to-loinc`).
- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm).
**Cách dùng trong VN Core:** Coding xét nghiệm dùng `system = http://loinc.org`, `code` = số LOINC. Terminology server nạp supplement này để hiển thị/tra cứu tên tiếng Việt của mã LOINC. Với chỉ số cận lâm sàng trong nước theo QĐ 1227/QĐ-BYT, dùng `vn-cls-cs` và ánh xạ sang LOINC qua `ConceptMap/vn-cm-cls-to-loinc`.
**Cách lấy artifact:** bản FHIR JSON đầy đủ `CodeSystem-vn-loinc-cs.full.json` (content = supplement, 89.470 designation tiếng Việt trên không gian 104.054 mã LOINC 2.78) trên release download surface — xem [trang tải xuống](downloads.html#loinc-fhir-json). Public IG page này chỉ là metadata declaration của supplement; nội dung designation được tiêu thụ qua package/download surface.
English summary: A CodeSystem supplement adding 89,470 Vietnamese `designation`s across the 104,054-code LOINC 2.78 namespace (`supplements = http://loinc.org`). Never used as `Coding.system` — code with `http://loinc.org`. Official MOH Vietnamese translation hosted on partner site loinc.whiteneuron.com."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<copyright
value="This material contains content from LOINC (http://loinc.org). LOINC is copyright © 1995-2024, Regenstrief Institute, Inc. and the Logical Observation Identifiers Names and Codes (LOINC) Committee and is available at no cost under the license at http://loinc.org/license. LOINC® is a registered United States trademark of Regenstrief Institute, Inc.
Bản dịch tiếng Việt: Cục Khám Chữa Bệnh — Bộ Y tế Việt Nam (host trên website đối tác loinc.whiteneuron.com). Việc sử dụng LOINC tại VN theo QĐ 1227/QĐ-BYT (11/04/2025)."/>
<content value="supplement"/>
<supplements value="http://loinc.org"/>
<count value="89470"/>
</CodeSystem>