HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.9.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.9.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

Mô hình logic: Sổ sức khỏe điện tử VNeID — Logical Model - Ánh xạ

Draft tại thời điểm 2026-07-31

Ánh xạ cho vnHealthBookVneidLm mô hình logic.

Mappings to Structures in this Implementation Guide

No Mappings Found

Mappings to other Structures

No Mappings Found

Other Mappings

NameVN Core FHIR mappingdoco
.. vnHealthBookVneidLm
... thongTinDinhDanh
  • VNCorePatient (định danh
  • tên
  • ngày sinh
  • giới tính
  • dân tộc
  • quốc tịch
  • nghề nghiệp) + VNCoreCoverage (thẻ BHYT
  • nơi ĐKKCB ban đầu)
.... @id
.... extension
.... modifierExtension
.... hoTen
VNCorePatient.name.text | VNCorePatient.name.family + VNCorePatient.name.given
.... ngaySinh
VNCorePatient.birthDate (+ extension[birthTime] nếu ghi giờ)
.... gioiTinh
VNCorePatient.gender
Mã số 1/2/3 cần ConceptMap sang HL7 AdministrativeGender (male/female/unknown/other).
.... danToc
VNCorePatient.extension[ethnicity].value[x] (VNEthnicityCS)
.... quocTich
VNCorePatient.extension[citizenship].value[x]
.... ngheNghiep
VNCorePatient.extension[occupation].value[x]
.... soDinhDanh
VNCorePatient.identifier[CCCD].value | VNCorePatient.identifier.value | VNCorePatient.identifier[HC].value
.... maTheBhyt
VNCorePatient.identifier[BHYT].value | VNCoreCoverage.subscriberId | VNCoreCoverage.identifier.value
.... noiDangKyKcbBanDau
VNCoreCoverage (nơi ĐKKCB ban đầu) -> VNCoreOrganization.identifier[CSKCB].value
.... soDienThoai
VNCorePatient.telecom.where(system='phone').value
... diaChiCuTru
VNCoreAddress (VNCorePatient.address)
.... @id
.... extension
.... modifierExtension
.... diaChi
VNCoreAddress.line
.... tinhThanhPho
VNCoreAddress.state
Đối chiếu VNProvinceLegacyCS (63 tỉnh cũ); không map thẳng sang bộ mã 34 tỉnh hiện hành mà phải qua ConceptMap sắp xếp ĐVHC.
.... quanHuyen
VNCoreAddress.district
Đối chiếu VNDistrictLegacyCS; cấp huyện đã bỏ theo mô hình 2 cấp từ 01/07/2025 — chỉ dùng cho dữ liệu legacy.
.... xaPhuong
VNCoreAddress.extension[ward].value[x]
Đối chiếu mã xã legacy (QĐ 124/2004/QĐ-TTg); không map thẳng sang danh mục xã/phường sau sắp xếp 01/07/2025.
... nguoiDaiDien
VNCoreRelatedPerson (VNCorePatient.contact khi không tách resource)
.... @id
.... extension
.... modifierExtension
.... hoTen
VNCoreRelatedPerson.name.text
.... moiQuanHe
VNCoreRelatedPerson.relationship
.... soDinhDanh
VNCoreRelatedPerson.identifier[CCCD].value
.... soDienThoai
VNCoreRelatedPerson.telecom.where(system='phone').value
.... @id
.... extension
.... modifierExtension
.... ngayKhamRaVien
VNCoreEncounter.period.start + VNCoreEncounter.period.end (đợt KCB trong lịch sử)
.... maCoSoKcb
VNCoreEncounter.serviceProvider.resolve().identifier[CSKCB].value | VNCoreOrganization.identifier[CSKCB].value
.... tenCoSoKcb
VNCoreOrganization.name
.... chanDoanRaVien
VNCoreCondition.code.text | VNCoreEncounter.diagnosis.condition.resolve().code.text
.... maBenhIcd10
VNCoreCondition.code.coding.code (ICD-10 VN; mã đầu tiên = bệnh chính)
Phụ lục 02 QĐ 2733/QĐ-BYT bổ sung nhóm mã tiêm vắc-xin/mũi tiêm vào MA_BENH_CHINH/MA_BENH_KT để hiển thị Tiền sử tiêm chủng — các mã tiêm này ánh xạ VNCoreImmunization thay vì VNCoreCondition.
.... tenBenhIcd10
VNCoreCondition.code.text | VNCoreCondition.code.coding.display
... dotKham
VNCoreEncounter (đợt KCB) + VNCoreCondition (chẩn đoán ra viện)
.... @id
.... extension
.... modifierExtension
.... maCskcbKcb
VNCoreEncounter.serviceProvider.resolve().identifier[CSKCB].value | VNCoreOrganization.identifier[CSKCB].value
.... tenCskcbKcb
VNCoreOrganization.name
.... maNoiDi
BHYTXML13ReferralLM.maCskcbDi | VNCoreEncounter.hospitalization.origin.resolve().identifier[CSKCB].value | VNCoreEncounter.extension[referralMode]
QĐ 3176/QĐ-BYT đổi tên MA_NOI_DI thành MA_CSKCB_DI (multi-value ngăn cách bằng ';').
.... tenNoiDi
VNCoreOrganization.name
.... lyDoKham
VNCoreEncounter.reasonCode.text | VNCoreCondition (reason for encounter)
.... loaiHinhKcb
VNCoreEncounter.class | VNCoreEncounter.type.coding.code
.... ngayGioVaoVien
VNCoreEncounter.period.start
.... ngayGioRaVien
VNCoreEncounter.period.end
.... ketQuaDieuTri
VNCoreEncounter.extension[treatmentOutcome].value[x] (VNCoreExtTreatmentOutcome)
.... tinhTrangRaVien
VNCoreEncounter.hospitalization.dischargeDisposition.coding.code
MA_LOAI_RV = 2 hoặc 5 là điều kiện trích chuyển Bảng 13 giấy chuyển tuyến (BHYTXML13ReferralLM).
.... maNoiDen
BHYTXML13ReferralLM.maCskcbDen | VNCoreEncounter.hospitalization.destination.resolve().identifier[CSKCB].value
.... tenNoiDen
VNCoreOrganization.name
.... chanDoanRaVien
VNCoreCondition.code.text | VNCoreEncounter.diagnosis.condition.resolve().code.text
.... maBenhIcd10
VNCoreCondition.code.coding.code (ICD-10 VN; mã đầu tiên = bệnh chính)
.... tenBenhIcd10
VNCoreCondition.code.text | VNCoreCondition.code.coding.display
.... ghiChu
VNCoreEncounter.extension | VNCoreCondition.note.text
... canLamSang
VNCoreDiagnosticReport + VNCoreObservationLab (Bảng 4 = BHYTXML4CLSLM; Bảng 3 = BHYTXML3ServiceLM)
.... @id
.... extension
.... modifierExtension
.... maNhomCls
VNCoreDiagnosticReport.category.coding.code | VNCoreServiceRequest.category.coding.code
.... tenNhomCls
VNCoreDiagnosticReport.category.text
.... maCls
VNCoreServiceRequest.code.coding.code | VNCoreDiagnosticReport.code.coding.code
.... tenCls
VNCoreServiceRequest.code.text | VNCoreDiagnosticReport.code.text
.... maChiSoCls
BHYTXML4CLSLM.maChiSo | VNCoreObservationLab.code.coding.code
.... tenChiSoCls
VNCoreObservationLab.code.text
.... ketQua
VNCoreObservationLab.value[x]
.... ketLuan
VNCoreDiagnosticReport.conclusion | VNCoreObservationLab.interpretation.text | VNCoreObservationLab.note.text
.... ngayGioThucHien
VNCoreObservationLab.effective[x] | VNCoreDiagnosticReport.effective[x]
.... lienKetKetQua
VNCoreDiagnosticReport.presentedForm.url | VNCoreDiagnosticReport.media.link
... thuoc
VNCoreMedicationRequest + VNCoreMedicationDispense + VNCoreMedication (Bảng 2 = BHYTXML2MedicationLM)
.... @id
.... extension
.... modifierExtension
.... maThuoc
BHYTXML2MedicationLM.maThuoc | VNCoreMedication.code.coding.code
.... tenThuocHamLuong
VNCoreMedication.code.text + VNCoreMedication.ingredient.strength
.... donViTinh
VNCoreMedicationDispense.quantity.unit | VNCoreMedicationRequest.dispenseRequest.quantity.unit
.... duongDung
VNCoreMedicationRequest.dosageInstruction.route
.... soLuong
VNCoreMedicationDispense.quantity.value | VNCoreMedicationRequest.dispenseRequest.quantity.value
.... lieuDung
VNCoreMedicationRequest.dosageInstruction.doseAndRate
.... cachDung
VNCoreMedicationRequest.dosageInstruction.text
... phauThuatThuThuat
  • VNCoreProcedure (Bảng 3 = BHYTXML3ServiceLM
  • lọc MA_NHOM = 8 | 18)
