# Itaú Corporate

> Consulta por API o MCP los saldos, movimientos y pagos por beneficiario de las nóminas de una empresa conectada a Emisso con Itaú Corporate.



Con la conexión de Itaú Corporate, tu software o tu agente lee los saldos, los movimientos y las nóminas de pago masivo
de la empresa conectada. Las consultas no llaman al banco: responden desde la última
sincronización.

Se cobra como cualquier conexión bancaria. Las [cinco herramientas de Itaú Corporate](/docs/referencia/itau_corporate) requieren una conexión autorizada.

## Qué datos trae [#qué-datos-trae]

| Alcance       | Herramienta                            | Qué devuelve                                                                                                                                                |
| ------------- | -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `saldos`      | `itau_corporate.saldos.consultar`      | Una foto diaria por cuenta: saldo total, retenciones y saldo disponible, incluida la cuenta dólar                                                           |
| `movimientos` | `itau_corporate.movimientos.consultar` | Los últimos 100 movimientos de cada cuenta, archivados por el mes de su fecha                                                                               |
| `nominas`     | `itau_corporate.nominas.consultar`     | Cada nómina con su fecha de creación, fecha de pago si existe, estado, total y líneas con el nombre y RUT del beneficiario, monto, moneda y estado del pago |

Emisso solo consulta: no transfiere, no paga y no cambia nada en el banco. Si tu usuario opera varias
empresas, Emisso lee únicamente la empresa de la conexión y no guarda datos si no puede abrirla.

## Antes de empezar [#antes-de-empezar]

1. **Elige tu portal.** En Conexiones, selecciona Itaú Corporate si accedes por el portal Corporate del banco. Si usas el portal Empresas, elige [Itaú Empresas](/docs/sistemas/itau-empresas).
2. **Empresa conectada.** Conecta Itaú Corporate desde [Conexiones](https://connect.emisso.ai/connections)
   con el RUT de usuario, la clave y el RUT de la empresa. La conexión queda lista cuando se confirma su
   primera sincronización.
3. **Permiso en tu clave o en tu agente.** Agrega el permiso **Itaú Corporate** (`itau_corporate:read`) a tu
   [clave de API](https://connect.emisso.ai/api-keys) o a tu [agente](https://connect.emisso.ai/agentes).
4. **El ID de la conexión.** Cópialo desde el detalle de la conexión: empieza con `conn_`.

## Consultar por API [#consultar-por-api]

Cada herramienta es un `POST` a `https://connect.emisso.ai/api/v1/tools/<herramienta>/execute`. La clave
va en `Authorization`, la conexión en la cabecera `X-Connect-Connection` y los argumentos dentro de `input`.
Los movimientos de octubre de 2026:

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/itau_corporate.movimientos.consultar/execute \
  -H "Authorization: Bearer $EMISSO_CONNECT_API_KEY" \
  -H "X-Connect-Connection: $EMISSO_CONNECTION_ID" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-10","limit":100}}'
```

```json
{
  "data": {
    "movimientos": [
      {
        "id": "4b1d0f6a9c2e47d8b3a5f0e1c9d7a6b5e4f3c2d1a0b9c8d7e6f5a4b3c2d1e0f9",
        "numeroCuenta": "1000000000",
        "currency": "CLP",
        "periodo": "2026-10",
        "fecha": "2026-10-07",
        "descripcion": "PAGO PROVEEDORES NOMINA",
        "documento": "200000000",
        "monto": 2490244,
        "type": "credit",
        "display": "-2.490.244",
        "saldo": 2509756,
        "oficina": "OPERACIONES CENTRALES",
        "contraparte": null,
        "superficie": "ultimos_movimientos",
        "syncedAt": "2026-11-04T14:02:11.000Z"
      }
    ],
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "itau_corporate.movimientos.consultar",
    "plane": "action"
  }
}
```

`monto` es la magnitud sin signo y `type` dice si la plata sale (`credit`) o entra (`debit`) según el libro
del banco. `saldo` es el saldo que queda después del movimiento. Cuando la respuesta trae `cursor`, reenvíalo
tal cual para pedir la página siguiente.

## Consultar una nómina de pago masivo [#consultar-una-nómina-de-pago-masivo]

El módulo **Nóminas de pago** viene desactivado. Habilítalo en **Conexiones → tu conexión de Itaú Corporate → Ajustes → Módulos de datos** si tu usuario tiene acceso a pagos masivos. Si ese acceso no está disponible, Emisso omite las nóminas y continúa con los demás módulos habilitados.
Emisso sincroniza el mes corriente. Del día 1 al 10 inclusive, según la fecha de Chile, también revisa el mes anterior. Puedes consultar los meses que ya quedaron guardados.

Emisso lee primero las nóminas nuevas que informa el banco, cualquiera sea su antigüedad. Después actualiza las pendientes hasta 90 días después de su creación, inclusive, según la fecha de Chile. El seguimiento termina antes si el banco informa que la nómina está pagada (incluido el pago con rechazos), rechazada o expirada.

Desde el día 91, su último estado y sus pagos siguen disponibles para consulta. Emisso deja de actualizarla aunque el banco todavía la incluya en el listado. Para nóminas antiguas de las que sólo se conoce el mes, cuenta el plazo desde el último día de ese mes.

En la pestaña **Datos**, abre el módulo y selecciona la cantidad de pagos de una nómina para ver sus beneficiarios.
Para actualizar el mes en curso, pide los módulos habilitados en una sola sincronización. Por ejemplo, si tienes los tres, usa `itau_corporate.conexion.sincronizar` con `periodo` en formato `AAAA-MM` y `alcances: ["saldos", "movimientos", "nominas"]`.

El filtro `periodo` usa la fecha de pago. Si el banco todavía no informa esa fecha, o si rechazó la nómina sin pagarla, usa el mes de creación. Revisa el estado de cada línea para distinguir los pagos realizados de los rechazados o pendientes. Cada elemento de `nominas` trae su
`idNomina` y un arreglo `lineas` con los pagos individuales.

```bash
curl -X POST https://connect.emisso.ai/api/v1/tools/itau_corporate.nominas.consultar/execute \
  -H "Authorization: Bearer $EMISSO_CONNECT_API_KEY" \
  -H "X-Connect-Connection: $EMISSO_CONNECTION_ID" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-11","limit":10}}'
```

Si ya conoces el identificador, envía `{"input":{"idNomina":"123"}}` al mismo endpoint.
Tanto `periodo` como `idNomina` son opcionales. La consulta trae 10 nóminas por defecto y admite hasta 50 por página, con todas sus líneas. Para continuar,
envía el `cursor` de la respuesta con los mismos filtros. Si la sincronización informa un fallo al leer una nómina, las que se verificaron completas siguen disponibles.

## Consultar desde un agente [#consultar-desde-un-agente]

Con el servidor MCP de Emisso, pide los datos en lenguaje natural, por ejemplo: «¿cuánto tengo disponible
en mis cuentas de Itaú Corporate?» o «¿qué movimientos tuvo mi cuenta de Itaú Corporate en octubre?».

Para revisar pagos, pide «Muéstrame las nóminas de Itaú Corporate de este mes y el monto pagado a cada beneficiario».


---

Esta página es parte de la documentación de Emisso. El índice completo, con cada página y su descripción, está en https://connect.emisso.ai/llms.txt. Esta misma página en HTML: https://connect.emisso.ai/docs/sistemas/itau-corporate.
