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
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
| Draft tại thời điểm 2026-09-22 |
Ánh xạ cho bhytXml14FollowUpAppointmentLm mô hình logic.
No Mappings Found
No Mappings Found
| Name | VN Core FHIR mapping![]() |
|---|---|
![]() |
|
![]() ![]() |
VNCoreClaim.identifier[MALK].value |
![]() ![]() |
VNCoreServiceRequest.identifier.value | VNCoreDocumentReference.identifier.value |
![]() ![]() |
VNCoreServiceRequest.requester.resolve().identifier[CSKCB].value | VNCoreOrganization.identifier[CSKCB].value |
![]() ![]() |
VNCorePatient.name.text |
![]() ![]() |
VNCorePatient.birthDate |
![]() ![]() |
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. |
![]() ![]() |
VNCorePatient.address.text |
![]() ![]() |
VNCoreCoverage.identifier[BHYT].value |
![]() ![]() |
VNCoreCoverage.period.end |
![]() ![]() |
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. |
![]() ![]() |
VNCoreEncounter.hospitalization | future admission instant extension |
![]() ![]() |
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. |
![]() ![]() |
VNCoreServiceRequest.occurrenceDateTime | VNCoreAppointment.start QĐ 3176/QĐ-BYT sửa toàn bộ diễn giải: định dạng còn 08 ký tự yyyymmdd (bỏ giờ phút), thay cho 12 ký tự yyyymmddHHMM theo QĐ 4750/QĐ-BYT cũ. Sửa 07/09/2026: đích thứ hai viết `Appointment.start` không có tiền tố profile, nên resolver PA5 bỏ qua IM LẶNG — chú thích cũ còn ghi 'IG chưa có VNCoreAppointment', nhận định đã lỗi thời vì profile ấy nay tồn tại với `start 0..1 MS`. Đổi sang `VNCoreAppointment.start` để nghĩa vụ của Bảng 14 nhìn thấy được. |
![]() ![]() |
VNCoreCondition.code.text | VNCoreComposition.section[diagnosis].text |
![]() ![]() |
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 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. |
![]() ![]() |
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 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. |
![]() ![]() |
VNCoreClaim.diagnosis.diagnosisCodeableConcept.coding.code | VNCoreConditionDiagnosis.code.coding[yhct].code |
![]() ![]() |
VNCoreClaim.subType Do not map to Coverage.extension[bhytCardType]; đây là phân loại lượt KCB, không phải nhóm thẻ/nhóm người tham gia BHYT. |
![]() ![]() |
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). |
![]() ![]() |
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ự (trước đây là mã số BHXH). |
![]() ![]() |
VNCoreServiceRequest.authoredOn | VNCoreDocumentReference.date |
![]() ![]() |
VNCoreProvenance.signature.data | future chữ-ký-số dự-phòng |
Documentation for this format | |