HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

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.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

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

URL chính thức: http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs Phiên bản: 0.10.0
Computable Name: VNICD10CS
Định danh khác: OID:2.25.161089673617632664299011809196868855799.16.185

Bản quyền/Pháp lý: Cục Quản lý Khám, chữa bệnh — Bộ Y tế Việt Nam. Nguồn: phụ lục TT 06/2026/TT-BYT (ban hành 02/04/2026, danh mục áp dụng từ 01/07/2026) và QĐ 1849/QĐ-BYT (23/6/2026); nền QĐ 4469/QĐ-BYT (28/10/2020) + QĐ 98/QĐ-BYT (14/01/2022). Việc tái phân phối và phạm vi quyền sử dụng cần được chủ sở hữu IG phê duyệt trước khi phát hành production.

Metadata wrapper cho danh mục ICD-10 Việt Nam edition 2026 — dựng từ bảng 29 cột trong phụ lục ban hành kèm TT 06/2026/TT-BYT (bản PDF ký/công bố), đã hợp nhất QĐ 1849/QĐ-BYT, gồm 16.052 concept (15.844 hiện hành + 208 mã huỷ giữ inactive). Danh mục áp dụng toàn quốc từ 01/07/2026; đã đối soát chéo với chuỗi QĐ 4469/QĐ-BYT − PL4 + PL5 QĐ 1849/QĐ-BYT (scripts/reconcile_icd10_edition.py).

Dữ liệu hiện có trong lớp chuẩn hoá

  • Cấu trúc phân cấp type -> disease; ký hiệu †/* giữ nguyên như bản in
  • 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
  • Sáu cờ sử dụng WHO 2019 (bảng TT 06 cột 24-29) + hướng dẫn mã hoá song ngữ

Cách dùng trong VN Core

  • Khi coding trong resource FHIR, dùng system = http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs; mã WHO gốc gửi kèm ở coding thứ hai với http://hl7.org/fhir/sid/icd-10
  • Dữ liệu lập trước 01/07/2026 theo edition 2020 đọc bằng bản đóng băng CodeSystem-vn-icd10-cs-2020-legacy.full.json (version 2020-legacy)

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 để 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; route canonical .json được trỏ sang full JSON download

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

This public IG page publishes http://fhir.hl7.org.vn/core/CodeSystem/vn-icd10-cs as a metadata wrapper on purpose. The concept list is not inlined here; use the guidance above to choose the appropriate download/package or terminology service path.

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