VN Core Server CapabilityStatement

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

CapabilityStatement: VN Core Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ FHIR theo VN Core (Thử nghiệm)

URL chính thức: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-server	Phiên bản: 0.8.0	Tô nổi bật phần thay đổi?
		Computable Name: VNCoreServerCapabilityStatement
Định danh khác: OID:2.25.161089673617632664299011809196868855799.13.5

Máy chủ FHIR tuân thủ VN Core IG PHẢI đáp ứng tối thiểu các yêu cầu được liệt kê dưới đây. Đây là CapabilityStatement yêu cầu mức cơ sở; khi triển khai theo từng vai trò cụ thể nên tham chiếu thêm VNCoreEMRServer, VNBHYTGatewayClient, VNBHYTGatewayServer, hoặc VNCitizenAppClient.

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

Language: vi

Implementation Guide Version: 0.8.0
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: `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/QH15 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	`_include`	`_revinclude`	Operations
Patient	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient	Y	Y	Y	Y	identifier, name, birthdate, gender, vn-cccd, vn-bhyt, vn-bhxh, vn-gks		`Encounter:patient`, `Observation:patient`, `Condition:patient`, `Procedure:patient`, `AllergyIntolerance:patient`, `MedicationRequest:patient`, `DiagnosticReport:patient`, `DocumentReference:patient`, `Coverage:beneficiary`, `CarePlan:patient`, `EpisodeOfCare:patient`, `ServiceRequest:patient`, `Consent:patient`, `Immunization:patient`, `ImagingStudy:patient`	`$summary`
RelatedPerson	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson	Y	Y	Y	Y	patient, identifier, name
Practitioner	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner	Y	Y			identifier, name, vn-gphn, vn-cchn
PractitionerRole	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role	Y	Y			practitioner, organization, location
Organization	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization	Y	Y			identifier, name, vn-cskcb
Location	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location	Y	Y	Y	Y	identifier, organization, partof, name
Encounter	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter	Y	Y	Y	Y	patient, date, status, class, vn-malydo, vn-ma-luot-kcb	`Encounter:patient`, `Encounter:service-provider`	`Observation:encounter`, `Condition:encounter`, `Procedure:encounter`, `DiagnosticReport:encounter`, `ServiceRequest:encounter`
Condition	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition	Y	Y		Y	patient, code, encounter, vn-icd10	`Condition:patient`, `Condition:encounter`
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 Phân loại ưu tiên cấp cứu VN Core — VN Core Triage Acuity Observation Phân loại sức khỏe VN Core — VN Core Observation Health Classification Profile	Y	Y		Y	patient, code, date, category	`Observation:patient`, `Observation:encounter`
Specimen	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen	Y	Y	Y	Y	subject, type, accession	`Specimen:subject`
AllergyIntolerance	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance	Y	Y		Y	patient, clinical-status	`AllergyIntolerance:patient`
Procedure	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure	Y	Y		Y	patient, code, date	`Procedure:patient`, `Procedure:encounter`
Coverage	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage	Y	Y			beneficiary, identifier, subscriber, status, vn-bhyt-card, vn-ma-dkbd	`Coverage:beneficiary`, `Coverage:payor`
Claim	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim	Y	Y	Y	Y	patient, provider, status, created, vn-ma-lk	`Claim:patient`, `Claim:insurer`, `Claim:provider`		`$reverse-bhyt-claim`
Bundle	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle								`$validate-bhyt-claim`, `$submit-bhyt-claim`
AuditEvent	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-event	Y	Y		Y	date, patient, agent
Provenance	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-provenance	Y	Y		Y	target, recorded
MedicationRequest	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request	Y	Y	Y	Y	patient, status, intent, authoredon, medication	`MedicationRequest:patient`, `MedicationRequest:medication`, `MedicationRequest:requester`
ServiceRequest	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request	Y	Y	Y	Y	patient, status, category, code, authored	`ServiceRequest:patient`, `ServiceRequest:encounter`, `ServiceRequest:requester`
DocumentReference	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference	Y	Y		Y	patient, type, date, encounter, custodian	`DocumentReference:patient`, `DocumentReference:encounter`
ClaimResponse	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response	Y	Y			patient, request, status, vn-xml1-id	`ClaimResponse:patient`, `ClaimResponse:request`
ExplanationOfBenefit	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit	Y	Y			patient, status, created	`ExplanationOfBenefit:patient`, `ExplanationOfBenefit:claim`, `ExplanationOfBenefit:coverage`
DiagnosticReport	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report	Y	Y		Y	patient, code, date, category, encounter	`DiagnosticReport:subject`, `DiagnosticReport:result`, `DiagnosticReport: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 Additional supported profiles: Thiết bị cấy ghép VN Core — VN Core Implantable Device Profile	Y	Y			type, status, vn-device-group, vn-ma-vat-tu, vn-registration-number, vn-risk-class
DeviceUseStatement	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement	Y	Y			patient, device
Consent	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent	Y	Y	Y	Y	patient, status, category, date
Composition	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition Additional supported profiles: Giấy khám sức khỏe định kỳ VN Core — VN Core Health Checkup Composition Profile Sổ Sức khỏe điện tử VN Core — VN Core Health Record Summary (Patient Summary) Profile Sổ Sức khỏe điện tử bản IPS quốc tế — VN Core IPS Composition Profile	Y	Y	Y	Y	patient, type, date, encounter	`Composition:subject`, `Composition:author`, `Composition:encounter`
EpisodeOfCare	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-episode-of-care	Y	Y	Y	Y	patient, status, type
CarePlan	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-care-plan	Y	Y	Y	Y	patient, status, category, date
CareTeam	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-care-team	Y	Y	Y	Y	patient, status
Goal	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-goal	Y	Y		Y	patient, lifecycle-status, category
ClinicalImpression	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-clinical-impression	Y	Y		Y	patient, status, date
MedicationStatement	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-statement	Y	Y		Y	patient, status
MedicationDispense	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispense	Y	Y		Y	patient, status	`MedicationDispense:patient`, `MedicationDispense:prescription`
MedicationAdministration	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-administration	Y	Y		Y	patient, context, status	`MedicationAdministration:patient`, `MedicationAdministration:request`
FamilyMemberHistory	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-family-member-history	Y	Y		Y	patient, status
Questionnaire	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-questionnaire	Y	Y			url, status
QuestionnaireResponse	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-questionnaire-response	Y	Y		Y	patient, questionnaire, status
Immunization	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-immunization	Y	Y		Y	patient, status, date
ImagingStudy	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-imaging-study	Y	Y			patient, status
HealthcareService	http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-healthcare-service	Y	Y			organization, active

