Docs

Sincronización

Mantener tu catálogo en Prize en sync con tu sistema fuente día a día. Tres modos según latencia, granularidad y complejidad. Importar SKUs cubre el flow inicial; esta página es la operación en curso.

Tres modos de sync

| Modo | Latencia | Granularidad | Complejidad | Ideal para | |------|---------|-------------|------------|-----------| | Full reimport CSV | Minutos | Todo el catálogo | Baja | Refresh diario simple, integración manual. | | API incremental | Segundos | Por SKU | Media | Integración programática con ERP/PIM. | | Webhook entrante | Inmediato | Por evento | Alta | Catálogos vivos. Cambios en tiempo real (Hot Sale, lanzamientos). |

Qué pasa durante un sync

Sync no detiene la operación. Los ciclos siguen, las recomendaciones siguen, pero los cambios se aplican según la naturaleza del campo modificado.

  • ¿Pausa ciclos? No. Los ciclos en curso terminan con la data que tenían cuando arrancaron.
  • Matches confirmados se preservan si el SKU sigue identificable (mismo EAN o mismo modelo + marca). Si cambió un atributo crítico, el match cae a MEDIA.
  • Recomendaciones en cola se invalidan si el SKU cambió de precio o atributos críticos. Se regeneran en el siguiente ciclo.
  • Auditoría: cada sync queda registrado. Quién (usuario o token API), cuándo, qué cambió, cuántas filas.

Frecuencia recomendada

| Tipo de cambio | Frecuencia | Modo recomendado | |---------------|-----------|-----------------| | Precio | Diario o cada vez que cambia | API incremental o Webhook | | SKUs nuevos | Semanal | API batch o CSV | | SKUs descontinuados | En el momento | API DELETE o Webhook | | Margen | Mensual o por lista nueva | CSV (campo amplio) | | Volumen | Trimestral | CSV (re-clasificación masiva) | | Categorías y atributos | Casi nunca | API individual o CSV partial |

Conflictos

  • Sync mientras un usuario edita — last-write-wins por default. La última operación gana. Si tu equipo edita manualmente con frecuencia, considerá pausar sync automático en horario laboral.
  • Sync en medio de un ciclo — los cambios no afectan el ciclo en curso. Entran al siguiente.
  • Sync con error parcial — Prize trata cada batch como transacción. Si cualquier fila falla validación, ninguna del batch se aplica.
  • Webhook fuera de orden — usá updated_at en el payload. Prize descarta eventos más viejos que el último aplicado.

Log y auditoría

Historial completo en Configuración → Catálogo → Sincronización:

  • Timestamp — cuándo se aplicó.
  • Modo — CSV / API / Webhook.
  • Origen — usuario humano o token API (con etiqueta).
  • Resultado — filas creadas / updateadas / eliminadas / con error.
  • Errores — si los hubo, con código y fila afectada.

Exportable a CSV. Filtrable por modo, origen, rango de fechas y resultado.

TIP · ROLLBACK

Cada sync queda como un punto de restauración por 30 días. Si una sync masiva sale mal (CSV con datos rotos pasó la validación), un Founder puede revertir al estado anterior desde el log. Después de 30 días los puntos se descartan.

Próximos pasos