Consultar nóminas de pago BCI 360

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

Tool IDbci_360.nominas.consultar
Nombre MCPbci_360__nominas__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 las cabeceras de las nóminas de pago de la empresa en BCI, también las cargadas a mano, desde lo ya sincronizado y sin contactar al banco. Cada una trae su estado en el código de BCI, un estado legible cuando el código es conocido y los conteos de pagos pagados, no pagados, eliminados y con destinatarios sin inscribir. Los pagos de cada nómina se piden con 'bci_360.nomina_pagos.consultar' y su 'folioNomina'. Exige el alcance 'nominas' habilitado. Pagina con 'cursor'.

Entrada

CampoTipoRequeridoDescripción
periodostring ^\d{4}-\d{2}$noMes AAAA-MM de creación. Si lo omites, trae todos los períodos guardados.
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": {
    "periodo": {
      "description": "Mes AAAA-MM de creación. Si lo omites, trae todos los períodos guardados.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}$"
    },
    "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
    }
  }
}

Ejemplo

curl
curl -X POST https://connect.emisso.ai/api/v1/tools/bci_360.nominas.consultar/execute \
  -H "Authorization: Bearer connect_sk_…" \
  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \
  -H "Content-Type: application/json" \
  -d '{"input":{"periodo":"2026-11"}}'
MCP · meta-tool execute
{
  "tool": "bci_360.nominas.consultar",
  "params": {
    "periodo": "2026-11"
  },
  "connectionId": "conn_9tKfR2mQx4Vb"
}

Salida esperada (200):

{
  "data": {
    "nominas": [
      {
        "folioNomina": "123456789012",
        "nombreNomina": "Pago proveedor",
        "nombreArchivo": "pago_proveedor.txt",
        "estado": "pendiente_firma",
        "estadoNomina": "EAPP",
        "subEstadoNomina": "PFIR",
        "razonEstadoNomina": null,
        "razonSubEstadoNomina": null,
        "fechaCarga": "2026-11-13",
        "fechaPago": null,
        "tipoPago": "GENERICO",
        "cuentaCargo": "000012345678",
        "moneda": "CLP",
        "registrosTotales": 1,
        "registrosPagados": 0,
        "registrosNoPagados": 0,
        "registrosEliminados": 0,
        "registrosConObservaciones": 0,
        "registrosValidados": 1,
        "registrosDestinatariosNoInscritos": 0,
        "montoTotal": 150000,
        "montoPagado": 0,
        "montoNoPagado": 0,
        "type": "credit",
        "display": "-150.000",
        "posibleDuplicado": false,
        "periodo": "2026-11",
        "ultimaLecturaEn": "2026-11-13T15:02:11.000Z"
      }
    ],
    "cursor": null
  },
  "meta": {
    "request_id": "req_…",
    "tool_id": "bci_360.nominas.consultar",
    "plane": "action",
    "latency_ms": 24,
    "audit_status": "recorded"
  }
}

Salida

