# text.div
Generated Narrative: CapabilityStatement vn-core-citizen-app-client

VN Core Citizen App Client CapabilityStatement

Implementation Guide Version: 0.5.1

FHIR Version: 4.0.1

Supported Formats: json, xml

Published on: 2026-05-10

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: unspecified Patient

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: unspecified RelatedPerson

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: unspecified Coverage

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: unspecified DocumentReference

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: unspecified Consent

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: unspecified AuditEvent

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

# title
VN Core Citizen App Client CapabilityStatement

# publisher
Omi HealthTech / VN Core FHIR Community Initiative

# contact[].name
Omi HealthTech / VN Core FHIR Community Initiative

# description
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.

# rest[].documentation
Ứ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.

# rest[].security.description
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.