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 |
{
"resourceType" : "ConceptMap",
"id" : "vn-cm-bhyt-financial-field-to-adjudication",
"language" : "vi",
"text" : {
"status" : "generated",
"div" : "<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>"
},
"url" : "http://fhir.hl7.org.vn/core/ConceptMap/vn-cm-bhyt-financial-field-to-adjudication",
"version" : "0.5.0",
"name" : "VNCMBHYTFinancialFieldToAdjudication",
"title" : "Ánh xạ trường tổng tiền BHYT → FHIR adjudication",
"status" : "draft",
"experimental" : false,
"date" : "2026-04-23",
"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" : "[email protected]"
}
]
},
{
"name" : "Omi HealthTech (OmiGroup)",
"telecom" : [
{
"system" : "url",
"value" : "https://omihealthtech.vn"
},
{
"system" : "url",
"value" : "https://omigroup.vn"
},
{
"system" : "email",
"value" : "[email protected]"
}
]
}
],
"description" : "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" : "urn:iso:std:iso:3166",
"code" : "VN",
"display" : "Viet Nam"
}
]
}
],
"copyright" : "Nguồn: QĐ 130/QĐ-BYT, QĐ 3176/QĐ-BYT và QĐ 697/QĐ-BYT.",
"sourceUri" : "http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-financial-field-vs",
"targetUri" : "http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs",
"group" : [
{
"source" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-financial-field-cs",
"target" : "http://terminology.hl7.org/CodeSystem/adjudication",
"element" : [
{
"code" : "T_TONGCHI",
"display" : "Tổng chi phí phát sinh",
"target" : [
{
"code" : "submitted",
"display" : "Submitted Amount",
"equivalence" : "equivalent",
"comment" : "Dùng cho tổng chi phí cơ sở KCB gửi/đề nghị ở giai đoạn claim hoặc EOB."
}
]
},
{
"code" : "T_TONGCHI_BV",
"display" : "Tổng chi phí bệnh viện",
"target" : [
{
"code" : "submitted",
"display" : "Submitted Amount",
"equivalence" : "equivalent",
"comment" : "Alias bảng kê/giám định cho tổng chi phí bệnh viện gửi/đề nghị."
}
]
},
{
"code" : "T_TONGCHI_BH",
"display" : "Tổng chi phí thuộc phạm vi BHYT",
"target" : [
{
"code" : "eligible",
"display" : "Eligible Amount",
"equivalence" : "wider",
"comment" : "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 đủ."
}
]
},
{
"code" : "T_BHTT",
"display" : "Quỹ BHYT thanh toán",
"target" : [
{
"code" : "benefit",
"display" : "Benefit Amount",
"equivalence" : "equivalent",
"comment" : "Dùng cho phần quỹ BHYT thanh toán/đề nghị thanh toán tùy giai đoạn."
}
]
},
{
"code" : "T_BNCCT",
"display" : "Người bệnh cùng chi trả",
"target" : [
{
"code" : "copay",
"display" : "CoPay",
"equivalence" : "equivalent"
}
]
}
]
},
{
"source" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-financial-field-cs",
"target" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-bhyt-adjudication-category-cs",
"element" : [
{
"code" : "T_BNTT",
"display" : "Người bệnh tự trả",
"target" : [
{
"code" : "patient-self-pay",
"display" : "Người bệnh tự trả",
"equivalence" : "equivalent",
"comment" : "Không map sang HL7 `copay`; `T_BNTT` là phần tự trả ngoài cùng chi trả BHYT."
}
]
},
{
"code" : "T_NGUONKHAC",
"display" : "Nguồn khác",
"target" : [
{
"code" : "other-fund",
"display" : "Nguồn khác",
"equivalence" : "equivalent",
"comment" : "Breakdown NSNN/VTNN/VTTN/CL cần extension hoặc model bổ sung khi pilot yêu cầu."
}
]
},
{
"code" : "T_NGOAIDS",
"display" : "Ngoài phạm vi/ngoài định suất",
"target" : [
{
"code" : "non-covered",
"display" : "Ngoài phạm vi/ngoài định suất",
"equivalence" : "equivalent",
"comment" : "Không map sang deductible vì ngữ nghĩa BHYT Việt Nam không phải khấu trừ bảo hiểm."
}
]
},
{
"code" : "T_THUOC",
"display" : "Tổng tiền thuốc, dịch truyền",
"target" : [
{
"code" : "medication-subtotal",
"display" : "Tổng thuốc, dịch truyền",
"equivalence" : "equivalent",
"comment" : "Subtotal theo nhóm chi phí; dùng cho total/costSummary, không phải line-level adjudication result."
}
]
},
{
"code" : "T_VTYT",
"display" : "Tổng tiền vật tư/thiết bị y tế",
"target" : [
{
"code" : "supplies-subtotal",
"display" : "Tổng vật tư/thiết bị y tế",
"equivalence" : "equivalent",
"comment" : "Subtotal theo nhóm chi phí; dùng cho total/costSummary, không phải line-level adjudication result."
}
]
}
]
}
]
}