Docs

Configurar Prize

Tu primer ciclo corrió y viste tu primera recomendación. Esta página te guía a calibrar Prize a tu negocio: árbol de categorías, umbrales, margen objetivo, autonomía y notificaciones. Otros 4 minutos bien invertidos.

Antes de configurar

Esta página asume que ya:

  • Hiciste Inicio rápido — workspace, catálogo y competidores listos.
  • Tu primer ciclo terminó (todas las fuentes en verde o ámbar — no Down).
  • Resolviste al menos los matches HIGH y viste tu primera recomendación.

Si recién creaste el workspace y todavía no corrió un ciclo, hacé eso primero — la mayoría de las decisiones de configuración se entienden mejor mirando datos reales.

Tu árbol de categorías

Prize deduce el árbol de categorías directamente del campo category de tu catálogo. Filas con paths como TV/Smart TV/4K y TV/Smart TV/OLED arman una jerarquía con tres niveles, donde 4K y OLED son hijas de Smart TV, que es hija de TV.

El árbol vivo lo ves en Catálogo → Categorías:

FIG. 4  Vista de árbol en Catálogo → Categorías. Deducido del campo category de cada SKU.

Operaciones disponibles sobre el árbol:

  • Renombrar — cambiar el nombre visible del nodo. No re-asigna SKUs.
  • Mergear — combinar dos nodos hermanos en uno. Útil cuando importaste con typos ("Heladeras" + "heladeras" → un solo nodo).
  • Dividir — partir un nodo en sub-categorías. Prize ofrece sugerencias basadas en atributos comunes (marca, capacidad, pulgadas).
  • Mover — cambiar el parent de un nodo.

Lo que se cuelga del árbol — y por eso importa que esté bien armado:

  • Umbrales — competitivo / tensión / alerta se definen por categoría.
  • Margen objetivo — un target por categoría, heredable a hijas.
  • Tiering de competidores — un competidor puede ser Tier 1 en TV pero Tier 3 en Soundbar.
  • Elasticidad — Prize estima un coeficiente por categoría.
CUIDADO · CAMBIOS DURANTE UN CICLO

Mergear o dividir nodos durante un ciclo en curso no afecta ese ciclo — los cambios entran al siguiente. Si querés que apliquen ya, pausá el ciclo desde Ciclos → Pausar, hacé los cambios y reanudá.

Umbrales por categoría

Los umbrales clasifican el estado de cada SKU en la matriz: Competitivo (estás bien), Tensión (mirar), Alerta (mover hoy). Definidos como variación porcentual respecto al líder del mercado en cada SKU.

Defaults globales razonables (vienen activos al crear el workspace):

−2%
−5%
COMPETITIVOTENSIÓNALERTA
≥ −2%−2 / −5%< −5%
FIG. 5  Configurador de umbrales. Arrastrás los breakpoints (−2%, −5%) o los editás manualmente.

Para overridear por categoría, andá a Configuración → Umbrales y elegí la categoría. Una de margen alto y elasticidad baja (TV premium) puede tolerar gaps mayores; una de mucho volumen y poca diferenciación (cargadores) requiere umbrales más estrictos.

| Categoría | Competitivo | Tensión | Alerta | |---|---|---|---| | Default global | ≥ −2% | −2 / −5% | < −5% | | TV / Premium | ≥ −1% | −1 / −3% | < −3% | | Pequeños electro | ≥ −3% | −3 / −7% | < −7% | | Cargadores / accesorios | ≥ −1% | −1 / −2% | < −2% |

Los cambios de umbrales se aplican al instante — la matriz se recalcula sin esperar al próximo ciclo. Las recomendaciones nuevas sí necesitan un ciclo nuevo para reflejar los cambios.

TIP · GUARDAR COMO TEMPLATE

Si ajustás los umbrales para una categoría y querés aplicar el mismo set a varias, guardalos como template ("TV premium", "Volumen alto") y asignalos a múltiples nodos del árbol con un clic.

Margen objetivo por categoría En desarrollo

El margen objetivo (target margin) es el guardrail que Prize usa para no recomendar movimientos que destruyan rentabilidad. Distinto del margen actual (que viene en el campo margin_pct del catálogo): el actual es dónde estás, el objetivo es dónde querés estar.

