# Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile 

 
Profile Claim cho Việt Nam. Dùng cho yêu cầu thanh toán chi phí khám chữa bệnh BHYT. Mapping từ chuẩn dữ liệu đầu ra phục vụ BHXH hiện hành (QĐ 130 → QĐ 4750 → QĐ 3176). Bảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã. Căn cứ: 
* QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu đầu ra phục vụ BHXH
* QĐ 4750/QĐ-BYT (2023) — Sửa đổi QĐ 130
* QĐ 3176/QĐ-BYT (29/10/2024) — Sửa đổi QĐ 4750
* QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB (thay QĐ 6556)
* NĐ 188/2025/NĐ-CP — ban hành 01/07/2025, hiệu lực 15/08/2025 — Hướng dẫn thi hành Luật BHYT, Điều 15 về giá trị sử dụng thẻ và Điều 22 về nhiều thẻ BHYT
* NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective) — Xử phạt vi phạm hành chính trong lĩnh vực y tế khi hồ sơ/chứng từ BHYT sai quy định
* Luật BHYT 2008 sửa đổi 2014
* Luật 25/2008/QH12 ngày 14/11/2008 về BHYT; Luật 51/2024/QH15 ngày 27/11/2024 sửa đổi Luật BHYT Nguồn TVPL: NĐ 188/2025/NĐ-CP https://thuvienphapluat.vn/van-ban/Bao-hiem/Nghi-dinh-188-2025-ND-CP-huong-dan-Luat-Bao-hiem-y-te-641049.aspx; NĐ 90/2026/NĐ-CP https://thuvienphapluat.vn/van-ban/Vi-pham-hanh-chinh/Nghi-dinh-sua-doi-Nghi-dinh-117-2020-ND-CP-xu-phat-vi-pham-hanh-chinh-trong-linh-vuc-y-te-639959.aspx
 

**Usages:**

* Refer to this Profile: [Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile](StructureDefinition-vn-core-claim-response.md) and [Quyết toán BHYT VN Core — VN Core Payment Reconciliation Profile](StructureDefinition-vn-core-payment-reconciliation.md)
* Examples for this Profile: [Claim/ExampleClaimBHYT](Claim-ExampleClaimBHYT.md), [Claim/ExampleClaimMultiService](Claim-ExampleClaimMultiService.md) and [Claim/ExampleClaimSelfPay](Claim-ExampleClaimSelfPay.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)

### 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)

#### Constraints

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 6 elements
 Must-Support: 25 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)
* [Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)](StructureDefinition-vn-core-practitioner.md)
* [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)](StructureDefinition-vn-core-practitioner-role.md)
* [Thẻ BHYT VN Core — VN Core Coverage Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage)](StructureDefinition-vn-core-coverage.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-cost-summary](StructureDefinition-vn-ext-claim-cost-summary.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-payment-period](StructureDefinition-vn-ext-claim-payment-period.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method](StructureDefinition-vn-ext-payment-method.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-item-department](StructureDefinition-vn-ext-claim-item-department.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-device-group](StructureDefinition-vn-ext-device-group.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-device-insurance-scope](StructureDefinition-vn-ext-device-insurance-scope.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info](StructureDefinition-vn-ext-insurance-cost-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source](StructureDefinition-vn-ext-payment-source.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-recurrent-wound-benefit](StructureDefinition-vn-ext-recurrent-wound-benefit.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info](StructureDefinition-vn-ext-tender-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method](StructureDefinition-vn-ext-traditional-processing-method.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 Claim.identifier
* The element 1 is sliced based on the values of Claim.diagnosis.diagnosis[x]
* The element 1 is sliced based on the values of Claim.procedure.procedure[x]

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

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Terminology Bindings (Differential)

#### Constraints

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 6 elements
 Must-Support: 25 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)
