# VN Core Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ FHIR theo VN Core - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## CapabilityStatement: VN Core Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ FHIR theo VN Core (Thử nghiệm) 

 
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`. 

 [Raw OpenAPI-Swagger Definition file](../vn-core-server.openapi.json) | [Tải xuống](../vn-core-server.openapi.json) 



## Resource Content

```json
{
  "resourceType" : "CapabilityStatement",
  "id" : "vn-core-server",
  "url" : "http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-server",
  "version" : "0.5.0",
  "name" : "VNCoreServerCapabilityStatement",
  "title" : "VN Core Server CapabilityStatement",
  "status" : "draft",
  "experimental" : true,
  "date" : "2026-03-23",
  "publisher" : "Omi HealthTech / VN Core FHIR Community Initiative",
  "contact" : [{
    "name" : "Omi HealthTech / VN Core FHIR Community Initiative",
    "telecom" : [{
      "system" : "url",
      "value" : "https://hl7.org.vn"
    },
    {
      "system" : "email",
      "value" : "info@hl7.org.vn"
    }]
  },
  {
    "name" : "Omi HealthTech (OmiGroup)",
    "telecom" : [{
      "system" : "url",
      "value" : "https://omihealthtech.vn"
    },
    {
      "system" : "url",
      "value" : "https://omigroup.vn"
    },
    {
      "system" : "email",
      "value" : "healthtech@omigroup.vn"
    }]
  }],
  "description" : "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" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "kind" : "requirements",
  "fhirVersion" : "4.0.1",
  "format" : ["json", "xml"],
  "rest" : [{
    "mode" : "server",
    "documentation" : "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" : true,
      "service" : [{
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/restful-security-service",
          "code" : "SMART-on-FHIR",
          "display" : "SMART-on-FHIR"
        }]
      }],
      "description" : "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" : "Patient",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "documentation" : "Bệnh nhân Việt Nam — VNCorePatient profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token",
        "documentation" : "Tìm theo CCCD, mã BHXH, GKS, hộ chiếu, MRN hoặc định danh khác"
      },
      {
        "name" : "name",
        "type" : "string",
        "documentation" : "Tìm theo họ tên (hỗ trợ Unicode tiếng Việt)"
      },
      {
        "name" : "birthdate",
        "type" : "date"
      },
      {
        "name" : "gender",
        "type" : "token"
      },
      {
        "name" : "vn-cccd",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-cccd",
        "type" : "token",
        "documentation" : "Tìm theo số CCCD 12 chữ số (Luật Căn cước 2023)"
      },
      {
        "name" : "vn-bhyt",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-bhyt",
        "type" : "token",
        "documentation" : "Tìm theo số thẻ BHYT (Luật BHYT)"
      },
      {
        "name" : "vn-bhxh",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-bhxh",
        "type" : "token",
        "documentation" : "Tìm theo mã số BHXH 10 chữ số"
      },
      {
        "name" : "vn-gks",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-gks",
        "type" : "token",
        "documentation" : "Tìm theo số Giấy khai sinh"
      }]
    },
    {
      "type" : "RelatedPerson",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-relatedperson",
      "documentation" : "Cha/mẹ/người giám hộ/người đại diện — VNCoreRelatedPerson profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm RelatedPerson theo bệnh nhân liên quan"
      },
      {
        "name" : "identifier",
        "type" : "token",
        "documentation" : "Tìm theo CCCD hoặc hộ chiếu của người liên quan"
      },
      {
        "name" : "name",
        "type" : "string"
      }]
    },
    {
      "type" : "Practitioner",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner",
      "documentation" : "Nhân viên y tế — VNCorePractitioner profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token",
        "documentation" : "Tìm theo GPHN hiện hành, CCCD, hoặc CCHN lịch sử"
      },
      {
        "name" : "name",
        "type" : "string"
      },
      {
        "name" : "vn-gphn",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-practitioner-gphn",
        "type" : "token",
        "documentation" : "Tìm theo số Giấy phép hành nghề khám bệnh, chữa bệnh hiện hành"
      },
      {
        "name" : "vn-cchn",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-practitioner-cchn",
        "type" : "token",
        "documentation" : "Tìm theo số Chứng chỉ hành nghề lịch sử khi chuyển đổi dữ liệu cũ"
      }]
    },
    {
      "type" : "PractitionerRole",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-practitioner-role",
      "documentation" : "Vai trò nhân viên y tế — VNCorePractitionerRole profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "practitioner",
        "type" : "reference"
      },
      {
        "name" : "organization",
        "type" : "reference"
      },
      {
        "name" : "location",
        "type" : "reference"
      }]
    },
    {
      "type" : "Organization",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "documentation" : "Cơ sở KCB — VNCoreOrganization profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token",
        "documentation" : "Tìm theo mã CSKCB"
      },
      {
        "name" : "name",
        "type" : "string"
      },
      {
        "name" : "vn-cskcb",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-organization-cskcb",
        "type" : "token",
        "documentation" : "Tìm theo mã cơ sở KCB 5 số (QĐ 3176/QĐ-BYT)"
      }]
    },
    {
      "type" : "Location",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-location",
      "documentation" : "Khoa/phòng/địa điểm cung cấp dịch vụ — VNCoreLocation profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token",
        "documentation" : "Tìm theo mã khoa/phòng hoặc mã địa điểm nội bộ"
      },
      {
        "name" : "organization",
        "type" : "reference",
        "documentation" : "Tìm các Location thuộc một Organization"
      },
      {
        "name" : "partof",
        "type" : "reference",
        "documentation" : "Tìm các Location con"
      },
      {
        "name" : "name",
        "type" : "string",
        "documentation" : "Tìm theo tên khoa/phòng/địa điểm"
      }]
    },
    {
      "type" : "Encounter",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-encounter",
      "documentation" : "Lượt khám/điều trị — VNCoreEncounter profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      },
      {
        "name" : "date",
        "type" : "date"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "class",
        "type" : "token"
      },
      {
        "name" : "vn-malydo",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-encounter-malydo",
        "type" : "token",
        "documentation" : "Tìm theo loại KCB BHYT — MALYDO (QĐ 3176/QĐ-BYT)"
      },
      {
        "name" : "vn-ma-luot-kcb",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-encounter-ma-luot-kcb",
        "type" : "token",
        "documentation" : "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" : "Condition",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-condition",
      "documentation" : "Chẩn đoán — VNCoreCondition profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      },
      {
        "name" : "code",
        "type" : "token",
        "documentation" : "Tìm theo mã ICD-10 VN hoặc Mã U (YHCT)"
      },
      {
        "name" : "encounter",
        "type" : "reference"
      },
      {
        "name" : "vn-icd10",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-condition-icd10",
        "type" : "token",
        "documentation" : "Tìm theo mã ICD-10 (QĐ 4469/QĐ-BYT, QĐ 98/QĐ-BYT)"
      }]
    },
    {
      "type" : "Observation",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-lab",
      "supportedProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-vital-signs",
      "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-observation-yhct"],
      "documentation" : "Kết quả xét nghiệm, sinh hiệu, và quan sát YHCT — VNCoreObservationLab + VNCoreObservationVitalSigns + VNCoreObservationYHCT profiles",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      },
      {
        "name" : "code",
        "type" : "token",
        "documentation" : "Tìm theo LOINC code"
      },
      {
        "name" : "date",
        "type" : "date"
      },
      {
        "name" : "category",
        "type" : "token"
      }]
    },
    {
      "type" : "Specimen",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-specimen",
      "documentation" : "Mẫu bệnh phẩm — VNCoreSpecimen profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "subject",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân cung cấp mẫu"
      },
      {
        "name" : "type",
        "type" : "token",
        "documentation" : "Tìm theo loại mẫu bệnh phẩm"
      },
      {
        "name" : "accession",
        "type" : "token",
        "documentation" : "Tìm theo mã tiếp nhận mẫu tại phòng xét nghiệm"
      }]
    },
    {
      "type" : "AllergyIntolerance",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-allergy-intolerance",
      "documentation" : "Dị ứng — VNCoreAllergyIntolerance profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      },
      {
        "name" : "clinical-status",
        "type" : "token"
      }]
    },
    {
      "type" : "Procedure",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-procedure",
      "documentation" : "Thủ thuật/phẫu thuật — VNCoreProcedure profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference"
      },
      {
        "name" : "code",
        "type" : "token",
        "documentation" : "Tìm theo mã ICD-9-CM"
      },
      {
        "name" : "date",
        "type" : "date"
      }]
    },
    {
      "type" : "Coverage",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "documentation" : "Thẻ BHYT — VNCoreCoverage profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "beneficiary",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân thụ hưởng BHYT"
      },
      {
        "name" : "identifier",
        "type" : "token",
        "documentation" : "Tìm theo số thẻ BHYT qua Coverage.identifier (CCCD/BHXH/format cũ)"
      },
      {
        "name" : "subscriber",
        "type" : "reference",
        "documentation" : "Tìm theo subscriber của Coverage"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "vn-bhyt-card",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-coverage-bhyt",
        "type" : "token",
        "documentation" : "Tìm theo số thẻ BHYT trong Coverage.identifier[BHYT] (NĐ 188/2025/NĐ-CP)"
      },
      {
        "name" : "vn-ma-dkbd",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-coverage-ma-dkbd",
        "type" : "token",
        "documentation" : "Tìm theo mã nơi ĐKKCB ban đầu MA_DKBD"
      }]
    },
    {
      "type" : "Claim",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
      "documentation" : "Yêu cầu thanh toán KCB BHYT — VNCoreClaim profile (QĐ 3176 → QĐ 697)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "provider",
        "type" : "reference",
        "documentation" : "Tìm theo cơ sở KCB"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "created",
        "type" : "date",
        "documentation" : "Tìm theo ngày tạo yêu cầu"
      },
      {
        "name" : "vn-ma-lk",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-claim-ma-lk",
        "type" : "token",
        "documentation" : "Tìm theo mã liên kết hồ sơ MA_LK"
      }]
    },
    {
      "type" : "AuditEvent",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-audit-event",
      "documentation" : "Nhật ký truy cập/chia sẻ dữ liệu y tế — VNCoreAuditEvent profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "date",
        "type" : "date",
        "documentation" : "Tìm theo thời điểm ghi nhận audit"
      },
      {
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm audit liên quan tới bệnh nhân"
      },
      {
        "name" : "agent",
        "type" : "reference",
        "documentation" : "Tìm theo người/hệ thống thực hiện hành động"
      }]
    },
    {
      "type" : "Provenance",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-provenance",
      "documentation" : "Nguồn gốc và chữ ký số của tài liệu/hồ sơ y tế — VNCoreProvenance profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "target",
        "type" : "reference",
        "documentation" : "Tìm theo resource đích được ký/xác nhận"
      },
      {
        "name" : "recorded",
        "type" : "date",
        "documentation" : "Tìm theo thời điểm ghi nhận provenance"
      }]
    },
    {
      "type" : "MedicationRequest",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication-request",
      "documentation" : "Đơn thuốc — VNCoreMedicationRequest profile (TT 13/2025, Luật Dược 2016)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "intent",
        "type" : "token"
      },
      {
        "name" : "authoredon",
        "type" : "date",
        "documentation" : "Tìm theo ngày kê đơn"
      },
      {
        "name" : "medication",
        "type" : "reference",
        "documentation" : "Tìm theo thuốc"
      }]
    },
    {
      "type" : "ServiceRequest",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-service-request",
      "documentation" : "Yêu cầu DVKT/CLS — VNCoreServiceRequest profile (TT 13/2025, TT 20/2014)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "category",
        "type" : "token",
        "documentation" : "Tìm theo loại dịch vụ (XN, CĐHA, PT, TT...)"
      },
      {
        "name" : "code",
        "type" : "token",
        "documentation" : "Tìm theo mã DVKT / ICD-9-CM"
      },
      {
        "name" : "authored",
        "type" : "date",
        "documentation" : "Tìm theo ngày chỉ định"
      }]
    },
    {
      "type" : "DocumentReference",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-document-reference",
      "documentation" : "Tài liệu y tế / Bệnh án điện tử — VNCoreDocumentReference profile (TT 13/2025)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "type",
        "type" : "token",
        "documentation" : "Tìm theo loại tài liệu"
      },
      {
        "name" : "date",
        "type" : "date",
        "documentation" : "Tìm theo thời điểm tạo"
      },
      {
        "name" : "encounter",
        "type" : "reference",
        "documentation" : "Tìm theo lượt khám liên quan"
      },
      {
        "name" : "custodian",
        "type" : "reference",
        "documentation" : "Tìm theo cơ sở y tế lưu trữ"
      }]
    },
    {
      "type" : "ClaimResponse",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response",
      "documentation" : "Phản hồi thanh toán BHYT — VNCoreClaimResponse profile (QĐ 3176, QĐ 697)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "request",
        "type" : "reference",
        "documentation" : "Tìm theo Claim gốc"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "vn-xml1-id",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-claim-response-xml1-id",
        "type" : "token",
        "documentation" : "Tìm theo XML1_ID/mã phản hồi gateway của hồ sơ BHYT"
      }]
    },
    {
      "type" : "ExplanationOfBenefit",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-explanation-of-benefit",
      "documentation" : "Giải trình quyền lợi BHYT — VNCoreExplanationOfBenefit profile (QĐ 697)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "created",
        "type" : "date",
        "documentation" : "Tìm theo ngày tạo"
      }]
    },
    {
      "type" : "DiagnosticReport",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-diagnostic-report",
      "documentation" : "Kết quả cận lâm sàng — VNCoreDiagnosticReport profile (TT 13/2025, QĐ 1227)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "code",
        "type" : "token",
        "documentation" : "Tìm theo loại báo cáo (LOINC)"
      },
      {
        "name" : "date",
        "type" : "date",
        "documentation" : "Tìm theo ngày báo cáo"
      },
      {
        "name" : "category",
        "type" : "token",
        "documentation" : "Tìm theo nhóm CLS (XN, CĐHA, GPB)"
      },
      {
        "name" : "encounter",
        "type" : "reference",
        "documentation" : "Tìm theo lượt khám liên quan"
      }]
    },
    {
      "type" : "Medication",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-medication",
      "documentation" : "Thuốc — VNCoreMedication profile (Luật Dược 2016, ATC/SNOMED CT)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "code",
        "type" : "token",
        "documentation" : "Tìm theo mã thuốc (ATC, SNOMED CT)"
      },
      {
        "name" : "status",
        "type" : "token"
      }]
    },
    {
      "type" : "Device",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device",
      "supportedProfile" : ["http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-implantable-device"],
      "documentation" : "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" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "type",
        "type" : "token",
        "documentation" : "Tìm theo loại thiết bị"
      },
      {
        "name" : "status",
        "type" : "token"
      }]
    },
    {
      "type" : "DeviceUseStatement",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-device-use-statement",
      "documentation" : "Sử dụng TBYT cho bệnh nhân — VNCoreDeviceUseStatement profile",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "device",
        "type" : "reference",
        "documentation" : "Tìm theo thiết bị"
      }]
    },
    {
      "type" : "Consent",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-consent",
      "documentation" : "Đồng ý xử lý DLCN y tế — VNCoreConsent profile (Luật 91/2025)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "status",
        "type" : "token",
        "documentation" : "Tìm theo trạng thái (active, rejected, inactive)"
      },
      {
        "name" : "category",
        "type" : "token",
        "documentation" : "Tìm theo loại đồng ý"
      },
      {
        "name" : "date",
        "type" : "date",
        "documentation" : "Tìm theo ngày đồng ý"
      }]
    },
    {
      "type" : "Composition",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-composition",
      "documentation" : "Bệnh án điện tử — VNCoreComposition profile (TT 13/2025)",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      },
      {
        "code" : "update"
      }],
      "searchParam" : [{
        "name" : "patient",
        "type" : "reference",
        "documentation" : "Tìm theo bệnh nhân"
      },
      {
        "name" : "type",
        "type" : "token",
        "documentation" : "Tìm theo loại bệnh án (LOINC)"
      },
      {
        "name" : "date",
        "type" : "date",
        "documentation" : "Tìm theo ngày lập bệnh án"
      },
      {
        "name" : "encounter",
        "type" : "reference",
        "documentation" : "Tìm theo lượt khám"
      }]
    }],
    "operation" : [{
      "name" : "validate-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-validate-bhyt-claim"
    },
    {
      "name" : "submit-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-submit-bhyt-claim"
    },
    {
      "name" : "reverse-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-reverse-bhyt-claim"
    }]
  }]
}

```