CampoTipoRequeridoDescripción
nominaslista de objetosíCabeceras guardadas, de la carga más reciente a la más antigua. Incluye las nóminas cargadas a mano en BCI. Una lista vacía significa que el período no se ha sincronizado o que no hubo nóminas.
nominas[].folioNominastring ^[1-9][0-9]{0,31}$síFolio de la nómina en BCI. Es el valor que pide 'bci_360.nomina_pagos.consultar' para traer sus pagos.
nominas[].nombreNominastringnullsí
nominas[].nombreArchivostringnullsí
nominas[].estado"pagada" · "eliminada" · "pendiente_firma" · "preparada"nullsí
nominas[].estadoNominastringsíCódigo de estado de la nómina tal como lo entrega BCI (por ejemplo PAG, ELI o EAPP).
nominas[].subEstadoNominastringnullsí
nominas[].razonEstadoNominastringnullsí
nominas[].razonSubEstadoNominastringnullsí
nominas[].fechaCargastringnullsí
nominas[].fechaPagostringnullsí
nominas[].tipoPagostringnullsí
nominas[].cuentaCargostringnullsí
nominas[].monedastringnullsí
nominas[].registrosTotalesenteronullsí
nominas[].registrosPagadosenteronullsí
nominas[].registrosNoPagadosenteronullsí
nominas[].registrosEliminadosenteronullsí
nominas[].registrosConObservacionesenteronullsí
nominas[].registrosValidadosenteronullsí
nominas[].registrosDestinatariosNoInscritosenteronullsí
nominas[].montoTotalnúmeronullsí
nominas[].montoPagadonúmeronullsí
nominas[].montoNoPagadonúmeronullsí
nominas[].type"credit" · "debit"nullsí
nominas[].displaystringnullsí
nominas[].posibleDuplicadobooleanonullsí
nominas[].periodostringsíMes AAAA-MM de creación de la nómina con que se sincronizó. No forma parte de su identidad.
nominas[].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": {
    "nominas": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "folioNomina": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,31}$",
            "description": "Folio de la nómina en BCI. Es el valor que pide 'bci_360.nomina_pagos.consultar' para traer sus pagos."
          },
          "nombreNomina": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Nombre con que se creó la nómina en BCI."
          },
          "nombreArchivo": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Nombre del archivo cargado, cuando la nómina vino de un archivo."
          },
          "estado": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "pagada",
                  "eliminada",
                  "pendiente_firma",
                  "preparada"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Estado legible, solo para códigos ya observados en BCI. null significa que el código no está mapeado: revisa 'estadoNomina'."
          },
          "estadoNomina": {
            "type": "string",
            "description": "Código de estado de la nómina tal como lo entrega BCI (por ejemplo PAG, ELI o EAPP)."
          },
          "subEstadoNomina": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Subestado entregado por BCI (por ejemplo PFIR: pendiente de firma). null si viene vacío."
          },
          "razonEstadoNomina": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Razón del estado en el texto del propio BCI, sin traducir."
          },
          "razonSubEstadoNomina": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Razón del subestado en el texto del propio BCI, sin traducir."
          },
          "fechaCarga": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "x-emisso-formato": "AAAA-MM-DD",
            "description": "La fecha de carga de la nómina en 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."
          },
          "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."
          },
          "tipoPago": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Tipo de pago en el código de BCI (por ejemplo GENERICO)."
          },
          "cuentaCargo": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuenta de la empresa contra la que se carga la nómina."
          },
          "moneda": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Moneda de la nómina según BCI."
          },
          "registrosTotales": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos que contiene la nómina. Sirve para dimensionar antes de pedir sus pagos."
          },
          "registrosPagados": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos que BCI informa como pagados."
          },
          "registrosNoPagados": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos que BCI informa como no pagados."
          },
          "registrosEliminados": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos eliminados de la nómina."
          },
          "registrosConObservaciones": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos con observaciones de BCI."
          },
          "registrosValidados": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos validados por BCI."
          },
          "registrosDestinatariosNoInscritos": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": -9007199254740991,
                "maximum": 9007199254740991
              },
              {
                "type": "null"
              }
            ],
            "description": "Pagos cuyo destinatario no está inscrito en BCI. Mientras sea mayor que cero la nómina no avanza: hay que inscribirlos en BCI."
          },
          "montoTotal": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Total de la nómina, como magnitud sin signo. El sentido lo da 'type': siempre 'credit', es un desembolso de la empresa."
          },
          "montoPagado": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Monto de los pagos informados como pagados."
          },
          "montoNoPagado": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "description": "Monto de los pagos informados como no pagados."
          },
          "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'."
          },
          "posibleDuplicado": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "description": "True cuando BCI marca la nómina como posible duplicado de otra."
          },
          "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",
          "nombreNomina",
          "nombreArchivo",
          "estado",
          "estadoNomina",
          "subEstadoNomina",
          "razonEstadoNomina",
          "razonSubEstadoNomina",
          "fechaCarga",
          "fechaPago",
          "tipoPago",
          "cuentaCargo",
          "moneda",
          "registrosTotales",
          "registrosPagados",
          "registrosNoPagados",
          "registrosEliminados",
          "registrosConObservaciones",
          "registrosValidados",
          "registrosDestinatariosNoInscritos",
          "montoTotal",
          "montoPagado",
          "montoNoPagado",
          "type",
          "display",
          "posibleDuplicado",
          "periodo",
          "ultimaLecturaEn"
        ],
        "additionalProperties": false
      },
      "description": "Cabeceras guardadas, de la carga más reciente a la más antigua. Incluye las nóminas cargadas a mano en BCI. Una lista vacía significa que el período no se ha sincronizado o que no hubo nóminas."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Si no es null hay más filas: vuelve a llamar con este valor en 'cursor'."
    }
  },
  "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