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

• Narrative Content
• XML
• JSON
• TTL

: Số thẻ Bảo hiểm Y tế (BHYT) — Vietnam Health Insurance Card Number - JSON Representation

Draft as of 2026-03-21

Raw json | Download

{
  "resourceType" : "NamingSystem",
  "id" : "vn-bhyt-ns",
  "text" : {
    "status" : "generated",
    "div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: NamingSystem vn-bhyt-ns</b></p><a name=\"vn-bhyt-ns\"> </a><a name=\"hcvn-bhyt-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-bhyt-ns</td></tr><tr><td>Version</td><td>0.1.0</td></tr><tr><td>Name</td><td>VNBHYT</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh Số thẻ Bảo hiểm Y tế, do BHXH Việt Nam cấp.\nHỗ trợ 3 format (hiện duy trì song song):</p>\n<ul>\n<li>CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)</li>\n<li>Mã số BHXH 10 chữ số: từ 01/4/2021</li>\n<li>Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021\nBên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất.\nCăn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT (29/10/2024).</li>\n</ul>\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/bhyt</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-bhyt-ns"
    },
    {
      "url" : "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version",
      "valueString" : "0.1.0"
    }
  ],
  "name" : "VNBHYT",
  "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ảo hiểm Xã hội Việt Nam (BHXH VN)",
  "description" : "Hệ thống định danh Số thẻ Bảo hiểm Y tế, do BHXH Việt Nam cấp.\nHỗ trợ 3 format (hiện duy trì song song):\n- CCCD 12 chữ số: hỗ trợ từ 15/8/2025 (NĐ 188/2025/NĐ-CP, hiệu lực 15/8/2025)\n- Mã số BHXH 10 chữ số: từ 01/4/2021\n- Format cũ 15 ký tự (2 chữ cái + 13 chữ số): trước 01/4/2021\nBên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất.\nCăn cứ: Luật BHYT 2008 sửa đổi 2014, NĐ 188/2025/NĐ-CP, QĐ 3176/QĐ-BYT (29/10/2024).",
  "jurisdiction" : [
    {
      "coding" : [
        {
          "system" : "urn:iso:std:iso:3166",
          "code" : "VN",
          "display" : "Viet Nam"
        }
      ]
    }
  ],
  "usage" : "Dùng cho Patient.identifier, Coverage.subscriberId. 3 format: CCCD 12 số (mới nhất) | BHXH 10 số | 15 ký tự (cũ). FHIRPath: value.matches('^[0-9]{12}$') or value.matches('^[0-9]{10}$') or value.matches('^[A-Z]{2}[0-9]{13}$')",
  "uniqueId" : [
    {
      "type" : "uri",
      "value" : "http://fhir.hl7.org.vn/core/sid/bhyt",
      "preferred" : true
    }
  ]
}