HL7 Vietnam VN Core FHIR Implementation Guide

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

: LOINC Việt Nam (bản dịch bổ sung) — Vietnam LOINC Vietnamese Supplement

Active tại thời điểm 2026-07-15

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


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

<http://hl7.org/fhir/CodeSystem/vn-loinc-cs> a fhir:CodeSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-loinc-cs"] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.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 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>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis" ] ;
     fhir:Extension.valueCoding [
       fhir:Coding.system [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs" ] ;
       fhir:Coding.code [ fhir:value "QD-1227-2025" ]
     ]
  ] ;
  fhir:CodeSystem.url [ fhir:value "http://fhir.hl7.org.vn/core/CodeSystem/vn-loinc-cs"] ;
  fhir:CodeSystem.identifier [
     fhir:index -1 ;
     fhir:Identifier.system [ fhir:value "urn:ietf:rfc:3986" ] ;
     fhir:Identifier.value [ fhir:value "urn:oid:2.25.161089673617632664299011809196868855799.16.106" ]
  ] ;
  fhir:CodeSystem.version [ fhir:value "0.8.0"] ;
  fhir:CodeSystem.name [ fhir:value "VNLOINCCS"] ;
  fhir:CodeSystem.title [ fhir:value "LOINC Việt Nam (bản dịch bổ sung) — Vietnam LOINC Vietnamese Supplement"] ;
  fhir:CodeSystem.status [ fhir:value "active"] ;
  fhir:CodeSystem.experimental [ fhir:value "false"^^xsd:boolean] ;
  fhir:CodeSystem.date [ fhir:value "2026-07-15"^^xsd:date] ;
  fhir:CodeSystem.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:CodeSystem.contact [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://hl7.org.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech (OmiGroup)" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omihealthtech.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omigroup.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ] ;
  fhir:CodeSystem.description [ fhir: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.\n\nPhạ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ô).\n\nCăn cứ pháp lý (khung sử dụng LOINC tại VN):\n- 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`).\n- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu BHXH, trường MA_XN (mã xét nghiệm).\n\n**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`.\n\n**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.\n\nEnglish 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."] ;
  fhir:CodeSystem.jurisdiction [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
       fhir:Coding.code [ fhir:value "VN" ] ;
       fhir:Coding.display [ fhir:value "Viet Nam" ]
     ]
  ] ;
  fhir:CodeSystem.copyright [ fhir: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.\nBả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)."] ;
  fhir:CodeSystem.content [ fhir:value "supplement"] ;
  fhir:CodeSystem.supplements [
     fhir:value "http://loinc.org" ;
     fhir:link <http://loinc.org>
  ] ;
  fhir:CodeSystem.count [ fhir:value "89470"^^xsd:nonNegativeInteger] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/CodeSystem/vn-loinc-cs.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/CodeSystem/vn-loinc-cs.ttl> .