HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.8.0 - Draft for Community Review Viet Nam cờ

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

: Ánh xạ trường tổng tiền BHYT → FHIR adjudication

Draft tại thời điểm 2026-04-23

Bản thô ttl | Tải xuống


@prefix fhir: <http://hl7.org/fhir/> .
@prefix owl: <http://www.w3.org/2002/07/owl#> .
@prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
@prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

# - resource -------------------------------------------------------------------

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

# - ontology header ------------------------------------------------------------

<http://hl7.org/fhir/ConceptMap/vn-cm-bhyt-financial-field-to-adjudication.ttl> a owl:Ontology ;
  owl:imports fhir:fhir.ttl ;
  owl:versionIRI <http://build.fhir.org/ConceptMap/vn-cm-bhyt-financial-field-to-adjudication.ttl> .