# Consultar los pagos de una nómina BCI 360

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



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

|                     |                                                                    |
| ------------------- | ------------------------------------------------------------------ |
| **Tool ID**         | `bci_360.nomina_pagos.consultar`                                   |
| **Nombre MCP**      | `bci_360__nomina_pagos__consultar`                                 |
| **Conector**        | `bci_360`                                                          |
| **Plano**           | `action`                                                           |
| **Lee el alcance**  | `nominas` (debe estar habilitado en la conexión)                   |
| **Scope (permiso)** | `bci_360: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. Devuelve los pagos guardados de UNA nómina de BCI, con el estado de cada pago en el código y el texto del propio BCI, el destinatario, su cuenta y el monto. Lee lo ya sincronizado y no contacta al banco. Pide el 'folioNomina' que entrega 'bci\_360.nominas.consultar'. Pagina con 'cursor'.

## Entrada [#entrada]

| Campo         | Tipo                        | Requerido          | Descripción                                                                                                                 |
| ------------- | --------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| `folioNomina` | string `^[1-9][0-9]{0,31}$` | sí                 | Folio de la nómina en BCI.                                                                                                  |
| `cursor`      | string                      | no                 | Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' de la respuesta anterior; omítelo para 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.                                                              |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "folioNomina": {
        "type": "string",
        "pattern": "^[1-9][0-9]{0,31}$",
        "description": "Folio de la nómina en BCI."
      },
      "cursor": {
        "description": "Puntero opaco a la página siguiente. Reenvía tal cual el 'cursor' de la respuesta anterior; omítelo para 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
      }
    },
    "required": [
      "folioNomina"
    ]
  }
  ```
</details>

## Ejemplo [#ejemplo]

```bash title="curl"
curl -X POST https://connect.emisso.ai/api/v1/tools/bci_360.nomina_pagos.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"folioNomina":"123456789012"}}'
```

```json title="MCP · meta-tool execute"
{
  "tool": "bci_360.nomina_pagos.consultar",
  "params": {
    "folioNomina": "123456789012"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}
```

**Salida esperada (200):**

```json
{
  "data": {
    "pagos": [
      {
        "folioNomina": "123456789012",
        "idPago": "1",
        "estado": null,
        "estadoPago": "VAL",
        "glosaEstadoPago": "Validado",
        "razonEstadoPago": null,
        "rutDestinatario": "76000000-0",
        "nombreDestinatario": "Proveedor de ejemplo",
        "cuentaDestinatario": "87654321",
        "tipoCuentaDestinatario": "CCT",
        "codigoBancoDestinatario": "037",
        "nombreBancoDestinatario": "Banco de ejemplo",
        "emailDestinatario": null,
        "monto": 150000,
        "type": "credit",
        "display": "-150.000",
        "moneda": "CLP",
        "mensaje": "Factura 1001",
        "numeroFactura": "1001",
        "numeroOrdenDeCompra": null,
        "fechaPago": null,
        "periodo": "2026-11",
        "ultimaLecturaEn": "2026-11-13T15:02:11.000Z"
      }
    ],
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "bci_360.nomina_pagos.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}
```

## Salida [#salida]

