HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.3.0 - STU1 Draft Viet Nam cờ

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

ValueSet: Loại định danh Việt Nam — Vietnam Identifier Type ValueSet

URL chính thức: http://fhir.hl7.org.vn/core/ValueSet/vn-identifier-type-vs Phiên bản: 0.3.0
Computable Name: VNIdentifierTypeVS

Tập giá trị bao gồm tất cả loại định danh Việt Nam, kết hợp với HL7 v2 Table 0203.

References

This value set is not used here; it may be used elsewhere (e.g. specifications and/or implementations that use this content)

Logical Definition (CLD)

This value set includes codes based on the following rules:

  • Include all codes defined in http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs version 📦0.3.0
  • Include these codes as defined in http://terminology.hl7.org/CodeSystem/v2-0203 version 📦5.0.0
    CodeDisplayDefinition
    MR Medical record number An identifier that is unique to a patient within a set of medical records, not necessarily unique within an application.
    NI National unique individual identifier National unique individual identifier
    PPN Passport number A unique number assigned to the document affirming that a person is a citizen of the country.

 

Khai triển

This value set contains 17 concepts

SystemCodeDisplay (vi)DefinitionJSONXML
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  CCCDCitizen Identity CardSố Căn cước công dân (12 chữ số) do Bộ Công an cấp — định danh chính (primary identifier) trong hệ thống y tế VN. Từ 01/7/2025 thay thế mã số thuế cá nhân.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  CMNDPeople's Identity Card (legacy)Số Chứng minh nhân dân (9 hoặc 12 chữ số) — loại giấy tờ cũ, đã ngừng cấp mới. Giữ lại cho backward-compatibility với dữ liệu lịch sử.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  BHYTHealth Insurance CardSố thẻ Bảo hiểm Y tế (15 ký tự: 2 chữ + 13 số) do BHXH Việt Nam cấp. Xác định quyền lợi KCB BHYT của người bệnh.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  MA_LKBHYT submission linkage identifierMã liên kết hồ sơ (MA_LK) dùng để liên kết toàn bộ dữ liệu của cùng một đợt khám chữa bệnh khi gửi cơ quan BHXH.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  MA_LUOT_KCBEncounter visit identifierMã lượt khám (MA_LUOT_KCB) do cơ sở khám chữa bệnh phát sinh cho từng Encounter cụ thể, dùng để đối soát và tham chiếu nội bộ/gateway theo QĐ 3176/QĐ-BYT.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  BHXHSocial Insurance NumberMã số Bảo hiểm Xã hội (10 chữ số) do BHXH Việt Nam cấp. Dùng cho quản lý BHXH, BHYT, BHTN.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  GPHNMedical Practice LicenseSố Giấy phép hành nghề khám bệnh, chữa bệnh do cơ quan có thẩm quyền cấp theo Luật KCB 2023 và NĐ 96/2023/NĐ-CP. Đây là định danh hành nghề hiện hành cho Practitioner.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  CCHNLegacy Practice CertificateSố Chứng chỉ hành nghề y được cấp theo khung pháp lý trước Luật KCB 2023. Giữ lại để parse và đối soát dữ liệu lịch sử; không còn là định danh hành nghề current.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  CSKCBHealthcare Facility CodeMã cơ sở khám chữa bệnh (5 chữ số) do BHXH VN cấp. Dùng trong giao dịch BHYT, gửi dữ liệu XML 3176.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  MRNMedical Record NumberMã bệnh nhân (Medical Record Number) do từng cơ sở KCB tự quản lý. Không có format thống nhất toàn quốc.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  HCPassportSố Hộ chiếu do Bộ Công an cấp. Dùng cho người nước ngoài hoặc công dân VN khi chưa có CCCD.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  GKSBirth CertificateSố Giấy khai sinh do UBND xã/phường cấp. Dùng cho trẻ sơ sinh chưa có CCCD.
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  MSTTax Identification NumberMã số thuế doanh nghiệp/tổ chức do Tổng cục Thuế cấp. Từ 01/7/2025 không còn dùng cho cá nhân (thay bằng CCCD).
http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs  VNEIDVNeID Electronic Identity AccountTài khoản định danh điện tử trên ứng dụng VNeID do BCA quản lý. Tích hợp CCCD, BHYT, sổ SKĐT (QĐ 1332/QĐ-BYT).
http://terminology.hl7.org/CodeSystem/v2-0203  MRKrankenaktennummerAn identifier that is unique to a patient within a set of medical records, not necessarily unique within an application.
http://terminology.hl7.org/CodeSystem/v2-0203  NINational unique individual identifier
http://terminology.hl7.org/CodeSystem/v2-0203  PPNPassnummerA unique number assigned to the document affirming that a person is a citizen of the country.

Mô tả các bảng ở trên.