> ## 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 SFRA Cartridge

## 26.04.0 — 2026-04-28

**Mudanças incompatíveis:**

* A identificação do varejista agora depende de uma nova preferência de site **obrigatória** `kleepRetailerUUID` em vez do host da requisição. Após a atualização, defina-a em **BM > Site Preferences > Kleep** — caso contrário, o rastreamento, o recurso 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 agora está sempre ativa.

**Correções:**

* Removidas informações pessoais identificáveis (PII) de clientes da exportação CSV de pedidos.
* Removida uma coluna vazia extra na exportação CSV de produtos e alinhado o formato de exportação com a especificação de 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. Compartilhado com iFrames para reconciliação de rastreamento interno/externo.
* Suporte para múltiplas categorias: Calçados, Infantil, Lingerie.
* Gerenciador de domínios harmonizado.
* 2 novas preferências personalizadas: mercado do site (KPIs por mercado / personalizações de fluxo) e habilitador de lógica de sessão.
* Confiabilidade de rastreamento aprimorada com acionamentos baseados em postMessage.

## 24.11.2 — 2024-11-12

**Correções:**

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

**Melhorias:**

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

## 24.11.1 — 2024-11-08

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

## 24.11.0 — 2024-11-06

**Correções:**

* Corrigidos dados ausentes da coluna `SFCC_custom_attributes` nas exportações.
* Corrigida a opção de exportação completa do KleepExportOrdersCSV.

**Melhorias:**

* Removido limite de 1000 pedidos na exportação.
* Logging aprimorado para ambos os jobs de exportação.
* Recurso de repetição no KleepExportOrdersCSV para pedidos com falha.

## 24.10.2 — 2024-10-23

* URL do modal de recomendação atualizada.

## 24.10.1 — 2024-10-21

**Melhorias:**

* Exportação inclui todas as variantes/grupos de variação quando pelo menos uma está categorizada. Cota: 20.000 masters.
* Nova coluna CSV `SFCC_Product_VariationGroups_ID`.
* Removida configuração `[BRAND]` não utilizada nas etapas do job.
* Exportação de pedidos filtrada apenas para o status "Exportado".
* Múltiplos CTAs do Kleep suportados em qualquer lugar da PDP. Removido spinner de carregamento do CTA.
* Verificação de estoque em tempo real antes de sugerir um produto. Novo evento `button_clicked`.

**Correções:**

* Corrigida falha do KleepExportOrdersCSV em pedidos 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 do `MainViewType`.

**Novos Recursos:**

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

**Correções:**

* Status do job exibindo "OK" no BM enquanto "ERROR" no backend.
* Bug de criação do `KleepExportDateTracker` em erros de job.
* 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 do pop-up; `kleepLastExported` ausente nos metadados.

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

## 24.8.0 — 2024-08-30

**Correções:** Erros de console na PDP resolvidos.

**Melhorias:** O recurso de Recomendação usa VariationGroups em vez de Masters.

## 24.7.0 — 2024-07-03

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

**Novos Recursos:** Rastreamento de eventos: `product_added_to_cart`, `checkout_completed`, `checkout_validated`.

**Correções:** Compilação de frontend. Falha no job de exportação em objeto personalizado ausente.

## 24.6.0 — 2024-06-10

Versão inicial.