Catálogo de Herramientas del Asistente
El asistente de IA cuenta con 24 herramientas para operar Core360, organizadas por módulo. Cada una hace una sola cosa concreta: buscar algo, traer un reporte, o —en un grupo reducido y marcado abajo— crear información nueva.
Preste especial atención a las que ESCRIBEN
Las herramientas marcadas como Escritura crean o modifican información real de su empresa (una factura, un asiento contable, un cliente, una cotización o una compra). Todas requieren que el plan contratado tenga habilitadas las herramientas de escritura (ver Cómo Conectar el Asistente), y quedan registradas como cualquier otra operación de Core360.
Contabilidad
| Herramienta | Qué hace | Tipo |
|---|---|---|
contabilidad_plan_de_cuentas | Obtiene el plan de cuentas completo de la empresa: código, nombre, tipo, naturaleza y saldo actual de cada cuenta | Consulta |
contabilidad_balanza_de_comprobacion | Genera la balanza de comprobación (saldos deudores y acreedores) de un año y mes específicos | Consulta |
contabilidad_balance_general | Genera el balance general (activos, pasivos y patrimonio) de un año y mes específicos | Consulta |
contabilidad_estado_de_resultados | Genera el estado de resultados (ingresos, costos, gastos y utilidad neta) de un año y mes específicos | Consulta |
contabilidad_crear_asiento | Crea un asiento contable (partida de diario) con su descripción, fecha y el detalle de cuentas con débitos y créditos | Escritura |
Bancos
| Herramienta | Qué hace | Tipo |
|---|---|---|
bancos_cuentas_bancarias | Obtiene todas las cuentas bancarias de la empresa: banco, número, tipo, moneda y saldo actual | Consulta |
bancos_antiguedad_cuentas_por_cobrar | Genera el reporte de antigüedad de cuentas por cobrar, agrupado por períodos (corriente, 30, 60, 90+ días); puede filtrarse a un cliente específico | Consulta |
Clientes (CRM)
| Herramienta | Qué hace | Tipo |
|---|---|---|
clientes_buscar | Busca clientes por nombre, correo o teléfono; retorna contacto, saldo y estado | Consulta |
clientes_estado_de_cuenta | Obtiene el estado de cuenta de un cliente puntual: facturas, pagos y saldo pendiente | Consulta |
clientes_saldos_pendientes | Lista los clientes ordenados de mayor a menor saldo pendiente, útil para revisar morosidad | Consulta |
clientes_crear | Crea un cliente nuevo (o un prospecto) con sus datos fiscales, de contacto y la cuenta contable por cobrar | Escritura |
Inventario
| Herramienta | Qué hace | Tipo |
|---|---|---|
inventario_buscar_productos | Busca productos por nombre o código; retorna categoría, precio y existencia | Consulta |
inventario_existencia_producto | Obtiene los niveles de existencia de un producto específico en todos los almacenes | Consulta |
Facturación
| Herramienta | Qué hace | Tipo |
|---|---|---|
facturacion_buscar_facturas | Busca facturas de venta por número o cliente; retorna fecha, total y estado de pago | Consulta |
facturacion_crear_factura | Crea una factura de venta con cliente, fechas y el detalle de productos, cantidades y precios | Escritura |
Cotizaciones
| Herramienta | Qué hace | Tipo |
|---|---|---|
cotizaciones_buscar | Busca cotizaciones, opcionalmente filtradas por estado (borrador, enviada, aceptada, rechazada, vencida, convertida) | Consulta |
cotizaciones_detalle | Obtiene el detalle completo de una cotización: líneas, precios, cliente/prospecto e historial de estados | Consulta |
cotizaciones_crear | Crea una cotización nueva para un cliente o un prospecto, con su detalle de líneas | Escritura |
cotizaciones_convertir_a_factura | Convierte una cotización aceptada en factura (y, si es de un prospecto, puede crear el cliente automáticamente) | Escritura |
Compras
| Herramienta | Qué hace | Tipo |
|---|---|---|
compras_buscar_ordenes | Busca órdenes de compra de la empresa: proveedor, fecha, total y estado | Consulta |
compras_buscar_proveedores | Busca proveedores por nombre o código; retorna contacto y saldo | Consulta |
compras_registrar_factura | Registra una factura de compra de un proveedor a partir de datos extraídos de una foto o PDF; queda pendiente de aprobación (ver Registrar una Factura de Compra) | Escritura |
Acceso al API (avanzado)
| Herramienta | Qué hace | Tipo |
|---|---|---|
api_buscar_endpoints | Busca en el catálogo completo de endpoints del API de Core360 por lenguaje natural, módulo o método HTTP, y devuelve el identificador necesario para ejecutarlos | Consulta |
api_ejecutar_endpoint | Ejecuta, por su identificador, cualquier endpoint del API que aparezca en el catálogo — incluyendo los que crean, modifican o eliminan información | Escritura potencial (depende del endpoint que se elija) |
Sobre api_ejecutar_endpoint: una herramienta de alcance amplio
A diferencia de las demás, esta herramienta no está limitada a una acción concreta: puede invocar cualquier endpoint del API de Core360 que el catálogo conozca, con cualquier método (GET, POST, PUT, DELETE). Es, en esencia, una puerta trasera hacia el resto del ERP para cuando ninguna herramienta dedicada cubre lo que se necesita.
Lo que la limita:
- Requiere plan Enterprise específicamente. El chequeo de acceso para
api_ejecutar_endpointes independiente del de las demás herramientas de escritura: una empresa puede tener escritura habilitada (crear facturas, asientos, etc.) y aun así no tener acceso a este ejecutor genérico. - Sigue atada a la empresa de la conexión. El ejecutor reenvía las llamadas con el mismo token interno que usa cualquier otra herramienta del asistente, así que hereda el mismo aislamiento por empresa: no puede usarse para leer ni escribir datos de una empresa distinta a la conectada.
- Solo puede usar lo que el catálogo tiene cargado. El catálogo de endpoints se construye automáticamente a partir de la documentación técnica (Swagger/OpenAPI) que expone el API de Core360. En un entorno donde esa documentación técnica no está publicada, el catálogo queda vacío y estas dos herramientas responden que "el catálogo todavía se está cargando" — en la práctica, quedan inhabilitadas.
- No reproduce los roles del ERP. Igual que el resto de las herramientas del asistente, la autorización de cada endpoint depende de que el usuario esté autenticado y de la empresa del token — no de los roles y permisos particulares que ese usuario tendría dentro de las pantallas de Core360.
Úsela con criterio
Si su plan incluye esta herramienta, tenga presente que un endpoint de creación o eliminación ejecutado por acá tiene el mismo efecto que ejecutarlo desde cualquier otro lugar del sistema — no hay una confirmación adicional de Core360 más allá de la que el propio asistente le pida a usted antes de actuar.