Docs

Inicio rápido

Configurá Prize en menos de 4 minutos. Esta guía te lleva de "creé el workspace" a "Prize me sugirió mi primera acción de pricing" sin saltos. Si es tu primera vez con Prize, leelo de arriba abajo — los pasos asumen el orden.

Antes de empezar

Tres cosas a mano:

  • Catálogo en CSV (formato más abajo) o credenciales de tu API interna.
  • Lista corta de competidores que te importan. Si no tenés definido, empezá con los 3 más obvios de tu vertical.
  • Margen objetivo aproximado por categoría. No tiene que ser exacto — Prize lo refina con datos.

Lo que no hace falta decidir hoy:

  • Tiering fino. Default razonable: Tier 1 = los 3 más relevantes.
  • Umbrales por categoría. Default: competitivo ≥−2%, tensión −2/−5%, alerta <−5%.
  • Bandas de autonomía. Default: cada reprice requiere un clic humano. Activás autonomía después.

Paso 1 · Crear workspace

Andá a prize.solutions/signup. Tres caminos para crear cuenta:

  • Continuar con Google — recomendado si tu empresa usa Google Workspace.
  • Continuar con Microsoft — si usás Microsoft 365.
  • Email + contraseña — si preferís credenciales separadas.

Después del signup, Prize te pide tres datos:

  • Nombre del workspace — el de tu empresa o unidad de negocio.
  • Idioma — ES o EN. Cambiable en cualquier momento.
  • Moneda — AR$ por default. Si operás en múltiples monedas, configurás más adelante.
TIP · UN WORKSPACE POR VERTICAL

El workspace es la unidad de aislamiento de Prize. Si gestionás dos verticales que requieren reglas distintas (ej. electro y deportes), creá dos workspaces separados. Compartís el equipo entre ambos pero cada uno tiene su catálogo, sus competidores y sus umbrales.

Dos caminos según cómo tenés la data hoy.

Opción A · CSV (recomendado para primer setup)

Bajá la plantilla: prize_catalog_template.csv.

Columnas requeridas:

| Columna | Tipo | Ejemplo | Notas | |---|---|---|---| | sku | string | TV-SAM-55-4K | Tu código interno. Único. | | name | string | Smart TV Samsung 55" Crystal UHD 4K | Nombre comercial. | | brand | string | Samsung | Marca. | | model | string | UN55CU7000 | Modelo del fabricante. | | ean | string | 8806094876123 | EAN-13 / GTIN. Recomendado para mejor matching. | | category | string | TV/Smart TV/4K | Path con /. | | price | integer | 1249999 | Precio actual en pesos, sin separadores. | | volume | enum | A | A (alto), B (medio), C (cola larga). | | margin_pct | decimal | 0.19 | Margen actual como decimal (0.19 = 19%). |

Columnas opcionales:

  • url — landing del producto en tu sitio. Mejora la calidad del matching.
  • image_url — imagen del producto. Útil para revisión humana en MEDIA.
  • attributes — JSON con atributos extra. Ej: {"pulgadas": 55, "smart": true}.

Ejemplo:

prize_catalog_template.csv

Subí el archivo en Catálogo → Importar. Prize valida fila por fila y muestra errores antes de aceptar.

CUIDADO · ERRORES COMUNES

EAN vacío para SKUs internacionales — no es bloqueante, pero baja la confianza del matching. Precio con separadores (1.249.999, $1,249,999) — usá entero limpio: 1249999. Categorías con typos distintos para el mismo path ("Heladeras" vs "heladeras") — Prize las trata como categorías distintas.

Opción B · API

POST a https://api.prize.solutions/v1/catalog/skus. Mismas columnas que el CSV, en JSON.

POST /v1/catalog/skus

Para batch, sync incremental y manejo de updates, mirá API · Catálogo.

Paso 3 · Configurar tu set competitivo

En Competidores → Agregar, elegí del catálogo Prize de fuentes argentinas:

  • Frávega
  • Mercado Libre (con o sin filtro Full)
  • Musimundo
  • Garbarino
  • Cetrogar
  • Coto
  • Otros según vertical (pedilos a soporte si no están)

A cada uno le asignás un tier:

| Tier | Rol | Peso default | |---|---|---| | Tier 1 | Referentes principales — los 3 que más mueven tu mercado. | 60% | | Tier 2 | Secundarios. | 30% | | Tier 3 | Nicho. | 10% |

TIP · DEFAULT PARA ELECTRO AR

