Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-07-30 |
<ValueSet xmlns="http://hl7.org/fhir">
<id value="vn-condition-code-vs"/>
<language value="vi"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ValueSet vn-condition-code-vs</b></p><a name="vn-condition-code-vs"> </a><a name="hcvn-condition-code-vs"> </a><p>This value set includes codes based on the following rules:</p><ul><li>Include all codes defined in <a href="http://terminology.hl7.org/6.5.0/CodeSystem-icd10.html"><code>http://hl7.org/fhir/sid/icd-10</code></a><span title="Version is not explicitly stated. No matching Code System found"> version Not Stated (use latest from terminology server)</span></li><li>Include codes from<a href="http://www.snomed.org/"><code>http://snomed.info/sct</code></a><span title="Version is not explicitly stated. No matching Code System found"> version Not Stated (use latest from terminology server)</span> where concept is-a 404684003</li><li>Include codes from<a href="http://www.snomed.org/"><code>http://snomed.info/sct</code></a><span title="Version is not explicitly stated. No matching Code System found"> version Not Stated (use latest from terminology server)</span> where concept is-a 272379006</li><li>Include all codes defined in <a href="CodeSystem-vn-yhct-disease-cs.html"><code>http://fhir.hl7.org.vn/core/CodeSystem/vn-yhct-disease-cs</code></a><span title="Version is not explicitly stated, which means it is fixed to the version provided in this specification"> version 📦0.9.0</span></li></ul></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-4469-2020"/>
</valueCoding>
</extension>
<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-98-2022"/>
</valueCoding>
</extension>
<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-1849-2026"/>
</valueCoding>
</extension>
<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="TT-06-2026"/>
</valueCoding>
</extension>
<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-2552-2025"/>
</valueCoding>
</extension>
<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-2805-2025"/>
</valueCoding>
</extension>
<url value="http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs"/>
<identifier>
<system value="urn:ietf:rfc:3986"/>
<value
value="urn:oid:2.25.161089673617632664299011809196868855799.48.19"/>
</identifier>
<version value="0.9.0"/>
<name value="VNConditionCodeVS"/>
<title value="Mã chẩn đoán — VN Core Condition Code ValueSet"/>
<status value="draft"/>
<experimental value="false"/>
<date value="2026-07-30"/>
<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="Tập giá trị mã chẩn đoán cho VN Core, bao gồm:
- ICD-10 Việt Nam theo QĐ 4469/QĐ-BYT 28/10/2020, bổ sung bởi QĐ 98/QĐ-BYT 14/01/2022 và cập nhật theo QĐ 1849/QĐ-BYT 23/6/2026 — 15.617 mã; profile/workflow áp dụng quyết định có bắt buộc slice này hay không
- SNOMED CT IPS Terminology — Clinical Findings (tùy chọn, miễn phí theo CC-BY-4.0) — 35.022 mã trong VN subset (VN subset gồm 36.349 mã Clinical Findings + Allergy; ValueSet này chỉ include nhánh Clinical Finding 404684003 và Events 272379006, không include nhánh Allergy)
- YHCT Mã U — 228 bệnh danh và thể lâm sàng y học cổ truyền theo QĐ 2552/QĐ-BYT Phụ lục I
Binding extensible — dùng mã trong tập khi có khái niệm phù hợp và cho phép mang nhiều coding khi quan hệ ngữ nghĩa đã được xác nhận; không tự chứng minh các coding là tương đương.
Lưu ý: Mã U YHCT KHÔNG PHẢI ICD-10, là hệ thống mã quốc gia riêng; FHIR `code` dùng Mã U/Mã hóa chính thức, còn Mã dùng chung được bảo toàn trong CodeSystem property.
ICD-11 đang trong Phase II lộ trình 2026, chưa thay thế ICD-10 tại Việt Nam."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<copyright
value="This value set includes content from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (IHTSDO), and distributed by agreement between IHTSDO and HL7. Implementer use of SNOMED CT is not covered by this agreement.
The SNOMED International IPS Terminology is distributed by International Health Terminology Standards Development Organisation, trading as SNOMED International, and is subject the terms of the Creative Commons Attribution 4.0 International Public License. For more information, see https://www.snomed.org/snomed-ct/Other-SNOMED-products/international-patient-summary-terminology
ICD-10: WHO — bản VN 15.617 mã (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT, TT 01/2025/TT-BYT, QĐ 1849/QĐ-BYT), tra cứu: icd.kcb.vn.
SNOMED CT VN subset 36.349 Clinical Findings + Allergy: QĐ 2805/QĐ-BYT (2025), trong khung kiến trúc số ngành y tế QĐ 4152/QĐ-BYT (2024).
YHCT: Cục Quản lý Y Dược Cổ Truyền — QĐ 2552/QĐ-BYT (12/8/2025), QĐ 3080/QĐ-BYT (26/9/2025)."/>
<compose>
<include>
<system value="http://hl7.org/fhir/sid/icd-10"/>
</include>
<include>
<system value="http://snomed.info/sct"/>
<filter>
<property value="concept"/>
<op value="is-a"/>
<value value="404684003"/>
</filter>
</include>
<include>
<system value="http://snomed.info/sct"/>
<filter>
<property value="concept"/>
<op value="is-a"/>
<value value="272379006"/>
</filter>
</include>
<include>
<system
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-yhct-disease-cs"/>
</include>
</compose>
</ValueSet>