banco_empresa.productos.consultar
Cuentas, tarjetas y líneas de crédito de una empresa, con saldos.
Lectura Credencial bancaria de empresa Ver ficha en JSON
Bancos
bcibicechileconsorcioestadointernacionalitausantanderscotiabanksecurity
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, chile, consorcio, 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. |
| mostrar_campos | objeto | Filtra campos por grupo, por ejemplo {"accounts": "all", "cards": ["number", "type"], "lines": []}. |
| 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.productos.consultar",
"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_empresa.productos.consultar",
"parametros": {
"banco": "bci",
"rut": "11111111-1",
"clave": "1234",
"rut_empresa": "77777777-7"
}
}'
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.productos.consultar',
'parametros': {'banco': 'bci',
'rut': '11111111-1',
'clave': '1234',
'rut_empresa': '77777777-7'}},
timeout=300,
)
print(respuesta.json())
Respuesta
Respuesta del sandbox de Floid normalizada por la capa, recortada a dos elementos por lista.
{
"data": {
"products": {
"accounts": [
{
"type": "corriente",
"number": 916891381,
"currency": "CLP",
"balance": 1000
},
{
"type": "vista",
"number": 916891382,
"currency": "CLP",
"balance": 0
}
],
"cards": [
{
"name": "MasterCard Advance",
"number": "****0001",
"currency": "CLP",
"total": 1000,
"used": 0,
"available": 1000
},
{
"name": "MasterCard Advance",
"number": "****0002",
"currency": "USD",
"total": 1000,
"used": 0,
"available": 1000
}
],
"lines": [
{
"number": 710138877884,
"currency": "CLP",
"total": 600000,
"used": 0,
"available": 600000
}
]
}
},
"meta": {
"herramienta": "banco_empresa.productos.consultar",
"caseid": "xxxxx"
}
}