banco_empresa.movimientos.consultar
Movimientos de una cuenta de empresa (cartola), con filtros de fecha y detalle opcional de transferencias.
Lectura Credencial bancaria de empresa Paginable Ver ficha en JSON
Bancos
bcibicecaja_los_heroeschileestadointernacionalitausantanderscotiabanksecurity
Antes de usarla
- Dos claves inválidas seguidas bloquean la credencial de empresa sin vencimiento: solo se libera con una validación exitosa. Ante INVALID_CREDENTIALS no reintentes.
Parámetros
| Nombre | Tipo | Descripción |
|---|---|---|
| bancorequerido | texto | Banco a consultar: bci, bice, caja_los_heroes, chile, estado, internacional, itau, santander, scotiabank, security. |
| rut | texto | RUT del titular, con guion (12345678-9). |
| clave solo REST | texto | Clave del titular en la institución. |
| rut_empresa | texto | RUT de la empresa, con guion. |
| credencial_token | texto | Token de credencial guardada en Floid (por ejemplo, el que entrega el widget). Reemplaza rut y clave. |
| cuenta requerido | texto | Número de la cuenta (sin guiones), tal como aparece en productos. |
| historico | booleano | true = últimos 12 meses; false = solo el último mes. |
| desde | fecha YYYY-MM-DD |
Fecha inicial (YYYY-MM-DD).
Solo bancos: bci, bice, caja_los_heroes, chile, estado, itau, santander, scotiabank, security |
| hasta | fecha YYYY-MM-DD |
Fecha final (YYYY-MM-DD).
Solo bancos: bci, bice, caja_los_heroes, chile, estado, itau, santander, scotiabank, security |
| id_secundario | booleano |
Agrega id_2 a cada movimiento: identificador alternativo que incluye la descripción.
Solo bancos: bci, bice, caja_los_heroes, chile, estado, itau, santander, scotiabank, security |
| id_pago | booleano |
Agrega payment_id: huella de fecha, monto, RUT y cuenta del ordenante, útil para conciliar pagos.
Solo bancos: santander |
| id_transaccion | booleano |
Agrega trx_id: identificador único y estable de cada transacción.
Solo bancos: bice, chile, estado, itau, santander, scotiabank, security |
| limite_transacciones | entero |
Máximo de transacciones a extraer.
Solo bancos: bci, caja_los_heroes, estado, itau, santander |
| transferencias | booleano |
Agrega el detalle de las transferencias (sender_info y recipient_info).
Solo bancos: bci, bice, caja_los_heroes, chile, estado, santander, scotiabank |
| conservar_hora | booleano |
Conserva la hora de cada transacción.
Solo bancos: bci |
| solo_ultimos | booleano |
Solo los últimos movimientos.
Solo bancos: bice |
| max_paginas | entero |
Máximo de páginas a recorrer en el banco.
Solo bancos: bice |
| recaudador | booleano |
Agrega los movimientos de recaudación.
Solo bancos: chile |
| offset | entero | Desde qué elemento devolver (0 = el primero). |
| limite | entero | Cuántos elementos devolver por página. |
| caseid | texto | Identificador del caso. Para pedir otra página de un resultado ya obtenido, repite el caseid de la primera respuesta. |
Credenciales del titular: credencial_token (la única opción por MCP) o sus datos de acceso solo por REST desde tu backend.
Cómo funcionan las credenciales.
Ejemplo
Con los datos de prueba del sandbox. En producción, quita /sandbox de la URL.
Argumentos de la herramienta MCP ejecutar
{
"herramienta": "banco_empresa.movimientos.consultar",
"parametros": {
"banco": "bci",
"credencial_token": "<credencial_token>",
"cuenta": "12345678"
}
}
Terminal
curl https://mcp.floid.app/sandbox/v1/ejecutar \
-H "Authorization: Bearer $FLOID_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"herramienta": "banco_empresa.movimientos.consultar",
"parametros": {
"banco": "bci",
"rut": "11111111-1",
"clave": "1234",
"rut_empresa": "77777777-7",
"cuenta": "12345678"
}
}'
Python
import os
import httpx
respuesta = httpx.post(
"https://mcp.floid.app/sandbox/v1/ejecutar",
headers={"Authorization": f"Bearer {os.environ['FLOID_TOKEN']}"},
json={'herramienta': 'banco_empresa.movimientos.consultar',
'parametros': {'banco': 'bci',
'rut': '11111111-1',
'clave': '1234',
'rut_empresa': '77777777-7',
'cuenta': '12345678'}},
timeout=300,
)
print(respuesta.json())
Respuesta
Respuesta del sandbox de Floid normalizada por la capa, recortada a dos elementos por lista.
{
"data": {
"transactions": [
{
"date": "2024-09-01",
"branch": "Agustinas",
"description": "Transf.Internet a 3o mismo Bco",
"doc_number": "0000000",
"out": 0,
"in": 4355000,
"balance": 15725662,
"id": "d3eab6db345023df7dd7ffc26563d5631"
},
{
"date": "2024-09-02",
"branch": "Agustinas",
"description": "Transf. Internet a otro Bancos",
"doc_number": "",
"out": -2500000,
"in": 0,
"balance": 13225662,
"id": "3c409308d19d8fb448c186d5a45a77a51"
}
]
},
"meta": {
"herramienta": "banco_empresa.movimientos.consultar",
"caseid": "xxxxx"
}
}