HL7 Vietnam VN Core FHIR Implementation Guide

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam
0.3.0 - STU1 Draft Viet Nam cờ

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

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

URL chính thức: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-emr-server Phiên bản: 0.3.0
Computable Name: VNCoreEMRServerCapabilityStatement

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ủ EMR/EHR nội bộ triển khai VN Core Base. Tập trung vào hồ sơ bệnh nhân, hồ sơ lâm sàng, tài liệu, Consent, AuditEventProvenance. / Minimum conformance requirements for internal EMR/EHR servers implementing VN Core Base.

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

Language: vi

VN Core EMR Server CapabilityStatement

  • Implementation Guide Version: 0.3.0
  • FHIR Version: 4.0.1
  • Supported Formats: json, xml
  • Published on: 2026-03-23
  • 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ủ EMR/EHR nội bộ nên dùng CapabilityStatement này làm bộ yêu cầu mức cơ sở ổn định cho VN Core Base, tách biệt với lớp liên thông hồ sơ BHYT (BHYT Submission).

Security
Enable CORS: yes
Security services supported: SMART-on-FHIR

Khuyến nghị OAuth 2.0/SMART-on-FHIR, phân quyền theo vai trò, ghi AuditEvent cho mọi truy cập hồ sơ y tế và hỗ trợ break-glass theo chính sách đơn vị.

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 TypeProfileRSUCSearches_include_revincludeOperations
Patienthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patientyyyyidentifier, name, birthdate
RelatedPersonhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedpersonyyyypatient, identifier
Locationhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-locationyyyyorganization, partof, name
Encounterhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounteryyyypatient, date
Conditionhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-conditionyyypatient, code
Observationhttp://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
yyypatient, code
ServiceRequesthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-requestyyyypatient, encounter, authored
Specimenhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimenyyyysubject, type, accession
DiagnosticReporthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-reportyyyypatient, code, date
MedicationRequesthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-requestyyyypatient, encounter, authoredon
Procedurehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedureyyyypatient, code, date
AllergyIntolerancehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intoleranceyyyypatient, clinical-status, code
Coveragehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverageyybeneficiary, identifier
DocumentReferencehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-referenceyyyypatient, type
Compositionhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-compositionyyyypatient, date
Consenthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consentyyyypatient, status
AuditEventhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-eventyydate, patient
Provenancehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-provenanceyyytarget

Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken
SHALLnamestring
SHALLbirthdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLidentifiertoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLorganizationreference
SHALLpartofreference
SHALLnamestring
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLcodetoken
 
Profile Conformance
SHALL
Reference Policy

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLcodetoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLencounterreference
SHALLauthoreddate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLsubjectreference
SHALLtypetoken
SHALLaccessiontoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLcodetoken
SHALLdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLencounterreference
SHALLauthoredondate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLcodetoken
SHALLdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLclinical-statustoken
SHALLcodetoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLbeneficiaryreference
SHALLidentifiertoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLtypetoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHALLstatustoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLdatedate
SHALLpatientreference
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports read, search-type, create.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLtargetreference