Generated Narrative: CapabilityStatement vn-core-server VN Core Server CapabilityStatement Implementation Guide Version: 0.1.0 FHIR Version: 4.0.1 Supported Formats: json, xml Published on: 2026-03-21 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ủ 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ư. 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 Practitioner http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner y y identifier, name, vn-cchn PractitionerRole http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role y y practitioner, organization Organization http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization y y identifier, name, vn-cskcb Encounter http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter y y y y patient, date, status, class, vn-malydo 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 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, status, vn-bhyt-card Claim http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim y y y y patient, provider, status, created 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 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 y y type, status DeviceUseStatement http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement y y patient, device Resource Conformance: supported 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, hoặc MRN 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) Resource Conformance: supported 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 CCHN hoặc CCCD SHALL name string SHALL vn-cchn token Tìm theo số chứng chỉ hành nghề (Luật KCB 2023) Resource Conformance: supported 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 Resource Conformance: supported 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: supported 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) Resource Conformance: supported 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: supported 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: supported 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: supported 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: supported 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 status token SHALL vn-bhyt-card token Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP) Resource Conformance: supported 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 Resource Conformance: supported 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: supported 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: supported 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: supported 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 Resource Conformance: supported 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: supported 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: supported 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: supported Device Base System Profile Vật tư y tế VN Core — VN Core Device Profile Profile Conformance SHALL Reference Policy Interaction summary Supports read, search-type. Documentation Trang thiết bị y tế — VNCoreDevice profile Search Parameters Conformance Parameter Type Documentation SHALL type token Tìm theo loại thiết bị SHALL status token Resource Conformance: supported 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ị
Máy chủ FHIR tuân thủ VN Core IG PHẢI hỗ trợ tối thiểu các khả năng được liệt kê dưới đây. / A FHIR server conforming to VN Core IG MUST support at minimum the capabilities listed below.
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.
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).
Bệnh nhân Việt Nam — VNCorePatient profile
Tìm theo họ tên (hỗ trợ Unicode tiếng Việt)
Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023)
Nhân viên y tế — VNCorePractitioner profile
Tìm theo số chứng chỉ hành nghề (Luật KCB 2023)
Vai trò nhân viên y tế — VNCorePractitionerRole profile
Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT)
Lượt khám/điều trị — VNCoreEncounter profile
Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT)
Tìm theo mã ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT)
Kết quả xét nghiệm, sinh hiệu, và quan sát YHCT — VNCoreObservationLab + VNCoreObservationVitalSigns + VNCoreObservationYHCT profiles
Dị ứng — VNCoreAllergyIntolerance profile
Thủ thuật/phẫu thuật — VNCoreProcedure profile
Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ)
Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)
Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176 → QĐ 697)
Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025, Luật Dược 2016)
Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025, TT 20/2014)
Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...)
Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025)
Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176, QĐ 697)
Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697)
Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025, QĐ 1227)
Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)
Trang thiết bị y tế — VNCoreDevice profile
Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile