# Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile 

 
Profile ClaimResponse cho Việt Nam. Kết quả xử lý yêu cầu thanh toán BHYT. Bao gồm adjudication chi tiết: tổng đề nghị, đủ điều kiện, cùng chi trả, BHYT thanh toán. Cặp đôi với VNCoreClaim — Claim là yêu cầu, ClaimResponse là kết quả. Mã phản hồi gateway như XML1_ID được biểu diễn bằng identifier slice riêng; không thay thế MA_LK của Claim/Bundle. Căn cứ: 
* QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH hiện hành)
* QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB
* Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025
* NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn Luật BHYT
* NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ giám định/thanh toán sai lệch Nguồn thiết kế: OHP Data Processor (ClaimResponse adjudication mapping).
 

**Usages:**

* Examples for this Profile: [ClaimResponse/ExampleClaimResponseBHYT](ClaimResponse-ExampleClaimResponseBHYT.md), [ClaimResponse/ExampleClaimResponsePartialDeny](ClaimResponse-ExampleClaimResponsePartialDeny.md) and [ClaimResponse/ExampleClaimResponseSelfPay](ClaimResponse-ExampleClaimResponseSelfPay.md)
* CapabilityStatements using this Profile: [VN Core BHYT Gateway Client CapabilityStatement](CapabilityStatement-vn-core-bhyt-gateway-client.md), [VN Core BHYT Gateway Server CapabilityStatement](CapabilityStatement-vn-core-bhyt-gateway-server.md) and [VN Core Server CapabilityStatement](CapabilityStatement-vn-core-server.md)