Resource Conformance: unspecifiedPatient

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

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

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	identifier	`token`	Tìm theo CCCD, mã BHXH, GKS, hộ chiếu, MRN hoặc định danh khác
SHOULD	name	`string`	Tìm theo họ tên (hỗ trợ Unicode tiếng Việt)
SHOULD	birthdate	`date`
SHOULD	gender	`token`
SHOULD	vn-cccd	`token`	Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023)
SHOULD	vn-bhyt	`token`	Tìm theo số thẻ BHYT (Luật BHYT)
SHOULD	vn-bhxh	`token`	Tìm theo mã số BHXH 10 chữ số
SHOULD	vn-gks	`token`	Tìm theo số Giấy khai sinh

Extended Operations

Conformance	Operation	Documentation
SHOULD	$summary	Sinh tóm tắt hồ sơ sức khỏe IPS cho bệnh nhân (Patient/[id]/$summary)

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

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Cha/mẹ/người giám hộ/người đại diện — VNCoreRelatedPerson profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm RelatedPerson theo bệnh nhân liên quan
SHOULD	identifier	`token`	Tìm theo CCCD hoặc hộ chiếu của người liên quan
SHOULD	name	`string`

Resource Conformance: unspecifiedPractitioner

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

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

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	identifier	`token`	Tìm theo GPHN hiện hành, CCCD, hoặc CCHN lịch sử
SHOULD	name	`string`
SHOULD	vn-gphn	`token`	Tìm theo số Giấy phép hành nghề khám bệnh, chữa bệnh hiện hành
SHOULD	vn-cchn	`token`	Tìm theo số Chứng chỉ hành nghề lịch sử khi chuyển đổi dữ liệu cũ

Resource Conformance: unspecifiedPractitionerRole

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

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

Search Parameters

Conformance	Parameter	Type
SHOULD	practitioner	`reference`
SHOULD	organization	`reference`
SHOULD	location	`reference`

Resource Conformance: unspecifiedOrganization

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Cơ sở KCB — VNCoreOrganization profile

Search Parameters

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

Resource Conformance: unspecifiedLocation

Base System Profile
Địa điểm cung cấp dịch vụ VN Core — VN Core Location Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Khoa/phòng/địa điểm cung cấp dịch vụ — VNCoreLocation profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	identifier	`token`	Tìm theo mã khoa/phòng hoặc mã địa điểm nội bộ
SHOULD	organization	`reference`	Tìm các Location thuộc một Organization
SHOULD	partof	`reference`	Tìm các Location con
SHOULD	name	`string`	Tìm theo tên khoa/phòng/địa điểm

