Consultar movimientos de tarjetas de Banco de Chile
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 exclusivamente la caché de movimientos de tarjetas de crédito de esta conexión; NO contacta al banco. Incluye pendientes del período actual y estados de cuenta facturados en CLP y USD. El monto conserva el signo que entregó el banco: no se infiere cargo o abono. Por defecto devuelve solo filas vigentes; usa soloVigentes=false para incluir pendientes que ya no aparecen en la última captura. Nunca devuelve PAN, titular, RUT, número de cuenta, IDs crudos ni raw.
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.movimientos_tarjetas.consultar/execute" \ -H "X-Connect-Connection: conn_9tKfR2mQx4Vb" \ -H "Content-Type: application/json" \ -d '{ "input": {} }'{ "data": { "movimientosTarjetas": [ { "id": "string", "cardReference": "string", "terminacionTarjeta": "string", "tipoTarjeta": "string", "currency": "CLP", "estado": "pendiente", "vigente": true, "periodo": "string", "fechaTransaccion": "string", "fechaFacturacion": "string", "horaAutorizacion": "string", "seccion": "no_facturados", "descripcion": "string", "comercio": "string", "monto": 0, "display": "string", "montoMonedaOrigen": 0, "displayMonedaOrigen": "string", "cuotas": "string", "pais": "string", "rubro": "string", "ciudad": "string", "grupo": "string", "repeticiones": 1, "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 }}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.
Consultar movimientos 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 los movimientos ya sincronizados de esta conexión, del más reciente al más antiguo, filtrables por período (AAAA-MM) y por cuenta. Lectura pura: NO contacta al banco ni dispara una sincronización. Si el período nunca se sincronizó, devuelve una lista vacía, que NO significa que no haya movimientos. Incluye cuentas en pesos chilenos (CLP) y dólares estadounidenses (USD); la moneda viaja en cada fila. Para traer datos nuevos, usa 'bch_empresas.conexion.sincronizar' primero. Los montos vienen como NÚMERO: 'monto' es la magnitud sin signo, 'type' dice si entra ('debit') o sale ('credit') plata según el libro del banco (al revés de como se lee una cartola), y 'display' es ese monto ya formateado a la chilena con su signo. 'saldoContable' es un balance: no lleva 'type' y conserva su propio signo. 'id' es el identificador que entrega el banco: el mismo movimiento visto en dos sincronizaciones trae el mismo 'id', salvo cuando el banco lo cambia. Lo hace con algunos abonos al contabilizarlos: la versión provisoria y la contabilizada llegan con 'id' distinto, a veces en días distintos. Si guardas los movimientos en tu sistema, no te limites a agregar filas nuevas: vuelve a leer al menos el mes en curso y el anterior (con 'periodo') y reemplaza esos meses en tu copia. 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.