Floid Developers Contáctanos

banco_persona.ingresos.calcular

Ingreso estimado de la persona a partir de 12 meses de movimientos (versión 2): promedio total, principal y extra, regularidad e ingreso por mes.

Lectura Credencial bancaria de persona Ver ficha en JSON

Bancos

bcibicechileestadofalabellaitauripleysantanderscotiabanksecurity

Antes de usarla

  • Dos claves inválidas seguidas bloquean la credencial en Floid por 1 hora. Ante INVALID_CREDENTIALS no reintentes con la misma clave.
  • Hace una extracción completa de 12 meses: puede tardar varios minutos.

Parámetros

NombreTipoDescripción
bancorequerido texto Banco a consultar: bci, bice, chile, estado, falabella, itau, ripley, santander, scotiabank, security.
rut texto RUT del titular, con guion (12345678-9).
clave solo REST texto Clave del titular en la institución.
credencial_token texto Token de credencial guardada en Floid (por ejemplo, el que entrega el widget). Reemplaza rut y clave.
cuenta texto Cuenta a analizar.
cuentas_excluidas lista Números de cuenta o textos cuyos abonos no cuentan como ingreso (por ejemplo, cuentas propias).
mostrar_movimientos booleano Incluye los movimientos usados en el cálculo.
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_persona.ingresos.calcular",
  "parametros": {
    "banco": "bci",
    "credencial_token": "<credencial_token>"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "banco_persona.ingresos.calcular",
  "parametros": {
    "banco": "bci",
    "rut": "11111111-1",
    "clave": "1234"
  }
}'

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_persona.ingresos.calcular',
     'parametros': {'banco': 'bci', 'rut': '11111111-1', 'clave': '1234'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

Siempre {"data": …, "meta": {"herramienta", "caseid"}}, o {"error": …, "meta": …} si algo falla. Formato de respuestas.