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

# Registro de cambios

> Historial de versiones del Cartucho SFRA

## 26.04.0 — 2026-04-28

**Cambios importantes:**

* La identificación del comerciante ahora depende de una nueva preferencia de sitio **obligatoria** `kleepRetailerUUID` en lugar del host de la solicitud. Tras la actualización, configúrala en **BM > Site Preferences > Kleep** — de lo contrario, el seguimiento, la funcionalidad de Recomendación y el iframe no funcionarán.

**Mejoras:**

* Se añadió contexto de mercado/locale al payload de `/recommend` para la personalización de recomendaciones por mercado.
* Se eliminó la preferencia `isKleepSessionEnabled` — la lógica de UUID de sesión ahora está siempre activa.

**Correcciones:**

* Se eliminó el PII de clientes de la exportación CSV de pedidos.
* Se eliminó una columna vacía adicional en la exportación CSV de productos y se alineó el formato de exportación con la especificación de estructura de datos SFTP.

## 25.09.0 — 2025-09-22

* Nueva lógica de sesión con UUID de sesión único por sesión para KPIs basados en sesión. Compartido con iFrames para la reconciliación de seguimiento interno/externo.
* Soporte para múltiples categorías: Zapatos, Niños, Lencería.
* Gestor de dominios armonizado.
* 2 nuevas preferencias personalizadas: mercado del sitio (KPIs por mercado / personalizaciones de flujo) y habilitador de lógica de sesión.
* Mayor fiabilidad del seguimiento con activadores basados en postMessage.

## 24.11.2 — 2024-11-12

**Correcciones:**

* Nuevo atributo booleano `isKleepExported` para corregir inconsistencias en las consultas de estado de exportación.
* Corrección del objeto vacío serializado en atributos personalizados (ahora cadena vacía).

**Mejoras:**

* Parámetro de tiempo de espera de trabajo personalizado (predeterminado: 900s).
* Parámetro de límite máximo de pedidos (predeterminado: 1000/ejecución).
* Nuevo trabajo de reinicio de pedidos para reexportaciones.
* Los pedidos ahora siempre se exportan en modo delta; los pedidos restantes continúan en la siguiente ejecución.

## 24.11.1 — 2024-11-08

* CTA de PDP localizado: FR, JA, ES, PT (PT/BR), IT, KO, DE (DE/BE), NL.
* Se eliminó el logotipo del CTA de PDP.

## 24.11.0 — 2024-11-06

**Correcciones:**

* Corrección de datos faltantes en la columna `SFCC_custom_attributes` en las exportaciones.
* Corrección de la opción de exportación completa de KleepExportOrdersCSV.

**Mejoras:**

* Se eliminó el límite de exportación de 1000 pedidos.
* Registro mejorado para ambos trabajos de exportación.
* Función de reintento en KleepExportOrdersCSV para pedidos fallidos.

## 24.10.2 — 2024-10-23

* URL del modal de recomendación actualizada.

## 24.10.1 — 2024-10-21

**Mejoras:**

* La exportación incluye todas las variantes/grupos de variación cuando al menos uno está categorizado. Cuota: 20.000 maestros.
* Nueva columna CSV `SFCC_Product_VariationGroups_ID`.
* Se eliminó la configuración `[BRAND]` no utilizada en los pasos del trabajo.
* Exportación de pedidos filtrada solo al estado «Exportado».
* Múltiples CTA de Kleep compatibles en cualquier lugar de la PDP. Se eliminó el spinner de carga del CTA.
* Verificación de inventario en tiempo real antes de sugerir un producto. Nuevo evento `button_clicked`.

**Correcciones:**

* Corrección del fallo de KleepExportOrdersCSV en pedidos con notas.

## 24.10.0 — 2024-10-07

**Mejoras:**

* Compatibilidad con API 21.2 para URL del modal de recomendación.
* Tamaño de fragmento de exportación de 1000→100, limpieza de líneas vacías/duplicadas, mejores registros, auto-recorte de `MainViewType`.

**Nuevas funcionalidades:**

* Parámetro `ExportType` (Delta/Completo) sin eliminar CustomObject.
* Nombres/IDs de categorías en la exportación de productos.

**Correcciones:**

* Estado del trabajo que mostraba «OK» en BM mientras era «ERROR» en el backend.
* Error de creación de `KleepExportDateTracker` en errores de trabajo.
* La exportación incluye variantes de grupos de variación cuando los maestros no están categorizados.

## 24.9.0 — 2024-09-25

**Correcciones:** AddToCart desde la ventana emergente; `kleepLastExported` faltante en los metadatos.

**Mejoras:** Compatibilidad de KleepExportProductsCSV con API de SFCC 21.2.

## 24.8.0 — 2024-08-30

**Correcciones:** Resolución de errores de consola en PDP.

**Mejoras:** La funcionalidad de Recomendación usa VariationGroups en lugar de Masters.

## 24.7.0 — 2024-07-03

**Mejoras:** Exportación delta por fecha `lastModified`. URLs de imagen absolutas en el seguimiento. Llamadas de API optimizadas.

**Nuevas funcionalidades:** Seguimiento de eventos: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Correcciones:** Compilación del frontend. Fallo de exportación del trabajo en objeto personalizado faltante.

## 24.6.0 — 2024-06-10

Versión inicial.
