Consultar transferencias de Banco Itaú

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar.

Tool IDitau_empresas.transferencias.consultar
Nombre MCPitau_empresas__transferencias__consultar
Conectoritau_empresas
Planoaction
Lee el alcancetransferencias (debe estar habilitado en la conexión)
Scope (permiso)itau_empresas:read
Authnone
Versión1
Sensiblesí
Deprecadono
ComportamientoreadOnly=true, destructive=false, idempotent=true, openWorld=false

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. 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

Si sincronizarSirve es false, sigue hacer: las indicaciones para pedir datos nuevos que siguen no aplican hasta resolver esa atención. La consulta de datos ya guardados sigue disponible según el plan. Lee las transferencias electrónicas (TEF) de Banco Itaú YA sincronizadas de esta conexión, enviadas y recibidas, de la más reciente a la más antigua. Trae los datos de contraparte de la TEF: RUT, nombre y banco cuando están disponibles. Esta consulta no agrega las contrapartes extraídas de glosas por movimientos.consultar. Cubre más que la cartola, cuyo portal sólo muestra los últimos 100 movimientos: aquí hay un mes por cada período sincronizado, e incluye las transferencias que fallaron y por eso nunca produjeron un movimiento. Lectura pura: NO contacta al banco. Para traer un mes nuevo usa 'itau_empresas.conexion.sincronizar' con ese período.

Entrada

