<status value="draft"/> <experimental value="false"/> <date value="2026-04-28"/> <publisher value="Omi HealthTech / VN Core FHIR Community Initiative"/> <contact> <name value="Omi HealthTech / VN Core FHIR Community Initiative"/> <telecom> <system value="url"/> <value value="https://hl7.org.vn"/> </telecom> <telecom> <system value="email"/> <value value="info@hl7.org.vn"/> </telecom> </contact> <contact> <name value="Omi HealthTech (OmiGroup)"/> <telecom> <system value="url"/> <value value="https://omihealthtech.vn"/> </telecom> <telecom> <system value="url"/> <value value="https://omigroup.vn"/> </telecom> <telecom> <system value="email"/> <value value="healthtech@omigroup.vn"/> </telecom> </contact> <description value="Generated StructureMap scaffold for Bảng 1 tổng hợp KCB BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML1SummaryLM.fsh` and remain aligned with the Python BHYT round-trip export adapter."/> <jurisdiction> <coding> <system value="urn:iso:std:iso:3166"/> <code value="VN"/> <display value="Viet Nam"/> </coding> </jurisdiction> <purpose value="Publish canonical, reviewable FHIR-to-BHYT XML mapping artifacts for XML1-XML12 without duplicating field-level mapping semantics across FSH, wiki, and export code."/> <structure> <url value="http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle"/> <mode value="source"/> <alias value="BHYTSubmissionBundle"/> <documentation value="FHIR-native source bundle profile used by the repository round-trip adapter."/> </structure> <structure> <url value="http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml1SummaryLm"/> <mode value="target"/> <alias value="BHYTXML1SummaryLM"/> <documentation value="Bảng 1 tổng hợp KCB BHYT — Logical Model"/> </structure> <group> <name value="MapBHYTXML1SummaryLM"/> <typeMode value="none"/> <documentation value="Full QD 3176 XML1 field catalog. StructureMap/export rules must preserve source field names and financial semantics. Generated from logical-model `^mapping` annotations. Fields still missing a field-level `^mapping.map` entry remain outside this StructureMap and are tracked in `wiki/mappings/bhyt-output-data/machine/structuremap-coverage.json`."/> <input> <name value="sourceBundle"/> <type value="BHYTSubmissionBundle"/> <mode value="source"/> <documentation value="VN Core BHYT submission bundle."/> </input> <input> <name value="targetRow"/> <type value="BHYTXML1SummaryLM"/> <mode value="target"/> <documentation value="Bảng 1 tổng hợp KCB BHYT — Logical Model"/> </input> <rule> <name value="maLk"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maLkSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maLk"/> </target> <documentation value="Target field: MA_LK - Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value"/> </rule> <rule> <name value="stt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="sttSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="stt"/> </target> <documentation value="Target field: STT - Số thứ tự FHIR path: Derived export row order"/> </rule> <rule> <name value="maBn"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maBnSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maBn"/> </target> <documentation value="Target field: MA_BN - Mã người bệnh tại cơ sở FHIR path: VNCorePatient.identifier[MRN].value"/> </rule> <rule> <name value="hoTen"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="hoTenSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="hoTen"/> </target> <documentation value="Target field: HO_TEN - Họ tên người bệnh FHIR path: VNCorePatient.name.text"/> </rule> <rule> <name value="ngaySinh"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngaySinhSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngaySinh"/> </target> <documentation value="Target field: NGAY_SINH - Ngày sinh FHIR path: VNCorePatient.birthDate"/> </rule> <rule> <name value="gioiTinh"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="gioiTinhSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="gioiTinh"/> </target> <documentation value="Target field: GIOI_TINH - Giới tính FHIR path: VNCorePatient.gender"/> </rule> <rule> <name value="maQuocTich"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maQuocTichSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maQuocTich"/> </target> <documentation value="Target field: MA_QUOCTICH - Mã quốc tịch FHIR path: VNCorePatient.extension[nationality].valueCodeableConcept.coding.code"/> </rule> <rule> <name value="maDanToc"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maDanTocSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maDanToc"/> </target> <documentation value="Target field: MA_DANTOC - Mã dân tộc FHIR path: VNCorePatient.extension[ethnicity].valueCodeableConcept.coding.code"/> </rule> <rule> <name value="maNgheNghiep"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maNgheNghiepSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maNgheNghiep"/> </target> <documentation value="Target field: MA_NGHE_NGHIEP - Mã nghề nghiệp FHIR path: VNCorePatient.extension[occupation].valueCodeableConcept.coding.code"/> </rule> <rule> <name value="diaChi"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="diaChiSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="diaChi"/> </target> <documentation value="Target field: DIA_CHI - Địa chỉ FHIR path: VNCorePatient.address.text"/> </rule> <rule> <name value="maTinhCuTru"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maTinhCuTruSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maTinhCuTru"/> </target> <documentation value="Target field: MATINH_CU_TRU - Mã tỉnh cư trú FHIR path: VNCorePatient.address.extension[province].valueCodeableConcept.coding.code"/> </rule> <rule> <name value="maHuyenCuTru"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maHuyenCuTruSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maHuyenCuTru"/> </target> <documentation value="Target field: MAHUYEN_CU_TRU - Mã huyện cư trú legacy FHIR path: VNCorePatient.address.district"/> </rule> <rule> <name value="maXaCuTru"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maXaCuTruSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maXaCuTru"/> </target> <documentation value="Target field: MAXA_CU_TRU - Mã xã cư trú FHIR path: VNCorePatient.address.extension[ward].valueCodeableConcept.coding.code"/> </rule> <rule> <name value="dienThoai"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="dienThoaiSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="dienThoai"/> </target> <documentation value="Target field: DIEN_THOAI - Số điện thoại FHIR path: VNCorePatient.telecom.where(system='phone').value"/> </rule> <rule> <name value="maTheBhyt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maTheBhytSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maTheBhyt"/> </target> <documentation value="Target field: MA_THE_BHYT - Mã thẻ BHYT FHIR path: VNCoreCoverage.identifier[BHYT].value | VNCorePatient.identifier[BHYT].value Mapping note: OHP/QD3176 export validator permits up to 2 BHYT card values; map repeated cards to focal/supplemental Coverage entries."/> </rule> <rule> <name value="maDkbd"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maDkbdSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maDkbd"/> </target> <documentation value="Target field: MA_DKBD - Mã nơi đăng ký KCB ban đầu FHIR path: VNCoreCoverage.extension[primaryCareFacility].valueReference.identifier.value Mapping note: OHP/QD3176 export validator permits up to 2 values aligned with multiple BHYT cards; this remains the registered primary care facility, not MA_CSKCB."/> </rule> <rule> <name value="gtTheTu"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="gtTheTuSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="gtTheTu"/> </target> <documentation value="Target field: GT_THE_TU - Giá trị thẻ từ ngày FHIR path: VNCoreCoverage.period.start Mapping note: OHP/QD3176 export validator permits up to 2 values aligned with multiple BHYT cards."/> </rule> <rule> <name value="gtTheDen"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="gtTheDenSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="gtTheDen"/> </target> <documentation value="Target field: GT_THE_DEN - Giá trị thẻ đến ngày FHIR path: VNCoreCoverage.period.end Mapping note: OHP/QD3176 export validator permits up to 2 values aligned with multiple BHYT cards."/> </rule> <rule> <name value="lyDoVv"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="lyDoVvSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="lyDoVv"/> </target> <documentation value="Target field: LY_DO_VV - Lý do vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreEncounter.reasonReference.resolve().code"/> </rule> <rule> <name value="lyDoVnt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="lyDoVntSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="lyDoVnt"/> </target> <documentation value="Target field: LY_DO_VNT - Lý do vào nội trú FHIR path: VNCoreEncounter.hospitalization.admitSource | VNCoreEncounter.reasonCode Mapping note: Conditionally required for selected inpatient/day-treatment MA_LOAI_KCB values."/> </rule> <rule> <name value="maLyDoVnt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maLyDoVntSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maLyDoVnt"/> </target> <documentation value="Target field: MA_LY_DO_VNT - Mã lý do vào nội trú FHIR path: VNCoreEncounter.hospitalization.admitSource.coding.code"/> </rule> <rule> <name value="chanDoanVao"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="chanDoanVaoSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="chanDoanVao"/> </target> <documentation value="Target field: CHAN_DOAN_VAO - Chẩn đoán vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreComposition.section[chiefComplaint].text"/> </rule> <rule> <name value="chanDoanRv"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="chanDoanRvSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="chanDoanRv"/> </target> <documentation value="Target field: CHAN_DOAN_RV - Chẩn đoán ra viện FHIR path: VNCoreCondition.code.text | VNCoreComposition.section[diagnosis].text"/> </rule> <rule> <name value="maBenhChinh"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maBenhChinhSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maBenhChinh"/> </target> <documentation value="Target field: MA_BENH_CHINH - Mã bệnh chính FHIR path: VNCoreClaim.diagnosis.where(type='principal').diagnosisCodeableConcept | VNCoreCondition.code"/> </rule> <rule> <name value="maBenhKt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maBenhKtSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maBenhKt"/> </target> <documentation value="Target field: MA_BENH_KT - Mã bệnh kèm theo FHIR path: VNCoreClaim.diagnosis.where(type!='principal').diagnosisCodeableConcept | VNCoreCondition.code"/> </rule> <rule> <name value="maBenhYhct"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maBenhYhctSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maBenhYhct"/> </target> <documentation value="Target field: MA_BENH_YHCT - Mã bệnh y học cổ truyền FHIR path: VNCoreClaim.diagnosis.diagnosisCodeableConcept.coding[yhct].code | VNCoreCondition.code.coding[yhct].code"/> </rule> <rule> <name value="maPtttQt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maPtttQtSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maPtttQt"/> </target> <documentation value="Target field: MA_PTTT_QT - Mã phương thức thanh toán FHIR path: VNCoreClaim.extension[paymentMethod].valueCodeableConcept.coding.code"/> </rule> <rule> <name value="maDoituongKcb"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maDoituongKcbSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maDoituongKcb"/> </target> <documentation value="Target field: MA_DOITUONG_KCB - Mã đối tượng đến KCB FHIR path: VNCoreClaim.subType Mapping note: Do not map to Coverage.extension[bhytCardType]; this is visit classification, not the insured/card group."/> </rule> <rule> <name value="maNoiDi"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maNoiDiSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maNoiDi"/> </target> <documentation value="Target field: MA_NOI_DI - Mã nơi đi FHIR path: VNCoreEncounter.hospitalization.origin.resolve().identifier[CSKCB].value"/> </rule> <rule> <name value="maNoiDen"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maNoiDenSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maNoiDen"/> </target> <documentation value="Target field: MA_NOI_DEN - Mã nơi đến FHIR path: VNCoreEncounter.hospitalization.destination.resolve().identifier[CSKCB].value"/> </rule> <rule> <name value="maTaiNan"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maTaiNanSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maTaiNan"/> </target> <documentation value="Target field: MA_TAI_NAN - Mã tai nạn FHIR path: VNCoreClaim.accident.type"/> </rule> <rule> <name value="ngayVao"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngayVaoSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngayVao"/> </target> <documentation value="Target field: NGAY_VAO - Ngày vào theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.start | VNCoreClaim.created"/> </rule> <rule> <name value="ngayVaoNoiTru"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngayVaoNoiTruSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngayVaoNoiTru"/> </target> <documentation value="Target field: NGAY_VAO_NOI_TRU - Ngày vào nội trú FHIR path: VNCoreEncounter.hospitalization | future admission instant extension"/> </rule> <rule> <name value="ngayRa"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngayRaSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngayRa"/> </target> <documentation value="Target field: NGAY_RA - Ngày ra theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.end | VNCoreClaim.created"/> </rule> <rule> <name value="soNgayDtri"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="soNgayDtriSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="soNgayDtri"/> </target> <documentation value="Target field: SO_NGAY_DTRI - Số ngày điều trị FHIR path: Derived from VNCoreEncounter.period.start/end | VNCoreEncounter.length.value"/> </rule> <rule> <name value="ketQuaDtri"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ketQuaDtriSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ketQuaDtri"/> </target> <documentation value="Target field: KET_QUA_DTRI - Kết quả điều trị FHIR path: VNCoreEncounter.extension[treatmentOutcome].valueCodeableConcept"/> </rule> <rule> <name value="maLoaiRv"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maLoaiRvSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maLoaiRv"/> </target> <documentation value="Target field: MA_LOAI_RV - Mã loại ra viện FHIR path: VNCoreEncounter.hospitalization.dischargeDisposition"/> </rule> <rule> <name value="ngayTtoan"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngayTtoanSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngayTtoan"/> </target> <documentation value="Target field: NGAY_TTOAN - Ngày thanh toán FHIR path: VNCoreExplanationOfBenefit.created | VNCoreClaimResponse.created"/> </rule> <rule> <name value="tThuoc"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tThuocSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tThuoc"/> </target> <documentation value="Target field: T_THUOC - Tổng tiền thuốc FHIR path: VNCoreClaim.extension[costSummary].extension[totalMedication].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalMedication].valueMoney.value"/> </rule> <rule> <name value="tVtyt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tVtytSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tVtyt"/> </target> <documentation value="Target field: T_VTYT - Tổng tiền vật tư y tế FHIR path: VNCoreClaim.extension[costSummary].extension[totalSupplies].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalSupplies].valueMoney.value"/> </rule> <rule> <name value="tTongchiBv"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tTongchiBvSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tTongchiBv"/> </target> <documentation value="Target field: T_TONGCHI_BV - Tổng chi phí bệnh viện FHIR path: VNCoreClaim.total.value | VNCoreExplanationOfBenefit.total.amount"/> </rule> <rule> <name value="tTongchiBh"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tTongchiBhSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tTongchiBh"/> </target> <documentation value="Target field: T_TONGCHI_BH - Tổng chi phí thuộc phạm vi BHYT FHIR path: VNCoreExplanationOfBenefit.total.where(category='eligible').amount.value | VNCoreClaimResponse.total.where(category='eligible').amount.value"/> </rule> <rule> <name value="tBntt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tBnttSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tBntt"/> </target> <documentation value="Target field: T_BNTT - Người bệnh tự trả FHIR path: VNCoreClaim.extension[costSummary].extension[totalPatientSelfPay].valueMoney.value | Derived from VNCoreClaimResponse.total.where(category='submitted').amount - .where(category='eligible').amount"/> </rule> <rule> <name value="tBncct"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tBncctSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tBncct"/> </target> <documentation value="Target field: T_BNCCT - Người bệnh cùng chi trả FHIR path: VNCoreClaim.extension[costSummary].extension[totalPatientCopay].valueMoney.value | VNCoreClaimResponse.total.where(category='copay').amount.value | VNCoreExplanationOfBenefit.total.where(category='copay').amount.value"/> </rule> <rule> <name value="tBhtt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tBhttSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tBhtt"/> </target> <documentation value="Target field: T_BHTT - Quỹ BHYT thanh toán FHIR path: VNCoreClaim.extension[costSummary].extension[totalInsurance].valueMoney.value | VNCoreClaimResponse.total.where(category='benefit').amount.value | VNCoreExplanationOfBenefit.total.where(category='benefit').amount.value"/> </rule> <rule> <name value="tNguonkhac"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="tNguonkhacSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="tNguonkhac"/> </target> <documentation value="Target field: T_NGUONKHAC - Nguồn khác FHIR path: VNCoreClaim.extension[costSummary].extension[totalOtherFund].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalOtherFund].valueMoney.value"/> </rule> <rule> <name value="namQt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="namQtSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="namQt"/> </target> <documentation value="Target field: NAM_QT - Năm quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[year]"/> </rule> <rule> <name value="thangQt"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="thangQtSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="thangQt"/> </target> <documentation value="Target field: THANG_QT - Tháng quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[month]"/> </rule> <rule> <name value="maLoaiKcb"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maLoaiKcbSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maLoaiKcb"/> </target> <documentation value="Target field: MA_LOAI_KCB - Mã loại khám chữa bệnh FHIR path: VNCoreEncounter.type"/> </rule> <rule> <name value="maKhoa"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maKhoaSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maKhoa"/> </target> <documentation value="Target field: MA_KHOA - Mã khoa FHIR path: VNCoreClaim.item.extension[department].valueCodeableConcept.coding.code | VNCoreEncounter.serviceType"/> </rule> <rule> <name value="maCskcb"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maCskcbSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maCskcb"/> </target> <documentation value="Target field: MA_CSKCB - Mã cơ sở khám chữa bệnh FHIR path: VNCoreEncounter.serviceProvider.resolve().identifier[CSKCB].value | VNCoreClaim.provider.resolve().identifier[CSKCB].value Mapping note: Actual visit/submission provider. Do not fall back to MA_DKBD on Coverage."/> </rule> <rule> <name value="canNang"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="canNangSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="canNang"/> </target> <documentation value="Target field: CAN_NANG - Cân nặng FHIR path: VNCoreObservationBodyWeight.valueQuantity.value"/> </rule> <rule> <name value="ngayTaiKham"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngayTaiKhamSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngayTaiKham"/> </target> <documentation value="Target field: NGAY_TAI_KHAM - Ngày tái khám FHIR path: VNCoreServiceRequest.occurrenceDateTime | Appointment.start"/> </rule> <rule> <name value="maHsba"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maHsbaSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maHsba"/> </target> <documentation value="Target field: MA_HSBA - Mã hồ sơ bệnh án FHIR path: VNCoreComposition.identifier.value | VNCoreDocumentReference.identifier.value"/> </rule> <rule> <name value="maTtdv"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="maTtdvSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="maTtdv"/> </target> <documentation value="Target field: MA_TTDV - Mã thủ trưởng đơn vị/người ký FHIR path: VNCoreComposition.author.resolve().identifier.value | VNCoreDocumentReference.author.resolve().identifier.value | VNCoreProvenance.signature.who.resolve().identifier.value"/> </rule> </group> </StructureMap>

