HL7 Vietnam VN Core FHIR Implementation Guide

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

Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam - Local Development build (v0.6.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.6.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.6.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ủ 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, birthdateEncounter:patient, Observation:patient, Condition:patient, Procedure:patient, AllergyIntolerance:patient, MedicationRequest:patient, DiagnosticReport:patient, DocumentReference:patient, Coverage:beneficiary, ServiceRequest:patient, Consent:patient
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, dateEncounter:patient, Encounter:service-providerObservation:encounter, Condition:encounter, Procedure:encounter, DiagnosticReport:encounter, ServiceRequest:encounter
Conditionhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-conditionYYYpatient, codeCondition:patient, Condition:encounter
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, codeObservation:patient, Observation:encounter
ServiceRequesthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-requestYYYYpatient, encounter, authoredServiceRequest:patient, ServiceRequest:encounter, ServiceRequest:requester
Specimenhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimenYYYYsubject, type, accessionSpecimen:subject
DiagnosticReporthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-reportYYYYpatient, code, dateDiagnosticReport:subject, DiagnosticReport:result, DiagnosticReport:encounter
MedicationRequesthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-requestYYYYpatient, encounter, authoredonMedicationRequest:patient, MedicationRequest:medication, MedicationRequest:requester
Procedurehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedureYYYYpatient, code, dateProcedure:patient, Procedure:encounter
AllergyIntolerancehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intoleranceYYYYpatient, clinical-status, codeAllergyIntolerance:patient
Coveragehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverageYYbeneficiary, identifierCoverage:beneficiary, Coverage:payor
DocumentReferencehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-referenceYYYYpatient, typeDocumentReference:patient, DocumentReference:encounter
Compositionhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-compositionYYYYpatient, dateComposition:subject, Composition:author, Composition:encounter
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
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDidentifiertoken
SHOULDnamestring
SHOULDbirthdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDidentifiertoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDorganizationreference
SHOULDpartofreference
SHOULDnamestring
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
 
Profile Conformance
SHALL
Reference Policy

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDencounterreference
SHOULDauthoreddate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDsubjectreference
SHOULDtypetoken
SHOULDaccessiontoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
SHOULDdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDencounterreference
SHOULDauthoredondate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
SHOULDdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDclinical-statustoken
SHOULDcodetoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDbeneficiaryreference
SHOULDidentifiertoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDtypetoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDdatedate
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create, update.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDstatustoken
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDdatedate
SHOULDpatientreference
 
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • SHALL support read, search-type.
  • SHOULD support create.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDtargetreference