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

VN Core Server 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: 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ư.

Summary of System-wide Operations

Conformance | Operation | Documentation

SHALL

$validate-bhyt-claim

SHALL

$submit-bhyt-claim

SHALL

$reverse-bhyt-claim

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

Specimen | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen | y | y | y | y | subject, type, accession | | |
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, subscriber, status, vn-bhyt-card, vn-ma-dkbd | | |
Claim | http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim | y | y | y | y | patient, provider, status, created, vn-ma-lk | | |
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 | | |
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, vn-xml1-id | | |
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
Additional supported profiles:
Thiết bị cấy ghép VN Core — VN Core Implantable Device Profile

y

y

type, status

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 | y | y | y | y | patient, type, date, encounter | | |

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, 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, GKS, hộ chiếu, MRN hoặc định danh khác

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)

SHALL

vn-bhxh

token

Tìm theo mã số BHXH 10 chữ số

SHALL

vn-gks

token

Tìm theo số Giấy khai sinh

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

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

patient

reference

Tìm RelatedPerson theo bệnh nhân liên quan

SHALL

identifier

token

Tìm theo CCCD hoặc hộ chiếu của người liên quan

SHALL

name

string

Resource Conformance: unspecified Practitioner

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 GPHN hiện hành, CCCD, hoặc CCHN lịch sử

SHALL

name

string

SHALL

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

SHALL

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

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

SHALL

location

reference

Resource Conformance: unspecified Organization

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

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

Supports read, search-type, create, update.

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

identifier

token

Tìm theo mã khoa/phòng hoặc mã địa điểm nội bộ

SHALL

organization

reference

Tìm các Location thuộc một Organization

SHALL

partof

reference

Tìm các Location con

SHALL

name

string

Tìm theo tên khoa/phòng/địa điểm

Resource Conformance: unspecified Encounter

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)

SHALL

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

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

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

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

subject

reference

Tìm theo bệnh nhân cung cấp mẫu

SHALL

type

token

Tìm theo loại mẫu bệnh phẩm

SHALL

accession

token

Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm

Resource Conformance: unspecified AllergyIntolerance

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

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

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

subscriber

reference

Tìm theo subscriber của Coverage

SHALL

status

token

SHALL

vn-bhyt-card

token

Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)

SHALL

vn-ma-dkbd

token

Tìm theo mã nơi ĐKKCB ban đầu MA_DKBD

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

SHALL

vn-ma-lk

token

Tìm theo mã liên kết hồ sơ MA_LK

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

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

date

date

Tìm theo thời điểm ghi nhận audit

SHALL

patient

reference

Tìm audit liên quan tới bệnh nhân

SHALL

agent

reference

Tìm theo người/hệ thống thực hiện hành động

Resource Conformance: unspecified Provenance

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

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

SHALL

target

reference

Tìm theo resource đích được ký/xác nhận

SHALL

recorded

date

Tìm theo thời điểm ghi nhận provenance

Resource Conformance: unspecified MedicationRequest

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

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

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

SHALL

vn-xml1-id

token

Tìm theo XML1_ID/mã phản hồi gateway của hồ sơ BHYT

Resource Conformance: unspecified ExplanationOfBenefit

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

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

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

Resource Conformance: unspecified Medication

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

code

token

Tìm theo mã thuốc (ATC, SNOMED CT)

SHALL

status

token

Resource Conformance: unspecified Device

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

Supports 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

SHALL

type

token

Tìm theo loại thiết bị

SHALL

status

token

Resource Conformance: unspecified DeviceUseStatement

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type.

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

patient

reference

Tìm theo bệnh nhân

SHALL

device

reference

Tìm theo thiết bị

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.

Documentation

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

Search Parameters

Conformance | Parameter | Type | Documentation

SHALL

patient

reference

Tìm theo bệnh nhân

SHALL

status

token

Tìm theo trạng thái (active, rejected, inactive)

SHALL

category

token

Tìm theo loại đồng ý

SHALL

date

date

Tìm theo ngày đồng ý

Resource Conformance: unspecified Composition

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

Profile Conformance
SHALL

Reference Policy

Interaction summary

Supports read, search-type, create, update.

Documentation

