Consultar nóminas de pago BCI 360

Antes de pedir datos nuevos, consulta atenciones en conexiones.estado.consultar. 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'.

POST
/v1/tools/bci_360.nominas.consultar/execute
AuthorizationBearer <token>

API key de la organización, en 'Authorization: Bearer connect_sk_…'. Es la credencial para tu backend y tus agentes propios; se crea en el dashboard con permisos explícitos y su valor completo se muestra una sola vez. Autentica como agente: la bitácora atribuye la acción a la clave, nunca a la persona que la creó.

In: header

Header Parameters

X-Connect-Connection*string

Cuál conexión (conn_…) ejecuta esta llamada. Obligatoria en todo sistema conectable y sin resolución implícita, ni siquiera cuando la organización tiene una sola conexión activa: la conexión ES la empresa, y elegir por ti una que hoy acierta mañana acierta distinto sin que nadie cambie nada. Los ids salen de la tool 'conexiones.estado.consultar'. Si falta, la respuesta es 'validation_error' y no se contacta al sistema externo.

Match^conn_

Request Body

application/json

La entrada de la tool, envuelta en 'input'. Manda '{"input": {}}' cuando la tool no toma argumentos: el sobre es obligatorio aunque esté vacío.

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/tools/bci_360.nominas.consultar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {}  }'
{  "data": {    "nominas": [      {        "folioNomina": "string",        "nombreNomina": "string",        "nombreArchivo": "string",        "estado": "pagada",        "estadoNomina": "string",        "subEstadoNomina": "string",        "razonEstadoNomina": "string",        "razonSubEstadoNomina": "string",        "fechaCarga": "string",        "fechaPago": "string",        "tipoPago": "string",        "cuentaCargo": "string",        "moneda": "string",        "registrosTotales": -9007199254740991,        "registrosPagados": -9007199254740991,        "registrosNoPagados": -9007199254740991,        "registrosEliminados": -9007199254740991,        "registrosConObservaciones": -9007199254740991,        "registrosValidados": -9007199254740991,        "registrosDestinatariosNoInscritos": -9007199254740991,        "montoTotal": 0,        "montoPagado": 0,        "montoNoPagado": 0,        "type": "credit",        "display": "string",        "posibleDuplicado": true,        "periodo": "string",        "ultimaLecturaEn": "string"      }    ],    "cursor": "string"  },  "meta": {    "request_id": "string",    "operation_request_id": "733a3a71-b72d-4633-94b1-070c6664565f",    "tool_id": "string",    "plane": "action",    "latency_ms": 0,    "audit_status": "recorded",    "idempotency": "replayed"  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}
{  "error": {    "code": "alcance_not_enabled",    "message": "string",    "suggested_fix": "string",    "request_id": "string",    "details": null  }}