HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## : Mã số BHXH — Vietnam Social Insurance Number

Draft tại thời điểm 2026-03-22

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

    @prefix fhir: <http://hl7.org/fhir/> .
    @prefix owl: <http://www.w3.org/2002/07/owl#> .
    @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
    @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
    @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

    # - resource -------------------------------------------------------------------

     a fhir:NamingSystem ;
      fhir:nodeRole fhir:treeRoot ;
      fhir:id [ fhir:v "vn-bhxh-ns"] ; #
      fhir:language [ fhir:v "vi"] ; #
      fhir:text [
    fhir:status [ fhir:v "generated" ] ;
    fhir:div [ fhir:v "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: NamingSystem vn-bhxh-ns</b></p><a name=\"vn-bhxh-ns\"> </a><a name=\"hcvn-bhxh-ns\"> </a><h3>Summary</h3><table class=\"grid\"><tr><td>Defining URL</td><td>http://fhir.hl7.org.vn/core/NamingSystem/vn-bhxh-ns</td></tr><tr><td>Version</td><td>0.5.0</td></tr><tr><td>Name</td><td>VNBHXH</td></tr><tr><td>Status</td><td>draft</td></tr><tr><td>Definition</td><td><div><p>Hệ thống định danh Mã số Bảo hiểm xã hội (10 chữ số), do BHXH Việt Nam cấp.\nGắn với sổ BHXH, dùng để tra cứu quá trình tham gia BHXH/BHYT/BHTN.\nLiên thông với CCCD nhưng vẫn tồn tại song song per NĐ 164/2025/NĐ-CP.\nCăn cứ bổ sung:</p>\n<ul>\n<li><strong>Luật 51/2024/QH15</strong> — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025</li>\n<li><strong>NĐ 164/2025/NĐ-CP</strong> — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH.</li>\n</ul>\n</div></td></tr><tr><td>Publisher</td><td>Omi HealthTech / VN Core FHIR Community Initiative</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/bhxh</td><td>true</td></tr></table></div>"^^rdf:XMLLiteral ]
      ] ; #
      fhir:extension ( [
    fhir:url [
    fhir:v "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url"^^xsd:anyURI ;
    fhir:l <http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url>     ] ;
    fhir:value [
    a fhir:Uri ;
    fhir:v "http://fhir.hl7.org.vn/core/NamingSystem/vn-bhxh-ns"^^xsd:anyURI ;
    fhir:l <http://fhir.hl7.org.vn/core/NamingSystem/vn-bhxh-ns>     ]
      ] [
    fhir:url [
    fhir:v "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version"^^xsd:anyURI ;
    fhir:l <http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version>     ] ;
    fhir:value [
    a fhir:String ;
    fhir:v "0.5.0"     ]
      ] ) ; #
      fhir:name [ fhir:v "VNBHXH"] ; #
      fhir:status [ fhir:v "draft"] ; #
      fhir:kind [ fhir:v "identifier"] ; #
      fhir:date [ fhir:v "2026-03-22"^^xsd:date] ; #
      fhir:publisher [ fhir:v "Omi HealthTech / VN Core FHIR Community Initiative"] ; #
      fhir:contact ( [
    fhir:name [ fhir:v "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
        ( fhir:telecom [
    fhir:system [ fhir:v "url" ] ;
    fhir:value [ fhir:v "https://hl7.org.vn" ]     ] [
    fhir:system [ fhir:v "email" ] ;
    fhir:value [ fhir:v "info@hl7.org.vn" ]     ] )
      ] [
    fhir:name [ fhir:v "Omi HealthTech (OmiGroup)" ] ;
        ( fhir:telecom [
    fhir:system [ fhir:v "url" ] ;
    fhir:value [ fhir:v "https://omihealthtech.vn" ]     ] [
    fhir:system [ fhir:v "url" ] ;
    fhir:value [ fhir:v "https://omigroup.vn" ]     ] [
    fhir:system [ fhir:v "email" ] ;
    fhir:value [ fhir:v "healthtech@omigroup.vn" ]     ] )
      ] ) ; #
      fhir:responsible [ fhir:v "Bảo hiểm xã hội Việt Nam (Vietnam Social Security)"] ; #
      fhir:description [ fhir:v "Hệ thống định danh Mã số Bảo hiểm xã hội (10 chữ số), do BHXH Việt Nam cấp.\nGắn với sổ BHXH, dùng để tra cứu quá trình tham gia BHXH/BHYT/BHTN.\nLiên thông với CCCD nhưng vẫn tồn tại song song per NĐ 164/2025/NĐ-CP.\nCăn cứ bổ sung:\n- **Luật 51/2024/QH15** — 27/11/2024 — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH."] ; #
      fhir:jurisdiction ( [
        ( fhir:coding [
    fhir:system [
    fhir:v "urn:iso:std:iso:3166"^^xsd:anyURI ;
    fhir:l <urn:iso:std:iso:3166>       ] ;
    fhir:code [ fhir:v "VN" ] ;
    fhir:display [ fhir:v "Viet Nam" ]     ] )
      ] ) ; #
      fhir:usage [ fhir:v "Dùng cho Patient.identifier, Coverage.identifier. Format: 10 chữ số. FHIRPath: value.matches('^[0-9]{10}$')"] ; #
      fhir:uniqueId ( [
    fhir:type [ fhir:v "uri" ] ;
    fhir:value [ fhir:v "http://fhir.hl7.org.vn/core/sid/bhxh" ] ;
    fhir:preferred [ fhir:v true ]
      ] ) . #