# Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle 

 
Profile Bundle chuyên dùng cho gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH. Bundle này thuộc lớp liên thông hồ sơ thanh toán BHYT, tách biệt với các Bundle FHIR nội bộ. Căn cứ: 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; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025 hướng dẫn Luật BHYT; QĐ 3176/QĐ-BYT ngày 29/10/2024 về chuẩn dữ liệu đầu ra KCB; QĐ 697/QĐ-BYT ngày 19/03/2026 về mẫu bảng kê chi phí KCB. 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 

**Usages:**

* Examples for this Profile: [Bundle/ExampleBHYTSubmissionDeathCertificate](Bundle-ExampleBHYTSubmissionDeathCertificate.md), [Bundle/ExampleBHYTSubmissionEmergencyUnknownIdentity](Bundle-ExampleBHYTSubmissionEmergencyUnknownIdentity.md), [Bundle/ExampleBHYTSubmissionHIV](Bundle-ExampleBHYTSubmissionHIV.md), [Bundle/ExampleBHYTSubmissionInpatient](Bundle-ExampleBHYTSubmissionInpatient.md)... Show 5 more, [Bundle/ExampleBHYTSubmissionMultiCoverage](Bundle-ExampleBHYTSubmissionMultiCoverage.md), [Bundle/ExampleBHYTSubmissionNewborn](Bundle-ExampleBHYTSubmissionNewborn.md), [Bundle/ExampleBHYTSubmissionOutpatient](Bundle-ExampleBHYTSubmissionOutpatient.md), [Bundle/ExampleBHYTSubmissionRecurrentWound](Bundle-ExampleBHYTSubmissionRecurrentWound.md) and [Bundle/ExampleBHYTSubmissionYHCT](Bundle-ExampleBHYTSubmissionYHCT.md)
* CapabilityStatements using this Profile: [VN Core BHYT Gateway Server CapabilityStatement](CapabilityStatement-vn-core-bhyt-gateway-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-bhyt-submission-bundle)

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

#### Constraints

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 6 elements
 Must-Support: 3 elements
 Fixed: 1 element

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

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Constraints

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Mandatory: 6 elements
 Must-Support: 3 elements
 Fixed: 1 element

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-bhyt-submission-bundle",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
  "version" : "0.5.0",
  "name" : "VNCoreBHYTSubmissionBundle",
  "title" : "Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle",
  "status" : "draft",
  "date" : "2026-03-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" : "Profile Bundle chuyên dùng cho gửi hồ sơ thanh toán BHYT lên Cổng giám định BHXH. Bundle này thuộc lớp liên thông hồ sơ thanh toán BHYT, tách biệt với các Bundle FHIR nội bộ.\nCăn cứ: 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; NĐ 188/2025/NĐ-CP ban hành 01/07/2025, hiệu lực 15/08/2025 hướng dẫn Luật BHYT; QĐ 3176/QĐ-BYT ngày 29/10/2024 về chuẩn dữ liệu đầu ra KCB; QĐ 697/QĐ-BYT ngày 19/03/2026 về mẫu bảng kê chi phí KCB.\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",
  "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; QĐ 3176/QĐ-BYT ngày 29/10/2024; QĐ 697/QĐ-BYT ngày 19/03/2026.",
  "fhirVersion" : "4.0.1",
  "mapping" : [{
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "cda",
    "uri" : "http://hl7.org/v3/cda",
    "name" : "CDA (R2)"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Bundle",
  "baseDefinition" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Bundle",
      "path" : "Bundle",
      "constraint" : [{
        "key" : "vn-bhyt-submission-has-claim",
        "severity" : "error",
        "human" : "Bundle hồ sơ thanh toán BHYT phải chứa ít nhất một Claim để biểu diễn chi phí/yêu cầu thanh toán từ chuẩn dữ liệu QĐ 3176/QĐ-BYT và bảng kê QĐ 697/QĐ-BYT",
        "expression" : "entry.resource.ofType(Claim).exists()",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle"
      },
      {
        "key" : "vn-bhyt-submission-has-patient",
        "severity" : "error",
        "human" : "Bundle hồ sơ thanh toán BHYT phải chứa ít nhất một Patient để biểu diễn nhóm thông tin người bệnh trong QĐ 3176/QĐ-BYT và hồ sơ bệnh án điện tử theo TT 13/2025/TT-BYT",
        "expression" : "entry.resource.ofType(Patient).exists()",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle"
      },
      {
        "key" : "vn-bhyt-submission-has-coverage",
        "severity" : "error",
        "human" : "Bundle hồ sơ thanh toán BHYT phải chứa ít nhất một Coverage để biểu diễn quyền lợi/thẻ BHYT theo Luật BHYT, NĐ 188/2025/NĐ-CP và các trường thẻ trong QĐ 3176/QĐ-BYT",
        "expression" : "entry.resource.ofType(Coverage).exists()",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle"
      }]
    },
    {
      "id" : "Bundle.identifier",
      "path" : "Bundle.identifier",
      "short" : "MA_LK của hồ sơ thanh toán BHYT",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Bundle.identifier.type",
      "path" : "Bundle.identifier.type",
      "patternCodeableConcept" : {
        "coding" : [{
          "system" : "http://fhir.hl7.org.vn/core/CodeSystem/vn-identifier-type-cs",
          "code" : "MA_LK"
        }]
      }
    },
    {
      "id" : "Bundle.identifier.system",
      "path" : "Bundle.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/ma-lk"
    },
    {
      "id" : "Bundle.identifier.value",
      "path" : "Bundle.identifier.value",
      "short" : "Giá trị MA_LK",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Bundle.type",
      "path" : "Bundle.type",
      "short" : "Bundle hồ sơ thanh toán BHYT",
      "patternCode" : "collection"
    },
    {
      "id" : "Bundle.timestamp",
      "path" : "Bundle.timestamp",
      "short" : "Thời điểm đóng gói bundle hồ sơ thanh toán",
      "min" : 1
    },
    {
      "id" : "Bundle.entry",
      "path" : "Bundle.entry",
      "short" : "Danh sách tài nguyên phục vụ hồ sơ BHYT",
      "min" : 1
    },
    {
      "id" : "Bundle.entry.resource",
      "path" : "Bundle.entry.resource",
      "min" : 1,
      "mustSupport" : true
    }]
  }
}

```