CampoTipoRequeridoDescripción
periodostring ^\d{4}-\d{2}$noUn mes, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Cada sitio de uso afina qué significa ahí: en una sincronización es el mes que se va a traer, y en una consulta a la caché es el filtro. Esta descripción base existe para que el campo nunca llegue pelado a quien lee el contrato.
direccion"enviada" · "recibida"noFiltra por sentido. Omítelo para ver las dos.
estado"ok" · "error" · "desconocido"noFiltra por resultado. Usa 'ok' para excluir las que el banco no cursó.
contraparteRutstringnoFiltra por el RUT de la contraparte. Acepta cualquier formato ('76.123.456-0' o '76123456-0'): Emisso lo canoniza antes de buscar. Es el filtro para conciliar contra un proveedor o un cliente concreto.
cursorstringnoPuntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.
limitentero 1-500no · default 100Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.
JSON Schema de entrada
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "periodo": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$",
      "description": "Un mes, en formato AAAA-MM y en calendario chileno (por ejemplo '2026-07'). Cada sitio de uso afina qué significa ahí: en una sincronización es el mes que se va a traer, y en una consulta a la caché es el filtro. Esta descripción base existe para que el campo nunca llegue pelado a quien lee el contrato."
    },
    "direccion": {
      "description": "Filtra por sentido. Omítelo para ver las dos.",
      "type": "string",
      "enum": [
        "enviada",
        "recibida"
      ]
    },
    "estado": {
      "description": "Filtra por resultado. Usa 'ok' para excluir las que el banco no cursó.",
      "type": "string",
      "enum": [
        "ok",
        "error",
        "desconocido"
      ]
    },
    "contraparteRut": {
      "description": "Filtra por el RUT de la contraparte. Acepta cualquier formato ('76.123.456-0' o '76123456-0'): Emisso lo canoniza antes de buscar. Es el filtro para conciliar contra un proveedor o un cliente concreto.",
      "type": "string"
    },
    "cursor": {
      "description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' que devolvió la llamada anterior; nunca lo construyas a mano. Omítelo para pedir la primera página.",
      "type": "string"
    },
    "limit": {
      "default": 100,
      "description": "Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  }
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/itau_empresas.transferencias.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-09","estado":"ok"}}'
MCP · meta-tool execute
{
  "tool": "itau_empresas.transferencias.consultar",
  "params": {
    "periodo": "2026-09",
    "estado": "ok"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "transferencias": [
      {
        "id": "900100011",
        "direccion": "enviada",
        "estado": "ok",
        "fecha": "2026-09-17T11:42:07Z",
        "periodo": "2026-09",
        "contraparte": {
          "rut": "76123456-0",
          "nombre": "COMERCIAL RIBERA LTDA",
          "banco": "BANCO DEMO"
        },
        "monto": 1870400,
        "display": "-1.870.400",
        "cuentaPropia": null,
        "syncedAt": "2026-09-23T14:02:11.000Z"
      }
    ],
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "itau_empresas.transferencias.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

'display' sale negativo porque la plata SALIÓ: el signo lo impone 'direccion'. El 'id' es el número que acuña Itaú, y es el mismo valor que trae 'documento' en el movimiento asociado.

Salida

CampoTipoRequeridoDescripción
transferenciaslista de objetosíLas transferencias guardadas que calzan con los filtros, de la más reciente a la más antigua. Una lista vacía significa que ese mes no se ha sincronizado, no que no haya transferencias.
transferencias[].idstringsíEl número de transferencia que acuña Itaú. Un movimiento no tiene número y Emisso lo identifica por su contenido; esto, en cambio, es un identificador del propio banco: es estable entre sincronizaciones y es el mismo valor que aparece en 'documento' del movimiento asociado.
transferencias[].direccion"enviada" · "recibida"síSi la plata SALIÓ ('enviada') o ENTRÓ ('recibida'). Reemplaza al eje credit/debit: en una transferencia el sentido es la pantalla, no una columna.
transferencias[].estado"ok" · "error" · "desconocido"síEl resultado según el banco. 'error' es una transferencia que NO se cursó y por lo tanto no tiene movimiento asociado. 'desconocido' es un estado que el banco estrenó y Emisso todavía no interpreta: no lo trates como exitoso.
transferencias[].fechastringnullsí
transferencias[].periodostringsíEl mes (AAAA-MM) con el que se sincronizó. A diferencia de saldos y movimientos, esta pantalla SÍ respeta el mes pedido, así que el período es real y no sólo una etiqueta. Aun así no entra en la identidad: volver a traerla bajo otro mes no crea una fila nueva.
transferencias[].contraparteobjetosíLos datos de contraparte publicados en la TEF. Cada campo puede ser null si no está disponible.
transferencias[].contraparte.rutstringnullsí
transferencias[].contraparte.nombrestringnullsí
transferencias[].contraparte.bancostringnullsí
transferencias[].montonúmeronullsí
transferencias[].displaystringnullsí
transferencias[].cuentaPropiastringnullsí
transferencias[].syncedAtstringsíCuándo se leyó esta fila del banco (ISO 8601). Si está vieja, la sincronización puede haber dejado de correr (por ejemplo, con la conexión pausada tras varios fallos) mientras esta tool sigue respondiendo con filas antiguas.
cursorstringnullsí
JSON Schema de salida
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "transferencias": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "El número de transferencia que acuña Itaú. Un movimiento no tiene número y Emisso lo identifica por su contenido; esto, en cambio, es un identificador del propio banco: es estable entre sincronizaciones y es el mismo valor que aparece en 'documento' del movimiento asociado."
          },
          "direccion": {
            "type": "string",
            "enum": [
              "enviada",
              "recibida"
            ],
            "description": "Si la plata SALIÓ ('enviada') o ENTRÓ ('recibida'). Reemplaza al eje credit/debit: en una transferencia el sentido es la pantalla, no una columna."
          },
          "estado": {
            "type": "string",
            "enum": [
              "ok",
              "error",
              "desconocido"
            ],
            "description": "El resultado según el banco. 'error' es una transferencia que NO se cursó y por lo tanto no tiene movimiento asociado. 'desconocido' es un estado que el banco estrenó y Emisso todavía no interpreta: no lo trates como exitoso."
          },
          "fecha": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Fecha y hora de la transferencia (ISO 8601). A diferencia de la cartola, esta pantalla SÍ informa la hora."
          },
          "periodo": {
            "type": "string",
            "description": "El mes (AAAA-MM) con el que se sincronizó. A diferencia de saldos y movimientos, esta pantalla SÍ respeta el mes pedido, así que el período es real y no sólo una etiqueta. Aun así no entra en la identidad: volver a traerla bajo otro mes no crea una fila nueva."
          },
          "contraparte": {
            "type": "object",
            "properties": {
              "rut": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "El RUT de la contraparte, en formato '<cuerpo>-<DV>' sin puntos y con el DV en mayúscula, para cotejarlo con documentos del SII. El formato y el dígito verificador no acreditan identidad ni titularidad."
              },
              "nombre": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "El nombre o razón social de la contraparte, tal como lo publica el banco."
              },
              "banco": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "El banco de la contraparte, en el texto del propio Itaú (por ejemplo 'BANCO DE CHILE / EDWARDS')."
              }
            },
            "required": [
              "rut",
              "nombre",
              "banco"
            ],
            "additionalProperties": false,
            "description": "Los datos de contraparte publicados en la TEF. Cada campo puede ser null si no está disponible."
          },
          "monto": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Magnitud de la transferencia SIN signo. El sentido lo da 'direccion' y el signo visible lo trae 'display'."
          },
          "display": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "El monto ya formateado a la chilena y CON signo, derivado de 'type' ('credit', plata que sale, se muestra negativo). Es una comodidad de presentación: se calcula en la lectura y no se persiste. Para operar con el número usa 'monto' (magnitud sin signo) junto con 'type'."
          },
          "cuentaPropia": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "La cuenta TUYA involucrada, cuando el banco la publica. Hoy sólo la trae el listado de recibidas; en las enviadas Itaú informa el banco de destino pero no la cuenta."
          },
          "syncedAt": {
            "type": "string",
            "description": "Cuándo se leyó esta fila del banco (ISO 8601). Si está vieja, la sincronización puede haber dejado de correr (por ejemplo, con la conexión pausada tras varios fallos) mientras esta tool sigue respondiendo con filas antiguas."
          }
        },
        "required": [
          "id",
          "direccion",
          "estado",
          "fecha",
          "periodo",
          "contraparte",
          "monto",
          "display",
          "cuentaPropia",
          "syncedAt"
        ],
        "additionalProperties": false
      },
      "description": "Las transferencias guardadas que calzan con los filtros, de la más reciente a la más antigua. Una lista vacía significa que ese mes no se ha sincronizado, no que no haya transferencias."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Puntero a la página siguiente. Si viene distinto de null hay más filas: vuelve a llamar reenviándolo tal cual en 'cursor'. Un null significa que no queda nada por traer."
    }
  },
  "required": [
    "transferencias",
    "cursor"
  ],
  "additionalProperties": false
}

Errores de esta tool

CódigoHTTPReintentableQué hacer
connection_disabled403noReactívala en /connections o usa otra conexión del mismo sistema.
connection_not_found404noUsa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
alcance_not_enabled403noHabilita el alcance en /connections o quítalo del input de la sincronización.

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

En esta página