HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.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.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: LOINC Việt Nam — Vietnam LOINC CodeSystem

Active tại thời điểm 2025-04-11

Bản thô xml | Tải xuống


<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 public IG page publishes <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs</code> as a metadata wrapper on purpose. The concept list is not inlined here; use the guidance above to choose the appropriate download/package or terminology service path.</p></div>
  </text>
  <url value="http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs"/>
  <version value="0.5.0"/>
  <name value="VNLOINCCS"/>
  <title value="LOINC Việt Nam — Vietnam LOINC CodeSystem"/>
  <status value="active"/>
  <experimental value="false"/>
  <date value="2025-04-11"/>
  <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="[email protected]"/>
    </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="[email protected]"/>
    </telecom>
  </contact>
  <description
               value="Bảng mã xét nghiệm quốc tế LOINC (Logical Observation Identifiers Names and Codes)
phiê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.
Trong đó ~59.000 mã có bản dịch tiếng Việt, ~7.000 mã chỉ có tên tiếng Anh.

Căn cứ pháp lý:
- QĐ 1227/QĐ-BYT (11/04/2025) — Ban hành bộ mã CLS (cận lâm sàng) quốc gia,
  ánh xạ mã CLS VN ↔ LOINC. VN có bộ mã CLS riêng, MAPPING sang LOINC.
- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm)

Vietnam LOINC translation, published by Cục KCB — MOH in collaboration with
Regenstrief Institute (USA). Contains 66,077 unique LOINC codes with Vietnamese
component translations. Source: https://loinc.whiteneuron.com
(Deduplicated from original 108,526 entries which included duplicates, CLS VN codes,
and EMR form field entries.)

**Dữ liệu hiện có trong lớp chuẩn hóa:**
`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.

**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ộ.

**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ộ.

**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.

Note: MOH publishes a separate national lab code system (QĐ 1227/2025) that MAPS to LOINC.
When coding in FHIR, use system = http://loinc.org with LOINC number from the mapping table."/>
  <jurisdiction>
    <coding>
      <system value="urn:iso:std:iso:3166"/>
      <code value="VN"/>
      <display value="Viet Nam"/>
    </coding>
  </jurisdiction>
  <copyright
             value="Nguồn dữ liệu chuẩn hóa: loinc.whiteneuron.com.
Bản dịch tiếng Việt: Cục KCB — BYT Việt Nam.
QĐ 1227/QĐ-BYT (11/04/2025) — Bộ mã CLS quốc gia ánh xạ LOINC.
Artifact này được công bố như metadata wrapper trong gói hl7.fhir.vn.terminology.clinical."/>
  <caseSensitive value="true"/>
  <content value="not-present"/>
  <count value="66077"/>
</CodeSystem>