Consultar nóminas de pago de Itaú Corporate

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

Tool IDitau_corporate.nominas.consultar
Nombre MCPitau_corporate__nominas__consultar
Conectoritau_corporate
Planoaction
Lee el alcancenominas (debe estar habilitado en la conexión)
Scope (permiso)itau_corporate: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. 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

CampoTipoRequeridoDescripción
periodostringnoMes 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.
idNominastringnoIdentificador exacto de la nómina que quieres consultar.
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-50no · default 10Número de nóminas por página, entre 1 y 50. Por omisión, 10.
JSON Schema de entrada
{
  "$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
    }
  }
}

Ejemplo

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"}}'
MCP · meta-tool execute
{
  "tool": "itau_corporate.nominas.consultar",
  "params": {
    "periodo": "2026-11",
    "idNomina": "17"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

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

CampoTipoRequeridoDescripción
nominaslista de objetosíNóminas guardadas que coinciden con los filtros, con los pagos de cada una.
nominas[].idNominastringsíIdentificador de la nómina asignado por Itaú Corporate.
nominas[].fechaPagostring ^\d{4}-\d{2}-\d{2}$nullsí
nominas[].fechaCreacionstring ^\d{4}-\d{2}-\d{2}$síDía de creación de la nómina en formato AAAA-MM-DD.
nominas[].descripcionstringsíDescripción de la nómina informada por el banco.
nominas[].estadostringsíEstado de la nómina informado por el banco.
nominas[].monedastringsíMoneda del monto total de la nómina.
nominas[].montonúmerosíMonto total de la nómina en la moneda indicada.
nominas[].lineaslista de objetosíPagos individuales que componen la nómina.
nominas[].lineas[].idLineastringsíIdentificador del pago dentro de la nómina.
nominas[].lineas[].beneficiariostringsíNombre del beneficiario del pago.
nominas[].lineas[].beneficiarioRutstringsíRUT del beneficiario del pago.
nominas[].lineas[].montonúmerosíMonto de este pago en la moneda de la línea.
nominas[].lineas[].monedastringsíMoneda de este pago.
nominas[].lineas[].estadostringsíEstado de este pago informado por el banco.
cursorstringnullsí
JSON Schema de salida
{
  "$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
}

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