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: Bảng 13 giấy chuyển tuyến/chuyển cơ sở KCB BHYT — XML13 Referral Logical Model - Ánh xạ

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

Ánh xạ cho bhytXml13ReferralLm 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
.. bhytXml13ReferralLm
... maLk
VNCoreClaim.identifier[MALK].value
... soHoSo
VNCoreServiceRequest.identifier.value | future referral soHoSo identifier slice
... soChuyenTuyen
VNCoreServiceRequest.identifier.value | future referral soChuyenTuyen identifier slice
... giayChuyenTuyen
VNCoreServiceRequest.identifier.value | VNCoreDocumentReference.identifier.value
... maCskcb
VNCoreServiceRequest.requester.resolve().identifier[CSKCB].value | VNCoreOrganization.identifier[CSKCB].value
... maCskcbDi
VNCoreEncounter.hospitalization.origin.resolve().identifier[CSKCB].value | future ServiceRequest nơi-chuyển-đi extension
QĐ 3176/QĐ-BYT đổi tên MA_NOI_DI thành MA_CSKCB_DI, tăng kích thước tối đa lên 100 ký tự; hỗ trợ multi-value ngăn cách bằng dấu chấm phẩy (;) khi người bệnh chuyển từ nhiều cơ sở.
... maCskcbDen
VNCoreEncounter.hospitalization.destination.resolve().identifier[CSKCB].value | VNCoreServiceRequest.performer.resolve().identifier[CSKCB].value
... hoTen
VNCorePatient.name.text
... ngaySinh
VNCorePatient.birthDate
... gioiTinh
VNCorePatient.gender
Mã nguồn là 1/2/3 (nam/nữ/chưa xác định) theo QĐ 130/QĐ-BYT, KHÔNG phải mã của AdministrativeGender. Phải chuyển qua ConceptMap/vn-cm-gender-to-administrative-gender trước khi ghi vào Patient.gender.
... maQuocTich
VNCorePatient.extension[citizenship].valueCodeableConcept.coding.code
Mã nguồn là mã quốc tịch 3 chữ số do Bộ Công an ban hành, KHÔNG phải ISO 3166. Phải chuyển sang hệ mã mà extension[citizenship] bind, hoặc ghi kèm đúng system của mã nguồn.
... maDanToc
VNCorePatient.extension[ethnicity].valueCodeableConcept.coding.code
... maNgheNghiep
VNCorePatient.extension[occupation].valueCodeableConcept.coding.code
... diaChi
VNCorePatient.address.text
... maTheBhyt
VNCoreCoverage.identifier[BHYT].value
... gtTheDen
VNCoreCoverage.period.end
... ngayVao
VNCoreEncounter.period.start | VNCoreClaim.billablePeriod.start
Đính chính 16/08/2026: trước đây ngayVao và ngayRa CÙNG trỏ VNCoreClaim.created. Claim.created là ngày LẬP hồ sơ yêu cầu (1..1) nên không thể mang cả hai mốc; kỳ khám chữa bệnh thuộc Claim.billablePeriod.
... ngayVaoNoiTru
VNCoreEncounter.hospitalization | future admission instant extension
... ngayRa
VNCoreEncounter.period.end | VNCoreClaim.billablePeriod.end
Xem ghi chú tại NGAY_VAO: kỳ KCB đi vào Claim.billablePeriod, không phải Claim.created.
... dauHieuLs
VNCoreServiceRequest.reasonCode.text | VNCoreClinicalImpression.finding.itemCodeableConcept.text
... chanDoanRv
VNCoreCondition.code.text | VNCoreComposition.section[diagnosis].text
... qtBenhLy
VNCoreComposition.section[history].text
... tomtatKq
VNCoreDiagnosticReport.conclusion
... ppDieuTri
VNCoreProcedure.code | VNCoreComposition.section[procedures].text
QĐ 3176/QĐ-BYT sửa toàn bộ diễn giải: trước đây tham chiếu Bảng 1, nay diễn giải trực tiếp phương pháp/thủ thuật/kỹ thuật/thuốc đã dùng.
... maBenhChinh
VNCoreClaim.diagnosis.where(type='principal').diagnosisCodeableConcept | VNCoreCondition.code
[MULTI-INSTANCE] Bệnh chính và bệnh kèm theo là HAI Condition khác nhau; bệnh kèm theo có thể có nhiều mã. Bệnh chính và bệnh kèm theo là HAI Condition riêng, phân biệt bằng Encounter.diagnosis.rank (rank=1 cho bệnh chính); không dồn vào một Condition.code.
... maBenhKt
VNCoreClaim.diagnosis.where(type!='principal').diagnosisCodeableConcept | VNCoreCondition.code
[MULTI-INSTANCE] Bệnh chính và bệnh kèm theo là HAI Condition khác nhau; bệnh kèm theo có thể có nhiều mã. Bệnh chính và bệnh kèm theo là HAI Condition riêng, phân biệt bằng Encounter.diagnosis.rank (rank=1 cho bệnh chính); không dồn vào một Condition.code.
... maBenhYhct
VNCoreClaim.diagnosis.diagnosisCodeableConcept.coding.code | VNCoreConditionDiagnosis.code.coding[yhct].code
... tinhTrangCt
VNCoreClinicalImpression.summary | future ServiceRequest tình-trạng-chuyển-tuyến extension
QĐ 3176/QĐ-BYT đổi tên trường PP_DIEU_TRI thành TINH_TRANG_CT và thay đổi hoàn toàn diễn giải so với QĐ 4750/QĐ-BYT.
... maLoaiRv
VNCoreEncounter.hospitalization.dischargeDisposition
Ghi chú cuối Bảng 13: chỉ trích chuyển Bảng này khi có chuyển tuyến/chuyển cơ sở KBCB và MA_LOAI_RV = 2 hoặc 5.
... maLydoCt
VNCoreServiceRequest.reasonCode (binding VNCareTransferReasonVS — vn-care-transfer-reason-cs) | future mã-lý-do-chuyển-tuyến extension
Mã hoá bằng CodeSystem vn-care-transfer-reason-cs (VNCareTransferReasonCS, QĐ 3176/QĐ-BYT Bảng 13 STT 32). Danh mục mã cố định: 1=đủ điều kiện & phù hợp quy định chuyển tuyến/chuyển cơ sở KBCB; 2=đủ điều kiện do không phù hợp khả năng đáp ứng của CSKCB; 3=theo yêu cầu người bệnh hoặc người đại diện hợp pháp.
... huongDieuTri
VNCoreCarePlan.description | VNCoreServiceRequest.note
... phuongtienVc
VNCoreServiceRequest.note | future ServiceRequest phương-tiện-vận-chuyển extension
... hotenNguoiHt
VNCoreRelatedPerson.name.text
Chỉ ghi nếu có người hộ tống.
... chucdanhNguoiHt
VNCoreRelatedPerson.relationship.text | future người-hộ-tống chức-danh
Chỉ ghi nếu có người hộ tống.
... maBacsi
VNCorePractitioner.identifier[GPHN].value
QĐ 3176/QĐ-BYT đổi căn cứ mã hoá từ CCHN sang GPHN. Trường hợp huy động/điều động chống dịch, thiên tai: mã hoá MA_BAC_SI.HD.XXXXX (XXXXX = mã CSKCB cử người đi; nếu không đăng ký hành nghề thì XXXXX = 2 ký tự mã tỉnh nơi ra quyết định huy động + XXX).
... maTtdv
VNCorePractitioner.identifier[GPHN].value | VNCorePractitioner.identifier[CCCD].value (fallback khi không có GPHN)
QĐ 3176/QĐ-BYT ưu tiên mã hoá theo GPHN; nếu không có GPHN thì ghi số CCCD hoặc số định danh cá nhân của người ký. Đổi kiểu dữ liệu sang chuỗi, tăng kích thước tối đa 255 ký tự.
... duPhong
VNCoreProvenance.signature.data | future chữ-ký-số dự-phòng

doco Documentation for this format