Sincronizar conexión BICE
Sincroniza los alcances solicitados (saldos, movimientos) de BICE Empresas para un período en una sola sincronización. `saldos` es una foto del momento, no del período: solo se sincroniza cuando se pide el período corriente. Valida todas las páginas de cada cuenta antes de publicar movimientos. Si rechaza una captura incompleta, repetida o contradictoria, conserva la evidencia y los datos anteriores de esa cuenta. Las fallas estructurales informan status 'failed' y error 'movimientos_truncated'; otras cuentas válidas pueden avanzar y recordsSynced cuenta los registros publicados. En provisionales con fechas propias de cada página se publican las operaciones estructuralmente válidas, pero su manifiesto sigue sin acreditar cobertura global y no autoriza retiros ni reactivaciones. Un cero rechazado no acredita ausencia de movimientos.
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
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.
^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/bice_empresas.conexion.sincronizar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": { "periodo": "string", "alcances": [ "saldos" ] } }'{ "data": { "periodo": "string", "estado": "encolado", "jobId": "string", "yaEnCurso": true, "results": [ { "alcance": "string", "marcador": "string", "status": "ok", "recordsSynced": -9007199254740991, "error": "string", "cuentasConsultadas": -9007199254740991, "fueraDeVentana": true, "detalle": "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 }}Buscar una transferencia en BCI (beta) POST
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. 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.
Verificar conexión BICE POST
Comprueba con BICE que las credenciales de la conexión funcionan. No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.