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 Citizen App Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client ứng dụng người dân (Thử nghiệm)

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

Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho ứng dụng người dân/cổng công dân/kết nối VNeID. Tập trung vào truy cập hồ sơ cá nhân, giấy tờ lâm sàng, `Consent` và lịch sử truy cập. / Minimum conformance requirements for citizen-facing or VNeID-connected apps.

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

Language: vi

## VN Core Citizen App 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`

Ứng dụng người dân chỉ nên truy cập theo patient compartment của chính chủ thể dữ liệu hoặc người đại diện hợp pháp.

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

> Khuyến nghị khởi chạy ứng dụng theo SMART-on-FHIR với scope tối thiểu `patient/*.read`, `patient/Consent.*`, audit bắt buộc và kiểm soát truy cập qua người giám hộ/RelatedPerson.

### 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
--- | --- | --- | --- | --- | --- | --- | --- | --- | ---
Patient | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient | y | y |  |  | identifier |  |  |
RelatedPerson | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson | y | y |  |  | patient |  |  |
Coverage | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage | y | y |  |  | beneficiary |  |  |
DocumentReference | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference | y | y |  |  | patient |  |  |
Consent | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent | y | y | y | y | patient |  |  |
AuditEvent | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-event | y | y |  |  | patient |  |  |

#### 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 | identifier | `token` |

#### Resource Conformance: unspecifiedRelatedPerson

Base System Profile
Người liên quan/người giám hộ VN Core — VN Core RelatedPerson Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | patient | `reference` |

#### 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` |

#### Resource Conformance: unspecifiedDocumentReference

Base System Profile
Tài liệu y tế VN Core — VN Core DocumentReference Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | patient | `reference` |

#### Resource Conformance: unspecifiedConsent

Base System Profile
Đồng ý xử lý dữ liệu VN Core — VN Core Consent Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | patient | `reference` |

#### Resource Conformance: unspecifiedAuditEvent

Base System Profile
Nhật ký truy cập dữ liệu VN Core — VN Core AuditEvent Profile
Profile Conformance
SHALL
Reference Policy

Interaction summary

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

Search Parameters

Conformance | Parameter | Type | Documentation
--- | --- | --- | ---
SHALL | patient | `reference` |