VN Core Server CapabilityStatement

VN Core FHIR Implementation Guide — Bộ Hướng dẫn Triển khai FHIR Cốt lõi cho Việt Nam - Local Development build (v0.1.0) built by the FHIR (HL7® FHIR® Standard) Build Tools. See the Directory of published versions

CapabilityStatement: VN Core Server CapabilityStatement — Mô tả khả năng máy chủ FHIR tuân thủ VN Core (Experimental)

Official URL: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-server				Version: 0.1.0
Draft as of 2026-03-20				Computable Name: VNCoreServerCapabilityStatement

Máy chủ FHIR tuân thủ VN Core IG PHẢI hỗ trợ tối thiểu các khả năng được liệt kê dưới đây. / A FHIR server conforming to VN Core IG MUST support at minimum the capabilities listed below.

Raw OpenAPI-Swagger Definition file | Download

Implementation Guide Version: 0.1.0
FHIR Version: 4.0.1
Supported Formats: json, xml
Published on: 2026-03-20
Published by: HL7 Vietnam

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ủ FHIR tuân thủ VN Core IG. Hỗ trợ JSON và XML. Yêu cầu xác thực theo SMART on FHIR hoặc OAuth 2.0. Tuân thủ Luật 91/2025 về bảo vệ dữ liệu cá nhân.

Security

Enable CORS: yes

Security services supported: SMART-on-FHIR

Hệ thống PHẢI tuân thủ Luật 91/2025/QH15 (BVDLCN) và NĐ 356/2025/NĐ-CP. Dữ liệu y tế = DLCN nhạy cảm. Xem Bảo mật và Quyền riêng tư.

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
Patient	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient	y	y	y	y	identifier, name, birthdate, gender, vn-cccd, vn-bhyt
Practitioner	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner	y	y			identifier, name, vn-cchn
PractitionerRole	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role	y	y			practitioner, organization
Organization	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization	y	y			identifier, name, vn-cskcb
Encounter	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter	y	y	y	y	patient, date, status, class, vn-malydo
Condition	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition	y	y		y	patient, code, encounter, vn-icd10
Observation	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab Additional supported profiles: Sinh hiệu VN Core — VN Core Observation Vital Signs Profile Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile	y	y		y	patient, code, date, category
AllergyIntolerance	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance	y	y		y	patient, clinical-status
Procedure	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure	y	y		y	patient, code, date
Coverage	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage	y	y			beneficiary, identifier, status, vn-bhyt-card
Claim	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim	y	y	y	y	patient, provider, status, created
MedicationRequest	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request	y	y	y	y	patient, status, intent, authoredon, medication
ServiceRequest	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request	y	y	y	y	patient, status, category, code, authored
DocumentReference	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference	y	y		y	patient, type, date, encounter, custodian
ClaimResponse	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response	y	y			patient, request, status
ExplanationOfBenefit	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit	y	y			patient, status, created
DiagnosticReport	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report	y	y		y	patient, code, date, category, encounter
Medication	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication	y	y			code, status
Device	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device	y	y			type, status
DeviceUseStatement	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement	y	y			patient, device

Resource Conformance: supportedPatient

Base System Profile
Bệnh nhân VN Core — VN Core Patient Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Documentation

Bệnh nhân Việt Nam — VNCorePatient profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	identifier	`token`	Tìm theo CCCD, mã BHXH, hoặc MRN
SHALL	name	`string`	Tìm theo họ tên (hỗ trợ Unicode tiếng Việt)
SHALL	birthdate	`date`
SHALL	gender	`token`
SHALL	vn-cccd	`token`	Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023)
SHALL	vn-bhyt	`token`	Tìm theo số thẻ BHYT (Luật BHYT)

Resource Conformance: supportedPractitioner

Base System Profile
Nhân viên y tế VN Core — VN Core Practitioner Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Nhân viên y tế — VNCorePractitioner profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	identifier	`token`	Tìm theo CCHN hoặc CCCD
SHALL	name	`string`
SHALL	vn-cchn	`token`	Tìm theo số chứng chỉ hành nghề (Luật KCB 2023)

Resource Conformance: supportedPractitionerRole

Base System Profile
Vai trò nhân viên y tế VN Core — VN Core PractitionerRole Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Vai trò nhân viên y tế — VNCorePractitionerRole profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	practitioner	`reference`
SHALL	organization	`reference`

Resource Conformance: supportedOrganization

Base System Profile
Cơ sở y tế VN Core — VN Core Organization Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Cơ sở KCB — VNCoreOrganization profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	identifier	`token`	Tìm theo mã CSKCB
SHALL	name	`string`
SHALL	vn-cskcb	`token`	Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT)

Resource Conformance: supportedEncounter