Resource Conformance: unspecifiedEncounter

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

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

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`
SHOULD	date	`date`
SHOULD	status	`token`
SHOULD	class	`token`
SHOULD	vn-malydo	`token`	Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT)
SHOULD	vn-ma-luot-kcb	`token`	Tìm theo Identifier MA_LUOT_KCB dùng đối soát BHXH; system khuyến nghị = http://fhir.hl7.org.vn/core/sid/ma-luot-kcb

Resource Conformance: unspecifiedCondition

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Chẩn đoán — VNCoreCondition profile

Search Parameters

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

Resource Conformance: unspecifiedObservation

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
Phân loại ưu tiên cấp cứu VN Core — VN Core Triage Acuity Observation
Phân loại sức khỏe VN Core — VN Core Observation Health Classification Profile

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Kết quả xét nghiệm, sinh hiệu, quan sát YHCT, phân loại ưu tiên cấp cứu (triage) và phân loại sức khỏe KSK — VNCoreObservationLab + VitalSigns + YHCT + TriageAcuity + HealthClassification profiles

Search Parameters

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

Resource Conformance: unspecifiedSpecimen

Base System Profile
Mẫu bệnh phẩm VN Core — VN Core Specimen Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Mẫu bệnh phẩm — VNCoreSpecimen profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	subject	`reference`	Tìm theo bệnh nhân cung cấp mẫu
SHOULD	type	`token`	Tìm theo loại mẫu bệnh phẩm
SHOULD	accession	`token`	Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm

Resource Conformance: unspecifiedAllergyIntolerance

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Dị ứng — VNCoreAllergyIntolerance profile

Search Parameters

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

Resource Conformance: unspecifiedProcedure

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

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

Search Parameters

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

Resource Conformance: unspecifiedCoverage

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Thẻ BHYT — VNCoreCoverage profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	beneficiary	`reference`	Tìm theo bệnh nhân thụ hưởng BHYT
SHOULD	identifier	`token`	Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ)
SHOULD	subscriber	`reference`	Tìm theo subscriber của Coverage
SHOULD	status	`token`
SHOULD	vn-bhyt-card	`token`	Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)
SHOULD	vn-ma-dkbd	`token`	Tìm theo mã nơi ĐKKCB ban đầu MA_DKBD

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

SHALL support read, search-type.
SHOULD support create, update.

Documentation

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

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	provider	`reference`	Tìm theo cơ sở KCB
SHOULD	status	`token`
SHOULD	created	`date`	Tìm theo ngày tạo yêu cầu
SHOULD	vn-ma-lk	`token`	Tìm theo mã liên kết hồ sơ MA_LK

Extended Operations

Conformance	Operation	Documentation
SHOULD	$reverse-bhyt-claim	Thu hồi/đảo hồ sơ BHYT đã gửi

Resource Conformance: unspecifiedBundle

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

Documentation

Bundle hồ sơ thanh toán BHYT — VNCoreBHYTSubmissionBundle profile; endpoint cho operations validate/submit

Extended Operations

Conformance	Operation	Documentation
SHOULD	$validate-bhyt-claim	Validate Bundle hồ sơ BHYT trước khi gửi Cổng giám định BHXH
SHOULD	$submit-bhyt-claim	Gửi hồ sơ thanh toán BHYT theo lớp liên thông hồ sơ BHYT

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

SHALL support read, search-type.
SHOULD support create.

Documentation

Nhật ký truy cập/chia sẻ dữ liệu y tế — VNCoreAuditEvent profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	date	`date`	Tìm theo thời điểm ghi nhận audit
SHOULD	patient	`reference`	Tìm audit liên quan tới bệnh nhân
SHOULD	agent	`reference`	Tìm theo người/hệ thống thực hiện hành động

Resource Conformance: unspecifiedProvenance

Base System Profile
Nguồn gốc dữ liệu và chữ ký số VN Core — VN Core Provenance Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Nguồn gốc và chữ ký số của tài liệu/hồ sơ y tế — VNCoreProvenance profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	target	`reference`	Tìm theo resource đích được ký/xác nhận
SHOULD	recorded	`date`	Tìm theo thời điểm ghi nhận provenance

Resource Conformance: unspecifiedMedicationRequest

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

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

Search Parameters

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

Resource Conformance: unspecifiedServiceRequest

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

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025/TT-BYT, TT 23/2024/TT-BYT)

Search Parameters

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

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

SHALL support read, search-type.
SHOULD support create.

Documentation

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

Search Parameters

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

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

SHALL support read, search-type.

Documentation

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

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	request	`reference`	Tìm theo Claim gốc
SHOULD	status	`token`
SHOULD	vn-xml1-id	`token`	Tìm theo XML1_ID/mã phản hồi gateway của hồ sơ BHYT

Resource Conformance: unspecifiedExplanationOfBenefit

Base System Profile
Giải trình quyền lợi BHYT VN Core — VN Core ExplanationOfBenefit Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

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

Search Parameters

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

Resource Conformance: unspecifiedDiagnosticReport

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

SHALL support read, search-type.
SHOULD support create.

Documentation

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

Search Parameters

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

Resource Conformance: unspecifiedMedication

Base System Profile
Thuốc VN Core — VN Core Medication Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	code	`token`	Tìm theo mã thuốc (ATC, SNOMED CT)
SHOULD	status	`token`

Resource Conformance: unspecifiedDevice

Base System Profile
Thiết bị y tế VN Core — VN Core Device Profile

Profile Conformance
SHALL

Reference Policy

Supported Profiles

Thiết bị cấy ghép VN Core — VN Core Implantable Device Profile

Interaction summary

SHALL support read, search-type.

Documentation

Trang thiết bị y tế — VNCoreDevice profile; thiết bị cấy ghép gắn người bệnh dùng thêm VNCoreImplantableDevice

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	type	`token`	Tìm theo loại thiết bị
SHOULD	status	`token`
SHOULD	vn-device-group	`token`	Tìm TBYT theo nhóm BHYT (N01–N09)
SHOULD	vn-ma-vat-tu	`token`	Tìm TBYT theo mã vật tư y tế
SHOULD	vn-registration-number	`token`	Tìm TBYT theo số đăng ký lưu hành
SHOULD	vn-risk-class	`token`	Tìm TBYT theo phân loại rủi ro A/B/C/D (NĐ 98/2021/NĐ-CP)

Resource Conformance: unspecifiedDeviceUseStatement

Base System Profile
Ghi nhận sử dụng VTYT VN Core — VN Core DeviceUseStatement Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	device	`reference`	Tìm theo thiết bị

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

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Đồng ý xử lý DLCN y tế — VNCoreConsent profile (Luật 91/2025/QH15)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	status	`token`	Tìm theo trạng thái (active, rejected, inactive)
SHOULD	category	`token`	Tìm theo loại đồng ý
SHOULD	date	`date`	Tìm theo ngày đồng ý

Resource Conformance: unspecifiedComposition

Base System Profile
Bệnh án điện tử VN Core — VN Core Composition Profile

Profile Conformance
SHALL

Reference Policy

Supported Profiles

Giấy khám sức khỏe định kỳ VN Core — VN Core Health Checkup Composition Profile
Sổ Sức khỏe điện tử VN Core — VN Core Health Record Summary (Patient Summary) Profile
Sổ Sức khỏe điện tử bản IPS quốc tế — VN Core IPS Composition Profile

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Bệnh án điện tử + giấy KSK + Sổ SKĐT (nội địa & bản IPS quốc tế) — VNCoreComposition + HealthCheckup/HealthRecordSummary/IPS profiles (TT 13/2025/TT-BYT, QĐ 1332/QĐ-BYT, QĐ 1551/QĐ-BYT hợp nhất QĐ 2062/QĐ-BYT)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	type	`token`	Tìm theo loại bệnh án (LOINC)
SHOULD	date	`date`	Tìm theo ngày lập bệnh án
SHOULD	encounter	`reference`	Tìm theo lượt khám

Resource Conformance: unspecifiedEpisodeOfCare

Base System Profile
Đợt chăm sóc VN Core — VN Core EpisodeOfCare Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Đợt chăm sóc — VNCoreEpisodeOfCare profile (TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type
SHOULD	patient	`reference`
SHOULD	status	`token`
SHOULD	type	`token`

Resource Conformance: unspecifiedCarePlan

Base System Profile
Kế hoạch chăm sóc VN Core — VN Core CarePlan Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Kế hoạch chăm sóc — VNCoreCarePlan profile (TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type
SHOULD	patient	`reference`
SHOULD	status	`token`
SHOULD	category	`token`
SHOULD	date	`date`

Resource Conformance: unspecifiedCareTeam

Base System Profile
Nhóm chăm sóc VN Core — VN Core CareTeam Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create, update.

Documentation

Nhóm chăm sóc — VNCoreCareTeam profile (TT 13/2025/TT-BYT, Luật KCB 2023)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`
SHOULD	status	`token`