Bệnh án điện tử — VNCoreComposition 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 bệnh án (LOINC)

SHALL

date

date

Tìm theo ngày lập bệnh án

SHALL

encounter

reference

Tìm theo lượt khám

# publisher
Omi HealthTech / VN Core FHIR Community Initiative

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

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

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

# rest[].security.description
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ư](security.html).

# rest[].resource[].documentation
Bệnh nhân Việt Nam — VNCorePatient profile

# rest[].resource[].searchParam[].documentation
Tìm theo CCCD, mã BHXH, GKS, hộ chiếu, MRN hoặc định danh khác

# rest[].resource[].searchParam[].documentation
Tìm theo họ tên (hỗ trợ Unicode tiếng Việt)

# rest[].resource[].searchParam[].documentation
Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023)

# rest[].resource[].documentation
Cha/mẹ/người giám hộ/người đại diện — VNCoreRelatedPerson profile

# rest[].resource[].searchParam[].documentation
Tìm RelatedPerson theo bệnh nhân liên quan

# rest[].resource[].searchParam[].documentation
Tìm theo CCCD hoặc hộ chiếu của người liên quan

# rest[].resource[].documentation
Nhân viên y tế — VNCorePractitioner profile

# rest[].resource[].searchParam[].documentation
Tìm theo GPHN hiện hành, CCCD, hoặc CCHN lịch sử

# rest[].resource[].searchParam[].documentation
Tìm theo số Giấy phép hành nghề khám bệnh, chữa bệnh hiện hành

# rest[].resource[].searchParam[].documentation
Tìm theo số Chứng chỉ hành nghề lịch sử khi chuyển đổi dữ liệu cũ

# rest[].resource[].documentation
Vai trò nhân viên y tế — VNCorePractitionerRole profile

# rest[].resource[].searchParam[].documentation
Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT)

# rest[].resource[].documentation
Khoa/phòng/địa điểm cung cấp dịch vụ — VNCoreLocation profile

# rest[].resource[].searchParam[].documentation
Tìm theo mã khoa/phòng hoặc mã địa điểm nội bộ

# rest[].resource[].documentation
Lượt khám/điều trị — VNCoreEncounter profile

# rest[].resource[].searchParam[].documentation
Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT)

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

# rest[].resource[].searchParam[].documentation
Tìm theo mã ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT)

# rest[].resource[].documentation
Kết quả xét nghiệm, sinh hiệu, và quan sát YHCT — VNCoreObservationLab + VNCoreObservationVitalSigns + VNCoreObservationYHCT profiles

# rest[].resource[].searchParam[].documentation
Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm

# rest[].resource[].documentation
Dị ứng — VNCoreAllergyIntolerance profile

# rest[].resource[].documentation
Thủ thuật/phẫu thuật — VNCoreProcedure profile

# rest[].resource[].searchParam[].documentation
Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ)

# rest[].resource[].searchParam[].documentation
Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)

# rest[].resource[].documentation
Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176 → QĐ 697)

# rest[].resource[].documentation
Nhật ký truy cập/chia sẻ dữ liệu y tế — VNCoreAuditEvent profile

# rest[].resource[].searchParam[].documentation
Tìm theo người/hệ thống thực hiện hành động

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

# rest[].resource[].documentation
Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025, Luật Dược 2016)

# rest[].resource[].documentation
Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025, TT 20/2014)

# rest[].resource[].searchParam[].documentation
Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...)

# rest[].resource[].documentation
Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025)

# rest[].resource[].documentation
Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176, QĐ 697)

# rest[].resource[].searchParam[].documentation
Tìm theo XML1_ID/mã phản hồi gateway của hồ sơ BHYT

# rest[].resource[].documentation
Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697)

# rest[].resource[].documentation
Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025, QĐ 1227)

# rest[].resource[].documentation
Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)

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

# rest[].resource[].documentation
Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile

# rest[].resource[].documentation
Đồng ý xử lý DLCN y tế — VNCoreConsent profile (Luật 91/2025)

# rest[].resource[].searchParam[].documentation
Tìm theo trạng thái (active, rejected, inactive)

# rest[].resource[].documentation
Bệnh án điện tử — VNCoreComposition profile (TT 13/2025)