# LOINC Việt Nam — Vietnam LOINC CodeSystem - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## CodeSystem: LOINC Việt Nam — Vietnam LOINC CodeSystem 

 
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.md#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. 

This Code system is referenced in the definition of the following value sets:

* This CodeSystem is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

-------

 [Mô tả các bảng ở trên](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#terminology). 



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "vn-loinc-cs",
  "url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs",
  "version" : "0.5.0",
  "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
}

```