Ejemplo concreto. Smart TV Samsung 55" con margen actual 19% y target 17%:

| Recomendación | Margen resultante | Acción de Prize | |---|---|---| | Bajar 2% | 17,3% | Sigue > target — recomendación normal, autoejecutable. | | Bajar 4% | 15,3% | Cae bajo target. Marcada como alerta de margen. No se autoejecuta ni siquiera con autonomía Nivel 2. | | Bajar 8% | 11% | Cae lejos del target. Recomendación bloqueada. Sólo aplicable con override explícito + razón. |

Configuración: Configuración → Márgenes → por categoría. Definís el target en porcentaje. Heredan los hijos del árbol salvo override explícito.

TIP · DÓNDE PONER EL TARGET

Una heurística que funciona: tu margen objetivo histórico (lo que tu CFO espera) menos 1–2 puntos de buffer. Eso te deja espacio para movimientos competitivos defensivos sin abandonar la regla de negocio.

Bandas de autonomía En desarrollo

Hasta qué punto Prize ejecuta solo, dónde te detiene a confirmar. Tres niveles. Default es Nivel 1 — cada reprice requiere clic humano.

| Nivel | Quién ejecuta | Cuándo activarlo | |---|---|---| | Nivel 1 — Clic humano | Prize prepara el reprice (precio nuevo, canales afectados, justificación). Vos aplicás con un clic. | Default. Para retailers que recién empiezan, o categorías de bajo volumen donde la calibración no se completó. | | Nivel 2 — Banda acotada | Definís bandas (rango máx de variación, margen mínimo, ventana horaria, SKUs incluidos). Dentro de la banda Prize ejecuta solo. Fuera, escala a humano. | Para categorías ya calibradas con confianza alta y muchas recomendaciones por día. Reduce fricción operacional sin ceder control. | | Nivel 3 — Workflow de aprobación | Reprices distintos requieren niveles de aprobación distintos (Category Manager, Pricing Director, CFO). Prize orquesta el flujo y mantiene trazabilidad. | Para retailers grandes con governance formal y reprices que cruzan límites de autoridad. |

Acá configurás solo el nivel default que el workspace usa. La configuración fina por categoría, por SKU o por banda específica vive en Reglas y umbrales.

CUIDADO · NIVEL 2 EN PRODUCCIÓN

Activar Nivel 2 sin haber operado en Nivel 1 al menos 30 días no es recomendado. Sin histórico, las bandas no están calibradas y Prize puede ejecutar movimientos que un humano hubiera vetado. La autonomía se gana con datos, no se delega por defecto.

Notificaciones En desarrollo

Cuándo Prize te avisa, por dónde y por cuál evento. Tres canales: email, in-app (campana en topbar) y webhook (para integración con tus sistemas).

| Evento | Email | In-app | Webhook | |---|---|---|---| | Ciclo completo · todas las fuentes terminaron | opcional | sí | sí | | Fuente degradada · una fuente bajó de Healthy | sí | sí | sí | | Recomendación de alto impacto · > umbral en pesos | sí | sí | sí | | Umbral cruzado · SKU pasó a Alerta | opcional | sí | sí | | Match pendiente de revisión · cola creció | — | sí | — | | Reprice aplicado · alguien ejecutó un reprice | — | sí | sí | | Alerta de margen · una rec quedó bloqueada por target | sí | sí | sí |

Configuración: Configuración → Notificaciones. Por canal y por evento. El umbral de "alto impacto" es configurable (default: +AR$ 5M de impacto estimado en 7 días).

Para webhook spec (URL, payload, retry policy, firma HMAC), mirá API · Webhooks.

TIP · CONFIGURACIÓN INICIAL RECOMENDADA

Si recién empezás, activá email para ciclo completo + alto impacto + alerta de margen, y dejá el resto en in-app. Suficiente para no perder nada importante sin que tu inbox se llene de ruido. Sumás más cuando ganes intuición sobre qué te interesa.

Próximos pasos

Configuración detallada

  • Reglas y umbrales — bandas de autonomía por SKU/categoría, excepciones explícitas, ventanas horarias.
  • Sincronización — frecuencia, intra-día, pausar/reanudar.

Integración

Equipo

  • Equipo y roles — invitar usuarios, asignar roles (Pricing Manager, Category Manager, Director, Viewer).