# Analíticas personalizadas
{% hint style="warning" %} **`Analítica personalizada`** se encuentra actualmente en **beta**.\
Se convertirá en una función de pago después del lanzamiento oficial.
{% endhint %}
***
## Aspectos clave
* Usa SQL para consultar tus datos de BoxHero.
* Combina condiciones (p. ej., artículo, atributo, precio, rango de fechas, socio) para definir los datos que quieres devolver como un informe personalizado.
* Guarda las consultas que uses con frecuencia y ábrelas nuevamente en cualquier momento.
* Exporta los resultados a Excel para análisis o informes adicionales.
## Cuándo usar Analítica personalizada
La función estándar de **`Informes de inventario`** te ofrece una vista rápida de métricas clave como la cantidad promedio de existencias y la rotación de inventario para un período seleccionado. Debido a que esos informes usan fórmulas y campos predefinidos, es posible que no cubran todos los tipos de análisis que tu equipo necesita.
**`Analítica personalizada`** te brinda más control sobre cómo exploras tus datos. Es especialmente útil cuando:
* No puedes encontrar los datos que necesitas en los [Informes de inventario](https://www.boxhero.io/docs/documentation/es/otras-funciones/analytics)
* Quieres filtrar o agrupar datos por artículo, proveedor, cliente, miembro del equipo u otras condiciones detalladas
* Necesitas análisis basados en el tiempo, como mensuales, trimestrales o interanuales
* Quieres guardar los informes en los que confías y volver a usarlos
* Necesitas datos flexibles para respaldar informes o la toma de decisiones
***
## Cómo usar Analítica personalizada
### 1. Primeros pasos
Ve a **`Informes`** > **`Analítica personalizada`**. Esto abre un nuevo espacio de trabajo donde puedes crear y administrar tus consultas SQL. Luego, selecciona **`+ Nuevo`** para crear una nueva consulta.
### 2. Escribe una consulta
Las consultas usan [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction). Puedes descargar el archivo de **`Prompt de IA`** para ver todas las tablas y columnas disponibles.
{% hint style="success" %}
Si estás usando **herramientas de IA** como ChatGPT o Gemini, adjuntar el archivo "*Prompt de IA"* ayuda a generar SQL preciso.
{% endhint %}
Selecciona **`Ejecutar`** para probar tu consulta. Como los resultados dependen de las condiciones que escribas, revisa la salida para confirmar que coincide con lo que esperas.
Después de que tu consulta se ejecute correctamente, puedes exportar los resultados con **`Exportar a Excel`**.
### 3. Guarda una consulta
Si planeas reutilizar una consulta, selecciona **`Guardar`** en la esquina superior derecha.
Las consultas guardadas aparecen en la barra lateral izquierda, donde puedes abrirlas y ejecutarlas en cualquier momento.
{% hint style="info" %}
Tus datos se sincronizan automáticamente **una vez al día**.\
Para sincronizar de inmediato, haz clic en el ícono de sincronización (🔄) en la parte inferior de la barra lateral.
{% endhint %}
***
## Variables de consulta
Si incluyes `{{variable_name}}` en tu consulta, se genera automáticamente un campo de entrada cuando se ejecuta la consulta. El valor introducido en ese campo se aplica a la variable en tu consulta SQL.
Cuando guardas una consulta, los miembros de tu equipo pueden introducir sus propios valores en el campo de variable y ejecutar el informe cada vez que lo necesiten.
#### Ejemplo
1. Para buscar artículos que contengan una palabra clave específica, introduce la siguiente consulta:
```sql
select sku, name
from items
where name ilike '%' || {{item_name}} || '%';
```
2. Cuando ejecutes la consulta, aparecerá un campo de entrada llamado **item\_name** aparece.
3. Introduce una palabra clave como *`suéter`* y los resultados mostrarán todos los artículos con *“suéter”* en su nombre.
4. Guarda la consulta si planeas volver a usarla. Puedes seleccionar y cargar consultas guardadas en cualquier momento desde el menú de la izquierda.
***
## Casos de uso
Analítica personalizada incluye plantillas integradas que puedes ejecutar de inmediato. Revisa una plantilla para entender cómo funciona, luego ajústala o crea una nueva consulta según tus necesidades.
#### Plantillas
* Informe semanal de entradas/salidas de stock
* Tendencia mensual de compras y ventas
* Última fecha de salida por artículo
***
## Preguntas frecuentes (FAQ)
### ¿Puedo combinar datos de varios equipos?
No. Los datos están separados por equipo y solo puedes analizar los datos del equipo en el que has iniciado sesión actualmente.
### ¿Puedo restringir a los miembros el uso de Analítica personalizada?
Los administradores y miembros pueden crear y ver consultas. Los miembros con permisos personalizados *no* tienen acceso a esta función.
Si necesitas restringir el acceso de un miembro, asígnale un [permiso personalizado](https://www.boxhero.io/docs/documentation/es/configuracion/members#custom-roles-and-permissions) con **todos los permisos seleccionados**. Analítica personalizada *no* está incluida en las opciones de permisos personalizados, por lo que, incluso con todos los permisos seleccionados, el miembro no tendrá acceso.
