Consultar los pagos de una nómina BCI 360

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

Tool IDbci_360.nomina_pagos.consultar
Nombre MCPbci_360__nomina_pagos__consultar
Conectorbci_360
Planoaction
Lee el alcancenominas (debe estar habilitado en la conexión)
Scope (permiso)bci_360: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. 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

CampoTipoRequeridoDescripción
folioNominastring ^[1-9][0-9]{0,31}$síFolio de la nómina en BCI.
cursorstringnoPuntero opaco a la página siguiente. Reenvía tal cual el 'cursor' de la respuesta anterior; omítelo para la primera página.
limitentero 1-500no · default 100Cuántas filas trae la página, entre 1 y 500. Por omisión, 100.
JSON Schema de entrada
{
  "$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"
  ]
}

Ejemplo

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"}}'
MCP · meta-tool execute
{
  "tool": "bci_360.nomina_pagos.consultar",
  "params": {
    "folioNomina": "123456789012"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

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

CampoTipoRequeridoDescripción
pagoslista de objetosíPagos guardados de la nómina pedida. Una lista vacía significa que sus pagos aún no se sincronizan.
pagos[].folioNominastring ^[1-9][0-9]{0,31}$síFolio de la nómina a la que pertenece el pago: el mismo que pediste.
pagos[].idPagostringsíIdentificador del pago dentro de la nómina, como texto.
pagos[].estado"pagado" · "eliminado"nullsí
pagos[].estadoPagostringnullsí
pagos[].glosaEstadoPagostringnullsí
pagos[].razonEstadoPagostringnullsí
pagos[].rutDestinatariostringnullsí
pagos[].nombreDestinatariostringnullsí
pagos[].cuentaDestinatariostringnullsí
pagos[].tipoCuentaDestinatariostringnullsí
pagos[].codigoBancoDestinatariostringnullsí
pagos[].nombreBancoDestinatariostringnullsí
pagos[].emailDestinatariostringnullsí
pagos[].montonúmeronullsí
pagos[].type"credit" · "debit"nullsí
pagos[].displaystringnullsí
pagos[].monedastringnullsí
pagos[].mensajestringnullsí
pagos[].numeroFacturastringnullsí
pagos[].numeroOrdenDeComprastringnullsí
pagos[].fechaPagostringnullsí
pagos[].periodostringsíMes AAAA-MM de creación de la nómina con que se sincronizó. No forma parte de su identidad.
pagos[].ultimaLecturaEnstringsíCuándo se leyó esta fila de BCI (ISO 8601). Si está vieja, revisa la última sincronización de la conexión.
cursorstringnullsí
JSON Schema de salida
{
  "$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
}

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