AGENTS
AGENTS
118 herramientas propias que los agentes pueden invocar. JSON en /herramientas.json · ver Capacidades · probar el chat.
| bastanteo 8 | |
bastanteo_altas_atascadas | Altas KYC de Bastanteo que no avanzan: distribución por paso del onboarding, verificaciones pendientes (teléfono, identidad, contrato, wallet) y los casos más parados con sus días sin actividad. El ALCANCE lo decide tu rol: administrador → solo los usuarios de las empresas de tu cartera; super-administrador → distribución global de toda la plataforma. Solo consulta; no admite consultar a un usuario concreto. |
bastanteo_apoderados_titulares | Apoderados/administradores, titulares reales y documentación societaria en Bastanteo (KYC/AML). SUPER-ADMINISTRADOR: foto GLOBAL — nº de empresas, administradores por tipo, titulares reales (y los que ostentan control con participación directa ≥ 25 %) y documentación societaria pendiente (escritura de constitución, tarjeta CIF, impuesto de sociedades, modelo 036/037, poder de apoderamiento). ADMINISTRADOR: el mismo control acotado a las empresas de su cartera, con las que no tienen administrador o titular real declarado y la documentación que falta. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
bastanteo_fallos_verificacion | Fallos de verificación (teléfono, identidad, contrato, wallet, IBAN; y SMS/vídeo en persona física) en Bastanteo. SUPER-ADMINISTRADOR: foto GLOBAL — cuántos tienen cada verificación pendiente, por tipo de persona. ADMINISTRADOR: lo mismo acotado a los usuarios de su cartera, con quién tiene verificaciones pendientes y cuáles. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. Los flags son copia local y pueden ir desfasados respecto a Sefide. |
bastanteo_legal_entity_data | Devuelve los datos de PERSONA JURÍDICA del usuario autenticado en bastanteo: datos de la empresa (nombre, CIF, dirección, CNAE), administradores y titulares reales. Solo aplica si el usuario es persona jurídica (si no, devuelve found:false). No recibe email: el servidor resuelve al usuario autenticado. |
bastanteo_onboarding_distribution | Distribución GLOBAL del onboarding jurídico de Bastanteo: nº de entidades en cada paso (currentStep). Solo conteos agregados. Consulta GLOBAL; solo super-administradores. |
bastanteo_onboarding_status | Devuelve el ESTADO del onboarding/KYC del usuario autenticado en bastanteo: pasos completados, paso actual, y verificaciones (teléfono, identidad, contrato firmado, wallet creada). No recibe email: el servidor resuelve al usuario autenticado. |
bastanteo_user_profile | Devuelve el perfil del usuario autenticado en bastanteo (KYC/onboarding): si es persona física o jurídica y si completó el proceso de bastanteo. No recibe email: el servidor resuelve al usuario autenticado. |
bastanteo_users_stats | Estadísticas GLOBALES de usuarios de Bastanteo: total, desglose por tipo de persona (jurídica/física) y bastanteos finalizados vs. pendientes. Solo conteos. Consulta GLOBAL; solo super-administradores. |
| cache 1 | |
redis_get | Lee claves de un servidor Redis del cliente (solo lectura). Soporta las operaciones get, mget, keys, ttl, type, exists, hgetall, llen, scard y strlen. Rechaza cualquier operación de escritura o destructiva. Útil para inspeccionar el contenido de un Redis sin riesgo de modificarlo. |
| control 6 | |
activate_control_agent | Activa un "agente de control" (revisión automática periódica, solo lectura) identificado por su código (p.ej. "AG-006"). El control quedará programado y avisará por Telegram. Usa primero list_control_agents para conocer los códigos disponibles. Opcionalmente admite una cadencia cron personalizada; si se omite, se usa la recomendada del agente. |
control_findings_digest | Devuelve las incidencias ABIERTAS acumuladas por los agentes de control, agrupadas por severidad (P1/P2/P3), para elaborar un parte consolidado. El alcance lo decide el rol: un super-administrador ve el parte GLOBAL, un administrador el de TODA SU CARTERA, y un usuario normal solo el suyo. Solo lectura. |
deactivate_control_agent | Desactiva un "agente de control" que el usuario tenía activado, identificado por su código (p.ej. "AG-006"). Deja de ejecutarse y de enviar avisos. Usa list_control_agents para ver los activos. |
list_control_agents | Lista los "agentes de control" (revisiones automáticas por excepción, solo lectura) que el usuario puede activar, con su periodicidad, prioridad y si ya están activos. Úsala cuando el usuario pregunte qué controles/vigilancias automáticas tiene disponibles o activadas. |
mcp_health_check | Comprueba la salud de las APIs/MCP de datos del ecosistema (wallet, factoring, prontopago, cuadro de mandos, bastanteo y SSO): estado OK/DEGRADED/DOWN, latencia y código HTTP de cada una. Úsala para detectar servicios caídos o lentos que dejarían ciegos a los agentes. Solo super-administradores. |
report_control_findings | Registra las incidencias detectadas por un agente de control y devuelve cuáles hay que COMUNICAR (nuevas, cambiadas o con recordatorio a las 24 h) y cuántas se silencian por deduplicación. Cada incidencia: entity (entidad/NIF), identifier (id de operación/factura), type, severity (P1/P2/P3), summary, y opcionalmente amount, currency y source. Llama a esta tool con TODAS las incidencias detectadas y comunica al usuario solo las devueltas en "report". |
| crypto-utils 5 | |
base64_tool | Codifica un texto a base64 o decodifica una cadena base64 a texto plano. Útil cuando el usuario necesita convertir datos hacia/desde base64. |
hash_text | Calcula el hash de un texto con md5, sha1, sha256 o sha512 y lo devuelve en hexadecimal. Útil para verificar integridad o generar huellas de un texto. |
jwt_decode | Decodifica (SIN verificar la firma) el header y el payload de un JWT y muestra sus claims. ATENCIÓN: no valida la firma ni la caducidad, solo decodifica para inspección. Útil para depurar tokens, nunca para confiar en ellos. |
password_strength | Evalúa la fortaleza de una contraseña analizando su longitud, las clases de caracteres que usa, una estimación de entropía en bits y un veredicto. Útil para orientar al usuario sobre si una contraseña es débil o robusta. No almacena ni transmite la contraseña. |
uuid_generate | Genera identificadores UUID. Soporta v4 (aleatorio) y v7 (ordenable por tiempo). Útil cuando el usuario necesita uno o varios identificadores únicos. |
| cuadro 6 | |
dashboard_bank_summary | Devuelve el RESUMEN BANCARIO del cuadro de mandos del usuario autenticado: saldo agregado de sus cuentas y las 10 transacciones más recientes (de la agregación bancaria de WealthReader). No recibe email: el servidor resuelve al usuario. |
dashboard_documents_analysis | Devuelve el ESTADO del análisis de documentos fiscales/financieros del usuario autenticado en el cuadro de mandos: total, conteo por estado (pendiente/procesando/completado/fallido) y tipos de documento. No incluye el contenido extraído. No recibe email: el servidor resuelve al usuario. |
dashboard_documents_backlog | Backlog GLOBAL de análisis documental del Cuadro de Mandos: nº total de documentos pendientes o en proceso, con desglose por estado y por tipo de documento. Solo conteos agregados (sin contenido ni datos extraídos). Consulta GLOBAL; solo super-administradores. |
dashboard_erp_health | Salud GLOBAL de los conectores ERP del Cuadro de Mandos: snapshots por estado (con tiempos), nº de ERPs pendientes de refresco y nº de snapshots con error en el rango. Solo agregados (sin credenciales ni datos crudos). Consulta GLOBAL; solo super-administradores. |
dashboard_erp_summary | Devuelve los ERPs conectados del usuario autenticado en el cuadro de mandos y su estado de sincronización (tipo, nombre, empresa, activo, última actualización, errores y qué datos tiene). Nunca expone credenciales. No recibe email: el servidor resuelve al usuario. |
dashboard_kpi_snapshot | Devuelve un RESUMEN EJECUTIVO (KPIs) del cuadro de mandos del usuario autenticado: saldo bancario agregado, nº de cuentas, documentos analizados y % completado, ERPs activos e incidencias. No recibe email: el servidor resuelve al usuario. Úsala para una visión global rápida. |
| dashboard 9 | |
dashboard_borme_cambios | Cambios societarios publicados en el BORME (nombramientos/ceses de administradores, cambios de objeto/domicilio, disoluciones). SUPER-ADMINISTRADOR: actos recientes de toda la plataforma. ADMINISTRADOR: los de las empresas de su cartera (por razón social). Solo consulta; el alcance lo decide tu rol. |
dashboard_certificados_fiscales_adversos | Certificados de Hacienda (AEAT) y Seguridad Social ADVERSOS — con deuda pendiente — a partir de los documentos analizados. SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los usuarios de su cartera. Devuelve, por certificado, el veredicto (con deuda / al corriente / indeterminado) y la lista de los adversos con su importe. Solo consulta; el alcance lo decide tu rol. Los certificados "indeterminados" no se pudieron clasificar y conviene revisarlos a mano. |
dashboard_concursal_boe | Publicidad CONCURSAL (Registro Público Concursal) y publicaciones críticas del BOE. SUPER-ADMINISTRADOR: publicaciones recientes de toda la plataforma. ADMINISTRADOR: las de las empresas de su cartera (por NIF). Señala concursos, insolvencias y publicaciones adversas. Solo consulta; el alcance lo decide tu rol. |
dashboard_conexiones_bancarias | Conexiones bancarias agregadas caducadas o desactualizadas en el Cuadro de Mandos. SUPER-ADMINISTRADOR: foto GLOBAL — cuántas conexiones están caducadas (último refresco anterior a 48 h), frescas o sin refrescar nunca. ADMINISTRADOR: lo mismo acotado a los usuarios de sus empresas asignadas (su cartera), con quién tiene la conexión caducada y desde cuándo. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
dashboard_deterioro_financiero | Deterioro financiero integral y cambio de scoring: índice 0-100 por cliente a partir de señales fiables (certificados fiscales con deuda + saldo bancario). SUPER-ADMINISTRADOR: ranking global de los clientes con más deterioro. ADMINISTRADOR: los usuarios de su cartera. Solo consulta; el alcance lo decide tu rol. (El componente ERP se marca no disponible por falta de histórico suficiente.) |
dashboard_documentacion_pendiente | Documentación financiera pendiente, en proceso o sin analizar en el Cuadro de Mandos. El alcance lo decide el ROL: un SUPER-ADMINISTRADOR obtiene el backlog GLOBAL de la plataforma (total y desglose por estado y por tipo de documento); un ADMINISTRADOR obtiene solo los usuarios de su cartera de empresas, con el backlog consolidado, el desglose por estado y los miembros con más acumulación. Devuelve solo conteos: nunca el contenido del documento ni los datos extraídos. El origen no expone fechas de caducidad ni antigüedad, así que «sin analizar» se cubre con los estados pendiente / en proceso / fallido. No recibe email: el ámbito se resuelve en el servidor. |
dashboard_erp_sincronizacion | Estado de sincronización de los conectores ERP/SII/EDI del Cuadro de Mandos. El alcance lo decide tu rol: SUPERADMIN ve la salud GLOBAL (snapshots por estado, ERPs pendientes de refresco y snapshots con error en el rango); ADMIN ve solo los conectores de los usuarios de su cartera, con el estado de cada uno, las HORAS transcurridas desde su último refresco y cuáles están en error o nunca se han refrescado. Devuelve las horas en crudo: el umbral de "desactualizado" lo aplica el agente. Solo consulta; nunca expone credenciales. Requiere rol de administrador. |
dashboard_seguro_credito_adverso | Avisos de SEGURO DE CRÉDITO (Crédito y Caución) — cambios adversos (impagos, siniestros, rebajas de cobertura). SUPER-ADMINISTRADOR: avisos recientes de toda la plataforma. ADMINISTRADOR: los de las empresas de su cartera (por su NIF/razón social). Solo consulta; el alcance lo decide tu rol. |
dashboard_tension_caja | Posición de caja y tensión financiera en el Cuadro de Mandos. SUPER-ADMINISTRADOR: saldo bancario agregado global y cuántos usuarios están en tensión (saldo por debajo del umbral, negativo incluido). ADMINISTRADOR: lo mismo acotado a los usuarios de sus empresas asignadas (su cartera), con quién tiene saldo negativo. Es una foto de posición, no una serie temporal. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
| data 3 | |
csv_to_json | Convierte texto CSV en JSON (array de objetos), usando la primera fila como cabecera de campos. Útil cuando el usuario quiere transformar datos tabulares CSV en estructuras JSON. |
json_tool | Valida y formatea texto JSON. Operaciones: "validate" (comprueba si es JSON válido), "pretty" (lo indenta de forma legible) y "minify" (lo compacta sin espacios). Útil cuando el usuario quiere comprobar, embellecer o compactar un JSON. |
regex_test | Prueba un patrón de expresión regular (PCRE) contra un texto y devuelve si hay coincidencia y los grupos capturados. Útil cuando el usuario quiere validar o depurar una regex. |
| database 4 | |
db_tables | Introspecciona el esquema de una base de datos (MySQL/MariaDB o PostgreSQL). Sin "table" devuelve la lista de tablas base; con "table" devuelve sus columnas (nombre, tipo, si admite NULL y valor por defecto). Útil para que el agente sepa qué tablas y columnas existen antes de consultar. |
mysql_query | Ejecuta una consulta de SOLO LECTURA (SELECT/SHOW/EXPLAIN/DESCRIBE/WITH) contra una base de datos MySQL o MariaDB de un cliente y devuelve las filas resultantes. Rechaza cualquier sentencia que modifique datos. Aplica un LIMIT defensivo si la consulta no lo incluye. |
postgres_query | Ejecuta UNA consulta de solo lectura (SELECT, SHOW, EXPLAIN, DESCRIBE o WITH) contra una base de datos PostgreSQL y devuelve las filas. Las consultas que modifican datos están bloqueadas. Se aplica un LIMIT por defecto para no traer demasiadas filas. Útil para inspeccionar datos de una BD Postgres del cliente. |
project_query | Ejecuta una consulta de SOLO LECTURA (SELECT/WITH) contra la base de datos de un PROYECTO del cliente identificado por nombre (p. ej. "wallet" o "factoring"). Las credenciales NO se exponen: se resuelven en el servidor por el nombre del proyecto. Los resultados se acotan SIEMPRE, en el servidor, al email del usuario autenticado: el backend fuerza el filtro por usuario, así que NO es posible leer datos de terceros y NO debes incluir ningún email/usuario en la consulta (se ignora). Usa el campo "project" con uno de los proyectos disponibles y una consulta SELECT sobre las tablas del proyecto. |
| datetime 3 | |
current_datetime | Devuelve la fecha y hora actuales en una zona horaria concreta (por defecto "Europe/Madrid"): ISO 8601, timestamp Unix, fecha y hora legibles y día de la semana. Útil cuando el usuario pregunta "qué hora es" o necesita la fecha de hoy. |
date_diff | Calcula la diferencia entre dos fechas/horas y la devuelve humanizada (años, meses, días, horas, minutos, segundos) y en totales. Útil cuando el usuario pregunta cuánto tiempo hay entre dos fechas o cuántos días faltan para algo. |
timezone_convert | Convierte una fecha/hora de una zona horaria a otra. Útil cuando el usuario quiere saber qué hora será en otra ciudad o región para un instante concreto. |
| domain-health 1 | |
check_domain_health | Comprueba la salud de correo de un dominio: registros MX, SPF, DKIM y DMARC. Útil cuando el usuario pregunta si un dominio está bien configurado para enviar correo. |
| ecosistema 1 | |
master_data_duplicates | Consistencia de maestros y DUPLICADOS de clientes en el ecosistema: cruza los censos de identidad (email, NIF, nombre) de factoring, ProntoPago y wallet, y detecta el mismo NIF con varios emails distintos (posibles maestros duplicados) o con nombres incoherentes entre plataformas. Consulta GLOBAL del ecosistema; solo super-administradores. |
| factoring 18 | |
factoring_cobros_pendientes_conciliacion | Cobros de deudores PENDIENTES DE CONCILIACIÓN en Factoring: operaciones ya vencidas cuyo cobro del deudor (devolución de la financiación) no está confirmado ni conciliado. SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera. Devuelve el nº pendiente, el importe, cuántos llevan más de 90 días y las más antiguas. Solo consulta; el alcance lo decide tu rol. |
factoring_concentracion_riesgo | Concentración de riesgo y financiación por DEUDOR (la empresa cliente de las facturas). SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera (fusionando deudores comunes). Devuelve la exposición viva total, el nº de deudores, los mayores por exposición y el % que concentra el mayor deudor y el top-5. Solo consulta; el alcance lo decide tu rol. |
factoring_desviacion_margen | Desviación de MARGEN y RENTABILIDAD en Factoring: compara el beneficio del inversor REAL pagado con el ESPERADO según el anuncio. SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera. Devuelve total esperado/real, la desviación absoluta y en %, y las operaciones con mayor desviación. Solo consulta; el alcance lo decide tu rol. |
factoring_financiaciones_pendientes_desembolso | Financiaciones APROBADAS pero PENDIENTES DE DESEMBOLSO en Factoring (sin fecha o sin importe de recepción del dinero). SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera. Devuelve el nº pendiente, el importe aprobado pendiente, el desglose por motivo y ejemplos. Solo consulta; el alcance lo decide tu rol. |
factoring_fondeo_excepciones | Excepciones de fondeo y asignación de inversores en Factoring: acción de fondear SIN inversor asignado, importe fondeado FUERA del rango [mín,máx] del anuncio, y operaciones ANUNCIADAS pero sin fondear. SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera. Devuelve el nº de operaciones afectadas por tipo, el total y ejemplos. Solo consulta. |
factoring_impagos | Impagos, recuperaciones y pérdida esperada de Factoring. SUPER-ADMINISTRADOR: foto GLOBAL de las operaciones de un rango de fechas, con el importe en problemas (mora, ejecución de garantía, impago) y el de las finalizadas impagadas o cobradas por el seguro de crédito, su peso sobre el importe total del periodo y la pérdida esperada estimada. ADMINISTRADOR: el mismo control acotado a los usuarios de sus empresas asignadas (su cartera), con el importe impagado agregado, su peso y los peores casos. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
factoring_investment_detail | Devuelve el DETALLE de una inversión concreta del usuario autenticado en factoring (importes, beneficio, fechas, tipo, garantías, porcentajes). Requiere el id de la inversión. El servidor la acota al usuario; el equipo de SmartEscrow (staff) puede indicar otro usuario en "usuario". |
factoring_investments | Devuelve el listado paginado de inversiones/operaciones del usuario autenticado en factoring (importe, retorno, beneficio, fechas, estado de pago). No recibe email: el servidor resuelve al usuario. Acepta paginación opcional (page, limit). |
factoring_operaciones_por_liquidar | Operaciones de Factoring ya VENCIDAS que siguen ABIERTAS (sin liquidar). SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera. Devuelve el nº de operaciones, los importes (invertido y a devolver), el desglose por antigüedad del vencimiento (hasta 30 / 31-90 / más de 90 días) y las más antiguas con sus días de retraso. Solo consulta; el alcance lo decide tu rol. |
factoring_operaciones_por_vencer | Operaciones de Factoring que VENCEN en los próximos días (aún abiertas, sin liquidar). SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los financiados de su cartera. Devuelve el nº de operaciones, los importes (invertido y a devolver) y las más próximas (operación, fecha de vencimiento, importe). Argumento opcional dias (por defecto 7). Solo consulta; el alcance lo decide tu rol. |
factoring_operaciones_rotas | Operaciones de Factoring ROTAS o con datos incoherentes (integridad de datos). Detecta: acción de fondear o de pago a inversores SIN inversor asignado, fecha de fondeo POSTERIOR al pago (TIR irracional) y operaciones SIN factura asociada. Devuelve el nº de operaciones afectadas por cada problema, el total de operaciones rotas y unos IDs de ejemplo por tipo. Consulta GLOBAL; solo super-administradores. |
factoring_operaciones_vencidas | Operaciones de Factoring VENCIDAS que siguen con saldo pendiente (mora, ejecución de garantía, impago). El alcance lo decide el ROL, no un argumento: un SUPER-ADMINISTRADOR obtiene la foto GLOBAL de la plataforma en el rango de fechas (nº de operaciones e importe vivo por grupo de estado); un ADMINISTRADOR obtiene solo la de los usuarios de las empresas de su cartera (importe vivo agregado, reparto por tipo de usuario y los miembros con más saldo pendiente). No acepta email: el servidor resuelve el ámbito. Solo consulta; requiere rol de administrador. |
factoring_operations_summary | Resumen GLOBAL de operaciones de Factoring en un rango de fechas, agrupadas por estado (finalizadas, en vuelo, con problemas, finalizadas con impago) con nº de operaciones e importes agregados (dinero invertido, beneficio del inversor y de la plataforma). Consulta GLOBAL; solo super-administradores. |
factoring_pagos_inversores_pendientes | Pagos a inversores PENDIENTES o incompletos en Factoring: no devueltos, incompletos, con retención o sin inversor asignado. SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los inversores de su cartera. Devuelve nº de pagos pendientes, desglose por motivo e importes (invertido pendiente, intereses, retenido). Solo consulta; el alcance lo decide tu rol. |
factoring_portfolio_stats | Devuelve KPIs GLOBALES de la cartera de Factoring: beneficio neto de plataforma (pagos, cobros y beneficio) y conteos globales (nº de inversores, financiados y operaciones). Consulta GLOBAL; solo super-administradores. |
factoring_user_profile | Devuelve el PERFIL del usuario autenticado en factoring: si es inversor o financiado, razón social, NIF/CIF, nombre de empresa y nacionalidad. No recibe email/identificador: el servidor resuelve al usuario autenticado. Úsala cuando pregunte por su perfil de factoring. |
factoring_user_statistics | Devuelve las ESTADÍSTICAS agregadas del usuario autenticado en factoring: número de inversiones/operaciones, total invertido o recibido, total pagado y beneficio. No recibe email: el servidor resuelve al usuario. Úsala para un resumen de su actividad de factoring. |
factoring_users_count | Devuelve el conteo GLOBAL de usuarios de Factoring: nº de inversores, nº de financiados y nº total de operaciones. Consulta GLOBAL; solo super-administradores. |
| firmadoc 3 | |
firmadoc_calidad_plantillas | Calidad de las plantillas de FirmaDoc y de los envíos que acaban mal: plantillas sin uso, envíos cancelados y expirados, y las plantillas con mayor tasa de fallo (proporción de sus envíos que terminan cancelados o expirados). Consulta GLOBAL; solo super-administradores. |
firmadoc_contratos_pendientes | Contratos de FirmaDoc pendientes de firma o próximos a expirar, con su estado, cuántos firmantes faltan y los días que quedan hasta la expiración (negativo si ya venció). El alcance lo decide tu ROL: un administrador ve los contratos de su cartera y un super-administrador los de toda la plataforma. Solo lectura. |
firmadoc_trazabilidad_firmas | Revisa la integridad y la trazabilidad de las firmas en FirmaDoc: contratos marcados como firmados a los que les faltan firmas en la auditoría, firmas de direcciones que no eran receptores del acuerdo, y acuerdos sin traza de actividad. El alcance lo decide tu ROL (administrador → su cartera; super-administrador → toda la plataforma). Solo lectura. |
| net 2 | |
dns_lookup | Resuelve registros DNS de un host para un tipo concreto (A, AAAA, MX, TXT, NS o CNAME). Útil cuando el usuario quiere consultar la configuración DNS de un dominio o host. |
ip_info | Resuelve un hostname a sus direcciones IP (v4 y v6) y, si se le pasa una IP, intenta el reverse DNS (PTR). Útil para saber a qué IPs apunta un host. |
| prontopago 14 | |
prontopago_active_rules | Devuelve las REGLAS configuradas para el usuario autenticado en prontopago: elegibilidad, fechas de vencimiento, límites, métodos de pago y grupos de descuento. No recibe email: el servidor resuelve al usuario. Úsala cuando pregunte por sus reglas/condiciones. |
prontopago_adelantadas_sin_pago | Facturas ya ADELANTADAS cuyo pago al proveedor todavía está pendiente. SUPER-ADMINISTRADOR: total global (nº de facturas, importe y desglose por estado). ADMINISTRADOR: lo mismo acotado a los usuarios de sus empresas asignadas (su cartera). Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
prontopago_calidad_transiciones | Calidad de las transiciones de estado de las facturas de pronto pago. Detecta señales de proceso deficiente: cambios sin efecto (noop), retrocesos de estado, salidas indebidas de un estado ya pagado, alto ratio de cambios manuales y facturas con demasiados reprocesos. SUPER-ADMINISTRADOR: toda la plataforma. ADMINISTRADOR: los usuarios de su cartera. Argumento opcional days (ventana, por defecto 30). Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
prontopago_cobros_proximos | Cobros de clientes próximos a vencimiento en ProntoPago: facturas cuyo vencimiento cae en los próximos días y siguen en un estado cobrable. SUPER-ADMINISTRADOR: total global (nº de facturas, importe y desglose por estado). ADMINISTRADOR: lo mismo acotado a los usuarios de sus empresas asignadas (su cartera). Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
prontopago_cobros_vencidos | Facturas VENCIDAS y cobros no recibidos en ProntoPago: nº de facturas, importe total, desglose por estado y los clientes con más importe vencido (los más graves primero). El alcance lo decide tu ROL: SUPER-ADMIN obtiene el agregado GLOBAL de la plataforma; ADMIN solo los usuarios de las empresas de su cartera. No acepta email: el servidor resuelve el ámbito. Solo consulta; requiere rol de administrador. |
prontopago_elegibles_sin_adelanto | Facturas ELEGIBLES para pronto pago cuyo cliente aún NO ha solicitado el adelanto — oportunidad comercial. SUPER-ADMINISTRADOR: total global de facturas elegibles sin adelantar, su importe y el desglose por estado. ADMINISTRADOR: lo mismo acotado a los usuarios de sus empresas asignadas (su cartera). Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
prontopago_expired_invoices | Resumen GLOBAL de facturas VENCIDAS en ProntoPago: nº total, importe total y desglose por estado. Solo agregados (sin lista de facturas ni datos de clientes). Consulta GLOBAL; solo super-administradores. |
prontopago_facturas_sin_validar | Facturas de ProntoPago pendientes de validación, con su desglose por estado e importe. El alcance lo decide tu ROL: un administrador ve las facturas de las empresas de su cartera y un super-administrador las de toda la plataforma. No expone la lista de facturas ni datos personales, solo agregados y los clientes con más pendiente. Solo lectura. |
prontopago_invoices_summary | Devuelve un RESUMEN de las facturas del usuario autenticado en prontopago: número total, pendientes de pago, conteo por estado e importe total. No recibe email: el servidor resuelve al usuario. Úsala para una visión rápida de la facturación del usuario. |
prontopago_no_elegibles | Facturas NO ELEGIBLES para pronto pago — las que las reglas de elegibilidad bloquean (causas de no elegibilidad). SUPER-ADMINISTRADOR: total global (nº de facturas, importe y desglose por estado). ADMINISTRADOR: lo mismo acotado a los usuarios de sus empresas asignadas (su cartera). Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
prontopago_pending_summary | Resumen GLOBAL de facturas PENDIENTES de procesar en ProntoPago (clientes activos): nº total, importe total y desglose por estado. Solo agregados (sin lista de facturas ni datos de clientes). Consulta GLOBAL; solo super-administradores. |
prontopago_rule_engine_anomalies | Ejecuciones ANÓMALAS del motor de reglas de ProntoPago (cron): fallos de ejecución (con su mensaje de error) y frescura del cron (horas desde la última ejecución; avisa si el motor lleva demasiado sin correr = posible caída). Argumento opcional horas (ventana, por defecto 72). Consulta GLOBAL; solo super-administradores. |
prontopago_unpaid_invoices | Devuelve la lista de FACTURAS PENDIENTES de pago del usuario autenticado en prontopago (número, importe, estado, fecha de vencimiento, si está vencida), ordenadas por vencimiento. No recibe email: el servidor resuelve al usuario. Acepta limit opcional. |
prontopago_user_profile | Devuelve el PERFIL del usuario autenticado en prontopago: razón social, NIF de empresa, roles (proveedor/cliente), IBAN de proveedor y estado. No recibe email: el servidor resuelve al usuario autenticado. Úsala cuando pregunte por su perfil en prontopago. |
| schedule 3 | |
cancel_scheduled_task | Cancela (elimina), pausa o reactiva una tarea programada del usuario, identificada por su task_id (usa antes list_scheduled_tasks para obtenerlo). action puede ser "cancel" (eliminar), "pause" (desactivar temporalmente) o "resume" (reactivar). No recibe identidad: el servidor sabe quién eres y solo permite operar sobre tus propias tareas. |
list_scheduled_tasks | Lista las tareas programadas (recurrentes) del usuario: su nombre, cadencia, próxima ejecución y estado. Úsala cuando el usuario pregunte qué tareas tiene activas o quiera revisarlas antes de cancelar/pausar alguna. No recibe identidad: el servidor sabe quién eres. |
schedule_task | Programa una tarea recurrente que se ejecutará automáticamente en segundo plano y cuyo resultado se entregará al usuario por Telegram sin que tenga que volver a preguntar. Úsala cuando el usuario pida algo periódico ("cada lunes", "cada mañana", "todos los días a las 9"). La cadencia se expresa en formato CRON estándar de 5 campos (minuto hora día-mes mes día-semana); p.ej. "0 9 * * 1" = lunes a las 9:00. "instruction" es lo que el agente debe hacer en cada ejecución (p.ej. "consulta mi saldo de wallet y dímelo"). Si el usuario quiere ser avisado solo cuando se cumpla una condición numérica, usa alert_mode="threshold" con alert_condition. No incluyas datos de identidad: el servidor sabe quién eres. |
| sso 6 | |
sso_authorized_projects | Devuelve la lista de PROYECTOS/servicios de SmartEscrow a los que el usuario autenticado tiene acceso autorizado (p. ej. wallet, factoring, prontopago, cuadro, bastanteo). No recibe argumentos: el servidor resuelve al usuario autenticado. Útil para saber qué datos puedes consultarle. |
sso_roles_audit | Audita los roles del SSO: detecta administradores SIN cartera de empresas asignada (no verían datos) y lista los super-administradores. Consulta GLOBAL de seguridad funcional; solo super-administradores. |
sso_search_users | Busca usuarios en el SSO de SmartEscrow por término parcial (email, nombre, apellidos, NIF/CIF o empresa) y devuelve email + nombre + NIF + empresa + roles + estado. Úsala para LOCALIZAR a un cliente (y su email) antes de consultarlo en wallet/factoring/etc. Consulta GLOBAL de la base de usuarios; solo super-administradores. |
sso_user_profile | Devuelve el PERFIL del usuario autenticado en el SSO de SmartEscrow: nombre, email, roles, tipo de persona, NIF/empresa, estado de la cuenta y los proyectos a los que tiene acceso. No recibe ni necesita ningún email/identificador: el servidor resuelve al usuario autenticado. Úsala cuando el usuario pregunte por sus datos de cuenta, su perfil o quién es. |
sso_users_by_role | Lista los usuarios del SSO que tienen un rol concreto (p. ej. ROLE_ADMIN, ROLE_INVERSOR, ROLE_FINANCIADO, ROLE_PROVEEDOR, ROLE_CLIENTE, ROLE_SUPER_ADMIN) con email, nombre, NIF, empresa y estado. Consulta GLOBAL; solo super-administradores. |
sso_users_stats | Devuelve estadísticas agregadas de la base de usuarios del SSO: total, activos y conteo por rol (super-admin, admin, inversor, financiado, proveedor, cliente). Consulta GLOBAL; solo super-administradores. |
| text 4 | |
case_convert | Convierte un texto entre mayúsculas, minúsculas, Título, snake_case, camelCase y kebab-case. Útil cuando el usuario quiere normalizar el estilo de un texto o identificador. |
lorem_ipsum | Genera texto de relleno (lorem ipsum) con el número de párrafos y de palabras por párrafo indicados. Útil cuando el usuario necesita contenido de prueba para maquetar. |
slugify | Convierte un texto en un slug apto para URLs (minúsculas, sin acentos, palabras unidas por un separador). Útil cuando el usuario necesita un identificador legible para una URL. |
text_stats | Cuenta palabras, caracteres (con y sin espacios), líneas y frases de un texto, y estima el tiempo de lectura. Útil cuando el usuario quiere medir la longitud de un texto. |
| wallet 18 | |
wallet_account_details | Devuelve el ESTADO DE CUENTA EN VIVO de la wallet del usuario autenticado, consultado a Sefide: IBAN, saldo disponible, divisa, estado operativo de la cuenta y bloqueos (normativo/operativo). No recibe ni necesita ningún email/identificador: el servidor resuelve al usuario autenticado y consulta SOLO su cuenta. Úsala cuando el usuario pregunte por su IBAN, el estado de su cuenta o los detalles de su wallet (más allá del saldo). |
wallet_balance | Devuelve el SALDO REAL y EN VIVO de la wallet del usuario autenticado, consultado a Sefide (la fuente de verdad), no a la base de datos (que está desincronizada). No recibe ni necesita ningún email/identificador: el servidor resuelve al usuario autenticado y consulta SOLO su wallet. Devuelve el saldo disponible, la divisa y el estado operativo de la cuenta. Úsala SIEMPRE que el usuario pregunte por su saldo, dinero disponible o estado de su wallet. |
wallet_clients_by_status | Lista los clientes de wallet cuyo estado de operación coincide con el indicado (p.ej. "En Mora", "Con Incidencia", "Financiada"). Consulta GLOBAL; solo super-administradores. Requiere el parámetro "status". |
wallet_direct_debits | Devuelve las DOMICILIACIONES/adeudos directos recibidos (recibos) EN VIVO de la wallet del usuario autenticado, consultados a Sefide. No recibe email/identificador: el servidor resuelve al usuario autenticado. Acepta filtros opcionales por fechas (fecha_inicio, fecha_fin en formato YYYY-MM-DD) y limit. Úsala cuando el usuario pregunte por sus recibos o quién le domicilia pagos. |
wallet_domiciliaciones_cartera | Resumen GLOBAL de domiciliaciones (adeudos SEPA) de TODOS los usuarios de las empresas asignadas al administrador (su "cartera"): total de recibos, cancelados, cancelables y sus importes agregados, más los miembros con más incidencias. Solo consulta; acotado a tu cartera. Requiere rol de administrador. |
wallet_domiciliaciones_control | Domiciliaciones (adeudos SEPA) recibidas y sus devoluciones/anulaciones. SUPER-ADMINISTRADOR: resumen de toda la plataforma (todos los clientes). ADMINISTRADOR: los usuarios de su cartera. Devuelve recibos, anulaciones, recibos cancelados/cancelables e importes, y el ranking de quién acumula más incidencias. Admite fechaInicio/fechaFin (YYYY-MM-DD). Solo consulta, nunca cancela; el alcance lo decide tu rol, nunca los argumentos. Dato vivo de Sefide. |
wallet_domiciliaciones | Consulta DOMICILIACIONES RECIBIDAS (adeudos directos/recibos SEPA) EN VIVO de la wallet, con su estado de cancelación (cancelable dentro de 56 días naturales, ya cancelada, o no cancelable) y conteos/importes. SOLO consulta, nunca cancela. Responde: cuántas domiciliaciones hay, cuántas están canceladas o son cancelables, el detalle de una por su referencia, o si hay nuevas desde una fecha. La identidad la resuelve el SERVIDOR (no necesitas ni debes pedir el email al usuario): un cliente ve automáticamente las SUYAS. Si quien pregunta es del equipo de SmartEscrow (acceso a todos los clientes), indica en "usuario" a qué cliente: vale el email, pero también un término PARCIAL (parte del email, nombre, apellidos o id de cliente Sefide), p.ej. "biotech3d"; si hay varias coincidencias te las listaré para que elijas. Si no sabes de qué cliente se trata, pregúntaselo. |
wallet_error_operations | Lista las operaciones de wallet con error o notificaciones recientes, para monitorización operativa. Consulta GLOBAL; solo super-administradores. |
wallet_incidencias_report | Lista los clientes de wallet que tienen incidencias (hard/soft) con su ficha básica (email, nombre, empresa, estado, KYC). Radar de riesgo GLOBAL; solo super-administradores. |
wallet_ingresos_sin_identificar | Ingresos entrantes SIN IDENTIFICAR o sin asignar: aquellos cuya contraparte no coincide con ningún cliente conocido. SUPER-ADMINISTRADOR: la cuenta maestra SmartEscrow (conciliación de entradas de tesorería). ADMINISTRADOR: los usuarios de su cartera. Distingue «contraparte desconocida» (posible ingreso a investigar) de «sin contraparte registrada» (suele ser movimiento interno). Argumento opcional days (ventana, por defecto 30). Solo consulta; el alcance lo decide tu rol. Dato vivo de Sefide. |
wallet_movements | Devuelve los MOVIMIENTOS/transacciones EN VIVO de la wallet del usuario autenticado (ingresos, cargos, transferencias), consultados a Sefide. No recibe email/identificador: el servidor resuelve al usuario autenticado y consulta SOLO sus movimientos. Acepta paginación opcional (limit, offset). Úsala cuando el usuario pregunte por sus últimos movimientos, su historial o sus transacciones. |
wallet_movimientos_inusuales | Movimientos INUSUALES o con posible indicio de FRAUDE operativo en los wallets. Marca por cliente: importes altos, importes atípicos (estadísticamente fuera de su patrón), ráfagas de muchos movimientos el mismo día y posibles round-trips (mismo importe entrando y saliendo a la misma contraparte). Argumentos opcionales: days (ventana, def 30), minAmount (umbral importe alto, def 3000), k (sensibilidad del atípico, def 4), burst (movimientos/día para ráfaga, def 6). Consulta GLOBAL; solo super-administradores. Dato vivo de Sefide. |
wallet_pagos_recibidos | Pagos/ingresos recibidos en el wallet en los últimos días. SUPER-ADMINISTRADOR: ingresos de la cuenta maestra SmartEscrow (tesorería de plataforma). ADMINISTRADOR: los ingresos de los usuarios de su cartera. Devuelve nº de ingresos, importe total y el detalle (fecha, importe, concepto, referencia). Solo consulta; el alcance lo decide tu rol, nunca los argumentos. Dato vivo de Sefide. |
wallet_portfolio_kpis | Devuelve los KPIs GLOBALES de la cartera de wallet (total solicitado, a devolver a Hacienda, operaciones financiadas/devueltas, importe devuelto, pendiente, beneficio bruto y tiempo medio de devolución). Consulta agregada de TODA la plataforma; solo super-administradores. |
wallet_saldos_liquidez | Saldo en vivo del wallet y riesgo de falta de liquidez. SUPER-ADMINISTRADOR: las cuentas maestras SmartEscrow (tesorería de plataforma). ADMINISTRADOR: los saldos de los usuarios de su cartera. Con el argumento saldo_minimo (opcional) señala qué cuentas/usuarios están por debajo del umbral y el saldo mínimo observado. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. Dato vivo de Sefide. |
wallet_top_ingresos | Los ingresos de mayor importe del último mes en el wallet. SUPER-ADMINISTRADOR: sobre la cuenta maestra SmartEscrow (tesorería de plataforma). ADMINISTRADOR: sobre los usuarios de su cartera. Devuelve los 3 mayores ingresos (fecha, importe, concepto, referencia) y el total del periodo. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. Dato vivo de Sefide. |
wallet_transfer_details | Devuelve el DETALLE EN VIVO de una transferencia concreta de la wallet del usuario autenticado (IBAN ordenante/beneficiario, importe, concepto, estado, fechas), consultado a Sefide. Requiere el id de operación de la transferencia. El servidor acota la consulta a la cuenta del usuario; el equipo de SmartEscrow (staff) puede indicar otro usuario en "usuario". |
wallet_transferencias_atascadas | Transferencias salientes ATASCADAS del wallet — pendientes, esperando SCA, rechazadas o con error técnico — creadas hace más de 24 h (para que un pago aprobado no quede bloqueado o se duplique). SUPER-ADMINISTRADOR: foto GLOBAL con el desglose por estado, importe total y las operaciones. ADMINISTRADOR: lo mismo acotado a los usuarios de su cartera. Solo consulta; el alcance lo decide tu rol, nunca los argumentos. |
| web 3 | |
http_api_request | Llama a una API REST (interna de SmartEscrow o del cliente) con el método, cabeceras, query string y cuerpo (JSON o texto) indicados, y devuelve la respuesta: estado HTTP, content-type, un subconjunto seguro de cabeceras, el cuerpo (truncado a 20000 caracteres) y, si la respuesta es JSON, el cuerpo decodificado. AVISO DE SEGURIDAD: es un fetch ejecutado en el servidor y puede apuntar a URLs arbitrarias (riesgo de SSRF); úsalo solo con APIs internas o del cliente, nunca con URLs no confiables. |
http_status | Hace una petición GET a una URL y devuelve el código de estado HTTP, el content-type, el tamaño en bytes del cuerpo y el tiempo total en milisegundos. Útil para comprobar si una URL está disponible y cómo responde. |
url_metadata | Descarga una URL HTML y extrae sus metadatos básicos: el <title>, la meta description y el og:title de Open Graph. Útil para obtener una vista previa de una página web. |