Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.8.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| Draft tại thời điểm 2026-07-17 |
Ánh xạ cho bhytXml3ServiceLm mô hình logic.
No Mappings Found
No Mappings Found
| Name | VN Core FHIR mapping |
|---|---|
  bhytXml3ServiceLm |
|
  maLk |
VNCoreClaim.identifier[MALK].value |
| stt |
VNCoreClaim.item.where(category!='8').sequence |
| maDichVu |
VNCoreClaim.item.where(category!='8').productOrService.coding.code | VNCoreServiceRequest.code.coding.code Conditionally required when MA_VAT_TU is absent or MA_NHOM is not 10. |
| maPtttQt |
VNCoreClaim.extension[paymentMethod].valueCodeableConcept.coding.code | VNCoreClaim.item.extension[paymentMethod].valueCodeableConcept.coding.code |
| maVatTu |
VNCoreDevice.identifier[medicalDeviceItemCode].value | VNCoreClaim.item.where(category!='8').productOrService.coding.code Conditionally required when MA_DICH_VU is absent or MA_NHOM=10; do not collapse medical supplies into service codes when Device is available. |
| maNhom |
ConceptMap/vn-cm-bhyt-claim-cost-group-to-cost-category -> VNCoreClaim.item.where(category!='8').category.coding.code Source code system is QD 3176 MA_NHOM. Export/import must bridge through the ConceptMap instead of assigning the QD 697 target code directly. |
| goiVtyt |
VNCoreClaim.item.where(category!='8') | future supply-package (GOI_VTYT) extension Mã gói VTYT trong một lần dùng DVKT (G1, G2,...) theo QĐ 3176/QĐ-BYT; ghi tại dòng DVKT phát sinh gói VTYT đi kèm → điều kiện, 0..1. Chưa có element đích — dùng future extension nhóm gói VTYT trên Claim.item (tiền lệ taiSuDung). |
| tenVatTu |
VNCoreDevice.deviceName.name | VNCoreClaim.item.where(category!='8').productOrService.text | display |
| tenDichVu |
VNCoreClaim.item.where(category!='8').productOrService.text | VNCoreServiceRequest.code.text | display |
| maXangDau |
VNCoreClaim.item.where(category!='8') | future fuel-type-code (MA_XANG_DAU) extension Mã loại xăng, dầu để tính chi phí vận chuyển người bệnh theo Bộ mã DMDC do Bộ Y tế ban hành (QĐ 3176/QĐ-BYT); chỉ áp cho dòng vận chuyển (MA_DICH_VU=VC.XXXXX) → điều kiện, 0..1. Chưa có element đích — dùng future extension mã nhiên liệu trên Claim.item. |
| donViTinh |
VNCoreClaim.item.where(category!='8').quantity.unit |
| phamVi |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[scope].valueCodeableConcept |
| soLuong |
VNCoreClaim.item.where(category!='8').quantity.value |
| donGiaBv |
VNCoreClaim.item.where(category!='8').unitPrice.value | VNCoreClaim.item.extension[hospitalUnitPrice].valueMoney.value Hospital charge price; keep separate from the BHYT price to avoid financial round-trip loss. |
| donGiaBh |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[insuranceUnitPrice].valueMoney.value BHYT-covered unit price; do not collapse into Claim.item.unitPrice when hospital and insurance prices differ. |
| ttThau |
VNCoreClaim.item.where(category!='8').extension[tenderInfo].valueString Chuỗi thông tin thầu VTYT: số QĐ trúng thầu; số gói thầu; mã nhóm thầu (Phụ lục 7 QĐ 5937/QĐ-BYT); năm ban hành, cách nhau bằng ';' (QĐ 3176/QĐ-BYT). Đính chính: tăng kích thước tối đa lên 50 ký tự; VTYT đấu thầu/duyệt kế hoạch từ 14/4/2023 tạm dùng mã nhóm thầu 'N0'. Đích: extension VNCoreExtTenderInfo (value string) đã tồn tại trên Claim.item. Ghi chú scope: TT_THAU chỉ áp cho dòng VTYT (điều kiện) nhưng cardinality hiện giữ 1..1 theo bản gốc — không sửa trong lượt bổ sung mapping này. |
| tyleTtDv |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[servicePaymentRatio].valueDecimal |
| tyleTtBh |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[paymentRatio].valueDecimal |
| thanhTienBv |
VNCoreClaim.item.where(category!='8').net.value | VNCoreClaim.item.extension[hospitalLineAmount].valueMoney.value Hospital line amount; keep separate from BHYT line amount. |
| thanhTienBh |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[insuranceLineAmount].valueMoney.value |
| tTrantt |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[paymentCeiling].valueMoney.value Mức thanh toán tối đa BHYT (45 tháng lương cơ sở) của gói VTYT trong một lần thực hiện DVKT theo Thông tư 04/2017/TT-BYT (diễn giải sửa đổi toàn bộ theo QĐ 3176/QĐ-BYT; kế thừa QĐ 4750/QĐ-BYT); trần 45 tháng lương cơ sở theo NĐ 188/2025/NĐ-CP. Chỉ ghi khi VTYT có quy định mức thanh toán BHYT, để trống khi không có trần → điều kiện, 0..1. Quan hệ tính toán: khi DON_GIA_BV vượt trần thì DON_GIA_BH = T_TRANTT. Đích là sub-extension paymentCeiling (valueMoney) của VNCoreExtInsuranceCostInfo trên Claim.item, tránh gộp mất dữ liệu vào insuranceUnitPrice. |
| mucHuong |
VNCoreClaim.item.where(category!='8').extension[insuranceCostInfo].extension[benefitLevel].valueDecimal QĐ 1931/QĐ-BYT (29/06/2026) sửa đổi QĐ 3176/QĐ-BYT: kích thước tối đa của MUC_HUONG tại Bảng 3 tăng lên 4 ký tự. |
| tNguonkhacNsnn |
VNCoreClaim.item.where(category!='8').extension[otherFundBreakdown].extension[stateBudget].valueMoney.value Số tiền DVKT/VTYT được ngân sách nhà nước (Trung ương và/hoặc địa phương) hỗ trợ theo QĐ 3176/QĐ-BYT, làm tròn 2 chữ số thập phân. Đích line-level là sub-extension stateBudget của VNCoreExtOtherFundBreakdown trên Claim.item; tổng hợp toàn hồ sơ tại Claim.extension[costSummary].extension[totalOtherFund]. |
| tNguonkhacVtnn |
VNCoreClaim.item.where(category!='8').extension[otherFundBreakdown].extension[foreignAid].valueMoney.value Số tiền DVKT/VTYT được tổ chức/cá nhân có trụ sở hoặc đang sinh sống, học tập, lao động ngoài lãnh thổ Việt Nam hỗ trợ (QĐ 3176/QĐ-BYT). Đích line-level là sub-extension foreignAid của VNCoreExtOtherFundBreakdown trên Claim.item. |
| tNguonkhacVttn |
VNCoreClaim.item.where(category!='8').extension[otherFundBreakdown].extension[domesticAid].valueMoney.value Số tiền DVKT/VTYT được tổ chức/cá nhân có trụ sở hoặc đang sinh sống, học tập, lao động trong lãnh thổ Việt Nam hỗ trợ (QĐ 3176/QĐ-BYT). Đích line-level là sub-extension domesticAid của VNCoreExtOtherFundBreakdown trên Claim.item. |
| tNguonkhacCl |
VNCoreClaim.item.where(category!='8').extension[otherFundBreakdown].extension[otherRemaining].valueMoney.value Số tiền DVKT/VTYT từ các nguồn khác còn lại, không thuộc ba nguồn NSNN/VTNN/VTTN (QĐ 3176/QĐ-BYT). Đích line-level là sub-extension otherRemaining của VNCoreExtOtherFundBreakdown trên Claim.item. |
| tNguonkhac |
VNCoreClaim.item.where(category!='8').extension[otherFundBreakdown] (tổng = stateBudget + foreignAid + domesticAid + otherRemaining) Tổng nguồn khác line-level = T_NGUONKHAC_NSNN + T_NGUONKHAC_VTNN + T_NGUONKHAC_VTTN + T_NGUONKHAC_CL (sửa đổi toàn bộ theo QĐ 3176/QĐ-BYT); khi >0 giảm trừ lần lượt vào T_BNTT, T_BNCCT, T_BHTT đến khi hết. 4 thành phần tách theo dòng qua VNCoreExtOtherFundBreakdown trên Claim.item; tổng toàn hồ sơ ánh xạ VNCoreClaim.extension[costSummary].extension[totalOtherFund].valueMoney.value (xem BHYTXML1SummaryLM). |
| tBntt |
Derived from VNCoreClaimResponse.item[serviceLine].adjudication.where(category='submitted').amount - .where(category='eligible').amount | Derived from VNCoreExplanationOfBenefit.item[serviceLine].adjudication.where(category='submitted').amount - .where(category='eligible').amount |
| tBncct |
VNCoreClaimResponse.item[serviceLine].adjudication.where(category='copay').amount.value | VNCoreExplanationOfBenefit.item[serviceLine].adjudication.where(category='copay').amount.value |
| tBhtt |
VNCoreClaimResponse.item[serviceLine].adjudication.where(category='benefit').amount.value | VNCoreExplanationOfBenefit.item[serviceLine].adjudication.where(category='benefit').amount.value |
| maKhoa |
VNCoreClaim.item.where(category!='8').extension[department].valueCodeableConcept.coding.code |
| maGiuong |
VNCoreEncounter.location.location.resolve().identifier.value Conditionally required for bed-day MA_NHOM values 14, 15, 16. |
| maBacSi |
VNCoreServiceRequest.requester.resolve().identifier.value | VNCoreProcedure.performer.actor.resolve().identifier.value | VNCorePractitioner.identifier.value |
| nguoiThucHien |
VNCoreProcedure.performer.actor.resolve().identifier.value | VNCorePractitioner.identifier.value |
| maBenh |
VNCoreCondition.code | VNCoreClaim.diagnosis.diagnosisCodeableConcept |
| maBenhYhct |
VNCoreClaim.diagnosis.diagnosisCodeableConcept.coding[yhct].code | VNCoreCondition.code.coding[yhct].code |
| ngayYl |
VNCoreServiceRequest.authoredOn | VNCoreProcedure.basedOn.resolve().authoredOn |
| ngayThYl |
VNCoreProcedure.performedDateTime | VNCoreServiceRequest.occurrenceDateTime |
| ngayKq |
VNCoreDiagnosticReport.issued | VNCoreObservationLab.effectiveDateTime Conditionally required except for bed-day MA_NHOM values 14, 15, 16. |
| maPttt |
VNCoreClaim.procedure.procedureCodeableConcept | VNCoreProcedure.code |
| vetThuongTp |
VNCoreClaim.item[serviceLine].extension[recurrentWoundBenefit].valueBoolean | VNCoreExplanationOfBenefit.item[serviceLine].extension[recurrentWoundBenefit].valueBoolean Exporter emits literal `1` only when the line-level recurrentWoundBenefit flag is true; this is not a diagnosis recurrence code. |
| ppVoCam |
VNCoreProcedure.extension[anesthesiaMethod] | VNCoreClaim.item.where(category!='8').extension[anesthesiaMethod] | binding vn-anesthesia-method-vs (VNAnesthesiaMethodCS) Mã phương pháp vô cảm trong PT-TT: 1=gây mê, 2=gây tê, 3=châm tê, 4=vô cảm khác (QĐ 3176/QĐ-BYT); chỉ bắt buộc khi PT-TT có dùng phương pháp vô cảm → 0..1. CodeSystem đích VNAnesthesiaMethodCS (vn-anesthesia-method-cs) đã được tạo — binding tới ValueSet vn-anesthesia-method-vs trên future extension anesthesiaMethod của Procedure; bổ sung host Claim.item.extension khi ràng buộc max-cardinality (MR) !=1 của extension được sửa. |
| viTriThDvkt |
VNCoreProcedure.bodySite | VNCoreServiceRequest.bodySite |
| maMay |
VNCoreDevice.identifier.value |
| maHieuSp |
VNCoreDevice.deviceName.name | VNCoreDevice.modelNumber |
| taiSuDung |
VNCoreDeviceUseStatement.note | future reusable-device extension |
 duPhong |
|
| Documentation for this format | |