* [Nhân viên y tế VN Core — VN Core Practitioner Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner)](StructureDefinition-vn-core-practitioner.md)
* [Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role)](StructureDefinition-vn-core-practitioner-role.md)
* [Thẻ BHYT VN Core — VN Core Coverage Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage)](StructureDefinition-vn-core-coverage.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-cost-summary](StructureDefinition-vn-ext-claim-cost-summary.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-payment-period](StructureDefinition-vn-ext-claim-payment-period.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method](StructureDefinition-vn-ext-payment-method.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-item-department](StructureDefinition-vn-ext-claim-item-department.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-device-group](StructureDefinition-vn-ext-device-group.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-device-insurance-scope](StructureDefinition-vn-ext-device-insurance-scope.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info](StructureDefinition-vn-ext-insurance-cost-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source](StructureDefinition-vn-ext-payment-source.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-recurrent-wound-benefit](StructureDefinition-vn-ext-recurrent-wound-benefit.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info](StructureDefinition-vn-ext-tender-info.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method](StructureDefinition-vn-ext-traditional-processing-method.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 Claim.identifier
* The element 1 is sliced based on the values of Claim.diagnosis.diagnosis[x]
* The element 1 is sliced based on the values of Claim.procedure.procedure[x]

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-claim",
  "extension" : [{
    "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
    "valueCoding" : {
      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
      "code" : "L-51-2024"
    }
  },
  {
    "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
    "valueCoding" : {
      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
      "code" : "ND-188-2025"
    }
  },
  {
    "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
    "valueCoding" : {
      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
      "code" : "ND-90-2026"
    }
  },
  {
    "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
    "valueCoding" : {
      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
      "code" : "QD-3176-2024"
    }
  },
  {
    "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
    "valueCoding" : {
      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
      "code" : "QD-697-2026"
    }
  },
  {
    "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis",
    "valueCoding" : {
      "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs",
      "code" : "TT-12-2026-BTC"
    }
  }],
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
  "version" : "0.5.0",
  "name" : "VNCoreClaim",
  "title" : "Yêu cầu thanh toán KCB VN Core — VN Core Claim 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 Claim cho Việt Nam. Dùng cho yêu cầu thanh toán chi phí khám chữa bệnh BHYT.\nMapping từ chuẩn dữ liệu đầu ra phục vụ BHXH hiện hành (QĐ 130 → QĐ 4750 → QĐ 3176).\nBảng kê chi phí theo QĐ 697/QĐ-BYT (19/3/2026) — 12 danh mục, 14 mã.\nCăn cứ:\n- QĐ 130/QĐ-BYT (2023) — Chuẩn dữ liệu đầu ra phục vụ BHXH\n- QĐ 4750/QĐ-BYT (2023) — Sửa đổi QĐ 130\n- QĐ 3176/QĐ-BYT (29/10/2024) — Sửa đổi QĐ 4750\n- QĐ 697/QĐ-BYT (19/3/2026) — Mẫu bảng kê chi phí KCB (thay QĐ 6556)\n- NĐ 188/2025/NĐ-CP — ban hành 01/07/2025, hiệu lực 15/08/2025 — Hướng dẫn thi hành Luật BHYT, Điều 15 về giá trị sử dụng thẻ và Điều 22 về nhiều thẻ 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 vi phạm hành chính trong lĩnh vực y tế khi hồ sơ/chứng từ BHYT sai quy định\n- Luật BHYT 2008 sửa đổi 2014\n- Luật 25/2008/QH12 ngày 14/11/2008 về BHYT; Luật 51/2024/QH15 ngày 27/11/2024 sửa đổi Luật BHYT\nNguồn TVPL: NĐ 188/2025/NĐ-CP https://thuvienphapluat.vn/van-ban/Bao-hiem/Nghi-dinh-188-2025-ND-CP-huong-dan-Luat-Bao-hiem-y-te-641049.aspx; NĐ 90/2026/NĐ-CP https://thuvienphapluat.vn/van-ban/Vi-pham-hanh-chinh/Nghi-dinh-sua-doi-Nghi-dinh-117-2020-ND-CP-xu-phat-vi-pham-hanh-chinh-trong-linh-vuc-y-te-639959.aspx",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "copyright" : "Căn cứ pháp lý Việt Nam: Luật 25/2008/QH12 ngày 14/11/2008; Luật 51/2024/QH15 ngày 27/11/2024; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025; NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective); QĐ 3176/QĐ-BYT ngày 29/10/2024; QĐ 697/QĐ-BYT ngày 19/03/2026.",
  "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" : "Claim",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Claim",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Claim",
      "path" : "Claim",
      "constraint" : [{
        "key" : "vn-claim-single-focal-insurance",
        "severity" : "error",
        "human" : "Phải có đúng 1 thẻ BHYT chính (focal=true). Các thẻ bổ trợ dùng focal=false — per QĐ 697/QĐ-BYT ngày 19/03/2026 cột 13, NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025, Đ22; sai hồ sơ/chứng từ BHYT có thể bị xử phạt theo NĐ 90/2026/NĐ-CP (ban hành 30/03/2026, hiệu lực 15/05/2026 — future-effective)",
        "expression" : "insurance.where(focal = true).count() = 1",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim"
      },
      {
        "key" : "vn-claim-coverage-not-expired",
        "severity" : "warning",
        "human" : "Cảnh báo: thẻ BHYT focal có thể đã hết hạn tại thời điểm tạo Claim — per NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025, Đ15",
        "expression" : "insurance.where(focal = true).coverage.resolve().period.end.all($this >= %resource.created)",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim"
      }]
    },
    {
      "id" : "Claim.meta",
      "path" : "Claim.meta",
      "comment" : "Hồ sơ Claim gửi BHXH cần đi kèm Provenance + chữ ký số (TT 12/2026/TT-BTC Đ2).",
      "requirements" : "Khi gửi hồ sơ thanh toán BHYT điện tử cho cơ quan BHXH theo TT 12/2026/TT-BTC Điều 2, bên gửi PHẢI kèm Provenance resource có Provenance.signature là chữ ký số hợp lệ của người có thẩm quyền tại cơ sở KCB (per NĐ 137/2024/NĐ-CP và NĐ 164/2025/NĐ-CP). Profile này không enforce constraint qua invariant — đây là policy ở lớp workflow/transport, có thể được kiểm tra ở Bundle, Task, hoặc API gateway."
    },
    {
      "id" : "Claim.extension",
      "path" : "Claim.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Claim.extension:costSummary",
      "path" : "Claim.extension",
      "sliceName" : "costSummary",
      "short" : "Tổng chi phí theo nhóm: thuốc, VTYT, BHYT, tự trả, cùng chi trả, nguồn khác",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-cost-summary"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Claim.extension:paymentPeriod",
      "path" : "Claim.extension",
      "sliceName" : "paymentPeriod",
      "short" : "Kỳ thanh toán BHYT (năm/tháng) — NAM_QT, THANG_QT",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-payment-period"]
      }]
    },
    {
      "id" : "Claim.extension:paymentMethod",
      "path" : "Claim.extension",
      "sliceName" : "paymentMethod",
      "short" : "Phương thức thanh toán (FFS/Capitation/DRG) — MA_PTTT_QT",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-method"]
      }]
    },
    {
      "id" : "Claim.identifier",
      "path" : "Claim.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "description" : "Phân loại identifier hồ sơ thanh toán theo hệ thống",
        "rules" : "open"
      },
      "short" : "Định danh hồ sơ thanh toán, bao gồm MA_LK",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Claim.identifier:MALK",
      "path" : "Claim.identifier",
      "sliceName" : "MALK",
      "short" : "Mã liên kết hồ sơ (MA_LK)",
      "definition" : "Khóa liên kết hồ sơ dùng chung cho toàn bộ dữ liệu của cùng một đợt KCB khi gửi cơ quan BHXH",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Claim.identifier:MALK.type",
      "path" : "Claim.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "MA_LK"
        }]
      }
    },
    {
      "id" : "Claim.identifier:MALK.system",
      "path" : "Claim.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/ma-lk"
    },
    {
      "id" : "Claim.identifier:MALK.value",
      "path" : "Claim.identifier.value",
      "short" : "Giá trị MA_LK",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Claim.status",
      "path" : "Claim.status",
      "short" : "Trạng thái yêu cầu thanh toán",
      "mustSupport" : true
    },
    {
      "id" : "Claim.type",
      "path" : "Claim.type",
      "short" : "Loại yêu cầu: institutional (nội trú), professional (ngoại trú)",
      "definition" : "Loại yêu cầu theo semantics chuẩn FHIR. Không dùng Claim.type để chứa MA_LOAI_KCB; MA_LOAI_KCB thuộc VNCoreEncounter.type.",
      "mustSupport" : true
    },
    {
      "id" : "Claim.subType",
      "path" : "Claim.subType",
      "short" : "Mã đối tượng đến KCB (MA_DOITUONG_KCB per QĐ 3276/QĐ-BYT)",
      "definition" : "Phân loại đối tượng đến KCB: KCB BHYT đúng tuyến (1.x), cấp cứu (2), trái tuyến (3.x), lĩnh thuốc (7.x), thu hồi (8), không BHYT (9). 27 mã per QĐ 3276/QĐ-BYT (17/10/2025), Phụ lục 1. Không populate trường này từ Coverage.extension[bhytCardType] vì nhóm thẻ BHYT khác nghĩa với đối tượng/lý do đến KCB.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-patient-visit-type-vs"
      }
    },
    {
      "id" : "Claim.use",
      "path" : "Claim.use",
      "short" : "Mục đích: claim (thanh toán) | preauthorization | predetermination",
      "mustSupport" : true
    },
    {
      "id" : "Claim.patient",
      "path" : "Claim.patient",
      "short" : "Bệnh nhân (XML 3176: MA_BN)",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Claim.created",
      "path" : "Claim.created",
      "short" : "Ngày tạo yêu cầu",
      "mustSupport" : true
    },
    {
      "id" : "Claim.insurer",
      "path" : "Claim.insurer",
      "short" : "Cơ quan BHXH thanh toán",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Claim.provider",
      "path" : "Claim.provider",
      "short" : "Cơ sở KCB thực hiện (XML 3176: MA_CSKCB)",
      "definition" : "Cơ sở hoặc người cung cấp dịch vụ cho hồ sơ thanh toán. Khi map MA_CSKCB, dùng Organization/Provider thực hiện lượt KCB; không fallback sang Coverage.extension[primaryCareFacility] vì đó là nơi đăng ký KCB ban đầu MA_DKBD trên thẻ.",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Claim.priority",
      "path" : "Claim.priority",
      "short" : "Mức ưu tiên xử lý",
      "definition" : "FHIR base yêu cầu Claim.priority. Trong đa số hồ sơ BHYT tại Việt Nam có thể dùng giá trị `normal`; chỉ dùng giá trị khác khi quy trình xử lý nghiệp vụ thật sự yêu cầu."
    },
    {
      "id" : "Claim.diagnosis",
      "path" : "Claim.diagnosis",
      "short" : "Chẩn đoán — ICD-10 VN (XML 3176: MA_BENH, MA_BENHKHAC)",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Claim.diagnosis.sequence",
      "path" : "Claim.diagnosis.sequence",
      "mustSupport" : true
    },
    {
      "id" : "Claim.diagnosis.diagnosis[x]",
      "path" : "Claim.diagnosis.diagnosis[x]",
      "slicing" : {
        "discriminator" : [{
          "type" : "type",
          "path" : "$this"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Claim.diagnosis.diagnosis[x]:diagnosisCodeableConcept",
      "path" : "Claim.diagnosis.diagnosis[x]",
      "sliceName" : "diagnosisCodeableConcept",
      "short" : "Mã bệnh ICD-10 VN (QĐ 4469/QĐ-BYT)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }],
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-condition-code-vs"
      }
    },
    {
      "id" : "Claim.diagnosis.type",
      "path" : "Claim.diagnosis.type",
      "short" : "Loại chẩn đoán (chính/phụ)",
      "mustSupport" : true
    },
    {
      "id" : "Claim.procedure",
      "path" : "Claim.procedure",
      "short" : "Thủ thuật/phẫu thuật — ICD-9-CM (XML 3176: MA_PTTT)"
    },
    {
      "id" : "Claim.procedure.procedure[x]",
      "path" : "Claim.procedure.procedure[x]",
      "slicing" : {
        "discriminator" : [{
          "type" : "type",
          "path" : "$this"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Claim.procedure.procedure[x]:procedureCodeableConcept",
      "path" : "Claim.procedure.procedure[x]",
      "sliceName" : "procedureCodeableConcept",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "CodeableConcept"
      }],
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-procedure-code-vs"
      }
    },
    {
      "id" : "Claim.insurance",
      "path" : "Claim.insurance",
      "short" : "Thông tin BHYT (XML 3176: MA_THE)",
      "mustSupport" : true
    },
    {
      "id" : "Claim.insurance.focal",
      "path" : "Claim.insurance.focal",
      "mustSupport" : true
    },
    {
      "id" : "Claim.insurance.coverage",
      "path" : "Claim.insurance.coverage",
      "short" : "Thẻ BHYT (Coverage)",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Claim.accident",
      "path" : "Claim.accident",
      "short" : "Thông tin tai nạn thương tích"
    },
    {
      "id" : "Claim.accident.type",
      "path" : "Claim.accident.type",
      "short" : "Loại tai nạn (MA_TAI_NAN per QĐ 3176, Bảng 8)",
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-accident-type-vs"
      }
    },
    {
      "id" : "Claim.item",
      "path" : "Claim.item",
      "short" : "Chi tiết chi phí — 12 nhóm per QĐ 697/QĐ-BYT (bắt buộc ít nhất 1 dòng)",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Claim.item.extension",
      "path" : "Claim.item.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Claim.item.extension:department",
      "path" : "Claim.item.extension",
      "sliceName" : "department",
      "short" : "Khoa thực hiện (MA_KHOA)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-claim-item-department"]
      }]
    },
    {
      "id" : "Claim.item.extension:deviceGroup",
      "path" : "Claim.item.extension",
      "sliceName" : "deviceGroup",
      "short" : "Nhóm TBYT BHYT N01-N09 cho dòng chi phí thiết bị/vật tư",
      "definition" : "Dùng khi Claim.item biểu diễn thiết bị/vật tư y tế trong XML3 hoặc bảng kê chi phí. Đây là vị trí ưu tiên cho nhóm TBYT BHYT N01-N09; không dùng Device.type để biểu diễn nhóm thanh toán này.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-device-group"]
      }]
    },
    {
      "id" : "Claim.item.extension:deviceInsuranceScope",
      "path" : "Claim.item.extension",
      "sliceName" : "deviceInsuranceScope",
      "short" : "Legacy PHAM_VI cho dòng TBYT; dữ liệu mới ưu tiên insuranceCostInfo.scope",
      "definition" : "Slice tương thích cho PHAM_VI VTYT legacy trong XML3. Khi tạo dữ liệu mới, dùng Claim.item.extension[insuranceCostInfo].extension[scope] để biểu diễn phạm vi BHYT thống nhất cho mọi dòng chi phí.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-device-insurance-scope"]
      }]
    },
    {
      "id" : "Claim.item.extension:insuranceCostInfo",
      "path" : "Claim.item.extension",
      "sliceName" : "insuranceCostInfo",
      "short" : "BHYT: phạm vi, tỷ lệ TT, mức hưởng",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-insurance-cost-info"]
      }]
    },
    {
      "id" : "Claim.item.extension:paymentSource",
      "path" : "Claim.item.extension",
      "sliceName" : "paymentSource",
      "short" : "Nguồn chi trả dòng chi phí (NGUON_CTRA)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-payment-source"]
      }]
    },
    {
      "id" : "Claim.item.extension:recurrentWoundBenefit",
      "path" : "Claim.item.extension",
      "sliceName" : "recurrentWoundBenefit",
      "short" : "Flag VET_THUONG_TP cho dòng thuốc/DVKT/VTYT",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-recurrent-wound-benefit"]
      }]
    },
    {
      "id" : "Claim.item.extension:tenderInfo",
      "path" : "Claim.item.extension",
      "sliceName" : "tenderInfo",
      "short" : "Thông tin thầu dòng chi phí (TT_THAU)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-tender-info"]
      }]
    },
    {
      "id" : "Claim.item.extension:processingMethod",
      "path" : "Claim.item.extension",
      "sliceName" : "processingMethod",
      "short" : "Phương pháp chế biến YHCT (MA_PP_CHEBIEN)",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-traditional-processing-method"]
      }]
    },
    {
      "id" : "Claim.item.sequence",
      "path" : "Claim.item.sequence",
      "mustSupport" : true
    },
    {
      "id" : "Claim.item.category",
      "path" : "Claim.item.category",
      "short" : "Nhóm chi phí: khám, giường, XN, CĐHA, thuốc, TBYT... (QĐ 697)",
      "mustSupport" : true,
      "binding" : {
        "strength" : "extensible",
        "valueSet" : "http://fhir.hl7.org.vn/core/ValueSet/vn-cost-category-vs"
      }
    },
    {
      "id" : "Claim.item.productOrService",
      "path" : "Claim.item.productOrService",
      "short" : "Mã dịch vụ/thuốc/TBYT",
      "mustSupport" : true
    },
    {
      "id" : "Claim.item.quantity",
      "path" : "Claim.item.quantity",
      "short" : "Số lượng"
    },
    {
      "id" : "Claim.item.unitPrice",
      "path" : "Claim.item.unitPrice",
      "short" : "Đơn giá"
    },
    {
      "id" : "Claim.item.net",
      "path" : "Claim.item.net",
      "short" : "Thành tiền",
      "mustSupport" : true
    },
    {
      "id" : "Claim.total",
      "path" : "Claim.total",
      "short" : "Tổng chi phí (XML 3176: T_TONGCHI)",
      "mustSupport" : true
    }]
  }
}

```
