# Consultar transferencias de Banco Itaú > 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. {/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */} | | | | ------------------- | ------------------------------------------------------------------ | | **Tool ID** | `itau_empresas.transferencias.consultar` | | **Nombre MCP** | `itau_empresas__transferencias__consultar` | | **Conector** | `itau_empresas` | | **Plano** | `action` | | **Lee el alcance** | `transferencias` (debe estar habilitado en la conexión) | | **Scope (permiso)** | `itau_empresas:read` | | **Auth** | `none` | | **Versión** | `1` | | **Sensible** | sí | | **Deprecado** | no | | **Comportamiento** | readOnly=true, destructive=false, idempotent=true, openWorld=false | > **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] Es la ÚNICA fuente de contraparte del conector: trae RUT, nombre y banco de quien está al otro lado, que la cartola no publica. Cubre más que la cartola, cuyo portal sólo muestra unas seis semanas: 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 [#entrada] | Campo | Tipo | Requerido | Descripción | | ---------------- | ------------------------------------ | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `periodo` | string `^\d{4}-\d{2}$` | no | 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` | `"enviada"` · `"recibida"` | no | Filtra por sentido. Omítelo para ver las dos. | | `estado` | `"ok"` · `"error"` · `"desconocido"` | no | Filtra por resultado. Usa 'ok' para excluir las que el banco no cursó. | | `contraparteRut` | string | no | Filtra por el RUT de la contraparte. Acepta cualquier formato ('76.123.456-0' o '76123456-0'): Connect lo canoniza antes de buscar. Es el filtro para conciliar contra un proveedor o un cliente concreto. | | `cursor` | string | no | 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. | | `limit` | entero 1-500 | no · default `100` | Cuántas filas trae la página, entre 1 y 500. Por omisión, 100. |
JSON Schema de entrada ```json { "$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'): Connect 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 [#ejemplo] ```bash title="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"}}' ``` ```ts title="SDK TypeScript" const data = await connect.tools.itau_empresas.transferencias.consultar({ periodo: "2026-09", estado: "ok" }, { connectionId: "conn_9tKfR2mQx4Vb" }); ``` ```json title="MCP · meta-tool execute" { "tool": "itau_empresas.transferencias.consultar", "params": { "periodo": "2026-09", "estado": "ok" }, "connectionId": "conn_9tKfR2mQx4Vb" } ``` **Salida esperada (200):** ```json { "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 [#salida] | Campo | Tipo | Requerido | Descripción | | | ------------------------------------- | ------------------------------------ | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `transferencias` | lista de objeto | sí | 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[].id` | string | sí | El número de transferencia que acuña Itaú. Un movimiento no tiene número y Connect 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 Connect todavía no interpreta: no lo trates como exitoso. | | | `transferencias[].fecha` | string | null | sí | Fecha y hora de la transferencia (ISO 8601). A diferencia de la cartola, esta pantalla SÍ informa la hora. | | `transferencias[].periodo` | string | sí | 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[].contraparte` | objeto | sí | Quién está al otro lado. El banco lo publica en el 100 % de estas filas. | | | `transferencias[].contraparte.rut` | string | null | sí | El RUT de la contraparte, en formato '\-\' sin puntos y con el DV en mayúscula. Es el mismo formato en que Connect lo guarda, así que sirve tal cual para cruzar contra documentos del SII. | | `transferencias[].contraparte.nombre` | string | null | sí | El nombre o razón social de la contraparte, tal como lo publica el banco. | | `transferencias[].contraparte.banco` | string | null | sí | El banco de la contraparte, en el texto del propio Itaú (por ejemplo 'BANCO DE CHILE / EDWARDS'). | | `transferencias[].monto` | número | null | sí | Magnitud de la transferencia SIN signo. El sentido lo da 'direccion' y el signo visible lo trae 'display'. | | `transferencias[].display` | string | null | sí | 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'. | | `transferencias[].cuentaPropia` | string | null | sí | 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. | | `transferencias[].syncedAt` | string | sí | 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. | | | `cursor` | string | null | sí | 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. |
JSON Schema de salida ```json { "$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 Connect 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 Connect 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 '-' sin puntos y con el DV en mayúscula. Es el mismo formato en que Connect lo guarda, así que sirve tal cual para cruzar contra documentos del SII." }, "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": "Quién está al otro lado. El banco lo publica en el 100 % de estas filas." }, "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 [#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. | | `alcance_not_enabled` | 403 | no | Habilita 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](../errores). ## Próximos pasos [#próximos-pasos] * [`itau_empresas.conexion.sincronizar`](./conexion-sincronizar): la tool que escribe los datos que esta lectura devuelve. * [Sincronizar y consultar](/docs/conceptos/sincronizar-consultar): por qué leer datos reales son dos pasos.