<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 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML6HIVCareLM.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/bhytXml6HivCareLm"/> <mode value="target"/> <alias value="BHYTXML6HIVCareLM"/> <documentation value="Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model"/> </structure> <group> <name value="MapBHYTXML6HIVCareLM"/> <typeMode value="none"/> <documentation value="Rows are derived from HIV/AIDS/TB clinical resources and supporting documents. This table was previously mis-numbered in draft FSH and must not be confused with discharge documents. 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="BHYTXML6HIVCareLM"/> <mode value="target"/> <documentation value="Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care 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ự dòng FHIR path: Derived export row order for HIV care rows"/> </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"/> </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="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ỉ cư trú 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].valueCoding.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].valueCoding.code"/> </rule> <rule> <name value="ngayKdHiv"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="ngayKdHivSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="ngayKdHiv"/> </target> <documentation value="Target field: NGAYKD_HIV - Ngày khẳng định HIV FHIR path: VNCoreCondition.onsetDateTime | VNCoreObservation.effectiveDateTime Mapping note: The local OHP validator marks NGAYKD_HIV required, but its rule text notes the legal/source exception for exposure prophylaxis. Keep optional until the exception is confirmed in the normative source."/> </rule> <rule> <name value="lyDoChuyenPhacDo"/> <source> <context value="sourceBundle"/> <min value="0"/> <max value="*"/> <element value="entry"/> <variable value="lyDoChuyenPhacDoSource"/> </source> <target> <context value="targetRow"/> <contextType value="variable"/> <element value="lyDoChuyenPhacDo"/> </target> <documentation value="Target field: LY_DO_CHUYEN_PHAC_DO - Lý do chuyển phác đồ FHIR path: VNCoreMedicationRequest.reasonCode | VNCoreDocumentReference.category | future HIV workflow extension"/> </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ở KCB FHIR path: VNCoreEncounter.serviceProvider.resolve().identifier[CSKCB].value | VNCoreClaim.provider.resolve().identifier[CSKCB].value"/> </rule> </group> </StructureMap>

Generated Narrative: StructureMap vn-sm-bhyt-xml6-hiv-care

map "http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml6-hiv-care" = "BHYTXML6HIVCareLMStructureMap"

// Generated StructureMap scaffold for Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML6HIVCareLM.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/bhytXml6HivCareLm" alias BHYTXML6HIVCareLM as target // Bảng 6 hồ sơ HIV/AIDS — XML6 HIV/AIDS Care Logical Model

// Rows are derived from HIV/AIDS/TB clinical resources and supporting documents. This table was previously mis-numbered in draft FSH and must not be confused with discharge documents. 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 MapBHYTXML6HIVCareLM(source sourceBundle : BHYTSubmissionBundle, target targetRow : BHYTXML6HIVCareLM) {
  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ự dòng FHIR path: Derived export row order for HIV care rows
  sourceBundle.entry as maTheBhytSource -> targetRow.maTheBhyt "maTheBhyt"; // Target field: MA_THE_BHYT - Mã thẻ BHYT FHIR path: VNCoreCoverage.identifier[BHYT].value
  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 diaChiSource -> targetRow.diaChi "diaChi"; // Target field: DIA_CHI - Địa chỉ cư trú 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].valueCoding.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].valueCoding.code
  sourceBundle.entry as ngayKdHivSource -> targetRow.ngayKdHiv "ngayKdHiv"; // Target field: NGAYKD_HIV - Ngày khẳng định HIV FHIR path: VNCoreCondition.onsetDateTime | VNCoreObservation.effectiveDateTime Mapping note: The local OHP validator marks NGAYKD_HIV required, but its rule text notes the legal/source exception for exposure prophylaxis. Keep optional until the exception is confirmed in the normative source.
  sourceBundle.entry as lyDoChuyenPhacDoSource -> targetRow.lyDoChuyenPhacDo "lyDoChuyenPhacDo"; // Target field: LY_DO_CHUYEN_PHAC_DO - Lý do chuyển phác đồ FHIR path: VNCoreMedicationRequest.reasonCode | VNCoreDocumentReference.category | future HIV workflow extension
  sourceBundle.entry as maCskcbSource -> targetRow.maCskcb "maCskcb"; // Target field: MA_CSKCB - Mã cơ sở KCB FHIR path: VNCoreEncounter.serviceProvider.resolve().identifier[CSKCB].value | VNCoreClaim.provider.resolve().identifier[CSKCB].value
}