> ## 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.

# Changelog

> Histórico de versões do Cartridge SFRA

## 26.04.0 — 2026-04-28

**Alterações incompatíveis:**

* A identificação do retalhista passa agora a depender de uma nova preferência de site **obrigatória** `kleepRetailerUUID` em vez do host do pedido. Após a atualização, defina-a em **BM > Site Preferences > Kleep** — caso contrário, o tracking, a funcionalidade de Recomendação e o iframe não funcionarão.

**Melhorias:**

* Adicionado contexto de mercado/locale ao payload `/recommend` para personalização de recomendações por mercado.
* Removida a preferência `isKleepSessionEnabled` — a lógica de UUID de sessão está agora sempre ativa.

**Correções:**

* Removidos dados pessoais de clientes da exportação CSV de encomendas.
* Removida uma coluna vazia extra na exportação CSV de produtos e alinhado o formato de exportação com a especificação da estrutura de dados SFTP.

## 25.09.0 — 2025-09-22

* Nova lógica de sessão com UUID de sessão único por sessão para KPIs baseados em sessão. Partilhado com iFrames para reconciliação de tracking interno/externo.
* Suporte para múltiplas categorias: Calçado, Infantil, Lingerie.
* Gestor de domínios harmonizado.
* 2 novas preferências personalizadas: mercado do site (KPIs por mercado / personalizações de fluxo) e ativador de lógica de sessão.
* Fiabilidade de tracking melhorada com triggers baseados em postMessage.

## 24.11.2 — 2024-11-12

**Correções:**

* Novo atributo booleano `isKleepExported` para corrigir inconsistências na consulta do estado de exportação.
* Corrigido objeto vazio em string nos atributos personalizados (agora string vazia).

**Melhorias:**

* Parâmetro de timeout personalizado do job (padrão: 900s).
* Parâmetro de limite máximo de encomendas (padrão: 1000/execução).
* Novo job de reinicialização de encomendas para re-exportações.
* As encomendas são agora sempre exportadas em modo delta; as encomendas restantes continuam na próxima execução.

## 24.11.1 — 2024-11-08

* CTA PDP localizado: FR, JA, ES, PT (PT/BR), IT, KO, DE (DE/BE), NL.
* Removido logótipo do CTA PDP.

## 24.11.0 — 2024-11-06

**Correções:**

* Corrigidos dados em falta na coluna `SFCC_custom_attributes` nas exportações.
* Corrigida a opção de exportação completa KleepExportOrdersCSV.

**Melhorias:**

* Removido limite de exportação de 1000 encomendas.
* Logging melhorado para ambos os jobs de exportação.
* Funcionalidade de repetição no KleepExportOrdersCSV para encomendas com falha.

## 24.10.2 — 2024-10-23

* URL do modal de recomendação atualizado.

## 24.10.1 — 2024-10-21

**Melhorias:**

* A exportação inclui todas as variantes/grupos de variação quando pelo menos uma está categorizada. Quota: 20.000 masters.
* Nova coluna CSV `SFCC_Product_VariationGroups_ID`.
* Removida configuração `[BRAND]` não utilizada nos passos do job.
* Exportação de encomendas filtrada apenas para o estado "Exported".
* Múltiplos CTAs Kleep suportados em qualquer lugar no PDP. Removido spinner de carregamento do CTA.
* Verificação de inventário em tempo real antes de sugerir um produto. Novo evento `button_clicked`.

**Correções:**

* Corrigida falha do KleepExportOrdersCSV em encomendas com notas.

## 24.10.0 — 2024-10-07

**Melhorias:**

* Compatibilidade com API 21.2 para URL do modal de recomendação.
* Tamanho do chunk de exportação 1000→100, limpeza de linhas vazias/duplicadas, melhores logs, auto-trim de `MainViewType`.

**Novas Funcionalidades:**

* Parâmetro `ExportType` (Delta/Full) sem eliminar CustomObject.
* Nomes/IDs de categorias na exportação de produtos.

**Correções:**

* Estado do job a mostrar "OK" no BM enquanto "ERROR" no backend.
* Bug de criação do `KleepExportDateTracker` em erros do job.
* A exportação inclui variantes de grupos de variação quando os masters não estão categorizados.

## 24.9.0 — 2024-09-25

**Correções:** AddToCart a partir do pop-up; `kleepLastExported` em falta nos metadados.

**Melhorias:** Compatibilidade do KleepExportProductsCSV com a API SFCC 21.2.

## 24.8.0 — 2024-08-30

**Correções:** Resolvidos erros de consola no PDP.

**Melhorias:** A funcionalidade de Recomendação utiliza VariationGroups em vez de Masters.

## 24.7.0 — 2024-07-03

**Melhorias:** Exportação delta por data `lastModified`. URLs absolutas de imagens no tracking. Chamadas de API otimizadas.

**Novas Funcionalidades:** Tracking de eventos: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Correções:** Compilação frontend. Falha na exportação do job por objeto personalizado em falta.

## 24.6.0 — 2024-06-10

Versão inicial.