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

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

URL chính thức: http://fhir.hl7.org.vn/core/CodeSystem/vn-snomed-subset-cs Phiên bản: 0.8.0
Computable Name: VNSNOMEDSubsetCS
Định danh khác: OID:2.25.161089673617632664299011809196868855799.16.128

Bản quyền/Pháp lý: This code system supplement includes content derived from SNOMED CT, which is copyright © 2002+ International Health Terminology Standards Development Organisation (IHTSDO), trading as SNOMED International. SNOMED CT là bộ mã quốc tế; khi coding dùng system = http://snomed.info/sct. Subset và bản dịch VN do Bộ Y tế Việt Nam ban hành: QĐ 2427/QĐ-BYT (2025) Đợt 1 Body Structure, QĐ 2493/QĐ-BYT (2025) Đợt 2 Morphologic Abnormality, QĐ 2805/QĐ-BYT (2025) Đợt 3 Clinical Finding + Allergy. Trong khung kiến trúc số ngành y tế QĐ 4152/QĐ-BYT (2024).

CodeSystem supplement bổ sung bản dịch tiếng Việt (designation.language = vi) cho SNOMED CT quốc tế. Đây KHÔNG phải một hệ mã độc lập — khi coding trong FHIR luôn dùng system = http://snomed.info/sct; supplement này chỉ gắn thêm tên tiếng Việt (và property vn-code — mã quốc gia BYT) cho các mã SNOMED CT.

Phạm vi: subset chính thức Bộ Y tế 77.393 concept từ 3 đợt ban hành, sau khử trùng snomed_ct_id còn 76.066 mã SNOMED riêng biệt (1.327 mã thuộc cả đợt dị ứng và phát hiện — giữ cả hai tên tiếng Việt làm designation):

  • Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts
  • Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts
  • Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts

Căn cứ pháp lý trực tiếp là 3 Quyết định nêu trên; khung kiến trúc số ngành y tế QĐ 4152/QĐ-BYT (2024).

Quan hệ với ValueSet: các ValueSet SNOMED (vn-body-site-vs, vn-morphology-vs, vn-allergy-code-vs, vn-condition-code-vs) định nghĩa intensional trực tiếp trên http://snomed.info/sct (concept is-a #X) — cần SNOMED terminology server để expand/validate. Supplement này bổ nghĩa tiếng Việt cho các mã đó, KHÔNG nằm trong định nghĩa ValueSet.

Cách dùng trong VN Core: Coding dùng system = http://snomed.info/sct, code = SNOMED CT ID. Terminology server nạp supplement này để hiển thị/tra cứu tên tiếng Việt. Property vn-code giữ mã quốc gia BYT để truy vết văn bản. Khi cần rà soát sai lệch bản dịch, xem trang đính chính SNOMED CT VN.

Cách lấy artifact: bản FHIR JSON đầy đủ CodeSystem-vn-snomed-subset-cs.full.json (content = supplement, 76.066 concept với designation tiếng Việt) trên release download surface — xem trang tải xuống. Public IG page này chỉ là metadata declaration của supplement.

English summary: A CodeSystem supplement adding Vietnamese designations (and a vn-code property) to international SNOMED CT (supplements = http://snomed.info/sct). Never used as Coding.system — code with http://snomed.info/sct. Covers the MOH 77,393-concept subset → 76,066 unique SCTIDs; official MOH Vietnamese translation (QĐ 2427/2493/2805).

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

  • This CodeSystem Supplement is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

This code system supplement http://fhir.hl7.org.vn/core/CodeSystem/vn-snomed-subset-cs defines features on the following codes:

Code

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