vn-core-server
type: CapabilityStatement
node role: treeRoot
id:
  v: vn-core-server
language:
  v: vi
text:
  status:
    v: extensions
  div:
    v: Generated Narrative: CapabilityStatement vn-core-server VN Core Server CapabilityStatement Implementation Guide Version: 0.5.1 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ủ 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ư. Summary of System-wide Operations Conformance Operation Documentation SHALL $validate-bhyt-claim SHALL $submit-bhyt-claim SHALL $reverse-bhyt-claim 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, vn-bhxh, vn-gks RelatedPerson http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson y y y y patient, identi…
extension:
  url:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis
    l: vn-ext-legal-basis
  value: Coding
    system:
      v: http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs
      l: vn-legal-document-ref-cs
    code:
      v: QD-3516-2025
extension:
  url:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis
    l: vn-ext-legal-basis
  value: Coding
    system:
      v: http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs
      l: vn-legal-document-ref-cs
    code:
      v: QD-4152-2024
extension:
  url:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis
    l: vn-ext-legal-basis
  value: Coding
    system:
      v: http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs
      l: vn-legal-document-ref-cs
    code:
      v: ND-102-2025
extension:
  url:
    v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-ext-legal-basis
    l: vn-ext-legal-basis
  value: Coding
    system:
      v: http://fhir.hl7.org.vn/core/CodeSystem/vn-legal-document-ref-cs
      l: vn-legal-document-ref-cs
    code:
      v: L-15-2023
url:
  v: http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-server
  l: vn-core-server
version:
  v: 0.5.1
name:
  v: VNCoreServerCapabilityStatement
title:
  v: VN Core Server CapabilityStatement
status:
  v: draft
experimental:
  v: true
date:
  v: 2026-05-10
publisher:
  v: Omi HealthTech / VN Core FHIR Community Initiative
contact:
  name:
    v: Omi HealthTech / VN Core FHIR Community Initiative
  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 đáp ứng tối thiểu các yêu cầu được liệt kê dưới đây. Đây là CapabilityStatement yêu cầu mức cơ sở; khi triển khai theo từng vai trò cụ thể nên tham chiếu thêm `VNCoreEMRServer`, `VNBHYTGatewayClient`, `VNBHYTGatewayServer`, hoặc `VNCitizenAppClient`.
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, GKS, hộ chiếu, MRN hoặc định danh khác
    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)
    search param:
      name:
        v: vn-bhxh
      definition:
        v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-bhxh
        l: vn-sp-patient-bhxh
      type:
        v: token
      documentation:
        v: Tìm theo mã số BHXH 10 chữ số
    search param:
      name:
        v: vn-gks
      definition:
        v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-gks
        l: vn-sp-patient-gks

v: SMART-on-FHIR

v: SMART-on-FHIR

v: token

v: Tìm theo số Giấy khai sinh

type:
  v: RelatedPerson
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson
  l: vn-core-relatedperson
documentation:
  v: Cha/mẹ/người giám hộ/người đại diện — VNCoreRelatedPerson 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
  documentation:
    v: Tìm RelatedPerson theo bệnh nhân liên quan
search param:
  name:
    v: identifier
  type:
    v: token
  documentation:
    v: Tìm theo CCCD hoặc hộ chiếu của người liên quan
search param:
  name:
    v: name
  type:
    v: string

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 GPHN hiện hành, CCCD, hoặc CCHN lịch sử
search param:
  name:
    v: name
  type:
    v: string
search param:
  name:
    v: vn-gphn
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-practitioner-gphn
    l: vn-sp-practitioner-gphn
  type:
    v: token
  documentation:
    v: Tìm theo số Giấy phép hành nghề khám bệnh, chữa bệnh hiện hành
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ề lịch sử khi chuyển đổi dữ liệu cũ

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
  type:
    v: reference
search param:
  name:
    v: location
  type:
    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: Location
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location
  l: vn-core-location
documentation:
  v: Khoa/phòng/địa điểm cung cấp dịch vụ — VNCoreLocation 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 mã khoa/phòng hoặc mã địa điểm nội bộ
search param:
  name:
    v: organization
  type:
    v: reference
  documentation:
    v: Tìm các Location thuộc một Organization
search param:
  name:
    v: partof
  type:
    v: reference
  documentation:
    v: Tìm các Location con
search param:
  name:
    v: name
  type:
    v: string
  documentation:
    v: Tìm theo tên khoa/phòng/địa điểm

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)
search param:
  name:
    v: vn-ma-luot-kcb
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-encounter-ma-luot-kcb
    l: vn-sp-encounter-ma-luot-kcb
  type:
    v: token
  documentation:
    v: Tìm theo Identifier MA_LUOT_KCB dùng đối soát BHXH; system khuyến nghị = http://fhir.hl7.org.vn/core/sid/ma-luot-kcb

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: Specimen
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen
  l: vn-core-specimen
