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

## CapabilityStatement: VN Core BHYT Gateway Server CapabilityStatement — Yêu cầu tuân thủ tối thiểu cho máy chủ cổng 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 máy chủ/facade tiếp nhận hồ sơ thanh toán BHYT từ HIS/EMR. Tập trung vào lớp liên thông hồ sơ BHYT, `MA_LK`, các operation kiểm tra hợp lệ/gửi/thu hồi và các quy tắc định dạng xuất cổng. / Minimum conformance requirements for payer-facing BHYT submission servers. 

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



## Resource Content

```json
{
  "resourceType" : "CapabilityStatement",
  "id" : "vn-core-bhyt-gateway-server",
  "url" : "http://fhir.hl7.org.vn/core/CapabilityStatement/vn-core-bhyt-gateway-server",
  "version" : "0.5.0",
  "name" : "VNBHYTGatewayServerCapabilityStatement",
  "title" : "VN Core BHYT Gateway 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" : "Yêu cầu tuân thủ tối thiểu theo từng vai trò triển khai dành cho máy chủ/facade tiếp nhận hồ sơ thanh toán BHYT từ HIS/EMR. Tập trung vào lớp liên thông hồ sơ BHYT, `MA_LK`, các operation kiểm tra hợp lệ/gửi/thu hồi và các quy tắc định dạng xuất cổng. / Minimum conformance requirements for payer-facing BHYT submission servers.",
  "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ủ cổng/facade nên công bố rõ khả năng kiểm tra hợp lệ hồ sơ, nhận `VNCoreBHYTSubmissionBundle`, truy vết theo `MA_LK` và phản hồi lỗi bằng `OperationOutcome`.",
    "security" : {
      "cors" : false,
      "service" : [{
        "coding" : [{
          "system" : "http://terminology.hl7.org/CodeSystem/restful-security-service",
          "code" : "SMART-on-FHIR",
          "display" : "SMART-on-FHIR"
        }]
      }],
      "description" : "Khuyến nghị token máy chủ - máy chủ, danh sách IP cho phép hoặc mTLS theo quy định vận hành, ghi log đầy đủ truy cập và quá trình tiếp nhận hồ sơ BHYT."
    },
    "resource" : [{
      "type" : "Bundle",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-bhyt-submission-bundle",
      "interaction" : [{
        "code" : "create"
      },
      {
        "code" : "read"
      }],
      "searchParam" : [{
        "name" : "identifier",
        "type" : "token"
      }]
    },
    {
      "type" : "Claim",
      "profile" : "http://fhir.hl7.org.vn/core/StructureDefinition/vn-core-claim",
      "interaction" : [{
        "code" : "read"
      },
      {
        "code" : "search-type"
      },
      {
        "code" : "create"
      }],
      "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" : "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"
      }]
    }],
    "operation" : [{
      "name" : "validate-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-validate-bhyt-claim",
      "documentation" : "Validate hồ sơ theo profile và quy tắc của lớp liên thông hồ sơ BHYT"
    },
    {
      "name" : "submit-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-submit-bhyt-claim",
      "documentation" : "Tiếp nhận hồ sơ thanh toán BHYT theo `VNCoreBHYTSubmissionBundle`"
    },
    {
      "name" : "reverse-bhyt-claim",
      "definition" : "http://fhir.hl7.org.vn/core/OperationDefinition/vn-reverse-bhyt-claim",
      "documentation" : "Thu hồi hoặc hủy hồ sơ đã gửi"
    }]
  }]
}

```
