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-xml5-clinical-course",
"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-xml5-clinical-course</b></p><a name=\"vn-sm-bhyt-xml5-clinical-course\"> </a><a name=\"hcvn-sm-bhyt-xml5-clinical-course\"> </a><pre class=\"fml\">\r\n<b>map</b><span style=\"color: navy\"> "</span>http://fhir.hl7.org.vn/core/StructureMap/vn-sm-bhyt-xml5-clinical-course<span style=\"color: navy\">" = "</span>BHYTXML5ClinicalCourseLMStructureMap<span style=\"color: navy\">"\r\n\r\n</span><span style=\"color: navy\">// </span><span style=\"color: green\">Generated StructureMap scaffold for Bảng 5 diễn biến lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML5ClinicalCourseLM.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 5 diễn biến lâm sàng BHYT — Logical Model</span>\r\n<b>uses</b><span style=\"color: navy\"> "</span><a href=\"StructureDefinition-bhytXml5ClinicalCourseLm.html\" title=\"Bảng 5 diễn biến lâm sàng BHYT — Logical Model\">http://fhir.hl7.org.vn/core/StructureDefinition/bhytXml5ClinicalCourseLm</a><span style=\"color: navy\">" </span><b>alias </b>BHYTXML5ClinicalCourseLM <b>as </b><b>target</b>\r\n\r\n<span style=\"color: navy\">// </span><span style=\"color: green\">Rows are derived from clinical-course timeline entries. QD 3176 XML5 currently carries row order, event time, and performer metadata only. 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>MapBHYTXML5ClinicalCourseLM<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>BHYTXML5ClinicalCourseLM<span style=\"color: navy\">)</span><span style=\"color: navy\"> {\r\n</span> <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: 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ự dòng FHIR path: Derived export row order from the clinical course timeline</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: DIEN_BIEN_LS - Diễn biến lâm sàng của người bệnh trong lần khám và/hoặc nội dung chăm sóc của nhân viên y tế FHIR path: VNCoreClinicalImpression.summary | VNCoreClinicalImpression.note.text Mapping note: Trường tự do. Khi mô tả diễn biến có đo chỉ số sinh tồn thì ghi theo quy ước ký hiệu Mạch (M), nhiệt độ (T), huyết áp (HA), nhịp thở (NT), SPO2 (SP), chế độ hộ lý (HL)... theo cú pháp mẫu CSST<M75_T37_HA120/70_NT18_HL2> (bổ sung hướng dẫn theo QĐ 4750/QĐ-BYT).</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">dienBienLsSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.dienBienLs <i>"dienBienLs"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: GIAI_DOAN_BENH - Giai đoạn bệnh, ghi khi cơ sở KBCB đã xác định được giai đoạn bệnh FHIR path: VNCoreCondition.stage.summary Mapping note: Chỉ ghi trong trường hợp cơ sở KBCB đã xác định giai đoạn bệnh (điều kiện có/không) — QĐ 3176/QĐ-BYT.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">giaiDoanBenhSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.giaiDoanBenh <i>"giaiDoanBenh"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: HOI_CHAN - Kết quả hội chẩn (nếu có) FHIR path: VNCoreClinicalImpression.summary | future hội-chẩn/consultation CareTeam extension Mapping note: Chỉ ghi khi có hội chẩn. Kết quả hội chẩn là văn bản tự do; chưa có element/slice riêng cho kết quả hội chẩn (case-conference) trên VNCoreCareTeam — QĐ 3176/QĐ-BYT.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">hoiChanSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.hoiChan <i>"hoiChan"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: PHAU_THUAT - Mô tả cách thức phẫu thuật, thủ thuật (nếu có) FHIR path: VNCoreProcedure.note.text Mapping note: Chỉ ghi khi có phẫu thuật/thủ thuật; mô tả tự do cách thức thực hiện — QĐ 3176/QĐ-BYT.</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">phauThuatSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.phauThuat <i>"phauThuat"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: THOI_DIEM_DBLS - Thời điểm diễn biến lâm sàng theo định dạng yyyyMMddHHmm FHIR path: VNCoreComposition.date | VNCoreObservation.effectiveDateTime</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">thoiDiemDblsSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.thoiDiemDbls <i>"thoiDiemDbls"</i><span style=\"color: navy\">;</span>\r\n <span style=\"color: navy\">// </span><span style=\"color: green\">Target field: NGUOI_THUC_HIEN - Mã người thực hiện FHIR path: VNCoreComposition.author.resolve().identifier.value | VNCorePractitioner.identifier.value</span>\r\n sourceBundle.entry 0<span style=\"color: navy\">..</span>*<b> as </b><span style=\"color: maroon\">nguoiThucHienSource</span><span style=\"color: navy\"><b> -> </b></span>targetRow.nguoiThucHien <i>"nguoiThucHien"</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-xml5-clinical-course",
"identifier" : [
{
"system" : "urn:ietf:rfc:3986",
"value" : "urn:oid:2.25.161089673617632664299011809196868855799.43.8"
}
],
"version" : "0.8.0",
"name" : "BHYTXML5ClinicalCourseLMStructureMap",
"title" : "Bảng 5 diễn biến lâm sàng 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 5 diễn biến lâm sàng BHYT — Logical Model. Source semantics come from the logical model mapping annotations in `BHYTXML5ClinicalCourseLM.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/bhytXml5ClinicalCourseLm",
"mode" : "target",
"alias" : "BHYTXML5ClinicalCourseLM",
"documentation" : "Bảng 5 diễn biến lâm sàng BHYT — Logical Model"
}
],
"group" : [
{
"name" : "MapBHYTXML5ClinicalCourseLM",
"typeMode" : "none",
"documentation" : "Rows are derived from clinical-course timeline entries. QD 3176 XML5 currently carries row order, event time, and performer metadata only. 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" : "BHYTXML5ClinicalCourseLM",
"mode" : "target",
"documentation" : "Bảng 5 diễn biến lâm sàng 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: 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ự dòng FHIR path: Derived export row order from the clinical course timeline"
},
{
"name" : "dienBienLs",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "dienBienLsSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "dienBienLs"
}
],
"documentation" : "Target field: DIEN_BIEN_LS - Diễn biến lâm sàng của người bệnh trong lần khám và/hoặc nội dung chăm sóc của nhân viên y tế FHIR path: VNCoreClinicalImpression.summary | VNCoreClinicalImpression.note.text Mapping note: Trường tự do. Khi mô tả diễn biến có đo chỉ số sinh tồn thì ghi theo quy ước ký hiệu Mạch (M), nhiệt độ (T), huyết áp (HA), nhịp thở (NT), SPO2 (SP), chế độ hộ lý (HL)... theo cú pháp mẫu CSST<M75_T37_HA120/70_NT18_HL2> (bổ sung hướng dẫn theo QĐ 4750/QĐ-BYT)."
},
{
"name" : "giaiDoanBenh",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "giaiDoanBenhSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "giaiDoanBenh"
}
],
"documentation" : "Target field: GIAI_DOAN_BENH - Giai đoạn bệnh, ghi khi cơ sở KBCB đã xác định được giai đoạn bệnh FHIR path: VNCoreCondition.stage.summary Mapping note: Chỉ ghi trong trường hợp cơ sở KBCB đã xác định giai đoạn bệnh (điều kiện có/không) — QĐ 3176/QĐ-BYT."
},
{
"name" : "hoiChan",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "hoiChanSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "hoiChan"
}
],
"documentation" : "Target field: HOI_CHAN - Kết quả hội chẩn (nếu có) FHIR path: VNCoreClinicalImpression.summary | future hội-chẩn/consultation CareTeam extension Mapping note: Chỉ ghi khi có hội chẩn. Kết quả hội chẩn là văn bản tự do; chưa có element/slice riêng cho kết quả hội chẩn (case-conference) trên VNCoreCareTeam — QĐ 3176/QĐ-BYT."
},
{
"name" : "phauThuat",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "phauThuatSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "phauThuat"
}
],
"documentation" : "Target field: PHAU_THUAT - Mô tả cách thức phẫu thuật, thủ thuật (nếu có) FHIR path: VNCoreProcedure.note.text Mapping note: Chỉ ghi khi có phẫu thuật/thủ thuật; mô tả tự do cách thức thực hiện — QĐ 3176/QĐ-BYT."
},
{
"name" : "thoiDiemDbls",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "thoiDiemDblsSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "thoiDiemDbls"
}
],
"documentation" : "Target field: THOI_DIEM_DBLS - Thời điểm diễn biến lâm sàng theo định dạng yyyyMMddHHmm FHIR path: VNCoreComposition.date | VNCoreObservation.effectiveDateTime"
},
{
"name" : "nguoiThucHien",
"source" : [
{
"context" : "sourceBundle",
"min" : 0,
"max" : "*",
"element" : "entry",
"variable" : "nguoiThucHienSource"
}
],
"target" : [
{
"context" : "targetRow",
"contextType" : "variable",
"element" : "nguoiThucHien"
}
],
"documentation" : "Target field: NGUOI_THUC_HIEN - Mã người thực hiện FHIR path: VNCoreComposition.author.resolve().identifier.value | VNCorePractitioner.identifier.value"
}
]
}
]
}