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 bhytXml2MedicationLm mô hình logic.
No Mappings Found
No Mappings Found
| Name | VN Core FHIR mapping |
|---|---|
  bhytXml2MedicationLm |
|
  maLk |
VNCoreClaim.identifier[MALK].value |
| stt |
VNCoreClaim.item[medicationLine].sequence |
| maThuoc |
VNCoreMedication.code.coding.code | VNCoreClaim.item[medicationLine].productOrService.coding.code |
| maPpChebien |
VNCoreClaim.item[medicationLine].extension[processingMethod].valueString | VNCoreExplanationOfBenefit.item[medicationLine].extension[processingMethod].valueString | VNCoreMedication.extension[processingMethod].valueString | VNCoreMedicationRequest.extension[processingMethod].valueString | VNCoreMedicationDispense.extension[processingMethod].valueString |
| maCskcbThuoc |
VNCoreMedicationDispense.performer.actor.resolve().identifier[CSKCB].value | VNCoreMedicationDispense.location.resolve().identifier[CSKCB].value |
| maNhom |
ConceptMap/vn-cm-bhyt-claim-cost-group-to-cost-category -> VNCoreClaim.item[medicationLine].category.coding.code QD 3176 uses MA_NHOM=4 for medication; StructureMap must first apply the ConceptMap, then populate VNCostCategoryCS#8. Do not assign the QD 3176 code directly to VNCostCategoryCS. |
| tenThuoc |
VNCoreMedication.code.text | VNCoreClaim.item[medicationLine].productOrService.text | display |
| donViTinh |
VNCoreClaim.item[medicationLine].quantity.unit |
| hamLuong |
VNCoreMedication.ingredient.strength | Medication.code.text |
| duongDung |
VNCoreMedicationRequest.dosageInstruction.route |
| dangBaoChe |
VNCoreMedication.form.coding.code | VNCoreMedication.form.text |
| lieuDung |
VNCoreMedicationRequest.dosageInstruction.doseAndRate |
| cachDung |
VNCoreMedicationRequest.dosageInstruction.text |
| soDangKy |
VNCoreMedication.extension[registrationNumber].valueString | VNCoreMedicationRequest.extension[registrationNumber].valueString | VNCoreMedicationDispense.extension[registrationNumber].valueString QĐ 1931/QĐ-BYT (29/06/2026) sửa đổi QĐ 3176/QĐ-BYT: thuốc hiếm được UBND cấp tỉnh cấp phép đơn hàng nhập khẩu mã hóa theo quy ước UBND.YYYY.X.S (YYYY = năm cấp giấy phép, X = số văn bản cấp phép nhập khẩu, S = số thứ tự thuốc trong văn bản cấp phép). |
| ttThau |
VNCoreClaim.item[medicationLine].extension[tenderInfo].valueString | VNCoreExplanationOfBenefit.item[medicationLine].extension[tenderInfo].valueString | VNCoreMedication.extension[tenderInfo].valueString | VNCoreMedicationRequest.extension[tenderInfo].valueString | VNCoreMedicationDispense.extension[tenderInfo].valueString |
| phamVi |
VNCoreClaim.item[medicationLine].extension[insuranceCostInfo].extension[scope].valueCodeableConcept |
| tyleTtBh |
VNCoreClaim.item[medicationLine].extension[insuranceCostInfo].extension[paymentRatio].valueDecimal |
| soLuong |
VNCoreClaim.item[medicationLine].quantity.value | VNCoreMedicationDispense.quantity.value |
| donGia |
VNCoreClaim.item[medicationLine].unitPrice.value |
| thanhTienBv |
VNCoreClaim.item[medicationLine].net.value | VNCoreClaim.item[medicationLine].extension[hospitalLineAmount].valueMoney.value |
| thanhTienBh |
VNCoreClaim.item[medicationLine].extension[insuranceCostInfo].extension[insuranceLineAmount].valueMoney.value |
| tNguonkhacNsnn |
VNCoreClaim.item[medicationLine].extension[otherFundBreakdown].extension[stateBudget].valueMoney.value | VNCoreExplanationOfBenefit.item[medicationLine].extension[otherFundBreakdown].extension[stateBudget].valueMoney.value Số tiền được ngân sách nhà nước hỗ trợ, tách theo dòng qua sub-extension stateBudget của VNCoreExtOtherFundBreakdown trên Claim.item/EOB.item. Số tiền gộp toàn nguồn khác vẫn ánh xạ category 'other-fund' theo ConceptMap vn-cm-bhyt-financial-field-to-adjudication (VNBHYTFinancialFieldCS#T_NGUONKHAC_NSNN). Căn cứ QĐ 3176/QĐ-BYT. |
| tNguonkhacVtnn |
VNCoreClaim.item[medicationLine].extension[otherFundBreakdown].extension[foreignAid].valueMoney.value | VNCoreExplanationOfBenefit.item[medicationLine].extension[otherFundBreakdown].extension[foreignAid].valueMoney.value Số tiền viện trợ từ tổ chức/cá nhân ngoài lãnh thổ Việt Nam, tách theo dòng qua sub-extension foreignAid của VNCoreExtOtherFundBreakdown trên Claim.item/EOB.item. Số tiền gộp toàn nguồn khác vẫn ánh xạ category 'other-fund' theo ConceptMap vn-cm-bhyt-financial-field-to-adjudication (VNBHYTFinancialFieldCS#T_NGUONKHAC_VTNN). Căn cứ QĐ 3176/QĐ-BYT. |
| tNguonkhacVttn |
VNCoreClaim.item[medicationLine].extension[otherFundBreakdown].extension[domesticAid].valueMoney.value | VNCoreExplanationOfBenefit.item[medicationLine].extension[otherFundBreakdown].extension[domesticAid].valueMoney.value Số tiền viện trợ từ tổ chức/cá nhân trong lãnh thổ Việt Nam, tách theo dòng qua sub-extension domesticAid của VNCoreExtOtherFundBreakdown trên Claim.item/EOB.item. Số tiền gộp toàn nguồn khác vẫn ánh xạ category 'other-fund' theo ConceptMap vn-cm-bhyt-financial-field-to-adjudication (VNBHYTFinancialFieldCS#T_NGUONKHAC_VTTN). Căn cứ QĐ 3176/QĐ-BYT. |
| tNguonkhacCl |
VNCoreClaim.item[medicationLine].extension[otherFundBreakdown].extension[otherRemaining].valueMoney.value | VNCoreExplanationOfBenefit.item[medicationLine].extension[otherFundBreakdown].extension[otherRemaining].valueMoney.value Số tiền từ các nguồn khác còn lại (ngoài NSNN/VTNN/VTTN), tách theo dòng qua sub-extension otherRemaining của VNCoreExtOtherFundBreakdown trên Claim.item/EOB.item. Số tiền gộp toàn nguồn khác vẫn ánh xạ category 'other-fund' theo ConceptMap vn-cm-bhyt-financial-field-to-adjudication (VNBHYTFinancialFieldCS#T_NGUONKHAC_CL). Căn cứ QĐ 3176/QĐ-BYT. |
| tNguonkhac |
VNCoreClaimResponse.item[medicationLine].adjudication.where(category='other-fund').amount.value | VNCoreExplanationOfBenefit.item[medicationLine].adjudication.where(category='other-fund').amount.value | VNCoreClaim.item[medicationLine].extension[otherFundBreakdown] (tổng = stateBudget + foreignAid + domesticAid + otherRemaining) T_NGUONKHAC = T_NGUONKHAC_NSNN + T_NGUONKHAC_VTNN + T_NGUONKHAC_VTTN + T_NGUONKHAC_CL; 4 thành phần được tách theo dòng qua VNCoreExtOtherFundBreakdown trên Claim.item. Tổng gộp toàn nguồn khác ở line-level ánh xạ category 'other-fund' theo ConceptMap vn-cm-bhyt-financial-field-to-adjudication (VNBHYTAdjudicationCategoryCS#other-fund); R4 không có Claim.item.adjudication nên đích tổng là (Claim)Response/EOB.item.adjudication. Công thức giảm trừ lần lượt T_BNTT → T_BNCCT → T_BHTT do StructureMap của exporter xử lý, không encode invariant ở profile. Căn cứ QĐ 3176/QĐ-BYT. |
| mucHuong |
VNCoreClaim.item[medicationLine].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 2 tăng lên 4 ký tự. |
| tBntt |
Derived from VNCoreClaimResponse.item[medicationLine].adjudication.where(category='submitted').amount - .where(category='eligible').amount | Derived from VNCoreExplanationOfBenefit.item[medicationLine].adjudication.where(category='submitted').amount - .where(category='eligible').amount |
| tBncct |
VNCoreClaimResponse.item[medicationLine].adjudication.where(category='copay').amount.value | VNCoreExplanationOfBenefit.item[medicationLine].adjudication.where(category='copay').amount.value |
| tBhtt |
VNCoreClaimResponse.item[medicationLine].adjudication.where(category='benefit').amount.value | VNCoreExplanationOfBenefit.item[medicationLine].adjudication.where(category='benefit').amount.value |
| maKhoa |
VNCoreClaim.item[medicationLine].extension[department].valueCodeableConcept.coding.code |
| maBacSi |
VNCoreMedicationRequest.requester.resolve().identifier.value | VNCorePractitioner.identifier.value |
| maDichVu |
VNCoreClaim.item[medicationLine].detail.productOrService.coding.code | VNCoreServiceRequest.code |
| ngayYl |
VNCoreMedicationRequest.authoredOn |
| ngayThYl |
VNCoreMedicationDispense.whenHandedOver | VNCoreMedicationDispense.whenPrepared |
| maPttt |
VNCoreClaim.procedure.procedureCodeableConcept | VNCoreProcedure.code Procedure context for medication lines when QD 3176 requires linking the drug to a related surgery/procedure; do not infer this from MA_NHOM. |
| nguonCtra |
VNCoreClaim.item[medicationLine].extension[paymentSource].valueCodeableConcept.coding.code | VNCoreExplanationOfBenefit.item[medicationLine].extension[paymentSource].valueCodeableConcept.coding.code |
| vetThuongTp |
VNCoreClaim.item[medicationLine].extension[recurrentWoundBenefit].valueBoolean | VNCoreExplanationOfBenefit.item[medicationLine].extension[recurrentWoundBenefit].valueBoolean Exporter emits literal `1` only when the line-level recurrentWoundBenefit flag is true; this is not a diagnosis recurrence code. |
 duPhong |
|
| Documentation for this format | |
