Floid Developers Contáctanos

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

NombreTipoDescripció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"
  }
}