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-04-28 |
{
"resourceType" : "StructureMap",
"id" : "vn-sm-bhyt-xml1-summary",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<div xmlns=\"http://www.w3.org/1999/xhtml\"><p class=\"res-header-id\"><b>Generated Narrative: StructureMap vn-sm-bhyt-xml1-summary</b></p><a name=\"vn-sm-bhyt-xml1-summary\"> </a><a name=\"hcvn-sm-bhyt-xml1-summary\"> </a><pre class=\"fml\">\r\n<b>map</b><span style=\"color: navy\"> "</span>http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml1-summary<span style=\"color: navy\">" = "</span>BHYTXML1SummaryLMStructureMap<span style=\"color: navy\">"\r\n\r\n</span><span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">FHIR-native source bundle profile used by the repository round-trip adapter.</span>\r\n<b>uses</b><span style=\"color: navy\"> "</span><a href=\"StructureDefinition-vn-core-bhyt-submission-bundle.html\" title=\"Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle\">http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle</a><span style=\"color: navy\">" </span><b>alias </b>BHYTSubmissionBundle <b>as </b><b>source</b>\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Bảng 1 tổng hợp KCB BHYT — Logical Model</span>\r\n<b>uses</b><span style=\"color: navy\"> "</span><a href=\"StructureDefinition-bhytXml1SummaryLm.html\" title=\"Bảng 1 tổng hợp KCB BHYT — Logical Model\">http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml1SummaryLm</a><span style=\"color: navy\">" </span><b>alias </b>BHYTXML1SummaryLM <b>as </b><b>target</b>\r\n\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">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`.</span>\r\n<b>group </b>MapBHYTXML1SummaryLM<span style=\"color: navy\">(</span><b>source</b> <span style=\"color: maroon\">sourceBundle</span><span style=\"color: navy\"> : </span>BHYTSubmissionBundle, <b>target</b> <span style=\"color: maroon\">targetRow</span><span style=\"color: navy\"> : </span>BHYTXML1SummaryLM<span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span> <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_LK - Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maLkSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maLk <i>"maLk"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: STT - Số thứ tự FHIR path: Derived export row order</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">sttSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.stt <i>"stt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_BN - Mã người bệnh tại cơ sở FHIR path: VNCorePatient.identifier[MRN].value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maBnSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maBn <i>"maBn"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: HO_TEN - Họ tên người bệnh FHIR path: VNCorePatient.name.text</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">hoTenSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.hoTen <i>"hoTen"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: SO_CCCD - Số CCCD/số định danh cá nhân/hộ chiếu/giấy khai sinh của người bệnh FHIR path: VNCorePatient.identifier[CCCD].value | VNCorePatient.identifier[HC].value | VNCorePatient.identifier[GKS].value Mapping note: Ghi số CCCD/số định danh cá nhân trên thẻ căn cước hoặc giấy khai sinh; người nước ngoài ghi số hộ chiếu (identifier[HC]); trẻ sơ sinh dùng số trên giấy khai sinh (identifier[GKS]); để trống trong trường hợp bất khả kháng (trẻ sơ sinh, người mất ý thức/tâm thần không lấy được số định danh). Đổi kiểu chuỗi và kích thước n theo QĐ 4750/QĐ-BYT.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">soCccdSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.soCccd <i>"soCccd"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_SINH - Ngày sinh FHIR path: VNCorePatient.birthDate</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngaySinhSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngaySinh <i>"ngaySinh"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: GIOI_TINH - Giới tính FHIR path: VNCorePatient.gender</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">gioiTinhSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.gioiTinh <i>"gioiTinh"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NHOM_MAU - Nhóm máu FHIR path: future blood-group Observation (LOINC 883-9 ABO group; 10331-7 Rh) Mapping note: Nhóm máu của người bệnh, tối đa 5 ký tự, chỉ ghi khi có thông tin (bổ sung theo QĐ 4750/QĐ-BYT). VN Core chưa có profile Observation nhóm máu chuyên biệt nên đánh dấu future.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">nhomMauSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.nhomMau <i>"nhomMau"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_QUOCTICH - Mã quốc tịch FHIR path: VNCorePatient.extension[nationality].valueCodeableConcept.coding.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maQuocTichSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maQuocTich <i>"maQuocTich"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_DANTOC - Mã dân tộc FHIR path: VNCorePatient.extension[ethnicity].valueCodeableConcept.coding.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maDanTocSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maDanToc <i>"maDanToc"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_NGHE_NGHIEP - Mã nghề nghiệp FHIR path: VNCorePatient.extension[occupation].valueCodeableConcept.coding.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maNgheNghiepSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maNgheNghiep <i>"maNgheNghiep"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: DIA_CHI - Địa chỉ FHIR path: VNCorePatient.address.text</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">diaChiSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.diaChi <i>"diaChi"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MATINH_CU_TRU - Mã tỉnh cư trú FHIR path: VNCorePatient.address.extension[province].valueCodeableConcept.coding.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maTinhCuTruSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maTinhCuTru <i>"maTinhCuTru"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MAHUYEN_CU_TRU - Mã huyện cư trú legacy FHIR path: VNCorePatient.address.district</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maHuyenCuTruSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maHuyenCuTru <i>"maHuyenCuTru"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MAXA_CU_TRU - Mã xã cư trú FHIR path: VNCorePatient.address.extension[ward].valueCodeableConcept.coding.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maXaCuTruSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maXaCuTru <i>"maXaCuTru"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: DIEN_THOAI - Số điện thoại FHIR path: VNCorePatient.telecom.where(system='phone').value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">dienThoaiSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.dienThoai <i>"dienThoai"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maTheBhytSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maTheBhyt <i>"maTheBhyt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maDkbdSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maDkbd <i>"maDkbd"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">gtTheTuSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.gtTheTu <i>"gtTheTu"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">gtTheDenSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.gtTheDen <i>"gtTheDen"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_MIEN_CCT - Ngày miễn cùng chi trả FHIR path: VNCoreCoverage | future copay-exemption-start-date extension Mapping note: Thời điểm người bệnh đủ điều kiện hưởng chế độ miễn cùng chi trả: 8 ký tự yyyymmdd nếu đã cấp giấy miễn cùng chi trả, 12 ký tự yyyymmddHHMM nếu chưa cấp giấy; để trống nếu không đủ cơ sở xác định. Liên quan trần cùng chi trả lũy kế theo NĐ 188/2025/NĐ-CP; VN Core chưa có extension ngày miễn cùng chi trả trên Coverage.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngayMienCctSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngayMienCct <i>"ngayMienCct"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: LY_DO_VV - Lý do vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreEncounter.reasonReference.resolve().code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">lyDoVvSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.lyDoVv <i>"lyDoVv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">lyDoVntSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.lyDoVnt <i>"lyDoVnt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_LY_DO_VNT - Mã lý do vào nội trú FHIR path: VNCoreEncounter.hospitalization.admitSource.coding.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maLyDoVntSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maLyDoVnt <i>"maLyDoVnt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: CHAN_DOAN_VAO - Chẩn đoán vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreComposition.section[chiefComplaint].text</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">chanDoanVaoSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.chanDoanVao <i>"chanDoanVao"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: CHAN_DOAN_RV - Chẩn đoán ra viện FHIR path: VNCoreCondition.code.text | VNCoreComposition.section[diagnosis].text</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">chanDoanRvSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.chanDoanRv <i>"chanDoanRv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_BENH_CHINH - Mã bệnh chính FHIR path: VNCoreClaim.diagnosis.where(type='principal').diagnosisCodeableConcept | VNCoreCondition.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maBenhChinhSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maBenhChinh <i>"maBenhChinh"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_BENH_KT - Mã bệnh kèm theo FHIR path: VNCoreClaim.diagnosis.where(type!='principal').diagnosisCodeableConcept | VNCoreCondition.code</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maBenhKtSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maBenhKt <i>"maBenhKt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maBenhYhctSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maBenhYhct <i>"maBenhYhct"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_PTTT_QT - Mã phẫu thuật, thủ thuật quốc tế ICD-9-CM FHIR path: VNCoreProcedure.code.coding.code Mapping note: Mã ICD-9-CM (VNICD9CMCS; QĐ 4440/QĐ-BYT, nay thay bằng QĐ 387/QĐ-BYT). Nhiều PT/TT thì các mã phân cách bằng ';'; chỉ ghi khi người bệnh có thực hiện phẫu thuật, thủ thuật. KHÔNG nhầm với MA_PTTT (mã phương thức thanh toán, Bảng 2/3 STT 36/40).</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maPtttQtSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maPtttQt <i>"maPtttQt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maDoituongKcbSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maDoituongKcb <i>"maDoituongKcb"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_NOI_DI - Mã nơi đi FHIR path: VNCoreEncounter.hospitalization.origin.resolve().identifier[CSKCB].value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maNoiDiSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maNoiDi <i>"maNoiDi"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_NOI_DEN - Mã nơi đến FHIR path: VNCoreEncounter.hospitalization.destination.resolve().identifier[CSKCB].value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maNoiDenSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maNoiDen <i>"maNoiDen"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_TAI_NAN - Mã tai nạn FHIR path: VNCoreClaim.accident.type</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maTaiNanSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maTaiNan <i>"maTaiNan"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_VAO - Ngày vào theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.start | VNCoreClaim.created</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngayVaoSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngayVao <i>"ngayVao"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_VAO_NOI_TRU - Ngày vào nội trú FHIR path: VNCoreEncounter.hospitalization | future admission instant extension</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngayVaoNoiTruSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngayVaoNoiTru <i>"ngayVaoNoiTru"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_RA - Ngày ra theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.end | VNCoreClaim.created</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngayRaSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngayRa <i>"ngayRa"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: GIAY_CHUYEN_TUYEN - Số giấy chuyển tuyến FHIR path: VNCoreServiceRequest.identifier.value | VNCoreDocumentReference.identifier.value Mapping note: Số giấy chuyển tuyến/chuyển cơ sở KBCB nơi chuyển người bệnh đi hoặc số giấy hẹn khám lại (nếu có). Ghi theo trường GIAY_CHUYEN_TUYEN Bảng 13 (BHYTXML13ReferralLM) — liên kết phiếu chuyển tuyến ServiceRequest.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">giayChuyenTuyenSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.giayChuyenTuyen <i>"giayChuyenTuyen"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: SO_NGAY_DTRI - Số ngày điều trị FHIR path: Derived from VNCoreEncounter.period.start/end | VNCoreEncounter.length.value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">soNgayDtriSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.soNgayDtri <i>"soNgayDtri"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: PP_DIEU_TRI - Phương pháp điều trị (nội khoa, ngoại khoa, xạ trị, hoá trị hoặc kết hợp) FHIR path: VNCoreProcedure.category | future treatment-method (PP_DIEU_TRI) extension Mapping note: Ghi phương pháp điều trị theo TT 18/2022/TT-BYT (nội khoa, ngoại khoa, xạ trị, hoá trị hoặc xạ trị + nội khoa). VN Core chưa có slice/extension chuyên biệt ở cấp đợt điều trị nên đánh dấu future.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ppDieuTriSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ppDieuTri <i>"ppDieuTri"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: KET_QUA_DTRI - Kết quả điều trị FHIR path: VNCoreEncounter.extension[treatmentOutcome].valueCodeableConcept</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ketQuaDtriSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ketQuaDtri <i>"ketQuaDtri"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_LOAI_RV - Mã loại ra viện FHIR path: VNCoreEncounter.hospitalization.dischargeDisposition</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maLoaiRvSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maLoaiRv <i>"maLoaiRv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: GHI_CHU - Lời dặn của bác sĩ/nhân viên y tế sau khi kết thúc KBCB FHIR path: VNCoreComposition.section[dischargeSummary].text Mapping note: Lời dặn của bác sĩ hoặc nhân viên y tế đối với người bệnh sau khi kết thúc lần KBCB; ghi vào phần tóm tắt ra viện/hướng điều trị tiếp của bệnh án điện tử (TT 13/2025/TT-BYT).</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ghiChuSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ghiChu <i>"ghiChu"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_TTOAN - Ngày thanh toán FHIR path: VNCoreExplanationOfBenefit.created | VNCoreClaimResponse.created</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngayTtoanSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngayTtoan <i>"ngayTtoan"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tThuocSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tThuoc <i>"tThuoc"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tVtytSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tVtyt <i>"tVtyt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: T_TONGCHI_BV - Tổng chi phí bệnh viện FHIR path: VNCoreClaim.total.value | VNCoreExplanationOfBenefit.total.amount</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tTongchiBvSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tTongchiBv <i>"tTongchiBv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tTongchiBhSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tTongchiBh <i>"tTongchiBh"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tBnttSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tBntt <i>"tBntt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tBncctSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tBncct <i>"tBncct"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tBhttSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tBhtt <i>"tBhtt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: T_NGUONKHAC - Nguồn khác FHIR path: VNCoreClaim.extension[costSummary].extension[totalOtherFund].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalOtherFund].valueMoney.value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tNguonkhacSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tNguonkhac <i>"tNguonkhac"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: T_BHTT_GDV - BHYT thanh toán giám định viên FHIR path: VNCoreClaim.extension[costSummary] | future totalInsuranceFeeForService sub-extension Mapping note: Số tiền quỹ BHYT thanh toán đối với các khoản chi ngoài định suất hoặc ngoài DRG (là T_BHTT tại Bảng 2, Bảng 3 đối với chi phí có MA_PTTT = '1' — Phí dịch vụ). VNCoreExtClaimCostSummary chưa có sub-extension chuyên biệt cho khoản này nên đánh dấu future.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">tBhttGdvSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.tBhttGdv <i>"tBhttGdv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NAM_QT - Năm quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[year]</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">namQtSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.namQt <i>"namQt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: THANG_QT - Tháng quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[month]</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">thangQtSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.thangQt <i>"thangQt"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_LOAI_KCB - Mã loại khám chữa bệnh FHIR path: VNCoreEncounter.type</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maLoaiKcbSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maLoaiKcb <i>"maLoaiKcb"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_KHOA - Mã khoa FHIR path: VNCoreClaim.item.extension[department].valueCodeableConcept.coding.code | VNCoreEncounter.serviceType</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maKhoaSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maKhoa <i>"maKhoa"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maCskcbSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maCskcb <i>"maCskcb"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_KHUVUC - Mã khu vực FHIR path: VNCoreCoverage | future BHYT living-area (K1/K2/K3) extension Mapping note: Mã nơi sinh sống của người bệnh ghi trên thẻ BHYT (danh mục mã cố định K1/K2/K3). VN Core chưa có extension mã khu vực sinh sống trên Coverage.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maKhuvucSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maKhuvuc <i>"maKhuvuc"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: CAN_NANG - Cân nặng FHIR path: VNCoreObservationBodyWeight.valueQuantity.value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">canNangSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.canNang <i>"canNang"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: CAN_NANG_CON - Cân nặng con FHIR path: VNCoreObservationBodyWeight.valueQuantity.value | future newborn-birth-weight extension Mapping note: Cân nặng con mới sinh, đơn vị gram; subject là trẻ mới sinh (RelatedPerson/Patient liên kết), không phải người bệnh mẹ. Chỉ ghi khi sinh con; sinh từ 2 con trở lên ghi lần lượt, phân cách bằng dấu chấm phẩy ';'.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">canNangConSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.canNangCon <i>"canNangCon"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NAM_NAM_LIEN_TUC - Thời điểm đủ 5 năm liên tục FHIR path: VNCoreCoverage | future five-year-continuous-participation date extension Mapping note: Thời điểm người bệnh tham gia BHYT đủ 05 năm liên tục, 8 ký tự yyyymmdd (mốc hưởng quyền lợi 5 năm liên tục). VN Core chưa có extension mốc 5 năm liên tục trên Coverage.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">namNamLienTucSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.namNamLienTuc <i>"namNamLienTuc"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGAY_TAI_KHAM - Ngày tái khám FHIR path: VNCoreServiceRequest.occurrenceDateTime | Appointment.start</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">ngayTaiKhamSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.ngayTaiKham <i>"ngayTaiKham"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: MA_HSBA - Mã hồ sơ bệnh án FHIR path: VNCoreComposition.identifier.value | VNCoreDocumentReference.identifier.value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maHsbaSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maHsba <i>"maHsba"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">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</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">maTtdvSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.maTtdv <i>"maTtdv"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: DU_PHONG - Trường dự phòng (tái sử dụng: ghi chiều cao người bệnh, đơn vị cm) FHIR path: VNCoreObservationBodyHeight.valueQuantity.value Mapping note: Theo bản sửa đổi, bổ sung QĐ 4750/QĐ-BYT: trường dự phòng Bảng 1 dùng để ghi chiều cao người bệnh (đơn vị cm), bắt buộc trong trường hợp sử dụng chỉ số này để chẩn đoán, điều trị. Riêng Bảng 1 khác các bảng khác (DU_PHONG thường dùng cho dữ liệu chữ ký số theo QĐ 3176/QĐ-BYT).</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">duPhongSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.duPhong <i>"duPhong"</i><span style=\"color: navy\">;</span>\r\n<span style=\"color: navy\">}\r\n\r\n</span></pre></div>"
},
"url" : "http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml1-summary",
"identifier" : [
{
"system" : "urn:ietf:rfc:3986",
"value" : "urn:oid:2.25.161089673617632664299011809196868855799.43.1"
}
],
"version" : "0.8.0",
"name" : "BHYTXML1SummaryLMStructureMap",
"title" : "Bảng 1 tổng hợp KCB BHYT — Logical Model — StructureMap",
"status" : "draft",
"experimental" : false,
"date" : "2026-04-28",
"publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
"contact" : [
{
"name" : "Omi HealthTech / VN Core FHIR Community Initiative",
"telecom" : [
{
"system" : "url",
"value" : "https://hl7.org.vn"
},
{
"system" : "email",
"value" : "info@hl7.org.vn"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "info@hl7.org.vn"
}
]
}
],
"description" : "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" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"purpose" : "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" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
"mode" : "source",
"alias" : "BHYTSubmissionBundle",
"documentation" : "FHIR-native source bundle profile used by the repository round-trip adapter."
},
{
"url" : "http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml1SummaryLm",
"mode" : "target",
"alias" : "BHYTXML1SummaryLM",
"documentation" : "Bảng 1 tổng hợp KCB BHYT — Logical Model"
}
],
"group" : [
{
"name" : "MapBHYTXML1SummaryLM",
"typeMode" : "none",
"documentation" : "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" : "sourceBundle",
"type" : "BHYTSubmissionBundle",
"mode" : "source",
"documentation" : "VN Core BHYT submission bundle."
},
{
"name" : "targetRow",
"type" : "BHYTXML1SummaryLM",
"mode" : "target",
"documentation" : "Bảng 1 tổng hợp KCB BHYT — Logical Model"
}
],
"rule" : [
{
"name" : "maLk",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maLkSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maLk"
}
],
"documentation" : "Target field: MA_LK - Mã liên kết hồ sơ FHIR path: VNCoreClaim.identifier[MALK].value"
},
{
"name" : "stt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "sttSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "stt"
}
],
"documentation" : "Target field: STT - Số thứ tự FHIR path: Derived export row order"
},
{
"name" : "maBn",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maBnSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maBn"
}
],
"documentation" : "Target field: MA_BN - Mã người bệnh tại cơ sở FHIR path: VNCorePatient.identifier[MRN].value"
},
{
"name" : "hoTen",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "hoTenSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "hoTen"
}
],
"documentation" : "Target field: HO_TEN - Họ tên người bệnh FHIR path: VNCorePatient.name.text"
},
{
"name" : "soCccd",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "soCccdSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "soCccd"
}
],
"documentation" : "Target field: SO_CCCD - Số CCCD/số định danh cá nhân/hộ chiếu/giấy khai sinh của người bệnh FHIR path: VNCorePatient.identifier[CCCD].value | VNCorePatient.identifier[HC].value | VNCorePatient.identifier[GKS].value Mapping note: Ghi số CCCD/số định danh cá nhân trên thẻ căn cước hoặc giấy khai sinh; người nước ngoài ghi số hộ chiếu (identifier[HC]); trẻ sơ sinh dùng số trên giấy khai sinh (identifier[GKS]); để trống trong trường hợp bất khả kháng (trẻ sơ sinh, người mất ý thức/tâm thần không lấy được số định danh). Đổi kiểu chuỗi và kích thước n theo QĐ 4750/QĐ-BYT."
},
{
"name" : "ngaySinh",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngaySinhSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngaySinh"
}
],
"documentation" : "Target field: NGAY_SINH - Ngày sinh FHIR path: VNCorePatient.birthDate"
},
{
"name" : "gioiTinh",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "gioiTinhSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "gioiTinh"
}
],
"documentation" : "Target field: GIOI_TINH - Giới tính FHIR path: VNCorePatient.gender"
},
{
"name" : "nhomMau",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "nhomMauSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "nhomMau"
}
],
"documentation" : "Target field: NHOM_MAU - Nhóm máu FHIR path: future blood-group Observation (LOINC 883-9 ABO group; 10331-7 Rh) Mapping note: Nhóm máu của người bệnh, tối đa 5 ký tự, chỉ ghi khi có thông tin (bổ sung theo QĐ 4750/QĐ-BYT). VN Core chưa có profile Observation nhóm máu chuyên biệt nên đánh dấu future."
},
{
"name" : "maQuocTich",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maQuocTichSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maQuocTich"
}
],
"documentation" : "Target field: MA_QUOCTICH - Mã quốc tịch FHIR path: VNCorePatient.extension[nationality].valueCodeableConcept.coding.code"
},
{
"name" : "maDanToc",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maDanTocSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maDanToc"
}
],
"documentation" : "Target field: MA_DANTOC - Mã dân tộc FHIR path: VNCorePatient.extension[ethnicity].valueCodeableConcept.coding.code"
},
{
"name" : "maNgheNghiep",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maNgheNghiepSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maNgheNghiep"
}
],
"documentation" : "Target field: MA_NGHE_NGHIEP - Mã nghề nghiệp FHIR path: VNCorePatient.extension[occupation].valueCodeableConcept.coding.code"
},
{
"name" : "diaChi",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "diaChiSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "diaChi"
}
],
"documentation" : "Target field: DIA_CHI - Địa chỉ FHIR path: VNCorePatient.address.text"
},
{
"name" : "maTinhCuTru",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maTinhCuTruSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maTinhCuTru"
}
],
"documentation" : "Target field: MATINH_CU_TRU - Mã tỉnh cư trú FHIR path: VNCorePatient.address.extension[province].valueCodeableConcept.coding.code"
},
{
"name" : "maHuyenCuTru",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maHuyenCuTruSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maHuyenCuTru"
}
],
"documentation" : "Target field: MAHUYEN_CU_TRU - Mã huyện cư trú legacy FHIR path: VNCorePatient.address.district"
},
{
"name" : "maXaCuTru",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maXaCuTruSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maXaCuTru"
}
],
"documentation" : "Target field: MAXA_CU_TRU - Mã xã cư trú FHIR path: VNCorePatient.address.extension[ward].valueCodeableConcept.coding.code"
},
{
"name" : "dienThoai",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "dienThoaiSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "dienThoai"
}
],
"documentation" : "Target field: DIEN_THOAI - Số điện thoại FHIR path: VNCorePatient.telecom.where(system='phone').value"
},
{
"name" : "maTheBhyt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maTheBhytSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maTheBhyt"
}
],
"documentation" : "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."
},
{
"name" : "maDkbd",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maDkbdSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maDkbd"
}
],
"documentation" : "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."
},
{
"name" : "gtTheTu",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "gtTheTuSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "gtTheTu"
}
],
"documentation" : "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."
},
{
"name" : "gtTheDen",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "gtTheDenSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "gtTheDen"
}
],
"documentation" : "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."
},
{
"name" : "ngayMienCct",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngayMienCctSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngayMienCct"
}
],
"documentation" : "Target field: NGAY_MIEN_CCT - Ngày miễn cùng chi trả FHIR path: VNCoreCoverage | future copay-exemption-start-date extension Mapping note: Thời điểm người bệnh đủ điều kiện hưởng chế độ miễn cùng chi trả: 8 ký tự yyyymmdd nếu đã cấp giấy miễn cùng chi trả, 12 ký tự yyyymmddHHMM nếu chưa cấp giấy; để trống nếu không đủ cơ sở xác định. Liên quan trần cùng chi trả lũy kế theo NĐ 188/2025/NĐ-CP; VN Core chưa có extension ngày miễn cùng chi trả trên Coverage."
},
{
"name" : "lyDoVv",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "lyDoVvSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "lyDoVv"
}
],
"documentation" : "Target field: LY_DO_VV - Lý do vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreEncounter.reasonReference.resolve().code"
},
{
"name" : "lyDoVnt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "lyDoVntSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "lyDoVnt"
}
],
"documentation" : "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."
},
{
"name" : "maLyDoVnt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maLyDoVntSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maLyDoVnt"
}
],
"documentation" : "Target field: MA_LY_DO_VNT - Mã lý do vào nội trú FHIR path: VNCoreEncounter.hospitalization.admitSource.coding.code"
},
{
"name" : "chanDoanVao",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "chanDoanVaoSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "chanDoanVao"
}
],
"documentation" : "Target field: CHAN_DOAN_VAO - Chẩn đoán vào viện FHIR path: VNCoreEncounter.reasonCode | VNCoreComposition.section[chiefComplaint].text"
},
{
"name" : "chanDoanRv",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "chanDoanRvSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "chanDoanRv"
}
],
"documentation" : "Target field: CHAN_DOAN_RV - Chẩn đoán ra viện FHIR path: VNCoreCondition.code.text | VNCoreComposition.section[diagnosis].text"
},
{
"name" : "maBenhChinh",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maBenhChinhSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maBenhChinh"
}
],
"documentation" : "Target field: MA_BENH_CHINH - Mã bệnh chính FHIR path: VNCoreClaim.diagnosis.where(type='principal').diagnosisCodeableConcept | VNCoreCondition.code"
},
{
"name" : "maBenhKt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maBenhKtSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maBenhKt"
}
],
"documentation" : "Target field: MA_BENH_KT - Mã bệnh kèm theo FHIR path: VNCoreClaim.diagnosis.where(type!='principal').diagnosisCodeableConcept | VNCoreCondition.code"
},
{
"name" : "maBenhYhct",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maBenhYhctSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maBenhYhct"
}
],
"documentation" : "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"
},
{
"name" : "maPtttQt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maPtttQtSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maPtttQt"
}
],
"documentation" : "Target field: MA_PTTT_QT - Mã phẫu thuật, thủ thuật quốc tế ICD-9-CM FHIR path: VNCoreProcedure.code.coding.code Mapping note: Mã ICD-9-CM (VNICD9CMCS; QĐ 4440/QĐ-BYT, nay thay bằng QĐ 387/QĐ-BYT). Nhiều PT/TT thì các mã phân cách bằng ';'; chỉ ghi khi người bệnh có thực hiện phẫu thuật, thủ thuật. KHÔNG nhầm với MA_PTTT (mã phương thức thanh toán, Bảng 2/3 STT 36/40)."
},
{
"name" : "maDoituongKcb",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maDoituongKcbSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maDoituongKcb"
}
],
"documentation" : "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."
},
{
"name" : "maNoiDi",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maNoiDiSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maNoiDi"
}
],
"documentation" : "Target field: MA_NOI_DI - Mã nơi đi FHIR path: VNCoreEncounter.hospitalization.origin.resolve().identifier[CSKCB].value"
},
{
"name" : "maNoiDen",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maNoiDenSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maNoiDen"
}
],
"documentation" : "Target field: MA_NOI_DEN - Mã nơi đến FHIR path: VNCoreEncounter.hospitalization.destination.resolve().identifier[CSKCB].value"
},
{
"name" : "maTaiNan",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maTaiNanSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maTaiNan"
}
],
"documentation" : "Target field: MA_TAI_NAN - Mã tai nạn FHIR path: VNCoreClaim.accident.type"
},
{
"name" : "ngayVao",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngayVaoSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngayVao"
}
],
"documentation" : "Target field: NGAY_VAO - Ngày vào theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.start | VNCoreClaim.created"
},
{
"name" : "ngayVaoNoiTru",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngayVaoNoiTruSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngayVaoNoiTru"
}
],
"documentation" : "Target field: NGAY_VAO_NOI_TRU - Ngày vào nội trú FHIR path: VNCoreEncounter.hospitalization | future admission instant extension"
},
{
"name" : "ngayRa",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngayRaSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngayRa"
}
],
"documentation" : "Target field: NGAY_RA - Ngày ra theo định dạng yyyyMMddHHmm FHIR path: VNCoreEncounter.period.end | VNCoreClaim.created"
},
{
"name" : "giayChuyenTuyen",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "giayChuyenTuyenSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "giayChuyenTuyen"
}
],
"documentation" : "Target field: GIAY_CHUYEN_TUYEN - Số giấy chuyển tuyến FHIR path: VNCoreServiceRequest.identifier.value | VNCoreDocumentReference.identifier.value Mapping note: Số giấy chuyển tuyến/chuyển cơ sở KBCB nơi chuyển người bệnh đi hoặc số giấy hẹn khám lại (nếu có). Ghi theo trường GIAY_CHUYEN_TUYEN Bảng 13 (BHYTXML13ReferralLM) — liên kết phiếu chuyển tuyến ServiceRequest."
},
{
"name" : "soNgayDtri",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "soNgayDtriSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "soNgayDtri"
}
],
"documentation" : "Target field: SO_NGAY_DTRI - Số ngày điều trị FHIR path: Derived from VNCoreEncounter.period.start/end | VNCoreEncounter.length.value"
},
{
"name" : "ppDieuTri",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ppDieuTriSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ppDieuTri"
}
],
"documentation" : "Target field: PP_DIEU_TRI - Phương pháp điều trị (nội khoa, ngoại khoa, xạ trị, hoá trị hoặc kết hợp) FHIR path: VNCoreProcedure.category | future treatment-method (PP_DIEU_TRI) extension Mapping note: Ghi phương pháp điều trị theo TT 18/2022/TT-BYT (nội khoa, ngoại khoa, xạ trị, hoá trị hoặc xạ trị + nội khoa). VN Core chưa có slice/extension chuyên biệt ở cấp đợt điều trị nên đánh dấu future."
},
{
"name" : "ketQuaDtri",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ketQuaDtriSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ketQuaDtri"
}
],
"documentation" : "Target field: KET_QUA_DTRI - Kết quả điều trị FHIR path: VNCoreEncounter.extension[treatmentOutcome].valueCodeableConcept"
},
{
"name" : "maLoaiRv",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maLoaiRvSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maLoaiRv"
}
],
"documentation" : "Target field: MA_LOAI_RV - Mã loại ra viện FHIR path: VNCoreEncounter.hospitalization.dischargeDisposition"
},
{
"name" : "ghiChu",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ghiChuSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ghiChu"
}
],
"documentation" : "Target field: GHI_CHU - Lời dặn của bác sĩ/nhân viên y tế sau khi kết thúc KBCB FHIR path: VNCoreComposition.section[dischargeSummary].text Mapping note: Lời dặn của bác sĩ hoặc nhân viên y tế đối với người bệnh sau khi kết thúc lần KBCB; ghi vào phần tóm tắt ra viện/hướng điều trị tiếp của bệnh án điện tử (TT 13/2025/TT-BYT)."
},
{
"name" : "ngayTtoan",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngayTtoanSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngayTtoan"
}
],
"documentation" : "Target field: NGAY_TTOAN - Ngày thanh toán FHIR path: VNCoreExplanationOfBenefit.created | VNCoreClaimResponse.created"
},
{
"name" : "tThuoc",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tThuocSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tThuoc"
}
],
"documentation" : "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"
},
{
"name" : "tVtyt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tVtytSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tVtyt"
}
],
"documentation" : "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"
},
{
"name" : "tTongchiBv",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tTongchiBvSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tTongchiBv"
}
],
"documentation" : "Target field: T_TONGCHI_BV - Tổng chi phí bệnh viện FHIR path: VNCoreClaim.total.value | VNCoreExplanationOfBenefit.total.amount"
},
{
"name" : "tTongchiBh",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tTongchiBhSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tTongchiBh"
}
],
"documentation" : "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"
},
{
"name" : "tBntt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tBnttSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tBntt"
}
],
"documentation" : "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"
},
{
"name" : "tBncct",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tBncctSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tBncct"
}
],
"documentation" : "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"
},
{
"name" : "tBhtt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tBhttSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tBhtt"
}
],
"documentation" : "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"
},
{
"name" : "tNguonkhac",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tNguonkhacSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tNguonkhac"
}
],
"documentation" : "Target field: T_NGUONKHAC - Nguồn khác FHIR path: VNCoreClaim.extension[costSummary].extension[totalOtherFund].valueMoney.value | VNCoreExplanationOfBenefit.extension[costSummary].extension[totalOtherFund].valueMoney.value"
},
{
"name" : "tBhttGdv",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "tBhttGdvSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "tBhttGdv"
}
],
"documentation" : "Target field: T_BHTT_GDV - BHYT thanh toán giám định viên FHIR path: VNCoreClaim.extension[costSummary] | future totalInsuranceFeeForService sub-extension Mapping note: Số tiền quỹ BHYT thanh toán đối với các khoản chi ngoài định suất hoặc ngoài DRG (là T_BHTT tại Bảng 2, Bảng 3 đối với chi phí có MA_PTTT = '1' — Phí dịch vụ). VNCoreExtClaimCostSummary chưa có sub-extension chuyên biệt cho khoản này nên đánh dấu future."
},
{
"name" : "namQt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "namQtSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "namQt"
}
],
"documentation" : "Target field: NAM_QT - Năm quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[year]"
},
{
"name" : "thangQt",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "thangQtSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "thangQt"
}
],
"documentation" : "Target field: THANG_QT - Tháng quyết toán FHIR path: VNCoreClaim.extension[paymentPeriod].extension[month]"
},
{
"name" : "maLoaiKcb",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maLoaiKcbSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maLoaiKcb"
}
],
"documentation" : "Target field: MA_LOAI_KCB - Mã loại khám chữa bệnh FHIR path: VNCoreEncounter.type"
},
{
"name" : "maKhoa",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maKhoaSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maKhoa"
}
],
"documentation" : "Target field: MA_KHOA - Mã khoa FHIR path: VNCoreClaim.item.extension[department].valueCodeableConcept.coding.code | VNCoreEncounter.serviceType"
},
{
"name" : "maCskcb",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maCskcbSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maCskcb"
}
],
"documentation" : "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."
},
{
"name" : "maKhuvuc",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maKhuvucSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maKhuvuc"
}
],
"documentation" : "Target field: MA_KHUVUC - Mã khu vực FHIR path: VNCoreCoverage | future BHYT living-area (K1/K2/K3) extension Mapping note: Mã nơi sinh sống của người bệnh ghi trên thẻ BHYT (danh mục mã cố định K1/K2/K3). VN Core chưa có extension mã khu vực sinh sống trên Coverage."
},
{
"name" : "canNang",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "canNangSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "canNang"
}
],
"documentation" : "Target field: CAN_NANG - Cân nặng FHIR path: VNCoreObservationBodyWeight.valueQuantity.value"
},
{
"name" : "canNangCon",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "canNangConSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "canNangCon"
}
],
"documentation" : "Target field: CAN_NANG_CON - Cân nặng con FHIR path: VNCoreObservationBodyWeight.valueQuantity.value | future newborn-birth-weight extension Mapping note: Cân nặng con mới sinh, đơn vị gram; subject là trẻ mới sinh (RelatedPerson/Patient liên kết), không phải người bệnh mẹ. Chỉ ghi khi sinh con; sinh từ 2 con trở lên ghi lần lượt, phân cách bằng dấu chấm phẩy ';'."
},
{
"name" : "namNamLienTuc",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "namNamLienTucSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "namNamLienTuc"
}
],
"documentation" : "Target field: NAM_NAM_LIEN_TUC - Thời điểm đủ 5 năm liên tục FHIR path: VNCoreCoverage | future five-year-continuous-participation date extension Mapping note: Thời điểm người bệnh tham gia BHYT đủ 05 năm liên tục, 8 ký tự yyyymmdd (mốc hưởng quyền lợi 5 năm liên tục). VN Core chưa có extension mốc 5 năm liên tục trên Coverage."
},
{
"name" : "ngayTaiKham",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "ngayTaiKhamSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "ngayTaiKham"
}
],
"documentation" : "Target field: NGAY_TAI_KHAM - Ngày tái khám FHIR path: VNCoreServiceRequest.occurrenceDateTime | Appointment.start"
},
{
"name" : "maHsba",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maHsbaSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maHsba"
}
],
"documentation" : "Target field: MA_HSBA - Mã hồ sơ bệnh án FHIR path: VNCoreComposition.identifier.value | VNCoreDocumentReference.identifier.value"
},
{
"name" : "maTtdv",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "maTtdvSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "maTtdv"
}
],
"documentation" : "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"
},
{
"name" : "duPhong",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "duPhongSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "duPhong"
}
],
"documentation" : "Target field: DU_PHONG - Trường dự phòng (tái sử dụng: ghi chiều cao người bệnh, đơn vị cm) FHIR path: VNCoreObservationBodyHeight.valueQuantity.value Mapping note: Theo bản sửa đổi, bổ sung QĐ 4750/QĐ-BYT: trường dự phòng Bảng 1 dùng để ghi chiều cao người bệnh (đơn vị cm), bắt buộc trong trường hợp sử dụng chỉ số này để chẩn đoán, điều trị. Riêng Bảng 1 khác các bảng khác (DU_PHONG thường dùng cho dữ liệu chữ ký số theo QĐ 3176/QĐ-BYT)."
}
]
}
]
}