HL7 VN

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam
0.1.0 - STU1 Draft Viet Nam flag

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

: Số Căn cước công dân (CCCD) — Vietnam Citizen Identity Card Number - JSON Representation

Draft as of 2026-03-21

Raw json | Download

{
  "resourceType" : "NamingSystem",
  "id" : "vn-cccd-ns",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: NamingSystem vn-cccd-ns</b></p><a name=\"vn-cccd-ns\"> </a><a name=\"hcvn-cccd-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-cccd-ns</td></tr><tr><td>Version</td><td>0.1.0</td></tr><tr><td>Name</td><td>VNCCCD</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh Số Căn cước công dân (12 chữ số), do Bộ Công an cấp.\nLà số định danh cá nhân duy nhất theo Luật Căn cước 2023 (26/2023/QH15).\nTừ 01/7/2025, thay thế mã số thuế cá nhân.\nBắt buộc cho bệnh án điện tử theo TT 13/2025/TT-BYT.</p>\n</div></td></tr><tr><td>Publisher</td><td>HL7 Vietnam</td></tr></table><h3>Identifiers</h3><table class=\"grid\"><tr><td><b>Type</b></td><td><b>Value</b></td><td><b>Preferred</b></td></tr><tr><td>URI</td><td>http://fhir.hl7.org.vn/core/sid/cccd</td><td>true</td></tr></table></div>"
  },
  "extension" : [
    {
      "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url",
      "valueUri" : "http://fhir.hl7.org.vn/core/NamingSystem/vn-cccd-ns"
    },
    {
      "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version",
      "valueString" : "0.1.0"
    }
  ],
  "name" : "VNCCCD",
  "status" : "draft",
  "kind" : "identifier",
  "date" : "2026-03-21",
  "publisher" : "HL7 Vietnam",
  "contact" : [
    {
      "name" : "HL7 Vietnam",
      "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"
        }
      ]
    }
  ],
  "responsible" : "Bộ Công an — Cục Cảnh sát quản lý hành chính về trật tự xã hội (C06)",
  "description" : "Hệ thống định danh Số Căn cước công dân (12 chữ số), do Bộ Công an cấp.\nLà số định danh cá nhân duy nhất theo Luật Căn cước 2023 (26/2023/QH15).\nTừ 01/7/2025, thay thế mã số thuế cá nhân.\nBắt buộc cho bệnh án điện tử theo TT 13/2025/TT-BYT.",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "VN",
          "display" : "Viet Nam"
        }
      ]
    }
  ],
  "usage" : "Dùng cho Patient.identifier, Practitioner.identifier. Format: 12 chữ số. FHIRPath: value.matches('^[0-9]{12}$')",
  "uniqueId" : [
    {
      "type" : "uri",
      "value" : "http://fhir.hl7.org.vn/core/sid/cccd",
      "preferred" : true
    }
  ]
}