# Qué puede hacer el asistente

El asistente IA de Frihet está impulsado por **Google Gemini** y cuenta con **50+ herramientas** para acelerar tus tareas cotidianas. Desde crear documentos hasta calcular impuestos trimestrales, el asistente opera con contexto real de tu negocio. Descubre todas las [capacidades de IA de Frihet](https://www.frihet.io/es/features).

## Capacidades por categoría

### Crear documentos por lenguaje natural

Escribe de forma natural y el asistente crea facturas, gastos y presupuestos automáticamente:

- **Facturas**: "Crea factura para Juan Garcia por 500 euros de diseño web"
- **Gastos**: "Registra gasto de 45 euros en Material de oficina"
- **Presupuestos**: "Presupuesto a Cliente SL: 3 horas de consultoría a 100 euros"
- **Facturas recurrentes**: "Crea factura recurrente mensual a Acme Corp por 500 euros de hosting"
- **Gestión de recurrentes**: "Lista mis facturas recurrentes activas"
- **Cancelar recurrentes**: "Cancela la recurrente de mantenimiento para ClienteX"

El asistente extrae clientes, conceptos, cantidades e importes. Siempre revisas antes de confirmar.

### Búsqueda de datos y análisis

Consulta tus datos con preguntas naturales:

- "¿Cuánto he facturado este trimestre?"
- "¿Quién es mi mejor cliente?"
- "¿Cuántas facturas vencidas tengo?"
- "Resumen de gastos por categoría"
- "¿Cuál es la rentabilidad de mi cliente Acme Corp?"
- "Registra un pago parcial de 500 euros en la factura F-2026-050"

El asistente devuelve **KPI cards**, **gráficos inline** o respuestas en texto con el contexto que necesitas.

### Exportar datos

Exporta tus datos directamente desde el chat, sin navegar a ninguna pantalla:

| Herramienta   | Qué hace                                                           | Ejemplo                                       |
| ------------- | ------------------------------------------------------------------ | --------------------------------------------- |
| `exportToCSV` | Exporta facturas, gastos, presupuestos, clientes o productos a CSV | "Exporta mis facturas de Q1 a CSV"            |
| `exportToPDF` | Genera un PDF con tus datos                                        | "Exporta el resumen de gastos de marzo a PDF" |

Más detalle en [Exportar datos desde el chat](./exportar-datos).

### Impuestos y cumplimiento fiscal

El asistente conoce el sistema fiscal español (IVA, IGIC, IRPF) y puede calcular tus obligaciones trimestrales:

| Herramienta          | Qué hace                                | Ejemplo                                  |
| -------------------- | --------------------------------------- | ---------------------------------------- |
| `calculateModelo303` | Calcula el IVA trimestral (Modelo 303)  | "Calcula mi Modelo 303 del Q1"           |
| `calculateModelo130` | Calcula el IRPF trimestral (Modelo 130) | "¿Cuánto debo de IRPF este trimestre?"   |
| `getTaxCalendar`     | Muestra plazos fiscales próximos        | "¿Cuándo tengo que presentar impuestos?" |

El asistente aplica automáticamente los tipos correctos según tu zona fiscal (Península, Canarias, Ceuta/Melilla) y conoce las reglas de VeriFactu. Más detalle en [Impuestos y fiscalidad](./impuestos-ia).

### Conciliación bancaria

Conecta tu banco y deja que el asistente haga el matching automático:

| Herramienta                   | Qué hace                                          | Ejemplo                                            |
| ----------------------------- | ------------------------------------------------- | -------------------------------------------------- |
| `reconcileTransactions`       | Cruza movimientos bancarios con facturas y gastos | "Concilia los movimientos de esta semana"          |
| `getUnreconciledTransactions` | Lista movimientos sin emparejar                   | "¿Qué movimientos bancarios no están conciliados?" |

### Operaciones masivas

Actualiza o elimina varios registros de una vez. Todas las operaciones masivas requieren **confirmación explícita** antes de ejecutarse:

| Herramienta          | Qué hace                                                | Ejemplo                                           |
| -------------------- | ------------------------------------------------------- | ------------------------------------------------- |
| `bulkUpdateInvoices` | Marca varias facturas como pagadas o cambia su estado   | "Marca como pagadas todas las facturas de enero"  |
| `bulkUpdateExpenses` | Cambia la categoría de varios gastos a la vez           | "Cambia todos los gastos de 'Otros' a 'Software'" |
| `bulkDeleteDrafts`   | Elimina todos los borradores de facturas o presupuestos | "Elimina todos los presupuestos en borrador"      |

Más detalle en [Operaciones masivas](./operaciones-masivas).

### Escaneo de documentos (OCR)

Sube fotografías de recibos, facturas o documentos. El asistente:

- Extrae datos automáticamente
- Reconoce concepto, importe, fecha
- Crea gastos o facturas directamente
- Soporta PDF, JPG, PNG

### Resúmenes financieros

Obtén análisis rápidos:

- Comparativas mes a mes
- Proyecciones de ingresos
- Análisis de rentabilidad por cliente
- Métricas de salud del negocio (clientes activos, retención)
- Registro de pagos parciales o totales
- Alertas de vencimientos próximos

## Encadenar acciones en un solo prompt

El asistente soporta **workflow chaining**: ejecutar varias acciones en secuencia con un solo mensaje.

```
"Crea una factura para Acme SL por 2.000 euros de consultoría y envíala por email"
```

El asistente:

1. Crea la factura con los datos indicados
2. Genera el PDF
3. Envía el email al cliente

Otros ejemplos de encadenamiento:

```
"Exporta mis facturas de Q1 a CSV y calcula el Modelo 303"
```

```
"Marca como pagadas las facturas de enero y genera un resumen del mes"
```

```
"Concilia los movimientos bancarios y muéstrame los que quedan sin emparejar"
```

El asistente ejecuta cada paso en orden y te muestra el resultado de cada uno.

## Gráficos inline

El asistente genera visualizaciones directamente en el chat:

- **Barras de desglose** — Gastos por categoría, facturación por cliente
- **Donut de estado** — Proporción de facturas pagadas, pendientes, vencidas
- **Línea de tendencia** — Evolución de ingresos o gastos mes a mes

Los gráficos usan diseño monocromo alineado con la identidad visual de Frihet. Aparecen automáticamente cuando la respuesta contiene datos financieros comparables.

## Caché semántica

Las consultas idénticas devuelven respuestas cacheadas durante 5 minutos. Si preguntas lo mismo dos veces seguidas, la segunda respuesta es instantánea. El caché se invalida automáticamente cuando se crean, modifican o eliminan registros.

## Comandos rápidos

Usa **slash commands** para acciones directas:

| Comando         | Función                          |
| --------------- | -------------------------------- |
| `/factura`      | Crear factura rápidamente        |
| `/gasto`        | Registrar gasto                  |
| `/pendientes`   | Ver facturas por cobrar          |
| `/resumen`      | Resumen financiero del mes       |
| `/clientes`     | Listar clientes y estadísticas   |
| `/ayuda`        | Ver todos los comandos           |
| `/meta`         | Objetivo de facturación del mes  |
| `/impuestos`    | Simulador de impuestos estimados |
| `/cobros`       | Últimos pagos recibidos          |
| `/recurrentes`  | Facturas recurrentes activas     |
| `/rentabilidad` | Rentabilidad por cliente         |
| `/exportar`     | Exportar datos a CSV o PDF       |
| `/conciliar`    | Conciliar movimientos bancarios  |
| `/modelo303`    | Calcular IVA trimestral          |
| `/modelo130`    | Calcular IRPF trimestral         |

## Todas las herramientas (50+)

Referencia completa de las herramientas del asistente, organizadas por categoría:

| Categoría               | Herramientas                                                                          | Descripción                         |
| ----------------------- | ------------------------------------------------------------------------------------- | ----------------------------------- |
| **Facturas**            | createInvoice, listInvoices, getInvoice, updateInvoice, deleteInvoice, searchInvoices | CRUD completo de facturas           |
| **Gastos**              | createExpense, listExpenses, getExpense, updateExpense, deleteExpense                 | CRUD completo de gastos             |
| **Clientes**            | createClient, listClients, getClient, updateClient, deleteClient                      | CRUD completo de clientes           |
| **Productos**           | createProduct, listProducts, getProduct, updateProduct, deleteProduct                 | CRUD completo de productos          |
| **Presupuestos**        | createQuote, listQuotes, getQuote, updateQuote, deleteQuote                           | CRUD completo de presupuestos       |
| **Recurrentes**         | createRecurring, listRecurring, cancelRecurring                                       | Facturas recurrentes                |
| **Pagos**               | recordPayment, listPayments                                                           | Registrar y consultar cobros        |
| **Exportación**         | exportToCSV, exportToPDF                                                              | Exportar datos a CSV o PDF          |
| **Impuestos**           | calculateModelo303, calculateModelo130, getTaxCalendar                                | Cálculos fiscales y calendario      |
| **Banca**               | reconcileTransactions, getUnreconciledTransactions                                    | Conciliación bancaria               |
| **Operaciones masivas** | bulkUpdateInvoices, bulkUpdateExpenses, bulkDeleteDrafts                              | Actualización y eliminación en lote |
| **Análisis**            | getSummary, getKPIs, getProjections                                                   | Resúmenes y métricas                |
| **Documentos**          | scanDocument, extractData                                                             | OCR y extracción de datos           |

## Límites por plan

El asistente IA tiene límites de mensajes según tu plan:

| Plan        | Mensajes/mes | Análisis de documentos | Histórico  |
| ----------- | ------------ | ---------------------- | ---------- |
| **Free**    | 20           | Sí                     | 7 días     |
| **Pro**     | 100          | Sí                     | 90 días    |
| **Premium** | 500          | Sí                     | Sin límite |

Los límites se reinician el primer día de cada mes.

## Historial persistente

El asistente mantiene **historial de conversaciones**:

- Accede a cualquier momento desde la barra lateral
- El contexto se preserva entre sesiones
- Puedes volver a referencias anteriores
- Los datos se sincronizan en todos tus dispositivos

## Privacidad y seguridad

- **Tus datos nunca se usan para entrenar modelos** — Solo procesamos con Gemini en tiempo real
- Encriptación end-to-end para uploads de documentos
- Las conversaciones se almacenan localmente en tu cuenta
- Puedes eliminar historial en cualquier momento

## Limitaciones actuales

El asistente **no puede**:

- Modificar clientes existentes (solo puede sugerir)
- Crear campañas de email masivas

## Extender las capacidades con la API

:::info Para desarrolladores
Puedes ampliar las capacidades del asistente IA de Frihet con herramientas programáticas:

- **Servidor MCP** — Conecta Claude, Cursor o Windsurf directamente a tu ERP via [@frihet/mcp-server](https://www.npmjs.com/package/@frihet/mcp-server). 157 herramientas para crear facturas, registrar gastos y consultar datos en lenguaje natural desde tu IDE.
- **API REST** — Construye flujos de IA personalizados usando los [endpoints de la API](/desarrolladores/api-rest). Ideal para pipelines de procesamiento, integraciones con LLMs propios o automatizaciones a medida.
- **Webhooks** — Dispara acciones cuando ocurren eventos como `invoice.created` o `expense.created`. Conecta con modelos de IA externos para clasificación automática, detección de anomalías o alertas inteligentes. Ver [documentación de webhooks](/desarrolladores/webhooks).

Consulta la [sección de desarrolladores](/desarrolladores) para la referencia completa.
:::

---

**Siguiente paso:** [Crear facturas por texto](./crear-facturas-por-texto)