.... @id
.... extension
.... modifierExtension
.... maPtTt
VNCoreProcedure.code.coding.code
.... tenPtTt
VNCoreProcedure.code.text
... tomTat
VNCoreComposition (các section tóm tắt) + BHYTXML8TreatmentSummaryLM
.... @id
.... extension
.... modifierExtension
.... tomTatBenhSu
BHYTXML8TreatmentSummaryLM.qtBenhly | VNCoreComposition.section[history].text
.... tomTatCls
BHYTXML8TreatmentSummaryLM.tomtatKq | VNCoreComposition.section[labResults].text
.... tomTatDieuTri
BHYTXML8TreatmentSummaryLM.ppDieuTri | VNCoreComposition.section[dischargeSummary].text
.... huongDieuTriTiepTheo
VNCoreComposition.section[dischargeSummary].text | VNCoreCarePlan.description
Thành phần NGAY_TAI_KHAM ánh xạ BHYTXML14FollowUpAppointmentLM (giấy hẹn khám lại) -> VNCoreServiceRequest.occurrence / future Appointment.start.
.... bacSiDieuTri
VNCorePractitioner.name.text | VNCoreEncounter.participant.where(type='ATND').individual.resolve().name.text
.... soDienThoaiBacSi
VNCorePractitioner.telecom.where(system='phone').value

doco Documentation for this format