# Ánh xạ trường tổng tiền BHYT → FHIR adjudication - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

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

 
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. 



## Resource Content

```json
{
  "resourceType" : "ConceptMap",
  "id" : "vn-cm-bhyt-financial-field-to-adjudication",
  "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" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "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."
      }]
    }]
  }]
}

```
