Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review
Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions
| URL chính thức: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage-eligibility-response | Phiên bản: 0.10.0 | ||||
| Computable Name: VNCoreCoverageEligibilityResponse | |||||
| Định danh khác: OID:2.25.161089673617632664299011809196868855799.42.53 | |||||
Bản quyền/Pháp lý: Căn cứ pháp lý Việt Nam: Luật 51/2024/QH15 ngày 27/11/2024; NĐ 188/2025/NĐ-CP; NĐ 164/2025/NĐ-CP ngày 29/06/2025; QĐ 3176/QĐ-BYT ngày 29/10/2024; CV 2036/BHXH-CSYT. |
|||||
Profile CoverageEligibilityResponse — phản hồi từ Cổng giám định BHYT cho yêu cầu tra cứu thẻ: hiệu lực thẻ tại thời điểm tra cứu (insurance.inforce), quyền lợi và mức hưởng. Cặp với VNCoreCoverageEligibilityRequest.
Mức hưởng là ẢNH CHỤP CÓ THỜI ĐIỂM, không phải thuộc tính của thẻ (kiểm toán 07/08/2026, mục 1.12): CV 2036/BHXH-CSYT hướng dẫn cơ sở KCB dùng kết quả tra cứu có thời điểm và áp dụng quyền lợi cao nhất khi người tham gia thuộc nhiều đối tượng — mức hưởng, trần và số luỹ kế thay đổi theo thời gian và theo tổ hợp đối tượng nên phải nằm trong phản hồi tra cứu (created + serviced[x] + insurance.item.benefit), không được ghi tĩnh trên Coverage. Tổng cùng chi trả luỹ kế trong năm (NĐ 188/2025/NĐ-CP Điều 18 khoản 2) biểu diễn bằng insurance.item.benefit với type = vn-benefit-type-cs#annual-copay-accumulator (0.10.0 — thay cách dùng sai benefit-type#copay-maximum của HL7, vốn nghĩa là mức cùng chi trả tối đa cho MỘT dịch vụ — T-02 review 97b): allowedMoney = trần miễn cùng chi trả (6 tháng lương cơ sở), usedMoney = số đã cùng chi trả luỹ kế tính đến thời điểm tra cứu; kỳ tính (năm tài chính) ghi ở serviced[x]. Extension vn-ext-coverage-cumulative-copay trên Coverage đã ngừng authoring từ 0.10.0.
Căn cứ:
serviced[x] vẫn đứng vững vì nó phản ánh bản chất ảnh-chụp-có-thời-điểm của kết quả tra cứu.Usages:
You can also check for usages in the FHIR IG Statistics
Mô tả profile, differential, snapshot và các biểu diễn liên quan.
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
0..* | CoverageEligibilityResponse | CoverageEligibilityResponse resource | |||||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||
![]() ![]() |
SO | 0..* | Identifier | Mã giao dịch phản hồi — đối soát với request của cơ sở KCB
| ||||||
![]() ![]() |
?!SOΣ | 1..1 | code | active | cancelled | draft | entered-in-error Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
| ||||||
![]() ![]() |
SOΣ | 1..* | code | Mục đích tra cứu (khớp request): validation | benefits | ... Binding: EligibilityResponsePurpose (required): A code specifying the types of information being requested.
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Intended recipient of products and services
| ||||||
![]() ![]() |
SO | 0..1 | Kỳ áp dụng của kết quả tra cứu — vd năm tài chính khi trả luỹ kế cùng chi trả
| |||||||
![]() ![]() ![]() |
date | |||||||||
![]() ![]() ![]() |
Period | |||||||||
![]() ![]() |
SOΣ | 1..1 | dateTime | Thời điểm tạo phản hồi
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile) | Yêu cầu tra cứu tương ứng
| ||||||
![]() ![]() |
SOΣ | 1..1 | code | queued | complete | error | partial — kết quả xử lý của Cổng BHYT Binding: ClaimProcessingCodes (required): The outcome of the processing.
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Organization) | Cơ quan BHXH phản hồi
| ||||||
![]() ![]() |
SO | 0..* | BackboneElement | Patient insurance information
| ||||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) | Insurance information | ||||||
![]() ![]() ![]() |
S | 0..1 | boolean | Thẻ BHYT còn hiệu lực tại thời điểm tra cứu (true/false) | ||||||
![]() ![]() ![]() |
SC | 0..* | BackboneElement | Chi tiết quyền lợi/mức hưởng BHYT khi purpose=benefits (mỗi nhóm quyền lợi 1 item) Constraints: ces-1 | ||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() |
S | 0..* | BackboneElement | Mức hưởng theo loại quyền lợi (vd tỷ lệ %, trần thanh toán) | ||||||
![]() ![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Benefit classification Binding: Loại quyền lợi — VN Benefit Type ValueSet (extensible) | |||||||
Documentation for this format | ||||||||||
| Path | Status | Usage | ValueSet | Version | Source |
| CoverageEligibilityResponse.status | Base | required | Financial Resource Status Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.purpose | Base | required | EligibilityResponsePurpose | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.outcome | Base | required | Claim Processing Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.benefit.type | Base | extensible | Loại quyền lợi — VN Benefit Type ValueSet | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| ces-1 | error | CoverageEligibilityResponse.insurance.item | SHALL contain a category or a billcode but not both. |
category.exists() xor productOrService.exists()
|
| dom-2 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CoverageEligibilityResponse | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| CoverageEligibilityResponse.insurance.item.benefit.type | Base | extensible | Loại quyền lợi — VN Benefit Type ValueSet | 📦0.10.0 | This IG |
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
0..* | CoverageEligibilityResponse | CoverageEligibilityResponse resource | |||||||
![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||||
![]() ![]() |
Σ | 0..1 | Meta | Metadata about the resource | ||||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (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..* | Resource | Contained, inline Resources | |||||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||
![]() ![]() |
SO | 0..* | Identifier | Mã giao dịch phản hồi — đối soát với request của cơ sở KCB
| ||||||
![]() ![]() |
?!SOΣ | 1..1 | code | active | cancelled | draft | entered-in-error Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
| ||||||
![]() ![]() |
SOΣ | 1..* | code | Mục đích tra cứu (khớp request): validation | benefits | ... Binding: EligibilityResponsePurpose (required): A code specifying the types of information being requested.
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Intended recipient of products and services
| ||||||
![]() ![]() |
SO | 0..1 | Kỳ áp dụng của kết quả tra cứu — vd năm tài chính khi trả luỹ kế cùng chi trả
| |||||||
![]() ![]() ![]() |
date | |||||||||
![]() ![]() ![]() |
Period | |||||||||
![]() ![]() |
SOΣ | 1..1 | dateTime | Thời điểm tạo phản hồi
| ||||||
![]() ![]() |
0..1 | Reference(Practitioner | PractitionerRole | Organization) | Party responsible for the request | |||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile) | Yêu cầu tra cứu tương ứng
| ||||||
![]() ![]() |
SOΣ | 1..1 | code | queued | complete | error | partial — kết quả xử lý của Cổng BHYT Binding: ClaimProcessingCodes (required): The outcome of the processing.
| ||||||
![]() ![]() |
0..1 | string | Disposition Message | |||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Organization) | Cơ quan BHXH phản hồi
| ||||||
![]() ![]() |
SO | 0..* | BackboneElement | Patient insurance information
| ||||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) | Insurance information | ||||||
![]() ![]() ![]() |
S | 0..1 | boolean | Thẻ BHYT còn hiệu lực tại thời điểm tra cứu (true/false) | ||||||
![]() ![]() ![]() |
0..1 | Period | When the benefits are applicable | |||||||
![]() ![]() ![]() |
SC | 0..* | BackboneElement | Chi tiết quyền lợi/mức hưởng BHYT khi purpose=benefits (mỗi nhóm quyền lợi 1 item) Constraints: ces-1 | ||||||
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Benefit classification Binding: BenefitCategoryCodes (example): Benefit categories such as: oral, medical, vision etc. | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Billing, service, product, or drug code Binding: USCLSCodes (example): Allowable service and product codes. | |||||||
![]() ![]() ![]() ![]() |
0..* | CodeableConcept | Product or service billing modifiers Binding: ModifierTypeCodes (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen. | |||||||
![]() ![]() ![]() ![]() |
0..1 | Reference(Practitioner | PractitionerRole) | Performing practitioner | |||||||
![]() ![]() ![]() ![]() |
0..1 | boolean | Excluded from the plan | |||||||
![]() ![]() ![]() ![]() |
0..1 | string | Short name for the benefit | |||||||
![]() ![]() ![]() ![]() |
0..1 | string | Description of the benefit or services covered | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | In or out of network Binding: NetworkTypeCodes (example): Code to classify in or out of network services. | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Individual or family Binding: UnitTypeCodes (example): Unit covered/serviced - individual or family. | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Annual or lifetime Binding: BenefitTermCodes (example): Coverage unit - annual, lifetime. | |||||||
![]() ![]() ![]() ![]() |
S | 0..* | BackboneElement | Mức hưởng theo loại quyền lợi (vd tỷ lệ %, trần thanh toán) | ||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Benefit classification Binding: Loại quyền lợi — VN Benefit Type ValueSet (extensible) | |||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | Benefits allowed | ||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
unsignedInt | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
string | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
Money | |||||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | Benefits used | ||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
unsignedInt | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
string | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
Money | |||||||||
![]() ![]() ![]() ![]() |
0..1 | boolean | Authorization required flag | |||||||
![]() ![]() ![]() ![]() |
0..* | CodeableConcept | Type of required supporting materials Binding: CoverageEligibilityResponseAuthSupportCodes (example): Type of supporting information to provide with a preauthorization. | |||||||
![]() ![]() ![]() ![]() |
0..1 | uri | Preauthorization requirements endpoint | |||||||
![]() ![]() |
0..1 | string | Preauthorization reference | |||||||
![]() ![]() |
0..1 | CodeableConcept | Printed form identifier Binding: Form Codes (example): The forms codes. | |||||||
![]() ![]() |
0..* | BackboneElement | Processing errors | |||||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() |
1..1 | CodeableConcept | Error code detailing processing issues Binding: Adjudication Error Codes (example): The error codes for adjudication processing. | |||||||
Documentation for this format | ||||||||||
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| CoverageEligibilityResponse.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.status | Base | required | Financial Resource Status Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.purpose | Base | required | EligibilityResponsePurpose | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.outcome | Base | required | Claim Processing Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.category | Base | example | Benefit Category Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.productOrService | Base | example | USCLS Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.modifier | Base | example | Modifier type Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.network | Base | example | Network Type Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.unit | Base | example | Unit Type Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.term | Base | example | Benefit Term Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.benefit.type | Base | extensible | Loại quyền lợi — VN Benefit Type ValueSet | 📦0.10.0 | This IG |
| CoverageEligibilityResponse.insurance.item.authorizationSupporting | Base | example | CoverageEligibilityResponse Auth Support Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.form | Base | example | Forms | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.error.code | Base | example | AdjudicationError | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ces-1 | error | CoverageEligibilityResponse.insurance.item | SHALL contain a category or a billcode but not both. |
category.exists() xor productOrService.exists()
|
| dom-2 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CoverageEligibilityResponse | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
Summary
Must-Support: 14 elements
Structures
This structure refers to these other structures:
Dạng xem phần tử chính
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
0..* | CoverageEligibilityResponse | CoverageEligibilityResponse resource | |||||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||
![]() ![]() |
SO | 0..* | Identifier | Mã giao dịch phản hồi — đối soát với request của cơ sở KCB
| ||||||
![]() ![]() |
?!SOΣ | 1..1 | code | active | cancelled | draft | entered-in-error Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
| ||||||
![]() ![]() |
SOΣ | 1..* | code | Mục đích tra cứu (khớp request): validation | benefits | ... Binding: EligibilityResponsePurpose (required): A code specifying the types of information being requested.
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Intended recipient of products and services
| ||||||
![]() ![]() |
SO | 0..1 | Kỳ áp dụng của kết quả tra cứu — vd năm tài chính khi trả luỹ kế cùng chi trả
| |||||||
![]() ![]() ![]() |
date | |||||||||
![]() ![]() ![]() |
Period | |||||||||
![]() ![]() |
SOΣ | 1..1 | dateTime | Thời điểm tạo phản hồi
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile) | Yêu cầu tra cứu tương ứng
| ||||||
![]() ![]() |
SOΣ | 1..1 | code | queued | complete | error | partial — kết quả xử lý của Cổng BHYT Binding: ClaimProcessingCodes (required): The outcome of the processing.
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Organization) | Cơ quan BHXH phản hồi
| ||||||
![]() ![]() |
SO | 0..* | BackboneElement | Patient insurance information
| ||||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) | Insurance information | ||||||
![]() ![]() ![]() |
S | 0..1 | boolean | Thẻ BHYT còn hiệu lực tại thời điểm tra cứu (true/false) | ||||||
![]() ![]() ![]() |
SC | 0..* | BackboneElement | Chi tiết quyền lợi/mức hưởng BHYT khi purpose=benefits (mỗi nhóm quyền lợi 1 item) Constraints: ces-1 | ||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() |
S | 0..* | BackboneElement | Mức hưởng theo loại quyền lợi (vd tỷ lệ %, trần thanh toán) | ||||||
![]() ![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Benefit classification Binding: Loại quyền lợi — VN Benefit Type ValueSet (extensible) | |||||||
Documentation for this format | ||||||||||
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| CoverageEligibilityResponse.status | Base | required | Financial Resource Status Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.purpose | Base | required | EligibilityResponsePurpose | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.outcome | Base | required | Claim Processing Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.benefit.type | Base | extensible | Loại quyền lợi — VN Benefit Type ValueSet | 📦0.10.0 | This IG |
| Id | Grade | Path(s) | Description | Expression |
| ces-1 | error | CoverageEligibilityResponse.insurance.item | SHALL contain a category or a billcode but not both. |
category.exists() xor productOrService.exists()
|
| dom-2 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CoverageEligibilityResponse | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
Dạng xem Differential
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
0..* | CoverageEligibilityResponse | CoverageEligibilityResponse resource | |||||||
![]() ![]() |
SO | 0..* | Identifier | Mã giao dịch phản hồi — đối soát với request của cơ sở KCB
| ||||||
![]() ![]() |
SO | 1..1 | code | active | cancelled | draft | entered-in-error
| ||||||
![]() ![]() |
SO | 1..* | code | Mục đích tra cứu (khớp request): validation | benefits | ...
| ||||||
![]() ![]() |
SO | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Intended recipient of products and services
| ||||||
![]() ![]() |
SO | 0..1 | date, Period | Kỳ áp dụng của kết quả tra cứu — vd năm tài chính khi trả luỹ kế cùng chi trả
| ||||||
![]() ![]() |
SO | 1..1 | dateTime | Thời điểm tạo phản hồi
| ||||||
![]() ![]() |
SO | 1..1 | Reference(Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile) | Yêu cầu tra cứu tương ứng
| ||||||
![]() ![]() |
SO | 1..1 | code | queued | complete | error | partial — kết quả xử lý của Cổng BHYT
| ||||||
![]() ![]() |
SO | 1..1 | Reference(Organization) | Cơ quan BHXH phản hồi
| ||||||
![]() ![]() |
SO | 0..* | BackboneElement | Patient insurance information
| ||||||
![]() ![]() ![]() |
S | 1..1 | Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) | Insurance information | ||||||
![]() ![]() ![]() |
S | 0..1 | boolean | Thẻ BHYT còn hiệu lực tại thời điểm tra cứu (true/false) | ||||||
![]() ![]() ![]() |
S | 0..* | BackboneElement | Chi tiết quyền lợi/mức hưởng BHYT khi purpose=benefits (mỗi nhóm quyền lợi 1 item) | ||||||
![]() ![]() ![]() ![]() |
S | 0..* | BackboneElement | Mức hưởng theo loại quyền lợi (vd tỷ lệ %, trần thanh toán) | ||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Benefit classification Binding: Loại quyền lợi — VN Benefit Type ValueSet (extensible) | |||||||
Documentation for this format | ||||||||||
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| CoverageEligibilityResponse.insurance.item.benefit.type | Base | extensible | Loại quyền lợi — VN Benefit Type ValueSet | 📦0.10.0 | This IG |
Dạng xem SnapshotView
| Name | Flags | Card. | Type | Description & Constraints Filter: ![]() ![]() | ||||||
|---|---|---|---|---|---|---|---|---|---|---|
![]() |
0..* | CoverageEligibilityResponse | CoverageEligibilityResponse resource | |||||||
![]() ![]() |
Σ | 0..1 | id | Logical id of this artifact | ||||||
![]() ![]() |
Σ | 0..1 | Meta | Metadata about the resource | ||||||
![]() ![]() |
?!Σ | 0..1 | uri | A set of rules under which this content was created | ||||||
![]() ![]() |
0..1 | code | Language of the resource content Binding: CommonLanguages (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..* | Resource | Contained, inline Resources | |||||||
![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() |
?! | 0..* | Extension | Extensions that cannot be ignored | ||||||
![]() ![]() |
SO | 0..* | Identifier | Mã giao dịch phản hồi — đối soát với request của cơ sở KCB
| ||||||
![]() ![]() |
?!SOΣ | 1..1 | code | active | cancelled | draft | entered-in-error Binding: FinancialResourceStatusCodes (required): A code specifying the state of the resource instance.
| ||||||
![]() ![]() |
SOΣ | 1..* | code | Mục đích tra cứu (khớp request): validation | benefits | ... Binding: EligibilityResponsePurpose (required): A code specifying the types of information being requested.
| ||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Bệnh nhân VN Core — VN Core Patient Profile) | Intended recipient of products and services
| ||||||
![]() ![]() |
SO | 0..1 | Kỳ áp dụng của kết quả tra cứu — vd năm tài chính khi trả luỹ kế cùng chi trả
| |||||||
![]() ![]() ![]() |
date | |||||||||
![]() ![]() ![]() |
Period | |||||||||
![]() ![]() |
SOΣ | 1..1 | dateTime | Thời điểm tạo phản hồi
| ||||||
![]() ![]() |
0..1 | Reference(Practitioner | PractitionerRole | Organization) | Party responsible for the request | |||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Yêu cầu tra cứu quyền lợi BHYT VN Core — VN Core Coverage Eligibility Request Profile) | Yêu cầu tra cứu tương ứng
| ||||||
![]() ![]() |
SOΣ | 1..1 | code | queued | complete | error | partial — kết quả xử lý của Cổng BHYT Binding: ClaimProcessingCodes (required): The outcome of the processing.
| ||||||
![]() ![]() |
0..1 | string | Disposition Message | |||||||
![]() ![]() |
SOΣ | 1..1 | Reference(Organization) | Cơ quan BHXH phản hồi
| ||||||
![]() ![]() |
SO | 0..* | BackboneElement | Patient insurance information
| ||||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() |
SΣ | 1..1 | Reference(Thẻ BHYT VN Core — VN Core Coverage Profile) | Insurance information | ||||||
![]() ![]() ![]() |
S | 0..1 | boolean | Thẻ BHYT còn hiệu lực tại thời điểm tra cứu (true/false) | ||||||
![]() ![]() ![]() |
0..1 | Period | When the benefits are applicable | |||||||
![]() ![]() ![]() |
SC | 0..* | BackboneElement | Chi tiết quyền lợi/mức hưởng BHYT khi purpose=benefits (mỗi nhóm quyền lợi 1 item) Constraints: ces-1 | ||||||
![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Benefit classification Binding: BenefitCategoryCodes (example): Benefit categories such as: oral, medical, vision etc. | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Billing, service, product, or drug code Binding: USCLSCodes (example): Allowable service and product codes. | |||||||
![]() ![]() ![]() ![]() |
0..* | CodeableConcept | Product or service billing modifiers Binding: ModifierTypeCodes (example): Item type or modifiers codes, eg for Oral whether the treatment is cosmetic or associated with TMJ, or an appliance was lost or stolen. | |||||||
![]() ![]() ![]() ![]() |
0..1 | Reference(Practitioner | PractitionerRole) | Performing practitioner | |||||||
![]() ![]() ![]() ![]() |
0..1 | boolean | Excluded from the plan | |||||||
![]() ![]() ![]() ![]() |
0..1 | string | Short name for the benefit | |||||||
![]() ![]() ![]() ![]() |
0..1 | string | Description of the benefit or services covered | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | In or out of network Binding: NetworkTypeCodes (example): Code to classify in or out of network services. | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Individual or family Binding: UnitTypeCodes (example): Unit covered/serviced - individual or family. | |||||||
![]() ![]() ![]() ![]() |
0..1 | CodeableConcept | Annual or lifetime Binding: BenefitTermCodes (example): Coverage unit - annual, lifetime. | |||||||
![]() ![]() ![]() ![]() |
S | 0..* | BackboneElement | Mức hưởng theo loại quyền lợi (vd tỷ lệ %, trần thanh toán) | ||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() ![]() ![]() |
1..1 | CodeableConcept | Benefit classification Binding: Loại quyền lợi — VN Benefit Type ValueSet (extensible) | |||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | Benefits allowed | ||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
unsignedInt | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
string | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
Money | |||||||||
![]() ![]() ![]() ![]() ![]() |
0..1 | Benefits used | ||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
unsignedInt | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
string | |||||||||
![]() ![]() ![]() ![]() ![]() ![]() |
Money | |||||||||
![]() ![]() ![]() ![]() |
0..1 | boolean | Authorization required flag | |||||||
![]() ![]() ![]() ![]() |
0..* | CodeableConcept | Type of required supporting materials Binding: CoverageEligibilityResponseAuthSupportCodes (example): Type of supporting information to provide with a preauthorization. | |||||||
![]() ![]() ![]() ![]() |
0..1 | uri | Preauthorization requirements endpoint | |||||||
![]() ![]() |
0..1 | string | Preauthorization reference | |||||||
![]() ![]() |
0..1 | CodeableConcept | Printed form identifier Binding: Form Codes (example): The forms codes. | |||||||
![]() ![]() |
0..* | BackboneElement | Processing errors | |||||||
![]() ![]() ![]() |
0..1 | string | Unique id for inter-element referencing | |||||||
![]() ![]() ![]() |
0..* | Extension | Additional content defined by implementations | |||||||
![]() ![]() ![]() |
?!Σ | 0..* | Extension | Extensions that cannot be ignored even if unrecognized | ||||||
![]() ![]() ![]() |
1..1 | CodeableConcept | Error code detailing processing issues Binding: Adjudication Error Codes (example): The error codes for adjudication processing. | |||||||
Documentation for this format | ||||||||||
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
| Path | Status | Usage | ValueSet | Version | Source |
| CoverageEligibilityResponse.language | Base | preferred | Common Languages | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.status | Base | required | Financial Resource Status Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.purpose | Base | required | EligibilityResponsePurpose | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.outcome | Base | required | Claim Processing Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.category | Base | example | Benefit Category Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.productOrService | Base | example | USCLS Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.modifier | Base | example | Modifier type Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.network | Base | example | Network Type Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.unit | Base | example | Unit Type Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.term | Base | example | Benefit Term Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.insurance.item.benefit.type | Base | extensible | Loại quyền lợi — VN Benefit Type ValueSet | 📦0.10.0 | This IG |
| CoverageEligibilityResponse.insurance.item.authorizationSupporting | Base | example | CoverageEligibilityResponse Auth Support Codes | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.form | Base | example | Forms | 📍4.0.1 | FHIR Std. |
| CoverageEligibilityResponse.error.code | Base | example | AdjudicationError | 📍4.0.1 | FHIR Std. |
| Id | Grade | Path(s) | Description | Expression |
| ces-1 | error | CoverageEligibilityResponse.insurance.item | SHALL contain a category or a billcode but not both. |
category.exists() xor productOrService.exists()
|
| dom-2 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL NOT contain nested Resources |
contained.contained.empty()
|
| dom-3 | error | CoverageEligibilityResponse | If the resource is contained in another resource, it SHALL be referred to from elsewhere in the resource or SHALL refer to the containing resource |
contained.where((('#'+id in (%resource.descendants().reference | %resource.descendants().as(canonical) | %resource.descendants().as(uri) | %resource.descendants().as(url))) or descendants().where(reference = '#').exists() or descendants().where(as(canonical) = '#').exists() or descendants().where(as(canonical) = '#').exists()).not()).trace('unmatched', id).empty()
|
| dom-4 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a meta.versionId or a meta.lastUpdated |
contained.meta.versionId.empty() and contained.meta.lastUpdated.empty()
|
| dom-5 | error | CoverageEligibilityResponse | If a resource is contained in another resource, it SHALL NOT have a security label |
contained.meta.security.empty()
|
| dom-6 | best practice | CoverageEligibilityResponse | A resource should have narrative for robust management |
text.`div`.exists()
|
| ele-1 | error | **ALL** elements | All FHIR elements must have a @value or children |
hasValue() or (children().count() > id.count())
|
| ext-1 | error | **ALL** extensions | Must have either extensions or value[x], not both |
extension.exists() != value.exists()
|
| Name | Bên giám định BHYT (Adjudicator) | Bên gửi hồ sơ BHYT (Submitter)![]() |
|---|---|---|
![]() |
||
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
![]() ![]() |
|
|
Documentation for this format | ||
Summary
Must-Support: 14 elements
Structures
This structure refers to these other structures:
Biểu diễn khác của hồ sơ: CSV, Excel, Schematron