# text.div
Generated Narrative: CapabilityStatement vn-core-bhyt-gateway-server

VN Core BHYT Gateway Server CapabilityStatement

Implementation Guide Version: 0.5.1

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: server

Máy chủ cổng/facade nên công bố rõ khả năng kiểm tra hợp lệ hồ sơ, nhận VNCoreBHYTSubmissionBundle, truy vết theo MA_LK và phản hồi lỗi bằng OperationOutcome.

Security

Enable CORS: no

Security services supported: SMART-on-FHIR

Khuyến nghị token máy chủ - máy chủ, danh sách IP cho phép hoặc mTLS theo quy định vận hành, ghi log đầy đủ truy cập và quá trình tiếp nhận hồ sơ BHYT.

Summary of System-wide Operations

Conformance | Operation | Documentation

SHALL

$validate-bhyt-claim

Validate hồ sơ theo profile và quy tắc của lớp liên thông hồ sơ BHYT

SHALL

$submit-bhyt-claim

Tiếp nhận hồ sơ thanh toán BHYT theo VNCoreBHYTSubmissionBundle

SHALL

$reverse-bhyt-claim

Thu hồi hoặc hủy hồ sơ đã 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
Bundle | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle | y | | | y | identifier | | |
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 | | | 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 | | |

Resource Conformance: unspecified Bundle

Base System Profile
Bundle hồ sơ thanh toán BHYT — VN Core BHYT Submission Bundle

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports create, read.

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

identifier

token

Resource Conformance: unspecified Claim

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 read, search-type, create.

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

identifier

token

SHALL

vn-ma-lk

token

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

vn-ma-dkbd

token

Resource Conformance: unspecified ClaimResponse

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

vn-cccd

token

# title
VN Core BHYT Gateway Server 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 máy chủ/facade tiếp nhận hồ sơ thanh toán BHYT từ HIS/EMR. Tập trung vào lớp liên thông hồ sơ BHYT, `MA_LK`, các operation kiểm tra hợp lệ/gửi/thu hồi và các quy tắc định dạng xuất cổng. / Minimum conformance requirements for payer-facing BHYT submission servers.

# rest[].documentation
Máy chủ cổng/facade nên công bố rõ khả năng kiểm tra hợp lệ hồ sơ, nhận `VNCoreBHYTSubmissionBundle`, truy vết theo `MA_LK` và phản hồi lỗi bằng `OperationOutcome`.

# rest[].security.description
Khuyến nghị token máy chủ - máy chủ, danh sách IP cho phép hoặc mTLS theo quy định vận hành, ghi log đầy đủ truy cập và quá trình tiếp nhận hồ sơ BHYT.

# rest[].operation[].documentation
Validate hồ sơ theo profile và quy tắc của lớp liên thông hồ sơ BHYT

# rest[].operation[].documentation
Tiếp nhận hồ sơ thanh toán BHYT theo `VNCoreBHYTSubmissionBundle`