vn-core-server
type: CapabilityStatement
node role: treeRoot
id:
  v: vn-core-server
text:
  status:
    v: extensions
  div:
    v: 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-organiza…
url:
  v: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-server
  l: vn-core-server
version:
  v: 0.1.0
name:
  v: VNCoreServerCapabilityStatement
title:
  v: VN Core Server CapabilityStatement
status:
  v: draft
experimental:
  v: true
date:
  v: 2026-03-21
publisher:
  v: HL7 Vietnam
contact:
  name:
    v: HL7 Vietnam
  telecom:
    system:
      v: url
    value:
      v: https://hl7.org.vn
  telecom:
    system:
      v: email
contact:
  name:
    v: Omi HealthTech (OmiGroup)
  telecom:
    system:
      v: url
    value:
      v: https://omihealthtech.vn
  telecom:
    system:
      v: url
    value:
      v: https://omigroup.vn
  telecom:
    system:
      v: email
description:
  v: 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.
jurisdiction:
  coding:
    system:
      v: urn:iso:std:iso:3166
      l: 3166
    code:
      v: VN
    display:
      v: Viet Nam
kind:
  v: requirements
fhir version:
  v: 4.0.1
format:
  v: json
format:
  v: xml
rest:
  mode:
    v: server
  documentation:
    v: 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:
    cors:
      v: true
    description:
      v: 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).
  resource:
    type:
      v: Patient
    profile:
      v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient
      l: vn-core-patient
    documentation:
      v: Bệnh nhân Việt Nam — VNCorePatient profile
    interaction:
      code:
        v: read
    interaction:
      code:
        v: search-type
    interaction:
      code:
        v: create
    interaction:
      code:
        v: update
    search param:
      name:
        v: identifier
      type:
        v: token
      documentation:
        v: Tìm theo CCCD, mã BHXH, hoặc MRN
    search param:
      name:
        v: name
      type:
        v: string
      documentation:
        v: Tìm theo họ tên (hỗ trợ Unicode tiếng Việt)
    search param:
      name:
        v: birthdate
      type:
        v: date
    search param:
      name:
        v: gender
      type:
        v: token
    search param:
      name:
        v: vn-cccd
      definition:
        v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-cccd
        l: vn-sp-patient-cccd
      type:
        v: token
      documentation:
        v: Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023)
    search param:
      name:
        v: vn-bhyt
      definition:
        v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-bhyt
        l: vn-sp-patient-bhyt
      type:
        v: token
      documentation:
        v: Tìm theo số thẻ BHYT (Luật BHYT)
  resource:
    type:
      v: Practitioner
    profile:
      v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner
      l: vn-core-practitioner
    documentation:
      v: Nhân viên y tế — VNCorePractitioner profile
    interaction:
      code:
        v: read
    interaction:
      code:
        v: search-type
    search param:
      name:
        v: identifier
      type:
        v: token
      documentation:
        v: Tìm theo CCHN hoặc CCCD
    search param:
      name:
        v: name
      type:
        v: string
    search param:
      name:
        v: vn-cchn
      definition:
        v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-practitioner-cchn
        l: vn-sp-practitioner-cchn
      type:
        v: token
      documentation:
        v: Tìm theo số chứng chỉ hành nghề (Luật KCB 2023)
  resource:
    type:
      v: PractitionerRole
    profile:
      v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role
      l: vn-core-practitioner-role
    documentation:
      v: Vai trò nhân viên y tế — VNCorePractitionerRole profile
    interaction:
      code:
        v: read
    interaction:
      code:
        v: search-type
    search param:
      name:
        v: practitioner
      type:
        v: reference
    search param:
      name:
        v: organization

v: SMART-on-FHIR

v: SMART-on-FHIR

v: reference

type:
  v: Organization
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization
  l: vn-core-organization
documentation:
  v: Cơ sở KCB — VNCoreOrganization profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: identifier
  type:
    v: token
  documentation:
    v: Tìm theo mã CSKCB
search param:
  name:
    v: name
  type:
    v: string
search param:
  name:
    v: vn-cskcb
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-organization-cskcb
    l: vn-sp-organization-cskcb
  type:
    v: token
  documentation:
    v: Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT)

type:
  v: Encounter
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter
  l: vn-core-encounter
documentation:
  v: Lượt khám/điều trị — VNCoreEncounter profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
interaction:
  code:
    v: update
search param:
  name:
    v: patient
  type:
    v: reference
search param:
  name:
    v: date
  type:
    v: date
search param:
  name:
    v: status
  type:
    v: token
search param:
  name:
    v: class
  type:
    v: token
search param:
  name:
    v: vn-malydo
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-encounter-malydo
    l: vn-sp-encounter-malydo
  type:
    v: token
  documentation:
    v: Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT)

type:
  v: Condition
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition
  l: vn-core-condition
documentation:
  v: Chẩn đoán — VNCoreCondition profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: patient
  type:
    v: reference
search param:
  name:
    v: code
  type:
    v: token
  documentation:
    v: Tìm theo mã ICD-10 VN hoặc Mã U (YHCT)
search param:
  name:
    v: encounter
  type:
    v: reference
search param:
  name:
    v: vn-icd10
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-condition-icd10
    l: vn-sp-condition-icd10
  type:
    v: token
  documentation:
    v: Tìm theo mã ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT)

type:
  v: Observation
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab
  l: vn-core-observation-lab
supported profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-vital-signs
  l: vn-core-observation-vital-signs
supported profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-yhct
  l: vn-core-observation-yhct