documentation:
  v: Mẫu bệnh phẩm — VNCoreSpecimen profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
interaction:
  code:
    v: update
search param:
  name:
    v: subject
  type:
    v: reference
  documentation:
    v: Tìm theo bệnh nhân cung cấp mẫu
search param:
  name:
    v: type
  type:
    v: token
  documentation:
    v: Tìm theo loại mẫu bệnh phẩm
search param:
  name:
    v: accession
  type:
    v: token
  documentation:
    v: Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm

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: subscriber
  type:
    v: reference
  documentation:
    v: Tìm theo subscriber của Coverage
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)
search param:
  name:
    v: vn-ma-dkbd
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-coverage-ma-dkbd
    l: vn-sp-coverage-ma-dkbd
  type:
    v: token
  documentation:
    v: Tìm theo mã nơi ĐKKCB ban đầu MA_DKBD

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
search param:
  name:
    v: vn-ma-lk
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-claim-ma-lk
    l: vn-sp-claim-ma-lk
  type:
    v: token
  documentation:
    v: Tìm theo mã liên kết hồ sơ MA_LK

type:
  v: AuditEvent
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-event
  l: vn-core-audit-event
documentation:
  v: Nhật ký truy cập/chia sẻ dữ liệu y tế — VNCoreAuditEvent profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: date
  type:
    v: date
  documentation:
    v: Tìm theo thời điểm ghi nhận audit
search param:
  name:
    v: patient
  type:
    v: reference
  documentation:
    v: Tìm audit liên quan tới bệnh nhân
search param:
  name:
    v: agent
  type:
    v: reference
  documentation:
    v: Tìm theo người/hệ thống thực hiện hành động

type:
  v: Provenance
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-provenance
  l: vn-core-provenance
documentation:
  v: Nguồn gốc và chữ ký số của tài liệu/hồ sơ y tế — VNCoreProvenance profile
interaction:
  code:
    v: read
interaction:
  code:
    v: search-type
interaction:
  code:
    v: create
search param:
  name:
    v: target
  type:
    v: reference
  documentation:
    v: Tìm theo resource đích được ký/xác nhận
search param:
  name:
    v: recorded
  type:
    v: date
  documentation:
    v: Tìm theo thời điểm ghi nhận provenance

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
search param:
  name:
    v: vn-xml1-id
  definition:
    v: http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-claim-response-xml1-id
    l: vn-sp-claim-response-xml1-id
  type:
    v: token
  documentation:
    v: Tìm theo XML1_ID/mã phản hồi gateway của hồ sơ BHYT

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
supported profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-implantable-device
  l: vn-core-implantable-device
documentation:
  v: Trang thiết bị y tế — VNCoreDevice profile; thiết bị cấy ghép gắn người bệnh dùng thêm VNCoreImplantableDevice
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ị

type:
  v: Consent
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent
  l: vn-core-consent
documentation:
  v: Đồng ý xử lý DLCN y tế — VNCoreConsent profile (Luật 91/2025)
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
  documentation:
    v: Tìm theo trạng thái (active, rejected, inactive)
search param:
  name:
    v: category
  type:
    v: token
  documentation:
    v: Tìm theo loại đồng ý
search param:
  name:
    v: date
  type:
    v: date
  documentation:
    v: Tìm theo ngày đồng ý

type:
  v: Composition
profile:
  v: http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition
  l: vn-core-composition
documentation:
  v: Bệnh án điện tử — VNCoreComposition profile (TT 13/2025)
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: type
  type:
    v: token
  documentation:
    v: Tìm theo loại bệnh án (LOINC)
search param:
  name:
    v: date
  type:
    v: date
  documentation:
    v: Tìm theo ngày lập bệnh án
search param:
  name:
    v: encounter
  type:
    v: reference
  documentation:
    v: Tìm theo lượt khám

name:
  v: validate-bhyt-claim
definition:
  v: http://fhir.hl7.org.vn/core/OperationDefinition/vn-validate-bhyt-claim
  l: vn-validate-bhyt-claim

name:
  v: submit-bhyt-claim
definition:
  v: http://fhir.hl7.org.vn/core/OperationDefinition/vn-submit-bhyt-claim
  l: vn-submit-bhyt-claim

name:
  v: reverse-bhyt-claim
definition:
  v: http://fhir.hl7.org.vn/core/OperationDefinition/vn-reverse-bhyt-claim
  l: vn-reverse-bhyt-claim