Floid Developers Contáctanos

banco_empresa.transferencias.consultar

Transferencias recibidas en una cuenta de empresa en un rango de fechas.

Lectura Credencial bancaria de empresa Ver ficha en JSON

Bancos

bcichileconsorcioestadosantander

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, chile, consorcio, estado, santander.
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.
desde requerido fecha YYYY-MM-DD Fecha inicial (YYYY-MM-DD).
hasta requerido fecha YYYY-MM-DD Fecha final (YYYY-MM-DD).
id_secundario booleano Agrega id_2 a cada movimiento: identificador alternativo que incluye la descripción.
Solo bancos: bci, chile, consorcio, estado
id_pago booleano Agrega payment_id: huella de fecha, monto, RUT y cuenta del ordenante, útil para conciliar pagos.
Solo bancos: bci, chile, consorcio, estado
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.transferencias.consultar",
  "parametros": {
    "banco": "bci",
    "credencial_token": "<credencial_token>",
    "cuenta": "12345678",
    "desde": "2025-01-01",
    "hasta": "2025-01-31"
  }
}

Terminal

curl https://mcp.floid.app/sandbox/v1/ejecutar \
  -H "Authorization: Bearer $FLOID_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "herramienta": "banco_empresa.transferencias.consultar",
  "parametros": {
    "banco": "bci",
    "rut": "11111111-1",
    "clave": "1234",
    "rut_empresa": "77777777-7",
    "cuenta": "12345678",
    "desde": "2025-01-01",
    "hasta": "2025-01-31"
  }
}'

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.transferencias.consultar',
     'parametros': {'banco': 'bci',
                    'rut': '11111111-1',
                    'clave': '1234',
                    'rut_empresa': '77777777-7',
                    'cuenta': '12345678',
                    'desde': '2025-01-01',
                    'hasta': '2025-01-31'}},
    timeout=300,
)
print(respuesta.json())

Respuesta

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