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

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

Active tại thời điểm 2026-07-16

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

{
  "resourceType" : "CodeSystem",
  "id" : "vn-snomed-subset-cs",
  "language" : "vi",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: CodeSystem vn-snomed-subset-cs</b></p><a name=\"vn-snomed-subset-cs\"> </a><a name=\"hcvn-snomed-subset-cs\"> </a><p>This code system supplement <code>http://fhir.hl7.org.vn/core/CodeSystem/vn-snomed-subset-cs</code> defines features on the following codes:</p><table class=\"codes\"><tr><td style=\"white-space:nowrap\"><b>Code</b></td></tr></table></div>"
  },
  "extension" : [
    {
      "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
      "valueCoding" : {
        "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
        "code" : "QD-2427-2025"
      }
    },
    {
      "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
      "valueCoding" : {
        "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
        "code" : "QD-2493-2025"
      }
    },
    {
      "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
      "valueCoding" : {
        "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
        "code" : "QD-2805-2025"
      }
    }
  ],
  "url" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-snomed-subset-cs",
  "identifier" : [
    {
      "system" : "urn:ietf:rfc:3986",
      "value" : "urn:oid:2.25.161089673617632664299011809196868855799.16.128"
    }
  ],
  "version" : "0.8.0",
  "name" : "VNSNOMEDSubsetCS",
  "title" : "SNOMED CT Việt Nam (bản dịch bổ sung) — Vietnam SNOMED CT Vietnamese Supplement",
  "status" : "active",
  "experimental" : false,
  "date" : "2026-07-16",
  "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" : "info@hl7.org.vn"
        }
      ]
    }
  ],
  "description" : "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.\n\nPhạ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):\n\n- Đợt 1 (QĐ 2427/QĐ-BYT, 25/7/2025): Body Structures — 35.889 concepts\n- Đợt 2 (QĐ 2493/QĐ-BYT, ~08/2025): Morphologic Abnormality — 5.155 concepts\n- Đợt 3 (QĐ 2805/QĐ-BYT, 04/9/2025): Clinical Finding + Allergy — 36.349 concepts\n\nCă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).\n\n**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.\n\n**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](snomed-vn-errata.html).\n\n**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](downloads.html#snomed-fhir-json). Public IG page này chỉ là metadata declaration của supplement.\n\nEnglish summary: A CodeSystem supplement adding Vietnamese `designation`s (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).",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "VN",
          "display" : "Viet Nam"
        }
      ]
    }
  ],
  "copyright" : "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.\nSubset 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).",
  "content" : "supplement",
  "supplements" : "http://snomed.info/sct",
  "count" : 76066
}