Generated Narrative: StructureMap vn-sm-bhyt-xml1-summary

map "http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml1-summary" = "BHYTXML1SummaryLMStructureMap"

// Generated StructureMap scaffold for Bảng 1 tổng hợp KCB BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML1SummaryLM.fsh` and remain aligned with the Python BHYT round-trip export adapter.

uses "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle" alias BHYTSubmissionBundle as source // FHIR-native source bundle profile used by the repository round-trip adapter.
uses "http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml1SummaryLm" alias BHYTXML1SummaryLM as target // Bảng 1 tổng hợp KCB BHYT — Logical Model

// Full QD 3176 XML1 field catalog. StructureMap/export rules must preserve source field names and financial semantics. Generated from logical-model `^mapping` annotations. Fields still missing a field-level `^mapping.map` entry remain outside this StructureMap and are tracked in `wiki/mappings/bhyt-output-data/machine/structuremap-coverage.json`.
group MapBHYTXML1SummaryLM(source sourceBundle : BHYTSubmissionBundle, target targetRow : BHYTXML1SummaryLM) {
  sourceBundle.entry as maLkSource -> targetRow.maLk "maLk"; // Target field: MA_LK - Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value
  sourceBundle.entry as sttSource -> targetRow.stt "stt"; // Target field: STT - Số thứ tự FHIR path: Derived export row order
  sourceBundle.entry as maBnSource -> targetRow.maBn "maBn"; // Target field: MA_BN - Mã người bệnh tại cơ sở FHIR path: VNCorePatient.identifier[MRN].value
  sourceBundle.entry as hoTenSource -> targetRow.hoTen "hoTen"; // Target field: HO_TEN - Họ tên người bệnh FHIR path: VNCorePatient.name.text
  sourceBundle.entry as ngaySinhSource -> targetRow.ngaySinh "ngaySinh"; // Target field: NGAY_SINH - Ngày sinh FHIR path: VNCorePatient.birthDate
  sourceBundle.entry as gioiTinhSource -> targetRow.gioiTinh "gioiTinh"; // Target field: GIOI_TINH - Giới tính FHIR path: VNCorePatient.gender
  sourceBundle.entry as maQuocTichSource -> targetRow.maQuocTich "maQuocTich"; // Target field: MA_QUOCTICH - Mã quốc tịch FHIR path: VNCorePatient.extension[nationality].valueCodeableConcept.coding.code
  sourceBundle.entry as maDanTocSource -> targetRow.maDanToc "maDanToc"; // Target field: MA_DANTOC - Mã dân tộc FHIR path: VNCorePatient.extension[ethnicity].valueCodeableConcept.coding.code
  sourceBundle.entry as maNgheNghiepSource -> targetRow.maNgheNghiep "maNgheNghiep"; // Target field: MA_NGHE_NGHIEP - Mã nghề nghiệp FHIR path: VNCorePatient.extension[occupation].valueCodeableConcept.coding.code
  sourceBundle.entry as diaChiSource -> targetRow.diaChi "diaChi"; // Target field: DIA_CHI - Địa chỉ FHIR path: VNCorePatient.address.text
  sourceBundle.entry as maTinhCuTruSource -> targetRow.maTinhCuTru "maTinhCuTru"; // Target field: MATINH_CU_TRU - Mã tỉnh cư trú FHIR path: VNCorePatient.address.extension[province].valueCodeableConcept.coding.code
  sourceBundle.entry as maHuyenCuTruSource -> targetRow.maHuyenCuTru "maHuyenCuTru"; // Target field: MAHUYEN_CU_TRU - Mã huyện cư trú legacy FHIR path: VNCorePatient.address.district
  sourceBundle.entry as maXaCuTruSource -> targetRow.maXaCuTru "maXaCuTru"; // Target field: MAXA_CU_TRU - Mã xã cư trú FHIR path: VNCorePatient.address.extension[ward].valueCodeableConcept.coding.code
  sourceBundle.entry as dienThoaiSource -> targetRow.dienThoai "dienThoai"; // Target field: DIEN_THOAI - Số điện thoại FHIR path: VNCorePatient.telecom.where(system='phone').value
  sourceBundle.entry as maTheBhytSource -> targetRow.maTheBhyt "maTheBhyt"; // Target field: MA_THE_BHYT - Mã thẻ BHYT FHIR path: VNCoreCoverage.identifier[BHYT].value | VNCorePatient.identifier[BHYT].value Mapping note: OHP/QD3176 export validator permits up to 2 BHYT card values; map repeated cards to focal/supplemental Coverage entries.
  sourceBundle.entry as maDkbdSource -> targetRow.maDkbd "maDkbd"; // Target field: MA_DKBD - Mã nơi đăng ký KCB ban đầu FHIR path: VNCoreCoverage.extension[primaryCareFacility].valueReference.identifier.value Mapping note: OHP/QD3176 export validator permits up to 2 values aligned with multiple BHYT cards; this remains the registered primary care facility, not MA_CSKCB.
  sourceBundle.entry as gtTheTuSource -> targetRow.gtTheTu "gtTheTu"; // Target field: GT_THE_TU - Giá trị thẻ từ ngày FHIR path: VNCoreCoverage.period.start Mapping note: OHP/QD3176 export validator permits up to 2 values aligned with multiple BHYT cards.
  sourceBundle.entry as gtTheDenSource -> targetRow.gtTheDen "gtTheDen"; // Target field: GT_THE_DEN - Giá trị thẻ đến ngày FHIR path: VNCoreCoverage.period.end Mapping note: OHP/QD3176 export validator permits up to 2 values aligned with multiple BHYT cards.
  sourceBundle.entry as lyDoVvSource -> targetRow.lyDoVv "lyDoVv"; // Target field: LY_DO_VV - Lý do vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreEncounter.reasonReference.resolve().code
  sourceBundle.entry as lyDoVntSource -> targetRow.lyDoVnt "lyDoVnt"; // Target field: LY_DO_VNT - Lý do vào nội trú FHIR path: VNCoreEncounter.hospitalization.admitSource | VNCoreEncounter.reasonCode Mapping note: Conditionally required for selected inpatient/day-treatment MA_LOAI_KCB values.
  sourceBundle.entry as maLyDoVntSource -> targetRow.maLyDoVnt "maLyDoVnt"; // Target field: MA_LY_DO_VNT - Mã lý do vào nội trú FHIR path: VNCoreEncounter.hospitalization.admitSource.coding.code
  sourceBundle.entry as chanDoanVaoSource -> targetRow.chanDoanVao "chanDoanVao"; // Target field: CHAN_DOAN_VAO - Chẩn đoán vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreComposition.section[chiefComplaint].text
  sourceBundle.entry as chanDoanRvSource -> targetRow.chanDoanRv "chanDoanRv"; // Target field: CHAN_DOAN_RV - Chẩn đoán ra viện FHIR path: VNCoreCondition.code.text | VNCoreComposition.section[diagnosis].text
  sourceBundle.entry as maBenhChinhSource -> targetRow.maBenhChinh "maBenhChinh"; // Target field: MA_BENH_CHINH - Mã bệnh chính FHIR path: VNCoreClaim.diagnosis.where(type='principal').diagnosisCodeableConcept | VNCoreCondition.code
  sourceBundle.entry as maBenhKtSource -> targetRow.maBenhKt "maBenhKt"; // Target field: MA_BENH_KT - Mã bệnh kèm theo FHIR path: VNCoreClaim.diagnosis.where(type!='principal').diagnosisCodeableConcept | VNCoreCondition.code
  sourceBundle.entry as maBenhYhctSource -> targetRow.maBenhYhct "maBenhYhct"; // Target field: MA_BENH_YHCT - Mã bệnh y học cổ truyền FHIR path: VNCoreClaim.diagnosis.diagnosisCodeableConcept.coding[yhct].code | VNCoreCondition.code.coding[yhct].code
  sourceBundle.entry as maPtttQtSource -> targetRow.maPtttQt "maPtttQt"; // Target field: MA_PTTT_QT - Mã phương thức thanh toán FHIR path: VNCoreClaim.extension[paymentMethod].valueCodeableConcept.coding.code
  sourceBundle.entry as maDoituongKcbSource -> targetRow.maDoituongKcb "maDoituongKcb"; // Target field: MA_DOITUONG_KCB - Mã đối tượng đến KCB FHIR path: VNCoreClaim.subType Mapping note: Do not map to Coverage.extension[bhytCardType]; this is visit classification, not the insured/card group.
  sourceBundle.entry as maNoiDiSource -> targetRow.maNoiDi "maNoiDi"; // Target field: MA_NOI_DI - Mã nơi đi FHIR path: VNCoreEncounter.hospitalization.origin.resolve().identifier[CSKCB].value
  sourceBundle.entry as maNoiDenSource -> targetRow.maNoiDen "maNoiDen"; // Target field: MA_NOI_DEN - Mã nơi đến FHIR path: VNCoreEncounter.hospitalization.destination.resolve().identifier[CSKCB].value
  sourceBundle.entry as maTaiNanSource -> targetRow.maTaiNan "maTaiNan"; // Target field: MA_TAI_NAN - Mã tai nạn FHIR path: VNCoreClaim.accident.type
  sourceBundle.entry as ngayVaoSource -> targetRow.ngayVao "ngayVao"; // Target field: NGAY_VAO - Ngày vào theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.start | VNCoreClaim.created
  sourceBundle.entry as ngayVaoNoiTruSource -> targetRow.ngayVaoNoiTru "ngayVaoNoiTru"; // Target field: NGAY_VAO_NOI_TRU - Ngày vào nội trú FHIR path: VNCoreEncounter.hospitalization | future admission instant extension
  sourceBundle.entry as ngayRaSource -> targetRow.ngayRa "ngayRa"; // Target field: NGAY_RA - Ngày ra theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.end | VNCoreClaim.created
  sourceBundle.entry as soNgayDtriSource -> targetRow.soNgayDtri "soNgayDtri"; // Target field: SO_NGAY_DTRI - Số ngày điều trị FHIR path: Derived from VNCoreEncounter.period.start/end | VNCoreEncounter.length.value
  sourceBundle.entry as ketQuaDtriSource -> targetRow.ketQuaDtri "ketQuaDtri"; // Target field: KET_QUA_DTRI - Kết quả điều trị FHIR path: VNCoreEncounter.extension[treatmentOutcome].valueCodeableConcept
  sourceBundle.entry as maLoaiRvSource -> targetRow.maLoaiRv "maLoaiRv"; // Target field: MA_LOAI_RV - Mã loại ra viện FHIR path: VNCoreEncounter.hospitalization.dischargeDisposition
  sourceBundle.entry as ngayTtoanSource -> targetRow.ngayTtoan "ngayTtoan"; // Target field: NGAY_TTOAN - Ngày thanh toán FHIR path: VNCoreExplanationOfBenefit.created | VNCoreClaimResponse.created
  sourceBundle.entry as tThuocSource -> targetRow.tThuoc "tThuoc"; // Target field: T_THUOC - Tổng tiền thuốc FHIR path: VNCoreClaim.extension[costSummary].extension[totalMedication].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalMedication].valueMoney.value
  sourceBundle.entry as tVtytSource -> targetRow.tVtyt "tVtyt"; // Target field: T_VTYT - Tổng tiền vật tư y tế FHIR path: VNCoreClaim.extension[costSummary].extension[totalSupplies].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalSupplies].valueMoney.value
  sourceBundle.entry as tTongchiBvSource -> targetRow.tTongchiBv "tTongchiBv"; // Target field: T_TONGCHI_BV - Tổng chi phí bệnh viện FHIR path: VNCoreClaim.total.value | VNCoreExplanationOfBenefit.total.amount
  sourceBundle.entry as tTongchiBhSource -> targetRow.tTongchiBh "tTongchiBh"; // Target field: T_TONGCHI_BH - Tổng chi phí thuộc phạm vi BHYT FHIR path: VNCoreExplanationOfBenefit.total.where(category='eligible').amount.value | VNCoreClaimResponse.total.where(category='eligible').amount.value
  sourceBundle.entry as tBnttSource -> targetRow.tBntt "tBntt"; // Target field: T_BNTT - Người bệnh tự trả FHIR path: VNCoreClaim.extension[costSummary].extension[totalPatientSelfPay].valueMoney.value | Derived from VNCoreClaimResponse.total.where(category='submitted').amount - .where(category='eligible').amount
  sourceBundle.entry as tBncctSource -> targetRow.tBncct "tBncct"; // Target field: T_BNCCT - Người bệnh cùng chi trả FHIR path: VNCoreClaim.extension[costSummary].extension[totalPatientCopay].valueMoney.value | VNCoreClaimResponse.total.where(category='copay').amount.value | VNCoreExplanationOfBenefit.total.where(category='copay').amount.value
  sourceBundle.entry as tBhttSource -> targetRow.tBhtt "tBhtt"; // Target field: T_BHTT - Quỹ BHYT thanh toán FHIR path: VNCoreClaim.extension[costSummary].extension[totalInsurance].valueMoney.value | VNCoreClaimResponse.total.where(category='benefit').amount.value | VNCoreExplanationOfBenefit.total.where(category='benefit').amount.value
  sourceBundle.entry as tNguonkhacSource -> targetRow.tNguonkhac "tNguonkhac"; // Target field: T_NGUONKHAC - Nguồn khác FHIR path: VNCoreClaim.extension[costSummary].extension[totalOtherFund].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalOtherFund].valueMoney.value
  sourceBundle.entry as namQtSource -> targetRow.namQt "namQt"; // Target field: NAM_QT - Năm quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[year]
  sourceBundle.entry as thangQtSource -> targetRow.thangQt "thangQt"; // Target field: THANG_QT - Tháng quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[month]
  sourceBundle.entry as maLoaiKcbSource -> targetRow.maLoaiKcb "maLoaiKcb"; // Target field: MA_LOAI_KCB - Mã loại khám chữa bệnh FHIR path: VNCoreEncounter.type
  sourceBundle.entry as maKhoaSource -> targetRow.maKhoa "maKhoa"; // Target field: MA_KHOA - Mã khoa FHIR path: VNCoreClaim.item.extension[department].valueCodeableConcept.coding.code | VNCoreEncounter.serviceType
  sourceBundle.entry as maCskcbSource -> targetRow.maCskcb "maCskcb"; // Target field: MA_CSKCB - Mã cơ sở khám chữa bệnh FHIR path: VNCoreEncounter.serviceProvider.resolve().identifier[CSKCB].value | VNCoreClaim.provider.resolve().identifier[CSKCB].value Mapping note: Actual visit/submission provider. Do not fall back to MA_DKBD on Coverage.
  sourceBundle.entry as canNangSource -> targetRow.canNang "canNang"; // Target field: CAN_NANG - Cân nặng FHIR path: VNCoreObservationBodyWeight.valueQuantity.value
  sourceBundle.entry as ngayTaiKhamSource -> targetRow.ngayTaiKham "ngayTaiKham"; // Target field: NGAY_TAI_KHAM - Ngày tái khám FHIR path: VNCoreServiceRequest.occurrenceDateTime | Appointment.start
  sourceBundle.entry as maHsbaSource -> targetRow.maHsba "maHsba"; // Target field: MA_HSBA - Mã hồ sơ bệnh án FHIR path: VNCoreComposition.identifier.value | VNCoreDocumentReference.identifier.value
  sourceBundle.entry as maTtdvSource -> targetRow.maTtdv "maTtdv"; // Target field: MA_TTDV - Mã thủ trưởng đơn vị/người ký FHIR path: VNCoreComposition.author.resolve().identifier.value | VNCoreDocumentReference.author.resolve().identifier.value | VNCoreProvenance.signature.who.resolve().identifier.value
}