Base System Profile
Lượt khám/nhập viện VN Core — VN Core Encounter Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Documentation

Lượt khám/điều trị — VNCoreEncounter profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	date	`date`
SHALL	status	`token`
SHALL	class	`token`
SHALL	vn-malydo	`token`	Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT)

Resource Conformance: supportedCondition

Base System Profile
Chẩn đoán VN Core — VN Core Condition Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create.

Documentation

Chẩn đoán — VNCoreCondition profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	code	`token`	Tìm theo mã ICD-10 VN hoặc Mã U (YHCT)
SHALL	encounter	`reference`
SHALL	vn-icd10	`token`	Tìm theo mã ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT)

Resource Conformance: supportedObservation

Base System Profile
Xét nghiệm VN Core — VN Core Observation Laboratory Profile

Profile Conformance
SHALL

Reference Policy

Supported Profiles

Sinh hiệu VN Core — VN Core Observation Vital Signs Profile
Đánh giá YHCT VN Core — VN Core Observation Traditional Medicine Profile

Interaction summary

Supports read, search-type, create.

Documentation

Kết quả xét nghiệm, sinh hiệu, và quan sát YHCT — VNCoreObservationLab + VNCoreObservationVitalSigns + VNCoreObservationYHCT profiles

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	code	`token`	Tìm theo LOINC code
SHALL	date	`date`
SHALL	category	`token`

Resource Conformance: supportedAllergyIntolerance

Base System Profile
Dị ứng/Bất dung nạp VN Core — VN Core AllergyIntolerance Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create.

Documentation

Dị ứng — VNCoreAllergyIntolerance profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	clinical-status	`token`

Resource Conformance: supportedProcedure

Base System Profile
Thủ thuật/DVKT VN Core — VN Core Procedure Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create.

Documentation

Thủ thuật/phẫu thuật — VNCoreProcedure profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`
SHALL	code	`token`	Tìm theo mã ICD-9-CM
SHALL	date	`date`

Resource Conformance: supportedCoverage

Base System Profile
Thẻ BHYT VN Core — VN Core Coverage Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Thẻ BHYT — VNCoreCoverage profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	beneficiary	`reference`	Tìm theo bệnh nhân thụ hưởng BHYT
SHALL	identifier	`token`	Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ)
SHALL	status	`token`
SHALL	vn-bhyt-card	`token`	Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)

Resource Conformance: supportedClaim

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, update.

Documentation

Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176 → QĐ 697)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	provider	`reference`	Tìm theo cơ sở KCB
SHALL	status	`token`
SHALL	created	`date`	Tìm theo ngày tạo yêu cầu

Resource Conformance: supportedMedicationRequest

Base System Profile
Đơn thuốc VN Core — VN Core MedicationRequest Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Documentation

Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025, Luật Dược 2016)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	status	`token`
SHALL	intent	`token`
SHALL	authoredon	`date`	Tìm theo ngày kê đơn
SHALL	medication	`reference`	Tìm theo thuốc

Resource Conformance: supportedServiceRequest

Base System Profile
Yêu cầu DVKT/Cận lâm sàng VN Core — VN Core ServiceRequest Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Documentation

Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025, TT 20/2014)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	status	`token`
SHALL	category	`token`	Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...)
SHALL	code	`token`	Tìm theo mã DVKT / ICD-9-CM
SHALL	authored	`date`	Tìm theo ngày chỉ định

Resource Conformance: supportedDocumentReference

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, create.

Documentation

Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	type	`token`	Tìm theo loại tài liệu
SHALL	date	`date`	Tìm theo thời điểm tạo
SHALL	encounter	`reference`	Tìm theo lượt khám liên quan
SHALL	custodian	`reference`	Tìm theo cơ sở y tế lưu trữ

Resource Conformance: supportedClaimResponse

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.

Documentation

Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176, QĐ 697)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	request	`reference`	Tìm theo Claim gốc
SHALL	status	`token`

Resource Conformance: supportedExplanationOfBenefit

Base System Profile
Giai trinh quyen loi BHYT VN Core — VN Core ExplanationOfBenefit Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	status	`token`
SHALL	created	`date`	Tìm theo ngày tạo

Resource Conformance: supportedDiagnosticReport

Base System Profile
Báo cáo cận lâm sàng VN Core — VN Core DiagnosticReport Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create.

Documentation

Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025, QĐ 1227)

Search Parameters

Conformance	Parameter	Type	Documentation
SHALL	patient	`reference`	Tìm theo bệnh nhân
SHALL	code	`token`	Tìm theo loại báo cáo (LOINC)
SHALL	date	`date`	Tìm theo ngày báo cáo
SHALL	category	`token`	Tìm theo nhóm CLS (XN, CĐHA, GPB)
SHALL	encounter	`reference`	Tìm theo lượt khám liên quan