HL7 Vietnam VN Core FHIR Implementation Guide

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 - Local Development build (v0.5.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 rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
    @prefix rdfs: <http://www.w3.org/2000/01/rdf-schema#> .
    @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .

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

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