> ## Documentation Index
> Fetch the complete documentation index at: https://docs.retailgrid.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Glosario de métricas

> Referencia de todas las métricas analíticas que calcula Retailgrid: definiciones, fórmulas y cuándo importa cada una.

Esta página es la referencia de todas las métricas que calcula Retailgrid. Úsala para confirmar qué significa una columna antes de actuar sobre ella.

Las métricas están disponibles como columnas **Analytical metric** (añadidas mediante **Add Column** o el botón **Metrics** de la barra de herramientas) y como resultados de agentes como Dynamic Pricing.

## Granularidad de las métricas

Cuando hay datos a nivel de tienda cargados, las métricas se calculan a nivel **SKU-Store**: los KPI de cada tienda (margen, índice de precios, diferencia frente a competidores) usan el precio, el costo y el conjunto de competidores de esa tienda. En la vista Product del Grid se muestra una agregación a nivel de producto de las mismas métricas. Consulta [Vistas de Grid de producto y SKU-Store](https://docs.retailgrid.io/es/grids/sku-store-view.md).

## Métricas de margen

### Margin

Margen monetario absoluto por unidad, con impuestos incluidos.

```text theme={null}
Margin = price - unit_cost
```

Úsala para: una revisión rápida de qué SKUs generan dinero.

### Margin %

Margen como porcentaje del precio de venta.

```text theme={null}
Margin % = (price - unit_cost) / price
```

Úsala para: comparar el margen entre SKUs con distintos niveles de precio.

### New Unit Margin %

Margen neto de impuestos sobre el precio calculado por Dynamic Pricing.

```text theme={null}
New Unit Margin % = (Rules Based Price / (1 + Tax Rate) - Unit Cost)
                  / (Rules Based Price / (1 + Tax Rate))
```

Úsala para: ver el margen que obtendrías si aceptaras el precio recomendado por el agente.

### Unit Margin % change

Cambio en puntos porcentuales entre el Margin % actual y el New Unit Margin %.

```text theme={null}
Unit Margin % change = New Unit Margin % - current Margin %
```

Úsala para: detectar las reglas que más mueven el margen (en positivo o en negativo).

## Métricas competitivas

### Price Index (PI)

Tu precio en relación con un único competidor o referencia de competidor.

```text theme={null}
Price Index = price / competitor_price * 100
```

100 = paridad, menos de 100 = eres más barato, más de 100 = eres más caro.

### CPI (Min)

El **CPI** (Competitive Price Index, índice de precios competitivo) compara tu precio con una referencia de competidor; las variantes siguientes solo difieren en qué precio de competidor usan como referencia.

Índice de precios competitivo frente al competidor más barato.

```text theme={null}
CPI (Min) = price / min(competitor_price) * 100
```

Úsala para: seguir lo agresivo que es el competidor más barato en cada SKU.

### CPI (Mode)

Índice de precios competitivo frente al precio de competidor más frecuente.

```text theme={null}
CPI (Mode) = price / mode(competitor_price) * 100
```

La moda suele representar mejor el "precio de mercado" que el mínimo, porque los competidores anormalmente baratos no la dominan.

### CPI (Weighted)

Índice de precios competitivo ponderado por el valor de ventas de cada SKU, de modo que los SKUs que realmente vendes dominan el índice.

```text theme={null}
CPI (Weighted) = Σ(sales_value × CPI) / Σ(sales_value)
```

Úsala para: el mejor resumen único de la posición de precio global en una categoría o en todo el Grid; los SKUs de alto volumen pesan más. Es la variante de CPI que se muestra en el dashboard integrado Competitive Position.

### Price Gap

Diferencia monetaria absoluta frente a una referencia de competidor.

```text theme={null}
Price Gap = price - competitor_price
```

Úsala para: entender los euros o dólares literales que te separan de un competidor.

### Cheapest Flag

Booleano. `true` si tu precio es el más barato entre los competidores disponibles; en caso contrario, `false`.

```text theme={null}
is_cheapest = price <= min(competitor_price)
```

Úsala para: filtrar Grids por "dónde estoy ganando en precio".

### Price Range

Columna visual que muestra el mínimo y el máximo de los precios de competidores y dónde se sitúa el precio actual dentro de ese rango.

Es un recurso de interfaz más que una métrica numérica: úsala para ver el posicionamiento de mercado de un vistazo y luego profundiza con las variantes de CPI para mayor precisión.

## Métricas de inventario y de precio realizado

Estas métricas muestran qué parte del precio de lista realizas en la práctica y cuánto capital está inmovilizado en stock. Aquí los precios son **sin IVA** (`price_ex_vat = price / (1 + tax_rate)`). Las métricas de inventario necesitan un valor de `stock` en tus datos de Products; las métricas de sell-through, rotación y GMROI necesitan Transactions.

Cuando un producto no tiene historial de stock utilizable en la ventana seleccionada, las métricas basadas en stock (Value of Inventory, Cost of Inventory y las métricas de productividad que dependen del stock) muestran un estado de **sin datos** en lugar de una cifra `0.00` o `100%`. Así se distingue un cero real de un stock ausente.

### Markup %

Margen sobre el costo, calculado sobre el precio sin IVA.

```text theme={null}
Markup % = (price_ex_vat - unit_cost) / unit_cost
```

### Realized Discount %

Cuánto se sitúa el precio de venta actual por debajo del precio regular (de lista): el descuento que estás dando realmente.

```text theme={null}
Realized Discount % = (regular_price_ex_vat - price_ex_vat) / regular_price_ex_vat
```

### Value of Inventory

Stock disponible valorado al precio de venta sin IVA.

```text theme={null}
Value of Inventory = stock * price_ex_vat
```

### Cost of Inventory

Stock disponible valorado al costo unitario: el capital inmovilizado en stock.

```text theme={null}
Cost of Inventory = stock * unit_cost
```

### Métricas de productividad del inventario

El selector también expone **GMROI**, **Sell-through %**, **Inventory Turnover** y **Average Selling Price**, calculadas a partir de tus Transactions en la ventana seleccionada: el retorno del margen bruto sobre la inversión en inventario, la proporción del stock disponible que se vendió, cuántas veces rota el stock y el precio medio realizado por unidad. Cada una necesita suficiente historial de ventas en la ventana para tener sentido; un producto sin transacciones en la ventana se muestra en blanco.

### Días de cobertura pronosticados

Cuántos días durará el stock actual al precio de hoy, leído del pronóstico de demanda diaria (estacionalidad incluida) en lugar de un promedio plano de ventas pasadas.

Añádela desde **Metrics** en cualquier Grid que tenga un valor de `stock` y un pronóstico; no necesitas ejecutar una optimización antes. Los artículos sin stock o sin pronóstico muestran un estado explícito de **unavailable** (no disponible) en lugar de un cero, y el stock que dura más allá del horizonte del pronóstico se muestra como **≥180**. El valor coincide con los días de cobertura que usa una optimización GMROI para el mismo artículo y fecha.

Sustituye al antiguo cálculo por ritmo de venta (stock ÷ promedio diario de ventas pasadas), que ignoraba la estacionalidad y el precio.

## Cadencia de actualización

La mayoría de las métricas se calculan en BigQuery y se actualizan casi en tiempo real a medida que cambian tus datos subyacentes (Products, Transactions, Competitors). En concreto:

* **Margin / Margin %** se actualizan cuando cambia `price` o `unit_cost` en un producto.
* **Las variantes de CPI y el Price Index** se actualizan cuando se actualiza la fila correspondiente del conjunto de datos Competitors.
* **Las columnas de salida de Dynamic Pricing** (Rules Based Price, New Unit Margin %, Unit Margin % change) se actualizan bajo demanda cuando se ejecuta el agente Dynamic Pricing.

Las métricas estáticas como el margen, el costo unitario y el precio también conservan un historial diario en BigQuery junto a las métricas de series temporales. Ese historial no se muestra como columna propia del Grid, pero puedes ver cómo han evolucionado el precio, los competidores, las ventas y el beneficio de un SKU a lo largo del tiempo en el [panel de analítica de series temporales del SKU](https://docs.retailgrid.io/es/grids/sku-analytics-panel.md).

Si una columna de métrica parece desactualizada, reemplaza el conjunto de datos de origen en la [página Datasets](https://docs.retailgrid.io/es/data-requirements/datasets.md): eso dispara una actualización en cadena.

## Relacionado

* [Añadir columnas](https://docs.retailgrid.io/es/grids/manage-columns.md)
* [Dynamic Pricing](https://docs.retailgrid.io/es/agents/dynamic-pricing.md)
* [Vistas de Grid de producto y SKU-Store](https://docs.retailgrid.io/es/grids/sku-store-view.md)
* [Especificación de datos de precios de competidores](https://docs.retailgrid.io/es/data-requirements/competitors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.