Sincronizar conexión Banco de Chile
Sincroniza los alcances solicitados (saldos, movimientos, movimientos de tarjetas y cartolas) 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. `cartolas` son los extractos MENSUALES ya emitidos por el banco, un objeto propio que NO alimenta `movimientos`. `movimientos` sincroniza cuentas en pesos chilenos (CLP) y dólares estadounidenses (USD).
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/bch_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", "completo": true, "recordsSynced": -9007199254740991, "error": "string", "detalle": "string", "diagnostico": { "version": 1, "tipo": "tarjetas", "identidad": "no_evaluada", "catalogo": { "productos": 0, "tarjetasReconocidas": 0, "tipo": { "ausente": 0, "cadena_vacia": 0, "cadena_no_vacia": 0 }, "familia": { "ausente": 0, "nula": 0, "cadena_vacia": 0, "cadena_no_vacia": 0 }, "etiquetasTipo": { "TARJETA": 0, "CUENTA": 0, "desconocida": 0 }, "etiquetasFamilia": { "TARJETA DE CREDITO": 0, "desconocida": 0 } } } } ] }, "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 líneas de una cartola histórica de Banco de Chile 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. Lee un extracto ya sincronizado por cuenta, moneda y fecha de emisión, y pagina sus líneas disponibles. No contacta al banco: primero sincroniza el alcance cartolas. El detalle de líneas está disponible para extractos CLP y USD cuando se obtuvo; otros extractos ofrecen sólo el resumen con sus saldos. Conserva repeticiones y documentos textuales; no ofrece contraparte estructurada ni IDs equivalentes al feed de movimientos. Una cartola puede existir con lineas null: no implica que esté vacía.
Verificar conexión Banco de Chile POST
Comprueba con Banco de Chile que las credenciales de la conexión funcionan. No sincroniza ni devuelve datos: solo confirma si las credenciales sirven.