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 - Draft for Community Review (v0.8.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-07-16

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


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

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

<http://hl7.org/fhir/NamingSystem/vn-bhxh-ns> a fhir:NamingSystem ;
  fhir:nodeRole fhir:treeRoot ;
  fhir:Resource.id [ fhir:value "vn-bhxh-ns"] ;
  fhir:Resource.language [ fhir:value "vi"] ;
  fhir:DomainResource.text [
     fhir:Narrative.status [ fhir:value "generated" ] ;
     fhir:Narrative.div "<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.8.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 theo NĐ 164/2025/NĐ-CP.\nQUAN HỆ VỚI sid/bhyt: mã số BHYT 10 chữ số TRÙNG GIÁ TRỊ mã số BHXH — chọn namespace theo\nNGỮ CẢNH NGHIỆP VỤ: sổ/quá trình BHXH dùng sid/bhxh; số thẻ/quyền lợi BHYT (Coverage,\nPatient.identifier[BHYT]) dùng sid/bhyt (xem vn-bhyt-ns). Cùng giá trị xuất hiện ở cả hai\nnamespace là HỢP LỆ và không phải trùng lặp dữ liệu.\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><tr><td>OID</td><td>2.25.161089673617632664299011809196868855799.31.1 (for OID based terminology systems)</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>"
  ] ;
  fhir:DomainResource.extension [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.url" ] ;
     fhir:Extension.valueUri [ fhir:value "http://fhir.hl7.org.vn/core/NamingSystem/vn-bhxh-ns" ]
  ], [
     fhir:index -1 ;
     fhir:Extension.url [ fhir:value "http://hl7.org/fhir/5.0/StructureDefinition/extension-NamingSystem.version" ] ;
     fhir:Extension.valueString [ fhir:value "0.8.0" ]
  ] ;
  fhir:NamingSystem.name [ fhir:value "VNBHXH"] ;
  fhir:NamingSystem.status [ fhir:value "draft"] ;
  fhir:NamingSystem.kind [ fhir:value "identifier"] ;
  fhir:NamingSystem.date [ fhir:value "2026-07-16"^^xsd:date] ;
  fhir:NamingSystem.publisher [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative"] ;
  fhir:NamingSystem.contact [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech / VN Core FHIR Community Initiative" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://hl7.org.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ], [
     fhir:index -1 ;
     fhir:ContactDetail.name [ fhir:value "Omi HealthTech (OmiGroup)" ] ;
     fhir:ContactDetail.telecom [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omihealthtech.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "url" ] ;
       fhir:ContactPoint.value [ fhir:value "https://omigroup.vn" ]
     ], [
       fhir:index -1 ;
       fhir:ContactPoint.system [ fhir:value "email" ] ;
       fhir:ContactPoint.value [ fhir:value "info@hl7.org.vn" ]
     ]
  ] ;
  fhir:NamingSystem.responsible [ fhir:value "Bảo hiểm xã hội Việt Nam (Vietnam Social Security)"] ;
  fhir:NamingSystem.description [ fhir:value "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 theo NĐ 164/2025/NĐ-CP.\nQUAN HỆ VỚI sid/bhyt: mã số BHYT 10 chữ số TRÙNG GIÁ TRỊ mã số BHXH — chọn namespace theo\nNGỮ CẢNH NGHIỆP VỤ: sổ/quá trình BHXH dùng sid/bhxh; số thẻ/quyền lợi BHYT (Coverage,\nPatient.identifier[BHYT]) dùng sid/bhyt (xem vn-bhyt-ns). Cùng giá trị xuất hiện ở cả hai\nnamespace là HỢP LỆ và không phải trùng lặp dữ liệu.\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:NamingSystem.jurisdiction [
     fhir:index -1 ;
     fhir:CodeableConcept.coding [
       fhir:index -1 ;
       fhir:Coding.system [ fhir:value "urn:iso:std:iso:3166" ] ;
       fhir:Coding.code [ fhir:value "VN" ] ;
       fhir:Coding.display [ fhir:value "Viet Nam" ]
     ]
  ] ;
  fhir:NamingSystem.usage [ fhir:value "Dùng cho Patient.identifier, Coverage.identifier. Format: 10 chữ số. FHIRPath: value.matches('^[0-9]{10}$')"] ;
  fhir:NamingSystem.uniqueId [
     fhir:index -1 ;
     fhir:NamingSystem.uniqueId.type [ fhir:value "uri" ] ;
     fhir:NamingSystem.uniqueId.value [ fhir:value "http://fhir.hl7.org.vn/core/sid/bhxh" ] ;
     fhir:NamingSystem.uniqueId.preferred [ fhir:value "true"^^xsd:boolean ]
  ] .

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/NamingSystem/vn-bhxh-ns.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/NamingSystem/vn-bhxh-ns.ttl> .