Recurso CapabilityStatement

El recurso CapabilityStatement de FHIR R4 describe las capacidades de un servidor FHIR, permitiendo que los clientes descubran de forma dinámica qué operaciones, recursos, formatos y protocolos soporta el servidor.

Este recurso es fundamental para la interoperabilidad, ya que permite a los integradores conocer las capacidades del servidor sin necesidad de documentación externa.

Especificación Estándar

Se puede consultar la especificación completa y detallada del recurso en la documentación oficial de HL7 FHIR:

Referencia Oficial: HL7 FHIR R4 - CapabilityStatement

Endpoint de Descubrimiento

La plataforma Quralo expone el CapabilityStatement a través del endpoint estándar de FHIR:

GET/metadata

Obtiene el CapabilityStatement del servidor Quralo.

Ejemplo de Solicitud

GET /metadata
Accept: application/fhir+json
Authorization: Bearer <ACCESS_TOKEN>

Ejemplo de Respuesta (parcial)

{
  "resourceType": "CapabilityStatement",
  "status": "active",
  "date": "2026-06-09",
  "publisher": "Quralo",
  "kind": "instance",
  "fhirVersion": "4.0.1",
  "format": [
    "json",
    "xml"
  ],
  "rest": [
    {
      "mode": "server",
      "resource": [
        {
          "type": "DiagnosticReport",
          "profile": "https://hl7.org/fhir/R4/DiagnosticReport.html",
          "interaction": [
            {
              "code": "read"
            },
            {
              "code": "search-type"
            },
            {
              "code": "create"
            },
            {
              "code": "patch"
            }
          ],
          "searchParam": [
            {
              "name": "identifier",
              "type": "token",
              "documentation": "Busca DiagnosticReport por su identificador (system|value)"
            }
          ]
        }
      ]
    }
  ]
}

Capacidades del Servidor Quralo

El servidor FHIR de Quralo soporta las siguientes capacidades:

Capacidad	Detalle
Versión FHIR	R4 (4.0.1)
Formatos	JSON, XML
Tipo	Instance (servidor productivo)
Recursos soportados	DiagnosticReport, CapabilityStatement (metadata)
Interacciones	read, search-type, create, patch
Parámetros de búsqueda	identifier (token) para DiagnosticReport
Autenticación	OAuth 2.0 (Client Credentials)

TIP

Los clientes FHIR pueden utilizar el endpoint /metadata para descubrir dinámicamente los recursos, interacciones y parámetros de búsqueda soportados por el servidor Quralo, sin necesidad de consultar documentación externa.