# VN Core BHYT Gateway Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client gửi hồ sơ thanh toán BHYT - Bộ Hướng dẫn Triển khai Core FHIR cho Việt Nam v0.5.0

## CapabilityStatement: VN Core BHYT Gateway Client CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho client gửi hồ sơ thanh toán BHYT (Thử nghiệm) 

 
Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho HIS/EMR hoặc middleware đóng vai trò client trong lớp liên thông hồ sơ BHYT, chịu trách nhiệm gửi hồ sơ thanh toán BHYT. / Minimum conformance requirements for payer submission clients using the VN Core BHYT Submission layer. 

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



## Resource Content

```json
{
  "resourceType" : "CapabilityStatement",
  "id" : "vn-core-bhyt-gateway-client",
  "url" : "http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-bhyt-gateway-client",
  "version" : "0.5.0",
  "name" : "VNBHYTGatewayClientCapabilityStatement",
  "title" : "VN Core BHYT Gateway Client 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" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho HIS/EMR hoặc middleware đóng vai trò client trong lớp liên thông hồ sơ BHYT, chịu trách nhiệm gửi hồ sơ thanh toán BHYT. / Minimum conformance requirements for payer submission clients using the VN Core BHYT Submission layer.",
  "jurisdiction" : [{
    "coding" : [{
      "system" : "urn:iso:std:iso:3166",
      "code" : "VN",
      "display" : "Viet Nam"
    }]
  }],
  "kind" : "requirements",
  "fhirVersion" : "4.0.1",
  "format" : ["json", "xml"],
  "rest" : [{
    "mode" : "client",
    "documentation" : "Client gửi hồ sơ thanh toán BHYT cần sinh đúng `VNCoreBHYTSubmissionBundle`, tìm theo `MA_LK`, và gọi được các operation validate/submit/reverse.",
    "security" : {
      "service" : [{
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/restful-security-service",
          "code" : "SMART-on-FHIR",
          "display" : "SMART-on-FHIR"
        }]
      }],
      "description" : "Khuyến nghị tài khoản dịch vụ riêng cho cổng BHYT, token ngắn hạn, audit đầy đủ và tách quyền với các ứng dụng lâm sàng nội bộ."
    },
    "resource" : [{
      "type" : "Claim",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
      "interaction" : [{
        "code" : "create"
      },
      {
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token"
      },
      {
        "name" : "vn-ma-lk",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-claim-ma-lk",
        "type" : "token"
      }]
    },
    {
      "type" : "Coverage",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-coverage",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "beneficiary",
        "type" : "reference"
      },
      {
        "name" : "vn-ma-dkbd",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-coverage-ma-dkbd",
        "type" : "token"
      }]
    },
    {
      "type" : "ClaimResponse",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim-response",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "request",
        "type" : "reference"
      },
      {
        "name" : "status",
        "type" : "token"
      },
      {
        "name" : "vn-xml1-id",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-claim-response-xml1-id",
        "type" : "token"
      }]
    },
    {
      "type" : "Patient",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-patient",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "vn-cccd",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-cccd",
        "type" : "token"
      },
      {
        "name" : "vn-bhxh",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-patient-bhxh",
        "type" : "token"
      }]
    },
    {
      "type" : "Organization",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-organization",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      }],
      "searchParam" : [{
        "name" : "vn-cskcb",
        "definition" : "http://fhir.hl7.org.vn/core/SearchParameter/vn-sp-organization-cskcb",
        "type" : "token"
      }]
    }],
    "operation" : [{
      "name" : "validate-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-validate-bhyt-claim",
      "documentation" : "Validate Bundle/Claim trước khi gửi Cổng BHXH"
    },
    {
      "name" : "submit-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-submit-bhyt-claim",
      "documentation" : "Gửi hồ sơ thanh toán BHYT theo lớp liên thông hồ sơ BHYT"
    },
    {
      "name" : "reverse-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-reverse-bhyt-claim",
      "documentation" : "Thu hồi/đảo hồ sơ BHYT đã gửi"
    }]
  }]
}

```
