# SNOMED CT Việt Nam Subset — Vietnam SNOMED CT National Subset - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## CodeSystem: SNOMED CT Việt Nam Subset — Vietnam SNOMED CT National Subset 

 
Bộ mã SNOMED CT phiên bản Việt Nam — subset chính thức do Bộ Y tế ban hành. 77.393 concepts với bản dịch tiếng Việt, song ngữ Việt-Anh, chia thành 3 đợt: 
* Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts Cấu trúc giải phẫu cơ thể người
* Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts Bất thường hình thái (mô bệnh học, khối u…)
* Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts Phát hiện lâm sàng (35.022) + Dị ứng (1.327)
 
Căn cứ nền tảng: QĐ 1928/QĐ-BYT (2023) — Kiến trúc Chính phủ điện tử Y tế v2.1, xác lập SNOMED CT là bộ mã thuật ngữ y tế chuẩn quốc gia. 
Vietnam national SNOMED CT subset, published by Ministry of Health in 3 batches. Contains 77,393 concepts with Vietnamese translations, bilingual VI-EN. Each concept has: vn_code (national code), snomed_ct_id (international), name_vn, name_en. For international interoperability: system = http://snomed.info/sct, code = snomed_ct_id. 
**Dữ liệu hiện có trong lớp chuẩn hóa:** `vn_code` (mã quốc gia do BYT công bố), `snomed_ct_id` (mã SNOMED CT quốc tế dùng cho coding/interoperability), `name_vn`, `name_en` (tên song ngữ), và `category` (nhóm thuật ngữ gốc trong dữ liệu tích hợp). 
**Các nhóm dữ liệu trong artifact:** `body structure` cho vị trí giải phẫu; `morphologic abnormality` cho bất thường hình thái/mô bệnh học; `clinical finding` cho phát hiện/chẩn đoán lâm sàng; `allergy` cho các khái niệm dị ứng và chất liên quan. 
**Cách dùng trong VN Core:** Dùng `snomed_ct_id` làm `code` khi gửi FHIR resource quốc tế hóa. Dùng cùng các companion ValueSet như `vn-body-site-vs`, `vn-condition-code-vs`, `vn-allergy-code-vs` tùy ca sử dụng. Khi cần rà soát sai lệch bản dịch, xem [trang đính chính SNOMED CT VN](snomed-vn-errata.md). 
**Cách lấy artifact:** Validator/FHIR server dùng file FHIR JSON đầy đủ `CodeSystem-vn-snomed-subset-cs.full.json` trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem [trang tải xuống](downloads.md#snomed-fhir-json) để lấy liên kết trực tiếp và gói `hl7.fhir.vn.terminology.clinical-0.3.0.tgz`. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ qua package/download surface và bộ nguồn chuẩn hóa nội bộ. 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. 
Implementation note: this IG publishes the VN SNOMED subset on the public HTML surface as metadata only (`content = not-present`). The 77,393 concepts are distributed as a separate full FHIR JSON artifact on the release download surface, and the canonical `.json` route is redirected there for machine access. 

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

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

-------

 [Mô tả các bảng ở trên](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#terminology). 



## Resource Content

```json
{
  "resourceType" : "CodeSystem",
  "id" : "vn-snomed-subset-cs",
  "url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-snomed-subset-cs",
  "version" : "0.5.0",
  "name" : "VNSNOMEDSubsetCS",
  "title" : "SNOMED CT Việt Nam Subset — Vietnam SNOMED CT National Subset",
  "status" : "active",
  "experimental" : false,
  "date" : "2025-09-04",
  "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
  "contact" : [{
    "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.org.vn"
    },
    {
      "system" : "email",
      "value" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Bộ mã SNOMED CT phiên bản Việt Nam — subset chính thức do Bộ Y tế ban hành.\n77.393 concepts với bản dịch tiếng Việt, song ngữ Việt-Anh, chia thành 3 đợt:\n\n- Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts\n  Cấu trúc giải phẫu cơ thể người\n- Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts\n  Bất thường hình thái (mô bệnh học, khối u...)\n- Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts\n  Phát hiện lâm sàng (35.022) + Dị ứng (1.327)\n\nCăn cứ nền tảng: QĐ 1928/QĐ-BYT (2023) — Kiến trúc Chính phủ điện tử Y tế v2.1,\nxác lập SNOMED CT là bộ mã thuật ngữ y tế chuẩn quốc gia.\n\nVietnam national SNOMED CT subset, published by Ministry of Health in 3 batches.\nContains 77,393 concepts with Vietnamese translations, bilingual VI-EN.\nEach concept has: vn_code (national code), snomed_ct_id (international), name_vn, name_en.\nFor international interoperability: system = http://snomed.info/sct, code = snomed_ct_id.\n\n**Dữ liệu hiện có trong lớp chuẩn hóa:**\n`vn_code` (mã quốc gia do BYT công bố), `snomed_ct_id` (mã SNOMED CT quốc tế dùng cho coding/interoperability), `name_vn`, `name_en` (tên song ngữ), và `category` (nhóm thuật ngữ gốc trong dữ liệu tích hợp).\n\n**Các nhóm dữ liệu trong artifact:** `body structure` cho vị trí giải phẫu; `morphologic abnormality` cho bất thường hình thái/mô bệnh học; `clinical finding` cho phát hiện/chẩn đoán lâm sàng; `allergy` cho các khái niệm dị ứng và chất liên quan.\n\n**Cách dùng trong VN Core:** Dùng `snomed_ct_id` làm `code` khi gửi FHIR resource quốc tế hóa. Dùng cùng các companion ValueSet như `vn-body-site-vs`, `vn-condition-code-vs`, `vn-allergy-code-vs` tùy ca sử dụng. Khi cần rà soát sai lệch bản dịch, xem [trang đính chính SNOMED CT VN](snomed-vn-errata.html).\n\n**Cách lấy artifact:** Validator/FHIR server dùng file FHIR JSON đầy đủ `CodeSystem-vn-snomed-subset-cs.full.json` trên release download surface khi cần preload toàn bộ mã. Bộ tải xuống phát hành: xem [trang tải xuống](downloads.html#snomed-fhir-json) để lấy liên kết trực tiếp và gói `hl7.fhir.vn.terminology.clinical-0.3.0.tgz`. Public IG page này là metadata wrapper; dữ liệu chi tiết được tiêu thụ qua package/download surface và bộ nguồn chuẩn hóa nội bộ. 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.\n\nImplementation note: this IG publishes the VN SNOMED subset on the public HTML surface as metadata only (`content = not-present`).\nThe 77,393 concepts are distributed as a separate full FHIR JSON artifact on the release download surface, and the canonical `.json` route is redirected there for machine access.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "copyright" : "Bộ Y tế Việt Nam — QĐ 1928/QĐ-BYT (2023) nền tảng.\nQĐ 2427/QĐ-BYT (2025) Đợt 1 Body Structure, QĐ 2493/QĐ-BYT (2025) Đợt 2 Morphologic Abnormality,\nQĐ 2805/QĐ-BYT (2025) Đợt 3 Clinical Finding + Allergy.\nBản dịch và mã VN: BYT Việt Nam.\nArtifact này được công bố như metadata wrapper trong gói hl7.fhir.vn.terminology.clinical.",
  "caseSensitive" : true,
  "content" : "not-present",
  "count" : 77393
}

```
