# Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model — StructureMap - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## StructureMap: Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model — StructureMap 

 
Generated StructureMap scaffold for Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML12MedicalAssessmentLM.fsh` and remain aligned with the Python BHYT round-trip export adapter. 



## Resource Content

```json
{
  "resourceType" : "StructureMap",
  "id" : "vn-sm-bhyt-xml12-medical-assessment",
  "url" : "http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml12-medical-assessment",
  "version" : "0.5.0",
  "name" : "BHYTXML12MedicalAssessmentLMStructureMap",
  "title" : "Bảng 12 giám định y khoa — XML12 Medical Assessment 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" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "Generated StructureMap scaffold for Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML12MedicalAssessmentLM.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/bhytXml12MedicalAssessmentLm",
    "mode" : "target",
    "alias" : "BHYTXML12MedicalAssessmentLM",
    "documentation" : "Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model"
  }],
  "group" : [{
    "name" : "MapBHYTXML12MedicalAssessmentLM",
    "typeMode" : "none",
    "documentation" : "Rows are derived from medical-assessment Composition/DocumentReference, Patient/Coverage identity data and structured assessment Observations. 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" : "BHYTXML12MedicalAssessmentLM",
      "mode" : "target",
      "documentation" : "Bảng 12 giám định y khoa — XML12 Medical Assessment Logical Model"
    }],
    "rule" : [{
      "name" : "nguoiChuTri",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "nguoiChuTriSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "nguoiChuTri"
      }],
      "documentation" : "Target field: NGUOI_CHU_TRI - Người chủ trì FHIR path: VNCoreComposition.author.resolve().identifier.value | VNCorePractitioner.identifier.value"
    },
    {
      "name" : "chucVu",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "chucVuSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "chucVu"
      }],
      "documentation" : "Target field: CHUC_VU - Chức vụ FHIR path: VNCorePractitionerRole.code | VNCorePractitioner.qualification.code"
    },
    {
      "name" : "ngayHop",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "ngayHopSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "ngayHop"
      }],
      "documentation" : "Target field: NGAY_HOP - Ngày họp FHIR path: VNCoreComposition.event.period.start | VNCoreDocumentReference.context.period.start"
    },
    {
      "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 được giám định FHIR path: VNCorePatient.name"
    },
    {
      "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" : "ngayCapCccd",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "ngayCapCccdSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "ngayCapCccd"
      }],
      "documentation" : "Target field: NGAY_CAP_CCCD - Ngày cấp CCCD FHIR path: VNCorePatient.identifier[CCCD].period.start"
    },
    {
      "name" : "noiCapCccd",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "noiCapCccdSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "noiCapCccd"
      }],
      "documentation" : "Target field: NOI_CAP_CCCD - Nơi cấp CCCD FHIR path: VNCorePatient.identifier[CCCD].assigner.display"
    },
    {
      "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].valueCoding.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].valueCoding.code"
    },
    {
      "name" : "maBhxh",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "maBhxhSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "maBhxh"
      }],
      "documentation" : "Target field: MA_BHXH - Mã BHXH FHIR path: VNCorePatient.identifier[BHXH].value | VNCoreCoverage.subscriberId"
    },
    {
      "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"
    },
    {
      "name" : "ngheNghiep",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "ngheNghiepSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "ngheNghiep"
      }],
      "documentation" : "Target field: NGHE_NGHIEP - Nghề nghiệp FHIR path: VNCorePatient.extension[occupation].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 - Điện thoại FHIR path: VNCorePatient.telecom.where(system='phone').value"
    },
    {
      "name" : "soBienBan",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "soBienBanSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "soBienBan"
      }],
      "documentation" : "Target field: SO_BIEN_BAN - Số biên bản FHIR path: VNCoreDocumentReference.identifier.value | VNCoreComposition.identifier.value"
    },
    {
      "name" : "tyleTtctCu",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "tyleTtctCuSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "tyleTtctCu"
      }],
      "documentation" : "Target field: TYLE_TTCT_CU - Tỷ lệ tổn thương cơ thể cũ FHIR path: VNCoreObservation.valueQuantity"
    },
    {
      "name" : "ngayChungTu",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "ngayChungTuSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "ngayChungTu"
      }],
      "documentation" : "Target field: NGAY_CHUNG_TU - Ngày chứng từ FHIR path: VNCoreDocumentReference.date | VNCoreComposition.date"
    },
    {
      "name" : "soGiayGioiThieu",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "soGiayGioiThieuSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "soGiayGioiThieu"
      }],
      "documentation" : "Target field: SO_GIAY_GIOI_THIEU - Số giấy giới thiệu FHIR path: VNCoreDocumentReference.relatesTo.target.identifier.value | VNCoreDocumentReference.identifier.value"
    },
    {
      "name" : "ngayDeNghi",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "ngayDeNghiSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "ngayDeNghi"
      }],
      "documentation" : "Target field: NGAY_DE_NGHI - Ngày đề nghị FHIR path: VNCoreServiceRequest.authoredOn | VNCoreDocumentReference.context.period.start"
    },
    {
      "name" : "maDonvi",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "maDonviSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "maDonvi"
      }],
      "documentation" : "Target field: MA_DONVI - Mã đơn vị FHIR path: VNCoreOrganization.identifier.value | VNCoreDocumentReference.custodian.resolve().identifier.value"
    },
    {
      "name" : "gioiThieuCua",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "gioiThieuCuaSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "gioiThieuCua"
      }],
      "documentation" : "Target field: GIOI_THIEU_CUA - Giới thiệu của FHIR path: VNCoreDocumentReference.relatesTo.target.display | VNCoreServiceRequest.requester.display"
    },
    {
      "name" : "soVanBanCanCu",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "soVanBanCanCuSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "soVanBanCanCu"
      }],
      "documentation" : "Target field: SO_VAN_BAN_CAN_CU - Số văn bản căn cứ FHIR path: VNCoreDocumentReference.identifier.value | VNCoreComposition.identifier.value"
    },
    {
      "name" : "tyleTtctMoi",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "tyleTtctMoiSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "tyleTtctMoi"
      }],
      "documentation" : "Target field: TYLE_TTCT_MOI - Tỷ lệ tổn thương cơ thể mới FHIR path: VNCoreObservation.valueQuantity"
    },
    {
      "name" : "tongTyleTtct",
      "source" : [{
        "context" : "sourceBundle",
        "min" : 0,
        "max" : "*",
        "element" : "entry",
        "variable" : "tongTyleTtctSource"
      }],
      "target" : [{
        "context" : "targetRow",
        "contextType" : "variable",
        "element" : "tongTyleTtct"
      }],
      "documentation" : "Target field: TONG_TYLE_TTCT - Tổng tỷ lệ tổn thương cơ thể FHIR path: VNCoreObservation.valueQuantity"
    }]
  }]
}

```
