HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.5.0 - Draft for Community Review

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.5.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

## CapabilityStatement: VN Core BHYT Gateway Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client gửi hồ sơ thanh toán BHYT (Thử nghiệm)

URL chính thức: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-bhyt-gateway-client | Phiên bản: 0.5.0 | Làm nổi bật phần thay đổi?
| Computable Name: VNBHYTGatewayClientCapabilityStatement

Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho HIS/EMR hoặc middleware đóng vai trò client trong lớp liên thông hồ sơ BHYT, chịu trách nhiệm gửi hồ sơ thanh toán BHYT. / Minimum conformance requirements for payer submission clients using the VN Core BHYT Submission layer.

Raw OpenAPI-Swagger Definition file | Tải xuống

Language: vi

## VN Core BHYT Gateway Client CapabilityStatement

- Implementation Guide Version: 0.5.0
- FHIR Version: 4.0.1
- Supported Formats: `json`, `xml`
- Published on: 2026-03-23
- Published by: Omi HealthTech / VN Core FHIR Community Initiative

> Note to Implementers: FHIR Capabilities

> Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

## FHIR RESTful Capabilities

### Mode: `client`

Client gửi hồ sơ thanh toán BHYT cần sinh đúng `VNCoreBHYTSubmissionBundle`, tìm theo `MA_LK`, và gọi được các operation validate/submit/reverse.

Security
Enable CORS: no
Security services supported: `SMART-on-FHIR`

> Khuyến nghị tài khoản dịch vụ riêng cho cổng BHYT, token ngắn hạn, audit đầy đủ và tách quyền với các ứng dụng lâm sàng nội bộ.

Summary of System-wide Operations

Conformance | Operation | Documentation
--- | --- | ---
SHALL | $validate-bhyt-claim | Validate Bundle/Claim trước khi gửi Cổng BHXH
SHALL | $submit-bhyt-claim | Gửi hồ sơ thanh toán BHYT theo lớp liên thông hồ sơ BHYT
SHALL | $reverse-bhyt-claim | Thu hồi/đảo hồ sơ BHYT đã gửi

### Capabilities by Resource/Profile

#### Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

- The relevant profiles (if any)
- The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
- The required, recommended, and some optional search parameters (if any).
- The linked resources enabled for `_include`
- The other resources enabled for `_revinclude`
- The operations on the resource (if any)

Resource Type | Profile | R | S | U | C | Searches | `_include` | `_revinclude` | Operations
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
Claim | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim | y | y |  | y | identifier, vn-ma-lk |  |  |
Coverage | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage | y | y |  |  | beneficiary, vn-ma-dkbd |  |  |
ClaimResponse | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response | y | y |  |  | request, status, vn-xml1-id |  |  |
Patient | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient | y | y |  |  | vn-cccd, vn-bhxh |  |  |
Organization | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization | y | y |  |  | vn-cskcb |  |  |

#### Resource Conformance: unspecifiedClaim

Base System Profile
Yêu cầu thanh toán KCB VN Core — VN Core Claim Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `create`, `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | identifier | `token` |
SHALL | vn-ma-lk | `token` |

#### Resource Conformance: unspecifiedCoverage

Base System Profile
Thẻ BHYT VN Core — VN Core Coverage Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | beneficiary | `reference` |
SHALL | vn-ma-dkbd | `token` |

#### Resource Conformance: unspecifiedClaimResponse

Base System Profile
Kết quả giải quyết BHYT VN Core — VN Core ClaimResponse Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | request | `reference` |
SHALL | status | `token` |
SHALL | vn-xml1-id | `token` |

#### Resource Conformance: unspecifiedPatient

Base System Profile
Bệnh nhân VN Core — VN Core Patient Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | vn-cccd | `token` |
SHALL | vn-bhxh | `token` |

#### Resource Conformance: unspecifiedOrganization

Base System Profile
Cơ sở y tế VN Core — VN Core Organization Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

- Supports `read`, `search-type`.

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | vn-cskcb | `token` |