# Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile 

 
Profile Bundle cho Việt Nam — gói trao đổi dữ liệu FHIR phục vụ liên thông y tế. Hỗ trợ các use case: gửi dữ liệu BHXH (transaction), phản hồi tìm kiếm (searchset), bệnh án điện tử trọn bộ (document), và tập hợp resources (collection). Căn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 3176/QĐ-BYT (dữ liệu BHXH), NĐ 164/2025/NĐ-CP (giao dịch điện tử BHXH). 

**Usages:**

* Derived from this Profile: [Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle](StructureDefinition-vn-core-bhyt-submission-bundle.md)
* Examples for this Profile: [Bundle/ExampleBundleEPrescription](Bundle-ExampleBundleEPrescription.md), [Bundle/ExampleBundleInpatientDischarge](Bundle-ExampleBundleInpatientDischarge.md), [Bundle/ExampleBundleLabOrderResult](Bundle-ExampleBundleLabOrderResult.md), [Bundle/ExampleBundleOutpatientBHYT](Bundle-ExampleBundleOutpatientBHYT.md)... Show 2 more, [Bundle/ExampleBundleReferralUpward](Bundle-ExampleBundleReferralUpward.md) and [Bundle/ExampleBundleYHCTFullVisit](Bundle-ExampleBundleYHCTFullVisit.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-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 **

Must-Support: 3 elements

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

#### Terminology Bindings

#### Constraints

 **Dạng xem Differential** 

#### Constraints

 **Dạng xem SnapshotView** 

#### Terminology Bindings

#### Constraints

** Summary **

Must-Support: 3 elements

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-bundle",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle",
  "version" : "0.5.0",
  "name" : "VNCoreBundle",
  "title" : "Gói trao đổi dữ liệu VN Core — VN Core Bundle Profile",
  "status" : "draft",
  "date" : "2026-03-22",
  "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 cho Việt Nam — gói trao đổi dữ liệu FHIR phục vụ liên thông y tế.\nHỗ trợ các use case: gửi dữ liệu BHXH (transaction), phản hồi tìm kiếm (searchset),\nbệnh án điện tử trọn bộ (document), và tập hợp resources (collection).\nCăn cứ: TT 13/2025/TT-BYT (bệnh án điện tử), QĐ 3176/QĐ-BYT (dữ liệu BHXH),\nNĐ 164/2025/NĐ-CP (giao dịch điện tử BHXH).",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "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://hl7.org/fhir/StructureDefinition/Bundle",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Bundle",
      "path" : "Bundle",
      "constraint" : [{
        "key" : "vn-bundle-document-first",
        "severity" : "error",
        "human" : "Bundle type 'document' phải có Composition là entry đầu tiên (per FHIR Bundle spec)",
        "expression" : "type = 'document' implies entry.first().resource.is(Composition)",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle"
      }]
    },
    {
      "id" : "Bundle.type",
      "path" : "Bundle.type",
      "short" : "Loại Bundle",
      "definition" : "document (bệnh án điện tử), transaction (gửi BHXH), searchset (kết quả tìm kiếm), collection (tập hợp).",
      "mustSupport" : true
    },
    {
      "id" : "Bundle.timestamp",
      "path" : "Bundle.timestamp",
      "short" : "Thời điểm tạo",
      "definition" : "Thời điểm tạo Bundle. Per NĐ 137/2024/NĐ-CP — yêu cầu audit trail cho giao dịch điện tử.",
      "mustSupport" : true
    },
    {
      "id" : "Bundle.entry",
      "path" : "Bundle.entry",
      "short" : "Danh sách resources",
      "definition" : "Các FHIR resource trong Bundle — phải tuân thủ VN Core profiles tương ứng.",
      "mustSupport" : true
    },
    {
      "id" : "Bundle.entry.fullUrl",
      "path" : "Bundle.entry.fullUrl",
      "short" : "URL đầy đủ",
      "definition" : "URL duy nhất định danh resource. Nên dùng canonical URL hoặc UUID."
    },
    {
      "id" : "Bundle.entry.resource",
      "path" : "Bundle.entry.resource",
      "short" : "Resource FHIR"
    }]
  }
}

```
