# Verificar conexión Banco Security

> Prueba las credenciales de la conexión contra Banco Security haciendo un login real (y su logout, a cargo del pipeline).



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `banco_security.conexion.verificar`                                |
| **Nombre MCP**      | `banco_security__conexion__verificar`                              |
| **Conector**        | `banco_security`                                                   |
| **Plano**           | `action`                                                           |
| **Scope (permiso)** | `banco_security:read`                                              |
| **Auth**            | `connection_credentials`                                           |
| **Versión**         | `2`                                                                |
| **Sensible**        | sí                                                                 |
| **Deprecado**       | no                                                                 |
| **Comportamiento**  | readOnly=false, destructive=false, idempotent=true, openWorld=true |

> **Requiere conexión.** Indica cuál en cada llamada: header `X-Connect-Connection` en REST, campo `connectionId` en el `execute` de MCP y en las opciones del SDK. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de [`conexiones.estado.consultar`](../conexiones/estado-consultar).

## Qué hace [#qué-hace]

No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.

## Entrada [#entrada]

Sin parámetros: envía `{}`.

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {}
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/banco_security.conexion.verificar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```ts title="SDK TypeScript"
const data = await connect.tools.banco_security.conexion.verificar({}, { connectionId: "conn_9tKfR2mQx4Vb" });
```

```json title="MCP · meta-tool execute"
{
  "tool": "banco_security.conexion.verificar",
  "params": {},
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "verificadoEn": "2026-08-07T14:12:03.220Z"
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "banco_security.conexion.verificar",
    "plane": "action",
    "latency_ms": 7410,
    "audit_status": "recorded"
  }
}
```

> Si la credencial no sirve, la respuesta es un error connection\_credential\_required con su suggested\_fix; esta tool nunca devuelve un booleano.

## Salida [#salida]

| Campo          | Tipo   | Requerido | Descripción                                                                                                                                                                                                                                                     |
| -------------- | ------ | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `verificadoEn` | string | sí        | Instante (ISO 8601) en que el login de prueba terminó bien. Es la única salida de esta tool: recibirla ya significa que la credencial sirve. Si no sirviera, la respuesta sería un error con su código de catálogo, nunca este objeto con un booleano en false. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "verificadoEn": {
        "type": "string",
        "description": "Instante (ISO 8601) en que el login de prueba terminó bien. Es la única salida de esta tool: recibirla ya significa que la credencial sirve. Si no sirviera, la respuesta sería un error con su código de catálogo, nunca este objeto con un booleano en false."
      }
    },
    "required": [
      "verificadoEn"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Errores de esta tool [#errores-de-esta-tool]

| Código                           | HTTP | Reintentable | Qué hacer                                                                                                                                                                                |
| -------------------------------- | ---- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `connection_disabled`            | 403  | no           | Reactívala en /connections o usa otra conexión del mismo sistema.                                                                                                                        |
| `connection_credential_required` | 428  | no           | Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior. |
| `connection_busy`                | 409  | sí           | Espera unos segundos y reintenta. El candado es por conexión y se suelta solo.                                                                                                           |
| `upstream_error`                 | 502  | sí           | Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.                                                                                          |
| `timeout`                        | 504  | sí           | Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.                                                                                           |

Toda llamada puede devolver además los códigos transversales (`validation_error`, `unauthorized`, `scope_not_granted`, `rate_limited`, entre otros): el detalle vive en el [catálogo de errores](../errores).

## Próximos pasos [#próximos-pasos]

* [`banco_security.conexion.sincronizar`](./conexion-sincronizar): si la credencial verifica bien, el paso siguiente es traer datos.