# Thẻ BHYT VN Core — VN Core Coverage Profile - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## Hồ sơ tài nguyên: Thẻ BHYT VN Core — VN Core Coverage Profile 

 
Profile Coverage đại diện thẻ bảo hiểm y tế Việt Nam. Bao gồm extensions loại đối tượng BHYT và nơi ĐKKCB ban đầu, hỗ trợ cả 3 format số thẻ. Căn cứ: 
* **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 thi hành Luật BHYT, quyền lợi và định danh thẻ BHYT
* **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH
* **QĐ 130/QĐ-BYT** — 18/01/2023; **QĐ 4750/QĐ-BYT** — 29/12/2023; **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH
* Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.
 

**Usages:**

* Refer to this Profile: [Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile](StructureDefinition-vn-core-claim.md), [Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile](StructureDefinition-vn-core-explanation-of-benefit.md), [Đơn thuốc VN Core — VN Core MedicationRequest Profile](StructureDefinition-vn-core-medication-request.md) and [Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile](StructureDefinition-vn-core-service-request.md)
* Examples for this Profile: [Coverage/ExampleCoverageBHYTDependent](Coverage-ExampleCoverageBHYTDependent.md), [Coverage/ExampleCoverageBHYTExpired](Coverage-ExampleCoverageBHYTExpired.md), [Coverage/ExampleCoverageBHYTGuardianLinked](Coverage-ExampleCoverageBHYTGuardianLinked.md), [Coverage/ExampleCoverageBHYTLegacy](Coverage-ExampleCoverageBHYTLegacy.md) and [Coverage/ExampleCoverageBHYTNew](Coverage-ExampleCoverageBHYTNew.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), [VN Core Citizen App Client CapabilityStatement](CapabilityStatement-vn-core-citizen-app-client.md), [VN Core EMR Server CapabilityStatement](CapabilityStatement-vn-core-emr-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-coverage)

### 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: 5 elements(2 nested mandatory elements)
 Must-Support: 16 elements
 Fixed: 3 elements

**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)
* [Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson)](StructureDefinition-vn-core-relatedperson.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type](StructureDefinition-vn-ext-bhyt-card-type.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-primary-care-facility](StructureDefinition-vn-ext-primary-care-facility.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-cumulative-copay](StructureDefinition-vn-ext-coverage-cumulative-copay.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 Coverage.identifier
* The element 1 is sliced based on the values of Coverage.type.coding

 **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: 5 elements(2 nested mandatory elements)
 Must-Support: 16 elements
 Fixed: 3 elements

**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)
* [Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson)](StructureDefinition-vn-core-relatedperson.md)

**Extensions**

This structure refers to these extensions:

* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type](StructureDefinition-vn-ext-bhyt-card-type.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-primary-care-facility](StructureDefinition-vn-ext-primary-care-facility.md)
* [http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-cumulative-copay](StructureDefinition-vn-ext-coverage-cumulative-copay.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 Coverage.identifier
* The element 1 is sliced based on the values of Coverage.type.coding

 

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



## Resource Content

```json
{
  "resourceType" : "StructureDefinition",
  "id" : "vn-core-coverage",
  "url" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
  "version" : "0.5.0",
  "name" : "VNCoreCoverage",
  "title" : "Thẻ BHYT VN Core — VN Core Coverage Profile",
  "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 Coverage đại diện thẻ bảo hiểm y tế Việt Nam. Bao gồm extensions\nloại đối tượng BHYT và nơi ĐKKCB ban đầu, hỗ trợ cả 3 format số thẻ.\nCăn cứ:\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 thi hành Luật BHYT, quyền lợi và định danh thẻ BHYT\n- **NĐ 164/2025/NĐ-CP** — 29/6/2025 — giao dịch điện tử trong lĩnh vực BHXH\n- **QĐ 130/QĐ-BYT** — 18/01/2023; **QĐ 4750/QĐ-BYT** — 29/12/2023; **QĐ 3176/QĐ-BYT** — 29/10/2024 — chuẩn dữ liệu KCB phục vụ BHXH\n- Luật BHYT 2008 sửa đổi 2014 — nền tảng lịch sử.",
  "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" : "rim",
    "uri" : "http://hl7.org/v3",
    "name" : "RIM Mapping"
  },
  {
    "identity" : "w5",
    "uri" : "http://hl7.org/fhir/fivews",
    "name" : "FiveWs Pattern Mapping"
  },
  {
    "identity" : "cdanetv4",
    "uri" : "http://www.cda-adc.ca/en/services/cdanet/",
    "name" : "Canadian Dental Association eclaims standard"
  },
  {
    "identity" : "v2",
    "uri" : "http://hl7.org/v2",
    "name" : "HL7 v2 Mapping"
  },
  {
    "identity" : "cpha3pharm",
    "uri" : "http://www.pharmacists.ca/",
    "name" : "Canadian Pharmacy Associaiton eclaims standard"
  }],
  "kind" : "resource",
  "abstract" : false,
  "type" : "Coverage",
  "baseDefinition" : "http://hl7.org/fhir/StructureDefinition/Coverage",
  "derivation" : "constraint",
  "differential" : {
    "element" : [{
      "id" : "Coverage",
      "path" : "Coverage",
      "constraint" : [{
        "key" : "vn-coverage-subscriberid-consistency",
        "severity" : "error",
        "human" : "Nếu đồng thời dùng subscriberId và identifier[BHYT] thì hai giá trị phải trùng nhau",
        "expression" : "subscriberId.empty() or identifier.where(system='http://fhir.hl7.org.vn/core/sid/bhyt').empty() or subscriberId = identifier.where(system='http://fhir.hl7.org.vn/core/sid/bhyt').first().value",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"
      }]
    },
    {
      "id" : "Coverage.extension",
      "path" : "Coverage.extension",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "url"
        }],
        "ordered" : false,
        "rules" : "open"
      }
    },
    {
      "id" : "Coverage.extension:bhytCardType",
      "path" : "Coverage.extension",
      "sliceName" : "bhytCardType",
      "short" : "Loại đối tượng BHYT (DN, HC, HN, TE...)",
      "definition" : "Nhóm thẻ/người tham gia BHYT lấy từ mã thẻ. Không dùng extension này để biểu diễn MA_DOITUONG_KCB; mã đối tượng đến KCB thuộc Claim.subType.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-bhyt-card-type"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Coverage.extension:primaryCareFacility",
      "path" : "Coverage.extension",
      "sliceName" : "primaryCareFacility",
      "short" : "Nơi ĐKKCB ban đầu (MA_DKBD)",
      "definition" : "Cơ sở đăng ký khám chữa bệnh ban đầu ghi trên thẻ BHYT. Không dùng extension này để biểu diễn MA_CSKCB của lượt khám thực tế; MA_CSKCB thuộc Encounter.serviceProvider hoặc Claim.provider.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-primary-care-facility"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Coverage.extension:cumulativeCopay",
      "path" : "Coverage.extension",
      "sliceName" : "cumulativeCopay",
      "short" : "Tổng cùng chi trả lũy kế trong năm (NĐ 188/2025/NĐ-CP Đ10)",
      "definition" : "Tổng số tiền cùng chi trả BHYT lũy kế trong năm dương lịch. Dùng để xác định trần cùng chi trả theo NĐ 188/2025/NĐ-CP Điều 10.",
      "min" : 0,
      "max" : "1",
      "type" : [{
        "code" : "Extension",
        "profile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-coverage-cumulative-copay"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Coverage.identifier",
      "path" : "Coverage.identifier",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "rules" : "open"
      },
      "mustSupport" : true
    },
    {
      "id" : "Coverage.identifier:BHYT",
      "path" : "Coverage.identifier",
      "sliceName" : "BHYT",
      "min" : 0,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Coverage.identifier:BHYT.system",
      "path" : "Coverage.identifier.system",
      "min" : 1,
      "fixedUri" : "http://fhir.hl7.org.vn/core/sid/bhyt"
    },
    {
      "id" : "Coverage.identifier:BHYT.value",
      "path" : "Coverage.identifier.value",
      "short" : "Số thẻ BHYT",
      "definition" : "Số thẻ BHYT hỗ trợ 3 format: 12 số (CCCD — hỗ trợ từ 15/8/2025 per NĐ 188/2025/NĐ-CP, hiện duy trì song song với các format cũ), 10 số (mã BHXH, từ 01/4/2021), hoặc 15 ký tự (legacy). Bên triển khai cần xác minh chính sách BHXH hiện hành trước khi coi CCCD là mã BHYT duy nhất; quyền lợi BHYT chịu tác động bởi Luật 51/2024/QH15",
      "min" : 1,
      "constraint" : [{
        "key" : "vn-bhyt-format",
        "severity" : "warning",
        "human" : "Số thẻ BHYT phải theo 1 trong 3 format: (1) 12 chữ số = CCCD (hỗ trợ từ 15/8/2025 per NĐ 188/2025), (2) 10 chữ số = mã BHXH (từ 01/4/2021), (3) 15 ký tự = 2 chữ + 13 số format cũ (trước 2021). Cả 3 format đều được chấp nhận song song",
        "expression" : "$this.empty() or $this.matches('^[0-9]{12}$') or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"
      }]
    },
    {
      "id" : "Coverage.status",
      "path" : "Coverage.status",
      "short" : "Trạng thái thẻ (active, cancelled)",
      "mustSupport" : true
    },
    {
      "id" : "Coverage.type",
      "path" : "Coverage.type",
      "short" : "Loại coverage theo ngữ nghĩa chuẩn FHIR",
      "definition" : "Biểu diễn loại coverage theo ngữ nghĩa chuẩn FHIR. Với hồ sơ thẻ bảo hiểm y tế Việt Nam, dùng mã chuẩn `medical` từ hệ `insurance-coverage-type`. Không dùng `Coverage.type` để mang trường `NGUON_CTRA`; thông tin nguồn chi trả được mô hình hóa ở lớp Claim, ExplanationOfBenefit và các extension tổng hợp chi phí.",
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Coverage.type.coding",
      "path" : "Coverage.type.coding",
      "slicing" : {
        "discriminator" : [{
          "type" : "value",
          "path" : "system"
        }],
        "rules" : "open"
      },
      "min" : 1,
      "mustSupport" : true
    },
    {
      "id" : "Coverage.type.coding:coverageCategory",
      "path" : "Coverage.type.coding",
      "sliceName" : "coverageCategory",
      "min" : 1,
      "max" : "1",
      "mustSupport" : true
    },
    {
      "id" : "Coverage.type.coding:coverageCategory.system",
      "path" : "Coverage.type.coding.system",
      "min" : 1,
      "fixedUri" : "http://terminology.hl7.org/CodeSystem/insurance-coverage-type"
    },
    {
      "id" : "Coverage.type.coding:coverageCategory.code",
      "path" : "Coverage.type.coding.code",
      "min" : 1,
      "fixedCode" : "medical"
    },
    {
      "id" : "Coverage.type.text",
      "path" : "Coverage.type.text",
      "short" : "Tên hiển thị tiếng Việt của loại coverage"
    },
    {
      "id" : "Coverage.subscriber",
      "path" : "Coverage.subscriber",
      "short" : "Người đứng tên/đối tượng subscriber theo Coverage",
      "definition" : "Giữ semantics chuẩn FHIR. Với thẻ BHYT gắn trực tiếp cho người bệnh thì subscriber có thể chính là beneficiary. Với hồ sơ phụ thuộc hoặc đại diện hợp pháp có thể tham chiếu VNCoreRelatedPerson.",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
        "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Coverage.subscriberId",
      "path" : "Coverage.subscriberId",
      "short" : "Số thẻ BHYT (deprecated — dùng identifier[BHYT])",
      "definition" : "Trường này giữ lại cho backward-compatible. Hệ thống MỚI nên dùng Coverage.identifier[BHYT]. Nếu cả hai có giá trị, identifier[BHYT].value là authoritative.",
      "constraint" : [{
        "key" : "vn-bhyt-format",
        "severity" : "warning",
        "human" : "Số thẻ BHYT phải theo 1 trong 3 format: (1) 12 chữ số = CCCD (hỗ trợ từ 15/8/2025 per NĐ 188/2025), (2) 10 chữ số = mã BHXH (từ 01/4/2021), (3) 15 ký tự = 2 chữ + 13 số format cũ (trước 2021). Cả 3 format đều được chấp nhận song song",
        "expression" : "$this.empty() or $this.matches('^[0-9]{12}$') or $this.matches('^[0-9]{10}$') or $this.matches('^[A-Z]{2}[0-9]{13}$')",
        "source" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage"
      }]
    },
    {
      "id" : "Coverage.beneficiary",
      "path" : "Coverage.beneficiary",
      "short" : "Người thụ hưởng BHYT",
      "type" : [{
        "code" : "Reference",
        "targetProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient"]
      }],
      "mustSupport" : true
    },
    {
      "id" : "Coverage.relationship",
      "path" : "Coverage.relationship",
      "short" : "Quan hệ giữa beneficiary và subscriber",
      "definition" : "Dùng bộ mã subscriber-relationship chuẩn FHIR để tránh tạo custom code system mới.",
      "mustSupport" : true,
      "binding" : {
        "strength" : "required",
        "valueSet" : "http://terminology.hl7.org/ValueSet/subscriber-relationship"
      }
    },
    {
      "id" : "Coverage.period",
      "path" : "Coverage.period",
      "short" : "Thời hạn thẻ BHYT",
      "mustSupport" : true
    },
    {
      "id" : "Coverage.period.start",
      "path" : "Coverage.period.start",
      "short" : "Ngày bắt đầu hiệu lực",
      "mustSupport" : true
    },
    {
      "id" : "Coverage.period.end",
      "path" : "Coverage.period.end",
      "short" : "Ngày hết hiệu lực",
      "mustSupport" : true
    },
    {
      "id" : "Coverage.payor",
      "path" : "Coverage.payor",
      "short" : "Cơ quan chi trả (BHXH Việt Nam)",
      "mustSupport" : true
    }]
  }
}

```