You can also check for [usages in the FHIR IG Statistics](https://packages2.fhir.org/xig/hl7.fhir.vn.core|current/StructureDefinition/vn-core-claim-response)

### Các dạng xem hình thức của nội dung hồ sơ

 [Mô tả profile, differential, snapshot và các biểu diễn liên quan](http://build.fhir.org/ig/FHIR/ig-guidance/readingIgs.html#structure-definitions). 

*  [Bảng phần tử chính](#tabs-key) 
*  [Bảng Differential](#tabs-diff) 
*  [Bảng Snapshot](#tabs-snap) 
*  [Thống kê/Tham chiếu](#tabs-summ) 
*  [Tất cả](#tabs-all) 

#### Terminology Bindings

#### Constraints

#### Terminology Bindings (Differential)

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 0 element(2 nested mandatory elements)
 Must-Support: 22 elements
 Fixed: 1 element

**Structures**

This structure refers to these other structures:

* [Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)](StructureDefinition-vn-core-patient.md)
* [Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)](StructureDefinition-vn-core-organization.md)
* [Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim)](StructureDefinition-vn-core-claim.md)

**Slices**

This structure defines the following [Slices](http://hl7.org/fhir/R4/profiling.html#slices):

* The element 1 is sliced based on the values of ClaimResponse.identifier

 **Dạng xem phần tử chính** 

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Terminology Bindings (Differential)

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 0 element(2 nested mandatory elements)
 Must-Support: 22 elements
 Fixed: 1 element

**Structures**

This structure refers to these other structures:

* [Bệnh nhân VN Core — VN Core Patient Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient)](StructureDefinition-vn-core-patient.md)
* [Cơ sở y tế VN Core — VN Core Organization Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization)](StructureDefinition-vn-core-organization.md)
* [Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim)](StructureDefinition-vn-core-claim.md)

**Slices**

This structure defines the following [Slices](http://hl7.org/fhir/R4/profiling.html#slices):

* The element 1 is sliced based on the values of ClaimResponse.identifier

 

Biểu diễn khác của hồ sơ: [CSV](../StructureDefinition-vn-core-claim-response.csv), [Excel](../StructureDefinition-vn-core-claim-response.xlsx), [Schematron](../StructureDefinition-vn-core-claim-response.sch) 



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-claim-response",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response",
  "version" : "0.5.0",
  "name" : "VNCoreClaimResponse",
  "title" : "Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile",
  "status" : "draft",
  "date" : "2026-03-21",
  "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" : "Profile ClaimResponse cho Việt Nam. Kết quả xử lý yêu cầu thanh toán BHYT.\nBao gồm adjudication chi tiết: tổng đề nghị, đủ điều kiện, cùng chi trả, BHYT thanh toán.\nCặp đôi với VNCoreClaim — Claim là yêu cầu, ClaimResponse là kết quả.\nMã phản hồi gateway như XML1_ID được biểu diễn bằng identifier slice riêng; không thay thế MA_LK của Claim/Bundle.\nCăn cứ:\n- QĐ 130/QĐ-BYT → QĐ 4750/QĐ-BYT → QĐ 3176/QĐ-BYT (chuẩn dữ liệu BHXH hiện hành)\n- QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB\n- Luật 51/2024/QH15 (27/11/2024) — sửa đổi Luật BHYT, hiệu lực 01/7/2025\n- NĐ 188/2025/NĐ-CP — ban hành 01/7/2025, hiệu lực 15/8/2025 — Hướng dẫn Luật BHYT\n- NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — xử phạt VPHC y tế, tham chiếu khi hồ sơ giám định/thanh toán sai lệch\nNguồn thiết kế: OHP Data Processor (ClaimResponse adjudication mapping).",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "workflow",
    "uri" : "http://hl7.org/fhir/workflow",
    "name" : "Workflow Pattern"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "ClaimResponse",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/ClaimResponse",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "ClaimResponse",
      "path" : "ClaimResponse"
    },
    {
      "id" : "ClaimResponse.identifier",
      "path" : "ClaimResponse.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "description" : "Phân loại identifier kết quả xử lý theo hệ thống định danh",
        "rules" : "open"
      },
      "short" : "Định danh kết quả xử lý, bao gồm mã phản hồi gateway nếu có",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.identifier:gatewayResponseId",
      "path" : "ClaimResponse.identifier",
      "sliceName" : "gatewayResponseId",
      "short" : "Mã phản hồi Cổng tiếp nhận BHYT (XML1_ID)",
      "definition" : "Mã phản hồi của Cổng tiếp nhận dữ liệu cho hồ sơ/bảng XML1. Không dùng thay cho MA_LK.",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.identifier:gatewayResponseId.type",
      "path" : "ClaimResponse.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "BHYT_XML1_ID"
        }]
      }
    },
    {
      "id" : "ClaimResponse.identifier:gatewayResponseId.system",
      "path" : "ClaimResponse.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/bhyt-gateway-response-id"
    },
    {
      "id" : "ClaimResponse.identifier:gatewayResponseId.value",
      "path" : "ClaimResponse.identifier.value",
      "short" : "Giá trị XML1_ID hoặc mã phản hồi tương đương",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.status",
      "path" : "ClaimResponse.status",
      "short" : "Trạng thái kết quả: active | cancelled | draft | entered-in-error",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.type",
      "path" : "ClaimResponse.type",
      "short" : "Loại: institutional (nội trú) | professional (ngoại trú)",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.use",
      "path" : "ClaimResponse.use",
      "short" : "Mục đích: claim | preauthorization | predetermination",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.patient",
      "path" : "ClaimResponse.patient",
      "short" : "Bệnh nhân",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.created",
      "path" : "ClaimResponse.created",
      "short" : "Ngày tạo kết quả",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.insurer",
      "path" : "ClaimResponse.insurer",
      "short" : "Cơ quan BHXH giải quyết",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.request",
      "path" : "ClaimResponse.request",
      "short" : "Yêu cầu thanh toán gốc (VNCoreClaim)",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.outcome",
      "path" : "ClaimResponse.outcome",
      "short" : "Kết quả: queued | complete | error | partial",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.item",
      "path" : "ClaimResponse.item",
      "short" : "Kết quả từng dòng chi phí",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.item.itemSequence",
      "path" : "ClaimResponse.item.itemSequence",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.item.adjudication",
      "path" : "ClaimResponse.item.adjudication",
      "short" : "Phân bổ chi phí: đề nghị, đủ ĐK, cùng chi trả, BHYT thanh toán",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.item.adjudication.category",
      "path" : "ClaimResponse.item.adjudication.category",
      "short" : "Loại: submitted | eligible | copay | benefit",
      "definition" : "Category giám định từng dòng. Ưu tiên HL7 adjudication (`submitted`, `eligible`, `copay`, `benefit`) cho line-level adjudication; các subtotal cục bộ của VN Core không dùng ở line-level.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://hl7.org/fhir/ValueSet/adjudication"
      }
    },
    {
      "id" : "ClaimResponse.item.adjudication.amount",
      "path" : "ClaimResponse.item.adjudication.amount",
      "short" : "Số tiền (VND)",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.total",
      "path" : "ClaimResponse.total",
      "short" : "Tổng adjudication",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.total.category",
      "path" : "ClaimResponse.total.category",
      "short" : "Loại tổng: submitted | eligible | copay | benefit hoặc category BHYT cục bộ",
      "definition" : "Category tổng hợp tài chính/adjudication. Dùng ConceptMap `vn-cm-bhyt-financial-field-to-adjudication` để map các trường tổng tiền BHYT như `T_TONGCHI`, `T_TONGCHI_BH`, `T_BHTT`, `T_BNCCT`, `T_BNTT`, `T_NGUONKHAC`, `T_NGOAIDS`, `T_THUOC`, `T_VTYT`. Không encode công thức quyền lợi hoặc adjudication business rule tại profile.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-adjudication-category-vs"
      }
    },
    {
      "id" : "ClaimResponse.total.amount",
      "path" : "ClaimResponse.total.amount",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.payment",
      "path" : "ClaimResponse.payment",
      "short" : "Thông tin thanh toán"
    },
    {
      "id" : "ClaimResponse.payment.amount",
      "path" : "ClaimResponse.payment.amount",
      "short" : "Số tiền BHXH thanh toán"
    },
    {
      "id" : "ClaimResponse.error",
      "path" : "ClaimResponse.error",
      "short" : "Nhóm issue giám định/từ chối hoặc yêu cầu điều chỉnh",
      "definition" : "Issue-level carrier cho phản hồi giám định, giảm trừ, yêu cầu điều chỉnh hoặc lỗi tiếp nhận có liên kết tới claim. `VNBHYTReviewIssueVS` chỉ là taxonomy baseline cục bộ từ TT 12/2026; không phải catalog payer/gateway chính thức đầy đủ.",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.error.itemSequence",
      "path" : "ClaimResponse.error.itemSequence",
      "short" : "Dòng chi phí liên quan nếu có",
      "mustSupport" : true
    },
    {
      "id" : "ClaimResponse.error.code",
      "path" : "ClaimResponse.error.code",
      "short" : "Nhóm issue/lý do BHYT",
      "definition" : "Mã nhóm issue để liên kết `ClaimResponse` với `OperationOutcome`, bảng kê từ chối hoặc biên bản giám định. Căn cứ pháp lý chi tiết và số tiền vẫn nằm ở tài liệu giám định/payer response cụ thể.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-bhyt-review-issue-vs"
      }
    }]
  }
}

```