Tier 1: Frávega + Mercado Libre + Musimundo. Tier 2: Garbarino + Cetrogar. Tier 3: Coto y sellers MELI no-Full. Lo ajustás después según tus datos — algunos retailers pequeños descubren que su Tier 1 real es distinto al obvio.

Paso 4 · Tu primer ciclo

Cuando guardás la config, Prize arranca el primer ciclo automáticamente. Lo que vas a ver:

CICLO C-0001 · EN CURSO60% · 2 min restantes
FIG. 2  Tu primer ciclo en curso. Las pills se ponen verdes a medida que cada fuente termina.
  • Barra de progreso — % completo del ciclo.
  • Status pills por fuente — Healthy / Degraded / Down. Verde es bueno.
  • Tiempo estimado — típicamente 2–5 minutos para un set de 10–20 SKUs × 6 fuentes.

Cuando la barra llega a 100% y todas las fuentes están en verde, el ciclo terminó.

CUIDADO · DEGRADED EN EL PRIMER CICLO

Si una fuente queda en Degraded, no es bloqueante — Prize sigue corriendo recomendaciones con el resto. Andá a Salud por fuente para entender qué pasó (timeout, captcha, cambio de DOM del competidor). En el 90% de los casos se resuelve solo en el siguiente ciclo.

Paso 5 · Resolver matches pendientes

Una vez completado el ciclo, en el sidebar va a aparecer una badge ámbar al lado de Matching (ej. 11). Hacé click y entrás a la cola.

Tres niveles de confianza:

| Nivel | Score | Acción | |---|---|---| | HIGH | ≥85% | Aceptás en bloque con Aceptar todos los HIGH. | | MEDIA | 60–84% | Uno a uno. Prize muestra hints contextuales (PSA regional, pulgadas distintas, capacidad diferente). | | BAJA | <60% | Quedan en cola. No entran al motor hasta que un humano los confirme. |

TIP · NO HACE FALTA RESOLVER TODA LA COLA

Para tu primera recomendación basta con resolver los HIGH automáticos + 5–10 MEDIA del Tier 1 y avanzar. Los demás los hacés después, a tu ritmo. Prize trabaja con lo que tiene.

Paso 6 · Tu primera recomendación En desarrollo

Andá a Inicio. Si todo salió bien, vas a ver algo así:

REC-001 · Smart TV Samsung 55 Crystal UHD 4Kconf. %
Sugerimos bajar −2,4%
$ 1.249.999$ 1.219.999·impacto +AR$ 29,2M (7d)
MERCADO
MELI a $ 1.189.999 — gap +5,0% con líder. Hot Sale activo en MUS y CET.
FIG. 3  Tu primera recomendación. La acción concreta, el impacto en pesos, la justificación del mercado.

Anatomía rápida del card destacado:

  • REC-XXX — id de la recomendación. La buscás en logs después por este id.
  • conf. NN% — score de confianza (verde ≥85, ámbar 70–84, rojo <70).
  • Sugerimos [acción] [Δ%] — la acción concreta: subir, bajar, mantener.
  • Precio actual → precio sugerido — el delta exacto en pesos.
  • Impacto estimado +AR$ X,XM (7d) — variación de margen en pesos para los próximos 7 días, con la elasticidad observada de la categoría.
  • Mercado — qué señal (gap, Hot Sale, OOS, cuotas) disparó la recomendación.

Tres botones, tres caminos:

  • Aplicar reprice — ejecuta el cambio. Si tenés un motor de repricing conectado, va al motor; si no, te muestra el precio nuevo para que lo subas vos.
  • Ver análisis completo — abre la justificación detallada (qué fuentes se consideraron, qué umbral disparó, qué elasticidad asume).
  • Marcar como vista — la viste y decidiste no aplicar. Queda en log con razón opcional. La recomendación no vuelve a aparecer hasta que el contexto del mercado cambie.
LISTO · BUCLE CERRADO

Acabás de cerrar el bucle Captura → Match → Recomendación → Acción. El próximo ciclo arranca automáticamente y la cola se renueva. De acá en más, Prize trabaja solo y vos atendés tu cola del día.

¿Qué viene después?

Tres caminos según qué necesitás resolver primero.

Operacional

  • Configurar Prize — umbrales por categoría, bandas de autonomía, notificaciones.

Integración

Equipo

¿Necesitás ayuda?

  • Demo Prize — sandbox interactivo con datos sintéticos. Recorrelo cuanto quieras antes de cargar tu catálogo real.
  • Onboarding en vivo — 15 minutos con un especialista.
  • Soporte — chat en producto o contacto@prize.solutions.