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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## : Bảng phân loại quốc tế bệnh tật ICD-10 Việt Nam / Vietnam ICD-10 Classification

Active tại thời điểm 2020-10-28

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

    <CodeSystem xmlns="http://hl7.org/fhir">
      <id value="vn-icd10-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-icd10-cs</b></p><a name="vn-icd10-cs"> </a><a name="hcvn-icd10-cs"> </a><p>This case-sensitive code system <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs</code> defines codes, but no codes are represented here</p></div>
      </text>
      <url value="http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs"/>
      <version value="0.5.0"/>
      <name value="VNICD10CS"/>
      <title
             value="Bảng phân loại quốc tế bệnh tật ICD-10 Việt Nam / Vietnam ICD-10 Classification"/>
      <status value="active"/>
      <experimental value="false"/>
      <date value="2020-10-28"/>
      <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="info@hl7.org.vn"/>
        </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="healthtech@omigroup.vn"/>
        </telecom>
      </contact>
      <description
                   value="Bảng phân loại quốc tế bệnh tật ICD-10 phiên bản Việt Nam, ban hành theo QĐ 4469/QĐ-BYT (28/10/2020), bổ sung theo QĐ 98/QĐ-BYT (14/01/2022). Artifact công bố trên IG này là metadata wrapper cho tập dữ liệu ICD-10 VN gồm `15.026` mã (2.043 type + 12.983 disease).

    ### Dữ liệu hiện có trong lớp chuẩn hóa
    - Cấu trúc phân cấp `type -&gt; disease`
    - `display` tiếng Việt và `designation` tiếng Anh cho từng mã khi có
    - Concept property cho `level`, `chapter-id`, `chapter-code`, `section-id`, `type-code`, `leaf`, `child-count`

    ### Cách dùng trong VN Core
    - Khi coding trong resource FHIR, vẫn ưu tiên `system = http://hl7.org/fhir/sid/icd-10`
    - Dùng metadata wrapper này để biết phạm vi dữ liệu ICD-10 VN đã được chuẩn hóa trong release hiện hành
    - Khi cần tra cứu hoặc import toàn bộ dữ liệu FHIR JSON, dùng release download surface thay vì public IG page

    ### Cách lấy artifact
    - Validator/FHIR server: dùng file FHIR JSON đầy đủ `CodeSystem-vn-icd10-cs.full.json` trên release download surface
    - Xem [trang tải xuống](downloads.html#icd10-fhir-json) để lấy liên kết tải trực tiếp
    - 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"/>
      <jurisdiction>
        <coding>
          <system value="urn:iso:std:iso:3166"/>
          <code value="VN"/>
          <display value="Viet Nam"/>
        </coding>
      </jurisdiction>
      <copyright
                 value="Cục Khám Chữa Bệnh — Bộ Y tế Việt Nam. QĐ 4469/QĐ-BYT (28/10/2020), QĐ 4400/QĐ-BYT (23/10/2020), QĐ 98/QĐ-BYT (14/01/2022), TT 01/2025/TT-BYT. Artifact IG này được công bố như metadata wrapper; bản FHIR JSON đầy đủ được phát hành tách rời trên release download surface."/>
      <caseSensitive value="true"/>
      <content value="not-present"/>
      <count value="15026"/>
    </CodeSystem>