> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.boxhero.io/docs/documentation/es/otras-funciones/custom-analytics.md).

# Analítica personalizada

<figure><img src="/files/90ac9ef3450348cee360c5deb6142d5418548e0e" alt=""><figcaption></figcaption></figure>

***

## Aspectos destacados

* Haz preguntas en lenguaje natural y el **Asistente de IA** escribe el SQL por ti.
* 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 usas con frecuencia y ábrelas de nuevo en cualquier momento.
* Exporta los resultados a Excel para realizar análisis o informes adicionales.

## Casos de uso

La función estándar <mark style="color:$primary;">`Informes de inventario`</mark> te ofrece una vista rápida de métricas clave como la cantidad media de stock y la rotación de inventario para un período seleccionado. Como esos informes usan fórmulas y campos predefinidos, puede que no cubran todos los tipos de análisis que tu equipo necesita.

<mark style="color:$primary;">`Analíticas personalizadas`</mark> te da más control sobre cómo exploras tus datos. Es especialmente útil cuando:

* No puedes encontrar los datos que necesitas en la función estándar [Informes de inventario](/docs/documentation/es/otras-funciones/analytics.md)
* 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 la elaboración de informes o la toma de decisiones

***

## Cómo usar Custom Analytics

### 1. Primeros pasos

Ve a <mark style="color:$primary;">`Informes`</mark> > <mark style="color:$primary;">`Analíticas personalizadas`</mark>. Esto abre un nuevo espacio de trabajo donde puedes crear y gestionar tus consultas SQL. Luego, selecciona <mark style="color:$primary;">`+ Nuevo`</mark> para crear una nueva consulta.

<figure><img src="/files/c551ddb3ba464653de0a8ca2257c3cd45ed7cd1d" alt=""><figcaption></figcaption></figure>

### 2. Escribe una consulta

Tienes dos formas de escribir consultas:

1. **Usa el Asistente de IA** para generar SQL a partir de una pregunta en lenguaje natural (recomendado para la mayoría de los usuarios).
2. **Escribe SQL directamente** usando [DuckDB SQL](https://duckdb.org/docs/stable/sql/introduction).

<figure><img src="/files/fe782ad07bc218fa60af0497c0388189d4aaa9fb" alt=""><figcaption></figcaption></figure>

#### Usar el Asistente de IA

El <mark style="color:$primary;">`Asistente de IA`</mark> convierte preguntas en lenguaje natural en consultas SQL funcionales. No necesitas saber SQL para usarlo.&#x20;

Escribe tu pregunta en el panel del asistente y pulsa Enter. El asistente genera el SQL, lo aplica al editor y lo ejecuta. Los resultados aparecen debajo de la consulta.

Puedes editar el SQL generado antes de guardarlo si quieres ajustar algo.

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/38e5c1fa675d1d7f16b1d9e95a6aabd4/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

**Ejemplos de preguntas**

* Artículos por debajo del nivel de stock de seguridad
* ¿Qué no se ha vendido en los últimos 90 días?
* Los 10 SKU principales por unidades vendidas este mes
* Órdenes de compra abiertas que han superado su fecha de llegada prevista
* Niveles de stock por ubicación&#x20;

#### Cómo crear consultas reutilizables

Puedes pedirle al asistente que incluya filtros ajustables en una consulta, como rangos de fechas o nombres de socios. El asistente usa variables de consulta para que puedas cambiar los valores de entrada más adelante sin reescribir el SQL.

Por ejemplo, al pedir *"ventas por artículo para un rango de fechas que pueda cambiar"* genera una consulta con una variable de fecha que solicita una entrada cada vez que se ejecuta la consulta.

<figure><img src="/files/0e2a39b2ab92017c66f33ce1184a8092f0319da0" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}
El Asistente de IA funciona mejor con **preguntas** **específicas**. \
En lugar de *"muéstrame las ventas,"* prueba *"los 10 artículos principales por ingresos este mes."*
{% endhint %}

{% embed url="<https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/iframe?autoplay=true&controls=false&letterboxColor=transparent&loop=true&muted=true&poster=https://customer-0jrbilsa8yt3k758.cloudflarestream.com/27509a71c500d77cd43f29409abe0d68/thumbnails/thumbnail.jpg?height=1080&preload=true>" %}

{% hint style="success" %}
Haz clic en el <mark style="color:$primary;">`Gráfico`</mark> para visualizar los datos — se admiten gráficos de barras, líneas, circulares, barras apiladas y áreas apiladas.
{% endhint %}

### 3. Guarda una consulta

Selecciona <mark style="color:$primary;">`Ejecutar`</mark> para probar tu consulta. Como los resultados dependen de las condiciones que escribas, revisa la salida para confirmar que coincide con lo que esperas.

Si planeas reutilizar una consulta, selecciona <mark style="color:$primary;">`Guardar`</mark> en la esquina superior derecha. Las consultas guardadas aparecen en la barra lateral izquierda, donde puedes abrirlas y ejecutarlas en cualquier momento.

Después de que tu consulta se ejecute correctamente, puedes exportar los resultados con <mark style="color:$primary;">`Exportar a Excel`</mark>.

<figure><img src="/files/63704664ace4550ed9e33230897f4b79bc0b6135" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Tus datos se sincronizan automáticamente **una vez al día**.\
Para sincronizar inmediatamente, haz clic en el icono 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 de tu consulta SQL.

Cuando guardas una consulta, los miembros de tu equipo pueden introducir sus propios valores en el campo de la variable y ejecutar el informe cuando 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.

<figure><img src="/files/1532f87951a9f07d258c5c66db7f9d5c1405af8c" alt=""><figcaption></figcaption></figure>

3. Introduce una palabra clave como *`suéter`* y los resultados mostrarán todos los artículos con *“suéter”* en su nombre.

<figure><img src="/files/89a0f9ad57662e31e1997eda43ebb5e9c8537a04" alt=""><figcaption></figcaption></figure>

4. Guarda la consulta si planeas usarla de nuevo. Puedes seleccionar y cargar consultas guardadas en cualquier momento desde el menú de la izquierda.

<figure><img src="/files/429075d58202f09103ff3434cb09043d9135f466" alt=""><figcaption></figcaption></figure>

***

## Ejemplos

Custom Analytics 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 y salidas de stock
* Tendencia mensual de compras y ventas
* Última fecha de salida por artículo

<figure><img src="/files/c952ee9fa37db83a037b14b09ef37b3c37ee07ad" alt=""><figcaption></figcaption></figure>

***

## Preguntas frecuentes

**¿Aún tienes preguntas?** Consulta nuestras preguntas frecuentes sobre Custom Analytics:

{% content-ref url="/spaces/2HSNaaMfPye6J7HoP6FU/pages/16710d56e0397ec207c5c277ad2a0815cbf4ea47" %}
[Analíticas personalizadas](/docs/faq/es/informes/analiticas-personalizadas.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.boxhero.io/docs/documentation/es/otras-funciones/custom-analytics.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.