HL7 Vietnam VN Core FHIR Implementation Guide

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide
0.10.0 - Draft for Community Review Viet Nam cờ

Hướng dẫn triển khai FHIR cốt lõi Việt Nam — VN Core FHIR Implementation Guide - Draft for Community Review (v0.10.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.10.0
Computable Name: VNCoreEMRServerCapabilityStatement
Định danh khác: OID:2.25.161089673617632664299011809196868855799.13.6

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, AuditEvent và Provenance. / 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.10.0
  • FHIR Version: 4.0.1
  • Supported Formats: json, xml
  • Published on: 2026-09-11
  • 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ị.

Summary of System-wide Interactions
  • SHOULD support the transactioninteraction described as follows:

    Bundle type=transaction PHẢI nguyên tử: hoặc mọi entry được áp dụng, hoặc không entry nào. Máy chủ không bảo đảm được tính nguyên tử thì KHÔNG khai transaction và bên gửi phải có hợp đồng bù trừ riêng.

  • SHOULD support the batchinteraction described as follows:

    Bundle type=batch KHÔNG nguyên tử — mỗi entry thành/bại độc lập. Không dùng batch cho nhóm dữ liệu phải nhất quán với nhau.

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 TypeProfileRV-RSUCH-ISearches_include_revincludeOperations
Patienthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patientYYYYYYidentifier, 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-relatedpersonYYYYYYpatient, identifier
Locationhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-locationYYYYYYorganization, partof, name, identifier
Encounterhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounterYYYYYYpatient, date, identifierEncounter:patient, Encounter:service-providerObservation:encounter, Condition:encounter, Procedure:encounter, DiagnosticReport:encounter, ServiceRequest:encounter
Conditionhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition
Additional supported profiles:
  Chẩn đoán lượt khám VN Core — VN Core Encounter Diagnosis Condition Profile
YYYYpatient, code, identifierCondition: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
  Huyết áp VN Core — VN Core Observation Blood Pressure Profile
  Chiều cao VN Core — VN Core Observation Body Height Profile
  Cân nặng VN Core — VN Core Observation Body Weight Profile
  Nhiệt độ cơ thể VN Core — VN Core Observation Body Temperature Profile
  Mạch VN Core — VN Core Observation Heart Rate Profile
  Nhịp thở VN Core — VN Core Observation Respiratory Rate Profile
  SpO2 VN Core — VN Core Observation SpO2 Profile
YYYYpatient, code, identifierObservation:patient, Observation:encounter
ServiceRequesthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-requestYYYYYYpatient, encounter, authored, identifierServiceRequest:patient, ServiceRequest:encounter, ServiceRequest:requester
Specimenhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimenYYYYYYsubject, type, accession, identifierSpecimen:subject
DiagnosticReporthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report
Additional supported profiles:
  Báo cáo Xét nghiệm VN Core — VN Core Lab DiagnosticReport
  Báo cáo Chẩn đoán hình ảnh VN Core — VN Core Imaging DiagnosticReport
  Báo cáo Giải phẫu bệnh VN Core — VN Core Pathology DiagnosticReport
YYYYYYpatient, code, date, identifierDiagnosticReport:subject, DiagnosticReport:result, DiagnosticReport:encounter
MedicationRequesthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request
Additional supported profiles:
  Đơn thuốc ngoại trú VN Core — VN Core Outpatient Prescription Profile
  Đơn thuốc cổ truyền ngoại trú VN Core — VN Core Traditional-Medicine Outpatient Prescription Profile
YYYYYYpatient, encounter, authoredon, identifierMedicationRequest:patient, MedicationRequest:medication, MedicationRequest:requester
Procedurehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedureYYYYYYpatient, code, date, identifierProcedure:patient, Procedure:encounter
AllergyIntolerancehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intoleranceYYYYYYpatient, clinical-status, code, identifierAllergyIntolerance:patient
Coveragehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverageYYYbeneficiary, identifierCoverage:beneficiary, Coverage:payor
DocumentReferencehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference
Additional supported profiles:
  Bản Giấy chứng sinh đã ký — VN Core Birth Certificate DocumentReference
YYYYYYpatient, type, identifierDocumentReference:patient, DocumentReference:encounter
Compositionhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition
Additional supported profiles:
  Giấy chứng sinh — VN Core Birth Certificate Composition
  Giấy chứng sinh mang thai hộ — VN Core Surrogacy Birth Certificate Composition
YYYYYYpatient, date, identifierComposition:subject, Composition:author, Composition:encounter
Consenthttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consentYYYYYYpatient, status, identifier
AuditEventhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-eventYYdate, patient
Provenancehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-provenanceYYYtarget
Medicationhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medicationYYY
MedicationDispensehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-dispenseYYYYYYpatient, identifierMedicationDispense:patient, MedicationDispense:medication
MedicationAdministrationhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-administrationYYYYYYpatient, identifierMedicationAdministration:patient, MedicationAdministration:medication
MedicationStatementhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-statementYYYYYYpatient, identifierMedicationStatement:patient
Immunizationhttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-immunizationYYYYYYpatient, identifierImmunization:patient
AdverseEventSupported Profiles
  Sự cố bất lợi sau tiêm chủng — VN Core Adverse Event Post Immunization
  Sự cố y khoa — VN Core Adverse Event (Patient Safety)
YYYYYYsubject, identifierAdverseEvent:subject
Bundlehttp://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bundle
Additional supported profiles:
  Document Bundle bàn giao bảng kê chi phí — VN Core Cost Statement Document Bundle
YYYidentifier

Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDidentifiertoken
SHOULDnamestring
SHOULDbirthdatedate
 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDidentifiertoken
 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDorganizationreference
SHOULDpartofreference
SHOULDnamestring
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDdatedate
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDencounterreference
SHOULDauthoreddate
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDsubjectreference
SHOULDtypetoken
SHOULDaccessiontoken
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
SHOULDdatedate
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDencounterreference
SHOULDauthoredondate
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDcodetoken
SHOULDdatedate
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDclinical-statustoken
SHOULDcodetoken
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDbeneficiaryreference
SHOULDidentifiertoken
 
Profile Conformance
SHALL
Reference Policy
literal

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

Documentation

Gồm cả tham chiếu tài liệu giấy chứng sinh lưu trong hồ sơ bệnh án điện tử.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDtypetoken
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Documentation

Gồm cả giấy chứng sinh đã lập, lưu cùng hồ sơ người bệnh.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDdatedate
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDpatientreference
SHOULDstatustoken
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

Interaction summary
  • SHALL support read, search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDdatedate
SHOULDpatientreference
 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDtargetreference
 
Profile Conformance
SHALL
Reference Policy
literal

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

Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatientreference
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Core FHIR Resource
AdverseEvent
Reference Policy
literal
Interaction summary
  • SHALL support read, search-type, create.
  • SHOULD support update, vread, history-instance.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLsubjectreference
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.

 
Profile Conformance
SHALL
Reference Policy
literal

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

Documentation

Kho bệnh án điện tử lưu bảng kê chi phí KCB đã lập, giữ nguyên nội dung và chữ ký.

Search Parameters
ConformanceParameterTypeDocumentation
SHOULDidentifiertoken

Tiêu chí đối sánh của If-None-Exist khi tạo có điều kiện — bên gửi dùng identifier={system}|{value} để lần gửi lại không sinh bản ghi thứ hai.