| Campo                             | Tipo                        | Requerido | Descripción                                                                                                |                                                                                                                                                                                                                                                                                                                                                                                                   |
| --------------------------------- | --------------------------- | --------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `pagos`                           | lista de objeto             | sí        | Pagos guardados de la nómina pedida. Una lista vacía significa que sus pagos aún no se sincronizan.        |                                                                                                                                                                                                                                                                                                                                                                                                   |
| `pagos[].folioNomina`             | string `^[1-9][0-9]{0,31}$` | sí        | Folio de la nómina a la que pertenece el pago: el mismo que pediste.                                       |                                                                                                                                                                                                                                                                                                                                                                                                   |
| `pagos[].idPago`                  | string                      | sí        | Identificador del pago dentro de la nómina, como texto.                                                    |                                                                                                                                                                                                                                                                                                                                                                                                   |
| `pagos[].estado`                  | `"pagado"` · `"eliminado"`  | null      | sí                                                                                                         | Estado legible, solo para códigos ya observados. null: revisa 'estadoPago' y 'glosaEstadoPago'.                                                                                                                                                                                                                                                                                                   |
| `pagos[].estadoPago`              | string                      | null      | sí                                                                                                         | Código de estado del pago tal como lo entrega BCI (por ejemplo PAG, ELI o VAL).                                                                                                                                                                                                                                                                                                                   |
| `pagos[].glosaEstadoPago`         | string                      | null      | sí                                                                                                         | Descripción del estado en el texto del propio BCI.                                                                                                                                                                                                                                                                                                                                                |
| `pagos[].razonEstadoPago`         | string                      | null      | sí                                                                                                         | Razón del estado en el texto del propio BCI, por ejemplo el motivo de un rechazo.                                                                                                                                                                                                                                                                                                                 |
| `pagos[].rutDestinatario`         | string                      | null      | sí                                                                                                         | RUT del destinatario, con dígito verificador.                                                                                                                                                                                                                                                                                                                                                     |
| `pagos[].nombreDestinatario`      | string                      | null      | sí                                                                                                         | Nombre del destinatario.                                                                                                                                                                                                                                                                                                                                                                          |
| `pagos[].cuentaDestinatario`      | string                      | null      | sí                                                                                                         | Cuenta de destino. Va cifrada en reposo, por eso no hay filtro por cuenta.                                                                                                                                                                                                                                                                                                                        |
| `pagos[].tipoCuentaDestinatario`  | string                      | null      | sí                                                                                                         | Tipo de cuenta de destino en el código de BCI.                                                                                                                                                                                                                                                                                                                                                    |
| `pagos[].codigoBancoDestinatario` | string                      | null      | sí                                                                                                         | Código del banco de destino.                                                                                                                                                                                                                                                                                                                                                                      |
| `pagos[].nombreBancoDestinatario` | string                      | null      | sí                                                                                                         | Nombre del banco de destino.                                                                                                                                                                                                                                                                                                                                                                      |
| `pagos[].emailDestinatario`       | string                      | null      | sí                                                                                                         | Correo de aviso al destinatario, cuando lo hay.                                                                                                                                                                                                                                                                                                                                                   |
| `pagos[].monto`                   | número                      | null      | sí                                                                                                         | Monto del pago, como magnitud sin signo. El sentido lo da 'type': siempre 'credit'.                                                                                                                                                                                                                                                                                                               |
| `pagos[].type`                    | `"credit"` · `"debit"`      | null      | sí                                                                                                         | Eje crédito/débito del LIBRO DEL BANCO, no el de la cartola: 'debit' es plata que ENTRA a la cuenta (un abono) y 'credit' es plata que SALE (un cargo). Es al revés de la lectura intuitiva y está así a propósito. El campo 'monto' es la magnitud SIN signo; el signo lo lleva 'display' ('credit' → negativo). 'null' significa que el banco no informó el tipo: no asumas ninguno de los dos. |
| `pagos[].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'.                                                                                                                    |
| `pagos[].moneda`                  | string                      | null      | sí                                                                                                         | Moneda del pago según BCI.                                                                                                                                                                                                                                                                                                                                                                        |
| `pagos[].mensaje`                 | string                      | null      | sí                                                                                                         | Mensaje o glosa con que se identifica el pago.                                                                                                                                                                                                                                                                                                                                                    |
| `pagos[].numeroFactura`           | string                      | null      | sí                                                                                                         | Número de factura informado en la nómina, como texto.                                                                                                                                                                                                                                                                                                                                             |
| `pagos[].numeroOrdenDeCompra`     | string                      | null      | sí                                                                                                         | Número de orden de compra informado en la nómina, como texto.                                                                                                                                                                                                                                                                                                                                     |
| `pagos[].fechaPago`               | string                      | null      | sí                                                                                                         | La fecha de pago informada por BCI en formato AAAA-MM-DD, o null si no vino o no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar.                                                                              |
| `pagos[].periodo`                 | string                      | sí        | Mes AAAA-MM de creación de la nómina con que se sincronizó. No forma parte de su identidad.                |                                                                                                                                                                                                                                                                                                                                                                                                   |
| `pagos[].ultimaLecturaEn`         | string                      | sí        | Cuándo se leyó esta fila de BCI (ISO 8601). Si está vieja, revisa la última sincronización de la conexión. |                                                                                                                                                                                                                                                                                                                                                                                                   |
| `cursor`                          | string                      | null      | sí                                                                                                         | Si no es null hay más filas: vuelve a llamar con este valor en 'cursor'.                                                                                                                                                                                                                                                                                                                          |

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

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "pagos": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "folioNomina": {
              "type": "string",
              "pattern": "^[1-9][0-9]{0,31}$",
              "description": "Folio de la nómina a la que pertenece el pago: el mismo que pediste."
            },
            "idPago": {
              "type": "string",
              "description": "Identificador del pago dentro de la nómina, como texto."
            },
            "estado": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "pagado",
                    "eliminado"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Estado legible, solo para códigos ya observados. null: revisa 'estadoPago' y 'glosaEstadoPago'."
            },
            "estadoPago": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Código de estado del pago tal como lo entrega BCI (por ejemplo PAG, ELI o VAL)."
            },
            "glosaEstadoPago": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Descripción del estado en el texto del propio BCI."
            },
            "razonEstadoPago": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Razón del estado en el texto del propio BCI, por ejemplo el motivo de un rechazo."
            },
            "rutDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "RUT del destinatario, con dígito verificador."
            },
            "nombreDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Nombre del destinatario."
            },
            "cuentaDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Cuenta de destino. Va cifrada en reposo, por eso no hay filtro por cuenta."
            },
            "tipoCuentaDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Tipo de cuenta de destino en el código de BCI."
            },
            "codigoBancoDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Código del banco de destino."
            },
            "nombreBancoDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Nombre del banco de destino."
            },
            "emailDestinatario": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Correo de aviso al destinatario, cuando lo hay."
            },
            "monto": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Monto del pago, como magnitud sin signo. El sentido lo da 'type': siempre 'credit'."
            },
            "type": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "credit",
                    "debit"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Eje crédito/débito del LIBRO DEL BANCO, no el de la cartola: 'debit' es plata que ENTRA a la cuenta (un abono) y 'credit' es plata que SALE (un cargo). Es al revés de la lectura intuitiva y está así a propósito. El campo 'monto' es la magnitud SIN signo; el signo lo lleva 'display' ('credit' → negativo). 'null' significa que el banco no informó el tipo: no asumas ninguno de los dos."
            },
            "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'."
            },
            "moneda": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Moneda del pago según BCI."
            },
            "mensaje": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Mensaje o glosa con que se identifica el pago."
            },
            "numeroFactura": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Número de factura informado en la nómina, como texto."
            },
            "numeroOrdenDeCompra": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Número de orden de compra informado en la nómina, como texto."
            },
            "fechaPago": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "x-emisso-formato": "AAAA-MM-DD",
              "description": "La fecha de pago informada por BCI en formato AAAA-MM-DD, o null si no vino o no se pudo parsear. Es un día calendario sin zona horaria: compáralo como texto o con Date.UTC, porque new Date('2026-09-07') es medianoche UTC y en Chile se muestra como el 6. Es el campo que conviene usar para ordenar y filtrar."
            },
            "periodo": {
              "type": "string",
              "description": "Mes AAAA-MM de creación de la nómina con que se sincronizó. No forma parte de su identidad."
            },
            "ultimaLecturaEn": {
              "type": "string",
              "description": "Cuándo se leyó esta fila de BCI (ISO 8601). Si está vieja, revisa la última sincronización de la conexión."
            }
          },
          "required": [
            "folioNomina",
            "idPago",
            "estado",
            "estadoPago",
            "glosaEstadoPago",
            "razonEstadoPago",
            "rutDestinatario",
            "nombreDestinatario",
            "cuentaDestinatario",
            "tipoCuentaDestinatario",
            "codigoBancoDestinatario",
            "nombreBancoDestinatario",
            "emailDestinatario",
            "monto",
            "type",
            "display",
            "moneda",
            "mensaje",
            "numeroFactura",
            "numeroOrdenDeCompra",
            "fechaPago",
            "periodo",
            "ultimaLecturaEn"
          ],
          "additionalProperties": false
        },
        "description": "Pagos guardados de la nómina pedida. Una lista vacía significa que sus pagos aún no se sincronizan."
      },
      "cursor": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "null"
          }
        ],
        "description": "Si no es null hay más filas: vuelve a llamar con este valor en 'cursor'."
      }
    },
    "required": [
      "pagos",
      "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]

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