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.10.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.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

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

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

Á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 mã hai chữ số trong vn-province-cs và ngày hồ sơ. History membership không chứng minh hiệu lực; chỉ chuyển sang đơn vị kế tiếp khi có quan hệ đã thẩm định và mục đích chuyển đổi rõ ràng, đồng thời giữ dữ liệu nguồn.
.... quanHuyen
VNCoreAddress.district
Đối chiếu mã nhà nước ba chữ số trong vn-district-cs; nếu nguồn là TMS hoặc mã ghép năm chữ số phải chuyển bằng registry đúng scheme/edition. Tra tên theo ngày hồ sơ khi có bằng chứng; thiếu bằng chứng giữ text nguồn. NQ 203/2025/QH15 Điều 2 khoản 2 kết thúc hoạt động cấp huyện từ 01/07/2025.
.... 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
[MULTI-INSTANCE] Bốn tên cơ sở trỏ tới BỐN Organization khác nhau: nơi khám của đợt, nơi đến, nơi đi và cơ sở trong tiền sử. Bốn chỉ tiêu trỏ tới các Organization KHÁC NHAU (cơ sở KCB của đợt khám, nơi chuyển đến, nơi chuyển đi, cơ sở trong tiền sử); mỗi Organization có name riêng.
.... 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
[MULTI-INSTANCE] Bốn tên cơ sở trỏ tới BỐN Organization khác nhau: nơi khám của đợt, nơi đến, nơi đi và cơ sở trong tiền sử. Bốn chỉ tiêu trỏ tới các Organization KHÁC NHAU (cơ sở KCB của đợt khám, nơi chuyển đến, nơi chuyển đi, cơ sở trong tiền sử); mỗi Organization có name riêng.
.... 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
[MULTI-INSTANCE] Bốn tên cơ sở trỏ tới BỐN Organization khác nhau: nơi khám của đợt, nơi đến, nơi đi và cơ sở trong tiền sử. Bốn chỉ tiêu trỏ tới các Organization KHÁC NHAU (cơ sở KCB của đợt khám, nơi chuyển đến, nơi chuyển đi, cơ sở trong tiền sử); mỗi Organization có name riêng.
.... 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
[MULTI-INSTANCE] Bốn tên cơ sở trỏ tới BỐN Organization khác nhau: nơi khám của đợt, nơi đến, nơi đi và cơ sở trong tiền sử. Bốn chỉ tiêu trỏ tới các Organization KHÁC NHAU (cơ sở KCB của đợt khám, nơi chuyển đến, nơi chuyển đi, cơ sở trong tiền sử); mỗi Organization có name riêng.
.... 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