Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review
Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Draft for Community Review (v0.5.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-23 |
<ConceptMap xmlns="http://hl7.org/fhir">
<id value="vn-cm-bhyt-financial-field-to-adjudication"/>
<language value="vi"/>
<text>
<status value="generated"/>
<div xmlns="http://www.w3.org/1999/xhtml"><p class="res-header-id"><b>Generated Narrative: ConceptMap vn-cm-bhyt-financial-field-to-adjudication</b></p><a name="vn-cm-bhyt-financial-field-to-adjudication"> </a><a name="hcvn-cm-bhyt-financial-field-to-adjudication"> </a><p>Mapping from <a href="ValueSet-vn-bhyt-financial-field-vs.html">Trường tổng tiền BHYT — BHYT Financial Field ValueSet</a> to <a href="ValueSet-vn-bhyt-adjudication-category-vs.html">Loại adjudication BHYT — BHYT Adjudication Category ValueSet</a></p><br/><p><b>Group 1 </b>Mapping from <a href="CodeSystem-vn-bhyt-financial-field-cs.html">Trường tổng tiền BHYT — BHYT Financial Field CodeSystem</a> to <a href="http://terminology.hl7.org/7.1.0/CodeSystem-adjudication.html">Adjudication Value Codes</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>T_TONGCHI (Tổng chi phí phát sinh)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>submitted (Submitted Amount)</td><td>Dùng cho tổng chi phí cơ sở KCB gửi/đề nghị ở giai đoạn claim hoặc EOB.</td></tr><tr><td>T_TONGCHI_BV (Tổng chi phí bệnh viện)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>submitted (Submitted Amount)</td><td>Alias bảng kê/giám định cho tổng chi phí bệnh viện gửi/đề nghị.</td></tr><tr><td>T_TONGCHI_BH (Tổng chi phí thuộc phạm vi BHYT)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#wider" title="wider">maps to wider concept</a></td><td>eligible (Eligible Amount)</td><td>Gần với eligible nhưng không đồng nhất tuyệt đối: source là tổng cơ sở KCB xác định thuộc phạm vi BHYT trước/ngoài adjudication payer đầy đủ.</td></tr><tr><td>T_BHTT (Quỹ BHYT thanh toán)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>benefit (Benefit Amount)</td><td>Dùng cho phần quỹ BHYT thanh toán/đề nghị thanh toán tùy giai đoạn.</td></tr><tr><td>T_BNCCT (Người bệnh cùng chi trả)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>copay</td><td/></tr></table><hr/><p><b>Group 2 </b>Mapping from <a href="CodeSystem-vn-bhyt-financial-field-cs.html">Trường tổng tiền BHYT — BHYT Financial Field CodeSystem</a> to <a href="CodeSystem-vn-bhyt-adjudication-category-cs.html">Loại tổng hợp adjudication BHYT — BHYT Adjudication Category CodeSystem</a></p><table class="grid"><tr><td><b>Source Code</b></td><td><b>Relationship</b></td><td><b>Target Code</b></td><td><b>Comment</b></td></tr><tr><td>T_BNTT (Người bệnh tự trả)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>patient-self-pay (Người bệnh tự trả)</td><td>Không map sang HL7 `copay`; `T_BNTT` là phần tự trả ngoài cùng chi trả BHYT.</td></tr><tr><td>T_NGUONKHAC (Nguồn khác)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>other-fund (Nguồn khác)</td><td>Breakdown NSNN/VTNN/VTTN/CL cần extension hoặc model bổ sung khi pilot yêu cầu.</td></tr><tr><td>T_NGOAIDS (Ngoài phạm vi/ngoài định suất)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>non-covered (Ngoài phạm vi/ngoài định suất)</td><td>Không map sang deductible vì ngữ nghĩa BHYT Việt Nam không phải khấu trừ bảo hiểm.</td></tr><tr><td>T_THUOC (Tổng tiền thuốc, dịch truyền)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>medication-subtotal (Tổng thuốc, dịch truyền)</td><td>Subtotal theo nhóm chi phí; dùng cho total/costSummary, không phải line-level adjudication result.</td></tr><tr><td>T_VTYT (Tổng tiền vật tư/thiết bị y tế)</td><td><a href="http://hl7.org/fhir/R5/codesystem-concept-map-relationship.html#equivalent" title="equivalent">is equivalent to</a></td><td>supplies-subtotal (Tổng vật tư/thiết bị y tế)</td><td>Subtotal theo nhóm chi phí; dùng cho total/costSummary, không phải line-level adjudication result.</td></tr></table></div>
</text>
<url
value="http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-bhyt-financial-field-to-adjudication"/>
<version value="0.5.0"/>
<name value="VNCMBHYTFinancialFieldToAdjudication"/>
<title value="Ánh xạ trường tổng tiền BHYT → FHIR adjudication"/>
<status value="draft"/>
<experimental value="false"/>
<date value="2026-04-23"/>
<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="[email protected]"/>
</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="[email protected]"/>
</telecom>
</contact>
<description
value="ConceptMap ánh xạ các trường tổng tiền BHYT từ QĐ 3176/QĐ-BYT và bối cảnh bảng kê/giám định sang category dùng trong `ClaimResponse.total`, `ExplanationOfBenefit.total` và `VNCoreExtClaimCostSummary`. ConceptMap này chỉ chuẩn hóa mã category; không encode công thức quyền lợi, tỷ lệ hưởng, trần thanh toán hoặc catalog lý do từ chối của payer. Các trường breakdown nguồn khác `T_NGUONKHAC_NSNN`, `T_NGUONKHAC_VTNN`, `T_NGUONKHAC_VTTN`, `T_NGUONKHAC_CL` hiện được giữ ở source terminology và chưa map ra target riêng."/>
<jurisdiction>
<coding>
<system value="urn:iso:std:iso:3166"/>
<code value="VN"/>
<display value="Viet Nam"/>
</coding>
</jurisdiction>
<copyright value="Nguồn: QĐ 130/QĐ-BYT, QĐ 3176/QĐ-BYT và QĐ 697/QĐ-BYT."/>
<sourceUri
value="http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-financial-field-vs"/>
<targetUri
value="http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs"/>
<group>
<source
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-financial-field-cs"/>
<target value="http://terminology.hl7.org/CodeSystem/adjudication"/>
<element>
<code value="T_TONGCHI"/>
<display value="Tổng chi phí phát sinh"/>
<target>
<code value="submitted"/>
<display value="Submitted Amount"/>
<equivalence value="equivalent"/>
<comment
value="Dùng cho tổng chi phí cơ sở KCB gửi/đề nghị ở giai đoạn claim hoặc EOB."/>
</target>
</element>
<element>
<code value="T_TONGCHI_BV"/>
<display value="Tổng chi phí bệnh viện"/>
<target>
<code value="submitted"/>
<display value="Submitted Amount"/>
<equivalence value="equivalent"/>
<comment
value="Alias bảng kê/giám định cho tổng chi phí bệnh viện gửi/đề nghị."/>
</target>
</element>
<element>
<code value="T_TONGCHI_BH"/>
<display value="Tổng chi phí thuộc phạm vi BHYT"/>
<target>
<code value="eligible"/>
<display value="Eligible Amount"/>
<equivalence value="wider"/>
<comment
value="Gần với eligible nhưng không đồng nhất tuyệt đối: source là tổng cơ sở KCB xác định thuộc phạm vi BHYT trước/ngoài adjudication payer đầy đủ."/>
</target>
</element>
<element>
<code value="T_BHTT"/>
<display value="Quỹ BHYT thanh toán"/>
<target>
<code value="benefit"/>
<display value="Benefit Amount"/>
<equivalence value="equivalent"/>
<comment
value="Dùng cho phần quỹ BHYT thanh toán/đề nghị thanh toán tùy giai đoạn."/>
</target>
</element>
<element>
<code value="T_BNCCT"/>
<display value="Người bệnh cùng chi trả"/>
<target>
<code value="copay"/>
<display value="CoPay"/>
<equivalence value="equivalent"/>
</target>
</element>
</group>
<group>
<source
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-financial-field-cs"/>
<target
value="http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs"/>
<element>
<code value="T_BNTT"/>
<display value="Người bệnh tự trả"/>
<target>
<code value="patient-self-pay"/>
<display value="Người bệnh tự trả"/>
<equivalence value="equivalent"/>
<comment
value="Không map sang HL7 `copay`; `T_BNTT` là phần tự trả ngoài cùng chi trả BHYT."/>
</target>
</element>
<element>
<code value="T_NGUONKHAC"/>
<display value="Nguồn khác"/>
<target>
<code value="other-fund"/>
<display value="Nguồn khác"/>
<equivalence value="equivalent"/>
<comment
value="Breakdown NSNN/VTNN/VTTN/CL cần extension hoặc model bổ sung khi pilot yêu cầu."/>
</target>
</element>
<element>
<code value="T_NGOAIDS"/>
<display value="Ngoài phạm vi/ngoài định suất"/>
<target>
<code value="non-covered"/>
<display value="Ngoài phạm vi/ngoài định suất"/>
<equivalence value="equivalent"/>
<comment
value="Không map sang deductible vì ngữ nghĩa BHYT Việt Nam không phải khấu trừ bảo hiểm."/>
</target>
</element>
<element>
<code value="T_THUOC"/>
<display value="Tổng tiền thuốc, dịch truyền"/>
<target>
<code value="medication-subtotal"/>
<display value="Tổng thuốc, dịch truyền"/>
<equivalence value="equivalent"/>
<comment
value="Subtotal theo nhóm chi phí; dùng cho total/costSummary, không phải line-level adjudication result."/>
</target>
</element>
<element>
<code value="T_VTYT"/>
<display value="Tổng tiền vật tư/thiết bị y tế"/>
<target>
<code value="supplies-subtotal"/>
<display value="Tổng vật tư/thiết bị y tế"/>
<equivalence value="equivalent"/>
<comment
value="Subtotal theo nhóm chi phí; dùng cho total/costSummary, không phải line-level adjudication result."/>
</target>
</element>
</group>
</ConceptMap>