Verificar conexión BancoEstado Empresas

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


Tool ID	`banco_estado.conexion.verificar`
Nombre MCP	`banco_estado__conexion__verificar`
Conector	`banco_estado`
Plano	`action`
Scope (permiso)	`banco_estado: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.

Qué hace

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

Entrada

Sin parámetros: envía {}.

JSON Schema de entrada

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

Ejemplo

curl

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

SDK TypeScript

const data = await connect.tools.banco_estado.conexion.verificar({}, { connectionId: "conn_9tKfR2mQx4Vb" });

MCP · meta-tool execute

{
  "tool": "banco_estado.conexion.verificar",
  "params": {},
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "verificadoEn": "2026-08-07T14:12:03.220Z"
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "banco_estado.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

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.

JSON Schema de salida

{
  "$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
}

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.
`connection_session_pending`	409	sí	Ejecuta la sincronización de esa conexión (ella acuña la sesión) o espera la programada, y reintenta.

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.

Próximos pasos

banco_estado.conexion.sincronizar: si la credencial verifica bien, el paso siguiente es traer datos.