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

• Nội dung narrative
• XML
• JSON
• TTL

CodeSystem: LOINC Việt Nam — Vietnam LOINC CodeSystem

URL chính thức: http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs				Phiên bản: 0.5.0	Làm nổi bật phần thay đổi?
					Computable Name: VNLOINCCS
Bản quyền/Pháp lý: 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.

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 để 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.

---

Mô tả các bảng ở trên.