# Consultar nóminas de pago de Itaú Corporate

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



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

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `itau_corporate.nominas.consultar`                                 |
| **Nombre MCP**      | `itau_corporate__nominas__consultar`                               |
| **Conector**        | `itau_corporate`                                                   |
| **Plano**           | `action`                                                           |
| **Lee el alcance**  | `nominas` (debe estar habilitado en la conexión)                   |
| **Scope (permiso)** | `itau_corporate: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 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`](/docs/referencia/conexiones/estado-consultar).

## Qué hace [#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. Consulta las nóminas de pago ya sincronizadas de esta conexión y el detalle por beneficiario. Puedes filtrar por mes y por identificador de nómina. El filtro y el orden usan la fecha de pago o, cuando falta, la de creación. Las más recientes aparecen primero. Si recibes un cursor, reenvíalo con los mismos filtros para obtener la página siguiente. Para actualizar el mes corriente usa 'itau\_corporate.conexion.sincronizar' y pide 'saldos', 'movimientos' y 'nominas' juntos si los tienes habilitados.

## Entrada [#entrada]

| Campo      | Tipo        | Requerido         | Descripción                                                                                                                                                           |
| ---------- | ----------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `periodo`  | string      | no                | Mes de pago en formato AAAA-MM. Si falta la fecha de pago, se usa el mes de creación. Omítelo para consultar todos los meses guardados.                               |
| `idNomina` | string      | no                | Identificador exacto de la nómina que quieres consultar.                                                                                                              |
| `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-50 | no · default `10` | Número de nóminas por página, entre 1 y 50. Por omisión, 10.                                                                                                          |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "periodo": {
        "description": "Mes de pago en formato AAAA-MM. Si falta la fecha de pago, se usa el mes de creación. Omítelo para consultar todos los meses guardados.",
        "type": "string",
        "allOf": [
          {
            "pattern": "^(?!0000)\\d{4}-\\d{2}$"
          },
          {
            "pattern": "-(?:0[1-9]|1[0-2])$"
          }
        ]
      },
      "idNomina": {
        "description": "Identificador exacto de la nómina que quieres consultar.",
        "type": "string",
        "minLength": 1
      },
      "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": 10,
        "description": "Número de nóminas por página, entre 1 y 50. Por omisión, 10.",
        "type": "integer",
        "minimum": 1,
        "maximum": 50
      }
    }
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/itau_corporate.nominas.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-11","idNomina":"17"}}'
```