Resource Conformance: unspecifiedGoal

Base System Profile
Mục tiêu điều trị VN Core — VN Core Goal Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Mục tiêu điều trị — VNCoreGoal profile (TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type
SHOULD	patient	`reference`
SHOULD	lifecycle-status	`token`
SHOULD	category	`token`

Resource Conformance: unspecifiedClinicalImpression

Base System Profile
Nhận định lâm sàng VN Core — VN Core ClinicalImpression Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Nhận định lâm sàng — VNCoreClinicalImpression profile (TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type
SHOULD	patient	`reference`
SHOULD	status	`token`
SHOULD	date	`date`

Resource Conformance: unspecifiedMedicationStatement

Base System Profile
Tiền sử dùng thuốc VN Core — VN Core MedicationStatement Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Tiền sử dùng thuốc — VNCoreMedicationStatement profile (TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`
SHOULD	status	`token`

Resource Conformance: unspecifiedMedicationDispense

Base System Profile
Cấp phát thuốc VN Core — VN Core Medication Dispense Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Cấp phát thuốc — VNCoreMedicationDispense profile (TT 13/2025/TT-BYT, TT 26/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`
SHOULD	status	`token`

Resource Conformance: unspecifiedMedicationAdministration

Base System Profile
Sử dụng/Cho dùng thuốc VN Core — VN Core Medication Administration Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Cho dùng thuốc — VNCoreMedicationAdministration profile (TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type
SHOULD	patient	`reference`
SHOULD	context	`reference`
SHOULD	status	`token`

Resource Conformance: unspecifiedFamilyMemberHistory

Base System Profile
Tiền sử gia đình VN Core — VN Core FamilyMemberHistory Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Tiền sử gia đình — VNCoreFamilyMemberHistory profile (QĐ 1551/QĐ-BYT, TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`
SHOULD	status	`token`

Resource Conformance: unspecifiedQuestionnaire

Base System Profile
Phiếu khám sức khỏe VN Core — VN Core Questionnaire (KSK form) Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Mẫu phiếu KSK — VNCoreQuestionnaire profile (QĐ 2062/QĐ-BYT Phụ lục 01, HL7 SDC); 3 mẫu theo nhóm tuổi VNKSKQuestionnaireU06/06to18/18Plus + mẫu tâm thần VNKSKQuestionnaireMental (TT 25/2026/TT-BYT). 17 mẫu QĐ 1551/QĐ-BYT (VNKSKQuestionnaire01–17) đã retired.

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	url	`uri`
SHOULD	status	`token`

Resource Conformance: unspecifiedQuestionnaireResponse

Base System Profile
Kết quả phiếu khám sức khỏe VN Core — VN Core QuestionnaireResponse Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Kết quả phiếu KSK — VNCoreQuestionnaireResponse profile (QĐ 2062/QĐ-BYT Phụ lục 01, TT 13/2025/TT-BYT)

Search Parameters

Conformance	Parameter	Type
SHOULD	patient	`reference`
SHOULD	questionnaire	`reference`
SHOULD	status	`token`

Resource Conformance: unspecifiedImmunization

Base System Profile
Tiêm chủng — VN Core Immunization

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.
SHOULD support create.

Documentation

Tiêm chủng — VNCoreImmunization profile (Luật 114/2025/QH15 — đang áp dụng từ 01/07/2026; TCMR)

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	status	`token`	Tìm theo trạng thái (completed, entered-in-error, not-done)
SHOULD	date	`date`	Tìm theo ngày tiêm

Resource Conformance: unspecifiedImagingStudy

Base System Profile
Nghiên cứu CĐHA VN Core — VN Core Imaging Study Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Chẩn đoán hình ảnh — VNCoreImagingStudy profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	patient	`reference`	Tìm theo bệnh nhân
SHOULD	status	`token`	Tìm theo trạng thái (available, cancelled, entered-in-error)

Resource Conformance: unspecifiedHealthcareService

Base System Profile
Dịch vụ y tế VN Core — VN Core HealthcareService Profile

Profile Conformance
SHALL

Reference Policy

Interaction summary

SHALL support read, search-type.

Documentation

Dịch vụ y tế — VNCoreHealthcareService profile

Search Parameters

Conformance	Parameter	Type	Documentation
SHOULD	organization	`reference`	Tìm theo cơ sở cung cấp dịch vụ
SHOULD	active	`token`	Tìm theo trạng thái hoạt động

CapabilityStatement: VN Core Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ FHIR theo VN Core (Thử nghiệm)