documentation:
  v: Kết quả xét nghiệm, sinh hiệu, và quan sát YHCT — VNCoreObservationLab + VNCoreObservationVitalSigns + VNCoreObservationYHCT profiles
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: patient
  type:
    v: reference
search param:
  name:
    v: code
  type:
    v: token
  documentation:
    v: Tìm theo LOINC code
search param:
  name:
    v: date
  type:
    v: date
search param:
  name:
    v: category
  type:
    v: token

type:
  v: AllergyIntolerance
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance
  l: vn-core-allergy-intolerance
documentation:
  v: Dị ứng — VNCoreAllergyIntolerance profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: patient
  type:
    v: reference
search param:
  name:
    v: clinical-status
  type:
    v: token

type:
  v: Procedure
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure
  l: vn-core-procedure
documentation:
  v: Thủ thuật/phẫu thuật — VNCoreProcedure profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: patient
  type:
    v: reference
search param:
  name:
    v: code
  type:
    v: token
  documentation:
    v: Tìm theo mã ICD-9-CM
search param:
  name:
    v: date
  type:
    v: date

type:
  v: Coverage
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage
  l: vn-core-coverage
documentation:
  v: Thẻ BHYT — VNCoreCoverage profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: beneficiary
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân thụ hưởng BHYT
search param:
  name:
    v: identifier
  type:
    v: token
  documentation:
    v: Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ)
search param:
  name:
    v: status
  type:
    v: token
search param:
  name:
    v: vn-bhyt-card
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-coverage-bhyt
    l: vn-sp-coverage-bhyt
  type:
    v: token
  documentation:
    v: Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)

type:
  v: Claim
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim
  l: vn-core-claim
documentation:
  v: Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176 → QĐ 697)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
interaction:
  code:
    v: update
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: provider
  type:
    v: reference
  documentation:
    v: Tìm theo cơ sở KCB
search param:
  name:
    v: status
  type:
    v: token
search param:
  name:
    v: created
  type:
    v: date
  documentation:
    v: Tìm theo ngày tạo yêu cầu

type:
  v: MedicationRequest
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request
  l: vn-core-medication-request
documentation:
  v: Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025, Luật Dược 2016)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
interaction:
  code:
    v: update
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: status
  type:
    v: token
search param:
  name:
    v: intent
  type:
    v: token
search param:
  name:
    v: authoredon
  type:
    v: date
  documentation:
    v: Tìm theo ngày kê đơn
search param:
  name:
    v: medication
  type:
    v: reference
  documentation:
    v: Tìm theo thuốc

type:
  v: ServiceRequest
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request
  l: vn-core-service-request
documentation:
  v: Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025, TT 20/2014)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
interaction:
  code:
    v: update
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: status
  type:
    v: token
search param:
  name:
    v: category
  type:
    v: token
  documentation:
    v: Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...)
search param:
  name:
    v: code
  type:
    v: token
  documentation:
    v: Tìm theo mã DVKT / ICD-9-CM
search param:
  name:
    v: authored
  type:
    v: date
  documentation:
    v: Tìm theo ngày chỉ định

type:
  v: DocumentReference
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference
  l: vn-core-document-reference
documentation:
  v: Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: type
  type:
    v: token
  documentation:
    v: Tìm theo loại tài liệu
search param:
  name:
    v: date
  type:
    v: date
  documentation:
    v: Tìm theo thời điểm tạo
search param:
  name:
    v: encounter
  type:
    v: reference
  documentation:
    v: Tìm theo lượt khám liên quan
search param:
  name:
    v: custodian
  type:
    v: reference
  documentation:
    v: Tìm theo cơ sở y tế lưu trữ

type:
  v: ClaimResponse
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response
  l: vn-core-claim-response
documentation:
  v: Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176, QĐ 697)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: request
  type:
    v: reference
  documentation:
    v: Tìm theo Claim gốc
search param:
  name:
    v: status
  type:
    v: token

type:
  v: ExplanationOfBenefit
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit
  l: vn-core-explanation-of-benefit
documentation:
  v: Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: status
  type:
    v: token
search param:
  name:
    v: created
  type:
    v: date
  documentation:
    v: Tìm theo ngày tạo

type:
  v: DiagnosticReport
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report
  l: vn-core-diagnostic-report
documentation:
  v: Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025, QĐ 1227)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: code
  type:
    v: token
  documentation:
    v: Tìm theo loại báo cáo (LOINC)
search param:
  name:
    v: date
  type:
    v: date
  documentation:
    v: Tìm theo ngày báo cáo
search param:
  name:
    v: category
  type:
    v: token
  documentation:
    v: Tìm theo nhóm CLS (XN, CĐHA, GPB)
search param:
  name:
    v: encounter
  type:
    v: reference
  documentation:
    v: Tìm theo lượt khám liên quan

type:
  v: Medication
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication
  l: vn-core-medication
documentation:
  v: Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: code
  type:
    v: token
  documentation:
    v: Tìm theo mã thuốc (ATC, SNOMED CT)
search param:
  name:
    v: status
  type:
    v: token

type:
  v: Device
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device
  l: vn-core-device
documentation:
  v: Trang thiết bị y tế — VNCoreDevice profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: type
  type:
    v: token
  documentation:
    v: Tìm theo loại thiết bị
search param:
  name:
    v: status
  type:
    v: token

type:
  v: DeviceUseStatement
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement
  l: vn-core-device-use-statement
documentation:
  v: Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân
search param:
  name:
    v: device
  type:
    v: reference
  documentation:
    v: Tìm theo thiết bị