```json title="MCP · meta-tool execute"
{
  "tool": "itau_corporate.nominas.consultar",
  "params": {
    "periodo": "2026-11",
    "idNomina": "17"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "nominas": [
      {
        "idNomina": "17",
        "fechaPago": "2026-11-18",
        "fechaCreacion": "2026-11-17",
        "descripcion": "Pago proveedores",
        "estado": "Pagada",
        "moneda": "CLP",
        "monto": 45000,
        "lineas": [
          {
            "idLinea": "1",
            "beneficiario": "Proveedor de ejemplo",
            "beneficiarioRut": "76.123.456-0",
            "monto": 45000,
            "moneda": "CLP",
            "estado": "Pagado"
          }
        ]
      }
    ],
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "itau_corporate.nominas.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

## Salida [#salida]

| Campo                                | Tipo                         | Requerido | Descripción                                                                 |                                                                                                                                                                           |
| ------------------------------------ | ---------------------------- | --------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `nominas`                            | lista de objeto              | sí        | Nóminas guardadas que coinciden con los filtros, con los pagos de cada una. |                                                                                                                                                                           |
| `nominas[].idNomina`                 | string                       | sí        | Identificador de la nómina asignado por Itaú Corporate.                     |                                                                                                                                                                           |
| `nominas[].fechaPago`                | string `^\d{4}-\d{2}-\d{2}$` | null      | sí                                                                          | Día de pago en formato AAAA-MM-DD. Puede ser null, por ejemplo en una nómina rechazada.                                                                                   |
| `nominas[].fechaCreacion`            | string `^\d{4}-\d{2}-\d{2}$` | sí        | Día de creación de la nómina en formato AAAA-MM-DD.                         |                                                                                                                                                                           |
| `nominas[].descripcion`              | string                       | sí        | Descripción de la nómina informada por el banco.                            |                                                                                                                                                                           |
| `nominas[].estado`                   | string                       | sí        | Estado de la nómina informado por el banco.                                 |                                                                                                                                                                           |
| `nominas[].moneda`                   | string                       | sí        | Moneda del monto total de la nómina.                                        |                                                                                                                                                                           |
| `nominas[].monto`                    | número                       | sí        | Monto total de la nómina en la moneda indicada.                             |                                                                                                                                                                           |
| `nominas[].lineas`                   | lista de objeto              | sí        | Pagos individuales que componen la nómina.                                  |                                                                                                                                                                           |
| `nominas[].lineas[].idLinea`         | string                       | sí        | Identificador del pago dentro de la nómina.                                 |                                                                                                                                                                           |
| `nominas[].lineas[].beneficiario`    | string                       | sí        | Nombre del beneficiario del pago.                                           |                                                                                                                                                                           |
| `nominas[].lineas[].beneficiarioRut` | string                       | sí        | RUT del beneficiario del pago.                                              |                                                                                                                                                                           |
| `nominas[].lineas[].monto`           | número                       | sí        | Monto de este pago en la moneda de la línea.                                |                                                                                                                                                                           |
| `nominas[].lineas[].moneda`          | string                       | sí        | Moneda de este pago.                                                        |                                                                                                                                                                           |
| `nominas[].lineas[].estado`          | string                       | sí        | Estado de este pago informado por el banco.                                 |                                                                                                                                                                           |
| `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. |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "nominas": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "idNomina": {
              "type": "string",
              "minLength": 1,
              "description": "Identificador de la nómina asignado por Itaú Corporate."
            },
            "fechaPago": {
              "anyOf": [
                {
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "x-emisso-formato": "AAAA-MM-DD"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Día de pago en formato AAAA-MM-DD. Puede ser null, por ejemplo en una nómina rechazada."
            },
            "fechaCreacion": {
              "type": "string",
              "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
              "x-emisso-formato": "AAAA-MM-DD",
              "description": "Día de creación de la nómina en formato AAAA-MM-DD."
            },
            "descripcion": {
              "type": "string",
              "description": "Descripción de la nómina informada por el banco."
            },
            "estado": {
              "type": "string",
              "description": "Estado de la nómina informado por el banco."
            },
            "moneda": {
              "type": "string",
              "description": "Moneda del monto total de la nómina."
            },
            "monto": {
              "type": "number",
              "description": "Monto total de la nómina en la moneda indicada."
            },
            "lineas": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "idLinea": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Identificador del pago dentro de la nómina."
                  },
                  "beneficiario": {
                    "type": "string",
                    "description": "Nombre del beneficiario del pago."
                  },
                  "beneficiarioRut": {
                    "type": "string",
                    "description": "RUT del beneficiario del pago."
                  },
                  "monto": {
                    "type": "number",
                    "description": "Monto de este pago en la moneda de la línea."
                  },
                  "moneda": {
                    "type": "string",
                    "description": "Moneda de este pago."
                  },
                  "estado": {
                    "type": "string",
                    "description": "Estado de este pago informado por el banco."
                  }
                },
                "required": [
                  "idLinea",
                  "beneficiario",
                  "beneficiarioRut",
                  "monto",
                  "moneda",
                  "estado"
                ],
                "additionalProperties": false
              },
              "description": "Pagos individuales que componen la nómina."
            }
          },
          "required": [
            "idNomina",
            "fechaPago",
            "fechaCreacion",
            "descripcion",
            "estado",
            "moneda",
            "monto",
            "lineas"
          ],
          "additionalProperties": false
        },
        "description": "Nóminas guardadas que coinciden con los filtros, con los pagos de cada una."
      },
      "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": [
      "nominas",
      "cursor"
    ],
    "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_not_found` | 404  | no           | Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada. |
| `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](/docs/referencia/errores).

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

* [`itau_corporate.conexion.sincronizar`](/docs/referencia/itau_corporate/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.


---

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/referencia/itau_corporate/nominas-consultar.
