| Left: | Thẻ BHYT VN Core — VN Core Coverage Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage) |
| Right: | Thẻ BHYT VN Core — VN Core Coverage Profile (http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage) |
| Error | StructureDefinition.version | Values for version differ: '0.5.0' vs '0.5.1' |
| Information | StructureDefinition.date | Values for date differ: '2026-03-23' vs '2026-05-10' |
| Name | Value | Comments | |
|---|---|---|---|
abstract | false | ||
baseDefinition | http://hl7.org/fhir/StructureDefinition/Coverage | ||
copyright | |||
date | 2026-03-23 | 2026-05-10 |
|
description | 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ử. | ||
experimental | |||
fhirVersion | 4.0.1 | ||
jurisdiction | |||
![]() jurisdiction[0] | urn:iso:std:iso:3166#VN | ||
kind | resource | ||
name | VNCoreCoverage | ||
publisher | Omi HealthTech / VN Core FHIR Community Initiative | ||
purpose | |||
status | draft | ||
title | Thẻ BHYT VN Core — VN Core Coverage Profile | ||
type | Coverage | ||
url | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage | ||
version | 0.5.0 | 0.5.1 |
|
| Name | L Flags | L Card. | L Type | L Description & Constraints | R Flags | R Card. | R Type | R Description & Constraints | Comments![]() | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
![]() | C | 0..* | Coverage | Insurance or medical plan or a payment agreement Constraints: vn-coverage-subscriberid-consistency | C | 0..* | Coverage | Insurance or medical plan or a payment agreement Constraints: vn-coverage-subscriberid-consistency | |||||||||
![]() ![]() | Σ | 0..1 | id | Logical id of this artifact | Σ | 0..1 | id | Logical id of this artifact | |||||||||
![]() ![]() | Σ | 0..1 | Meta | Metadata about the resource | Σ | 0..1 | Meta | Metadata about the resource | |||||||||
![]() ![]() | ?!Σ | 0..1 | uri | A set of rules under which this content was created | ?!Σ | 0..1 | uri | A set of rules under which this content was created | |||||||||
![]() ![]() | 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| 0..1 | code | Language of the resource content Binding: ?? (preferred): A human language.
| |||||||||||
![]() ![]() | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | 0..1 | Narrative | Text summary of the resource, for human interpretation This profile does not constrain the narrative in regard to content, language, or traceability to data elements | |||||||||||
![]() ![]() | 0..* | Resource | Contained, inline Resources | 0..* | Resource | Contained, inline Resources | |||||||||||
![]() ![]() | 0..* | Extension | Extension Slice: Unordered, Open by value:url | 0..* | Extension | Extension Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() | ?! | 0..* | Extension | Extensions that cannot be ignored | ?! | 0..* | Extension | Extensions that cannot be ignored | |||||||||
![]() ![]() | SΣ | 0..* | Identifier | Business Identifier for the coverage Slice: Unordered, Open by value:system | SΣ | 0..* | Identifier | Business Identifier for the coverage Slice: Unordered, Open by value:system | |||||||||
![]() ![]() | ?!SΣ | 1..1 | code | Trạng thái thẻ (active, cancelled) Binding: ?? (required): A code specifying the state of the resource instance. | ?!SΣ | 1..1 | code | Trạng thái thẻ (active, cancelled) Binding: ?? (required): A code specifying the state of the resource instance. | |||||||||
![]() ![]() | SΣ | 1..1 | CodeableConcept | Loại coverage theo ngữ nghĩa chuẩn FHIR Binding: ?? (preferred): The type of insurance: public health, worker compensation; private accident, auto, private health, etc.) or a direct payment by an individual or organization. | SΣ | 1..1 | CodeableConcept | Loại coverage theo ngữ nghĩa chuẩn FHIR Binding: ?? (preferred): The type of insurance: public health, worker compensation; private accident, auto, private health, etc.) or a direct payment by an individual or organization. | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() ![]() | SΣ | 1..* | Coding | Code defined by a terminology system Slice: Unordered, Open by value:system | SΣ | 1..* | Coding | Code defined by a terminology system Slice: Unordered, Open by value:system | |||||||||
![]() ![]() ![]() | Σ | 0..1 | string | Tên hiển thị tiếng Việt của loại coverage | Σ | 0..1 | string | Tên hiển thị tiếng Việt của loại coverage | |||||||||
![]() ![]() | Σ | 0..1 | Reference(Patient | RelatedPerson | Organization) | Owner of the policy | Σ | 0..1 | Reference(Patient | RelatedPerson | Organization) | Owner of the policy | |||||||||
![]() ![]() | SΣ | 0..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile) | Người đứng tên/đối tượng subscriber theo Coverage | SΣ | 0..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile | Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile) | Người đứng tên/đối tượng subscriber theo Coverage | |||||||||
![]() ![]() | ΣC | 0..1 | string | Số thẻ BHYT (deprecated — dùng identifier[BHYT]) Constraints: vn-bhyt-format | ΣC | 0..1 | string | Số thẻ BHYT (deprecated — dùng identifier[BHYT]) Constraints: vn-bhyt-format | |||||||||
![]() ![]() | SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Người thụ hưởng BHYT | SΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Người thụ hưởng BHYT | |||||||||
![]() ![]() | Σ | 0..1 | string | Dependent number | Σ | 0..1 | string | Dependent number | |||||||||
![]() ![]() | S | 0..1 | CodeableConcept | Quan hệ giữa beneficiary và subscriber Binding: ?? (required) | S | 0..1 | CodeableConcept | Quan hệ giữa beneficiary và subscriber Binding: ?? (required) | |||||||||
![]() ![]() | SΣ | 0..1 | Period | Thời hạn thẻ BHYT | SΣ | 0..1 | Period | Thời hạn thẻ BHYT | |||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | 0..* | Extension | Additional content defined by implementations Slice: Unordered, Open by value:url | |||||||||||
![]() ![]() ![]() | SΣC | 0..1 | dateTime | Ngày bắt đầu hiệu lực | SΣC | 0..1 | dateTime | Ngày bắt đầu hiệu lực | |||||||||
![]() ![]() ![]() | SΣC | 0..1 | dateTime | Ngày hết hiệu lực | SΣC | 0..1 | dateTime | Ngày hết hiệu lực | |||||||||
![]() ![]() | SΣ | 1..* | Reference(Organization | Patient | RelatedPerson) | Cơ quan chi trả (BHXH Việt Nam) | SΣ | 1..* | Reference(Organization | Patient | RelatedPerson) | Cơ quan chi trả (BHXH Việt Nam) | |||||||||
![]() ![]() | 0..* | BackboneElement | Additional coverage classifications | 0..* | BackboneElement | Additional coverage classifications | |||||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | Σ | 1..1 | CodeableConcept | Type of class such as 'group' or 'plan' Binding: ?? (extensible): The policy classifications, eg. Group, Plan, Class, etc. | Σ | 1..1 | CodeableConcept | Type of class such as 'group' or 'plan' Binding: ?? (extensible): The policy classifications, eg. Group, Plan, Class, etc. | |||||||||
![]() ![]() ![]() | Σ | 1..1 | string | Value associated with the type | Σ | 1..1 | string | Value associated with the type | |||||||||
![]() ![]() ![]() | Σ | 0..1 | string | Human readable description of the type and value | Σ | 0..1 | string | Human readable description of the type and value | |||||||||
![]() ![]() | Σ | 0..1 | positiveInt | Relative order of the coverage | Σ | 0..1 | positiveInt | Relative order of the coverage | |||||||||
![]() ![]() | Σ | 0..1 | string | Insurer network | Σ | 0..1 | string | Insurer network | |||||||||
![]() ![]() | 0..* | BackboneElement | Patient payments for services/products | 0..* | BackboneElement | Patient payments for services/products | |||||||||||
![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() | Σ | 0..1 | CodeableConcept | Cost category Binding: ?? (extensible): The types of services to which patient copayments are specified. | Σ | 0..1 | CodeableConcept | Cost category Binding: ?? (extensible): The types of services to which patient copayments are specified. | |||||||||
![]() ![]() ![]() | Σ | 1..1 | ??, Money | The amount or percentage due from the beneficiary | Σ | 1..1 | ??, Money | The amount or percentage due from the beneficiary | |||||||||
![]() ![]() ![]() | 0..* | BackboneElement | Exceptions for patient payments | 0..* | BackboneElement | Exceptions for patient payments | |||||||||||
![]() ![]() ![]() ![]() | 0..1 | string | Unique id for inter-element referencing | 0..1 | string | Unique id for inter-element referencing | |||||||||||
![]() ![]() ![]() ![]() | 0..* | Extension | Additional content defined by implementations | 0..* | Extension | Additional content defined by implementations | |||||||||||
![]() ![]() ![]() ![]() | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | |||||||||
![]() ![]() ![]() ![]() | Σ | 1..1 | CodeableConcept | Exception category Binding: ?? (example): The types of exceptions from the part or full value of financial obligations such as copays. | Σ | 1..1 | CodeableConcept | Exception category Binding: ?? (example): The types of exceptions from the part or full value of financial obligations such as copays. | |||||||||
![]() ![]() ![]() ![]() | Σ | 0..1 | Period | The effective period of the exception | Σ | 0..1 | Period | The effective period of the exception | |||||||||
![]() ![]() | 0..1 | boolean | Reimbursement to insurer | 0..1 | boolean | Reimbursement to insurer | |||||||||||
![]() ![]() | 0..* | Reference(Contract) | Contract details | 0..* | Reference(Contract) | Contract details | |||||||||||
Documentation for this format | |||||||||||||||||