Otras operaciones
Sólo lecturaContextos (assignments)
Sólo lecturabaas_list_assignments
Lista los contextos tenant/cuenta (assignments) disponibles para las credenciales del API bancario del usuario. Úsalo cuando otra herramienta pida assignmentId.
Parámetros
Sin parámetros.
Devuelve
{ assignments[] }
assignments = contextos disponibles con assignment_id, tenant_code, owner_type, country_code y status.
Diagnóstico
Sólo lecturabaas_diagnostics
Verifica las credenciales del API bancario del usuario, el login, el intercambio de token y el acceso a cuentas. Úsalo cuando una consulta falle.
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
assignmentId | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |
Devuelve
{ checks[], failed }
checks = una fila por verificación (credenciales, login + assignments, cuentas) con ok y detalle; failed = cuántas fallaron. El correo de la credencial se devuelve enmascarado.
Listar cuentas
Sólo lecturabaas_list_accounts
Lista las cuentas accesibles del API bancario, sin saldos: tipo de identificador, valor y moneda.
Operación del API: GET /api/public/v1/accounts — ver la página de la operación
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
accountType | string | — | Filtro por esquema (IBAN) |
accountValue | string | — | Filtro por identificador |
limit | integer | — | Tamaño de página, entre 1 y 100 |
cursor | string | — | Cursor de la página anterior |
assignmentId | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |
Devuelve
{ result }
result = respuesta del API bancario tal cual.
Saldo de una cuenta
Sólo lecturabaas_get_balance
Obtiene el saldo actual de una cuenta del API bancario identificada por IBAN.
Operación del API: GET /api/public/v1/accounts/balance — ver la página de la operación
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
accountType | string (IBAN) | — | Esquema del identificador de la cuenta (IBAN) |
accountValue | string | sí | Identificador de la cuenta (IBAN) |
assignmentId | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |
Devuelve
{ result }
result = respuesta del API bancario tal cual.
Estado de la solicitud de estado de cuenta
Sólo lecturabaas_get_statement_status
Consulta el estado de una solicitud de estado de cuenta. Cuando está DONE incluye el enlace de descarga firmado y su vencimiento.
Operación del API: GET /api/public/v1/accounts/statements/{request_id} — ver la página de la operación
Parámetros
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
requestId | string | sí | request_id devuelto al solicitar el estado de cuenta |
assignmentId | string | — | Contexto (assignment) del API bancario; se envía sólo cuando hay varios |
Devuelve
{ result }
result = respuesta del API bancario tal cual.
Última verificación: 2026-09-03 · Responsable: equipo-integraciones