Connect
API REST

Buscar una transferencia en BCI (beta)

Busca, entre los movimientos ya sincronizados y sin contactar al banco, la transferencia que corresponde a un pago: recibe el monto, el día y, si lo tienes, el RUT de quien pagó, y devuelve las candidatas con una confianza ('alta', 'media', 'baja') y sus motivos. Sirve para validar un pago por transferencia sin creerle al comprobante. Exige el alcance 'movimientos' habilitado. Solo ve lo leído hasta 'ultimaLecturaEn': una transferencia más nueva requiere 'bci_pyme.conexion.sincronizar' primero. Sin candidatas NO significa que el pago no exista; revisa 'ultimaLecturaEn' y 'completo'. Si 'ambigua' es true hay más de un movimiento igual de probable. Cada movimiento valida un solo pago: lleva tú la cuenta de cuáles ya usaste. Está en beta: la confianza y la respuesta pueden ajustarse, y cada cambio queda en el changelog.

POST
/v1/tools/bci_pyme.transferencias.buscar/execute

Authorization

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_pyme.transferencias.buscar/execute" \  -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \  -H "Content-Type: application/json" \  -d '{    "input": {      "monto": 1,      "fecha": "string"    }  }'
{  "data": {    "candidatas": [      {        "confianza": "alta",        "motivos": [          "rut_coincide"        ],        "diferenciaDias": -9007199254740991,        "movimiento": {          "numeroCuenta": "string",          "currency": "string",          "serie": "string",          "periodo": "string",          "fechaMovimiento": "string",          "fechaContable": "string",          "descripcion": "string",          "monto": 0,          "type": "credit",          "display": "string",          "saldoContable": 0,          "category": "string",          "mnemonico": "string",          "counterparty": {            "name": "string",            "rut": "string",            "bank": "string",            "account": "string"          },          "ultimaLecturaEn": "string"        }      }    ],    "ambigua": true,    "ultimaLecturaEn": "string",    "completo": true  },  "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  }}

Consultar saldos de BCI POST

Devuelve, desde la caché ya sincronizada y sin contactar al banco, los saldos guardados de esta conexión (contable, disponible, 9AM y retención), con el snapshot más reciente primero. Exige el alcance 'saldos' habilitado. Si nunca se sincronizó, devuelve una lista vacía: eso NO significa que la empresa no tenga cuentas. Para traer datos nuevos usa 'bci_pyme.conexion.sincronizar' primero. Los saldos son un snapshot POR DÍA, así que sin filtro de fecha la primera página ya son los más recientes que hay guardados. Los cuatro saldos vienen como NÚMERO ya normalizado y conservan su signo: un sobregiro es negativo. Un saldo no lleva 'type' (no es una operación). 'ultimaLecturaEn' dice cuándo se leyó esa fila del banco: si es vieja, la conexión puede estar pausada. Pagina con 'cursor': cuando la respuesta trae 'cursor' distinto de null hay más filas: reenvía ese valor tal cual; nunca lo construyas a mano.

Sincronizar conexión BICE POST

Sincroniza los alcances solicitados (saldos, movimientos) para un período en una sola sesión de portal. `saldos` es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente.