Docs

Estados y umbrales

Cada SKU en la matriz lleva un estado: Competitivo, Tensión o Alerta. Esta página explica cómo se calculan, cómo se ven, y cómo cambian. Para configurar los umbrales, mirá Configurar Prize · Umbrales.

Los tres estados en la matriz

| Estado | Significado | Visual en la matriz | |--------|-------------|---------------------| | ● Competitivo | Tu precio está dentro del rango aceptable. No requiere acción. | Dot verde a la izquierda de la fila. Texto del SKU en color normal. | | ● Tensión | El gap empezó a abrirse. Mirar pero no necesariamente actuar todavía. | Dot ámbar. Algunas celdas pueden aparecer también en ámbar si individualmente cruzan el umbral. | | ● Alerta | Gap material. Acción recomendada hoy o en este ciclo. | Dot rojo. Celdas problemáticas también en rojo. Generalmente esta fila también aparece en la cola de recomendaciones. |

Cómo se calcula el estado por celda

El estado de una celda individual (intersección de tu SKU y un competidor) se calcula con un cálculo simple:

  • Gap = (mi precio − precio competidor) ÷ precio competidor × 100
  • Si gap ≥ −2% (default) → Competitivo a nivel celda.
  • Si −2% > gap ≥ −5% (default) → Tensión.
  • Si gap < −5% (default) → Alerta.

Los umbrales (−2%, −5%) son configurables globalmente y por categoría. Detalle en Configurar Prize · Umbrales por categoría.

Cómo se clasifica un SKU completo

El estado del SKU completo (la fila entera) no es worst-of de las celdas. Es un promedio ponderado de los gaps de cada celda, donde el peso de cada celda viene del tier de su competidor.

  • Cada celda contribuye su gap × peso del tier.
  • Pesos default: Tier 1 = 60%, Tier 2 = 30%, Tier 3 = 10%. El tier share se reparte uniformemente entre las fuentes activas de ese tier.
  • La suma se normaliza por el peso total presente.
  • El gap promedio resultante se mapea a Competitivo / Tensión / Alerta usando los mismos umbrales globales.

Ejemplo con números

Smart TV Samsung 55" — tu precio $ 1.249.999. Cinco fuentes activas:

| Fuente | Tier | Precio | Gap | Peso de la celda | Contribución | |--------|------|--------|-----|-----------------|--------------| | Frávega | 1 | $ 1.199.999 | −4,0% | 60% / 3 = 20% | −0,80 | | Musimundo | 1 | $ 1.264.999 | +1,2% | 20% | +0,24 | | MELI · Samsung Oficial | 1 | $ 1.189.999 | −4,8% | 20% | −0,96 | | Garbarino | 2 | $ 1.229.999 | −1,6% | 30% / 2 = 15% | −0,24 | | Cetrogar | 2 | $ 1.214.999 | −2,8% | 15% | −0,42 |

Suma de contribuciones: −0,80 + 0,24 − 0,96 − 0,24 − 0,42 = −2,18. Como no hay Tier 3 activo, el peso total es 90% — normalizado a 100%, el gap promedio queda en −2,42%.

Mapeado a los umbrales (−2% / −5%) → estado Tensión. La fila completa se marca con dot ámbar.

TIP · POR QUÉ NO ES WORST-OF

Si Prize usara worst-of, una sola fuente Tier 3 con un precio −6% arrastraría el SKU a Alerta. Eso es ruidoso — un nicho con poco peso no debería disparar alarma. El promedio ponderado captura "qué tan defendible es tu posición competitiva" mucho mejor.

Datos faltantes en una fuente

Cuando una fuente no tiene el SKU (huérfano contra esa fuente, o fuente Down), su celda queda con guión — y no entra al promedio. El peso se redistribuye entre las fuentes activas del mismo tier.

Caso especial: si todas las fuentes Tier 1 están sin datos al mismo tiempo, el SKU no puede clasificarse con suficiente confianza. Prize lo marca como "datos insuficientes" en lugar de un estado normal — sin dot de color, con un dash en su lugar. La fila sigue siendo visible pero no contribuye a los contadores de status pills.

Recálculo en vivo

Tres triggers que recalculan estados sin esperar al próximo ciclo:

  • Cambio de umbral — modificás el umbral global o el de una categoría → la matriz se actualiza al instante.
  • Cambio de tier de una fuente — modificás el peso → recalcula gaps promedio.
  • Cambio de tu precio — updateaste un SKU vía CSV/API → ese SKU se recalcula.

Lo que no se recalcula sin un ciclo nuevo: precios de los competidores. Para esos hay que esperar al próximo sync (o forzar refresh manual).

Próximos pasos