- O Histórico de Alterações guarda cada mudança feita nos seus produtos: qual campo mudou, o valor antes, o valor depois, a data, quem fez e de onde veio (painel, integração, pedido).
- Responde perguntas como "quem mudou o preço deste produto?", "por que este produto saiu do site?" ou "por que o estoque não bate com o meu sistema?".
- Também registra o estoque que entra e sai por pedidos (vendas, cancelamentos e reembolsos), com o número do pedido.
- Funciona no painel administrativo da loja virtual Magento 1. O cliente final não vê nada disso.
Passo a Passo por Escrito
1. Acesse as configurações do histórico
No painel administrativo, acesse Sistema → Configuração → Catálogo → Catálogo. Role a página até o fim e clique no grupo Histórico de Produtos para abri-lo.
Resultado esperado: o grupo Histórico de Produtos se abre com os campos de configuração do histórico.
2. Confira se o registro está ligado
No campo Registrar alterações de produtos, confira se está selecionado Sim.
O histórico já vem ligado. Você só precisa mexer neste campo se quiser parar de registrar. Desligar para de gravar novas alterações, mas não apaga o que já foi registrado.
Resultado esperado: o campo mostra Sim e os demais campos do grupo aparecem logo abaixo.
3. Defina por quanto tempo manter o histórico
No campo Manter o histórico por (dias), informe por quantos dias as alterações devem ficar guardadas. O valor vai de 30 a 365. O padrão é 180.
Todo dia, de madrugada, a loja apaga sozinha o que passou desse prazo. Exemplo: com 180, o histórico guarda sempre os últimos 180 dias.
O que a limpeza automática apaga sai de vez, sem lixeira. Se você precisar guardar mais de 1 ano de histórico, exporte o CSV periodicamente (passo 9).
Toda mudança neste prazo fica registrada em Limpezas do Histórico, com o usuário que alterou.
Resultado esperado: o campo mostra o número de dias escolhido, entre 30 e 365.
4. Escolha de onde vêm as alterações registradas (opcional)
No campo Origens registradas, marque de onde vêm as alterações que devem entrar no histórico. Segure Ctrl (ou Cmd no Mac) para marcar mais de uma opção:
- Painel: alterações feitas por usuários no painel administrativo.
- API: alterações feitas por integrações que usam a API da loja (ERP, hub).
- Cron: alterações feitas pelas tarefas automáticas agendadas da loja.
- Script: alterações feitas por programas de integração que rodam no servidor.
- Requisição externa: alterações recebidas de outros sistemas, como retornos de marketplace.
- Pedido: estoque que entra e sai por vendas, cancelamentos e reembolsos.
Por padrão, todas as origens já vêm marcadas. Recomendamos manter assim.
Resultado esperado: as origens desejadas aparecem selecionadas na lista.
5. Escolha os campos que não devem entrar no histórico (opcional)
No campo Campos ignorados, marque os campos que você não quer acompanhar. Segure Ctrl (ou Cmd no Mac) para marcar ou desmarcar mais de um.
Use este campo para campos de controle que mudam sozinhos a cada sincronização da sua integração e só ocupam espaço no histórico.
Os campos de controle mais comuns já vêm marcados. Na dúvida, deixe o campo registrando: é melhor ter o histórico e não precisar do que precisar e não ter.
Resultado esperado: os campos escolhidos aparecem selecionados na lista.
6. Salve e atualize o cache
Clique em Salvar, no topo da página. Depois acesse Sistema → Cache, clique em Marcar Todos, escolha Atualizar em Ações e clique em Enviar.
As alterações na configuração só passam a valer depois de atualizar o cache da loja (memória temporária da loja).
Resultado esperado: a mensagem "A configuração foi salva" aparece no topo da tela e o cache aparece como atualizado.
7. Consulte o histórico de um produto
Acesse Catálogo → Gerenciar Produtos e abra um produto. No menu lateral, clique na última aba, Histórico de Alterações.
Cada linha mostra a Data, o Campo alterado, o valor Antes, o valor Depois, a Origem e o Usuário. Textos longos e listas (categorias, imagens) aparecem resumidos. Clique em ver alteração completa ou ver lista completa para abrir a comparação: o que saiu aparece em vermelho e o que entrou, em verde.
Na coluna Origem, as alterações feitas por pedido mostram o motivo e o número do pedido. Exemplo: Venda — pedido #100000391 · Checkout da loja.
Resultado esperado: a aba mostra as alterações do produto, da mais recente para a mais antiga.
8. Consulte o histórico de todos os produtos
Acesse Catálogo → Histórico de Alterações (Todos os Produtos). A tela mostra as alterações de todos os produtos da loja, com a coluna SKU para identificar cada um.
Use os filtros no topo das colunas para encontrar o que procura: período (De / Até), SKU, Campo, Origem, Usuário ou um valor de Antes / Depois. Clique em Filtrar para aplicar e em Limpar Filtros para voltar a ver tudo.
Produtos excluídos continuam aparecendo nesta tela, com o SKU, na linha Produto excluído.
Resultado esperado: a lista mostra só as alterações que batem com os filtros preenchidos.
9. Exporte o histórico em CSV (opcional)
Na tela de todos os produtos ou na aba do produto, preencha os filtros que quiser e clique em Exportar CSV. O arquivo é montado em partes e baixado ao final.
O arquivo abre direto no Excel, com acentos e colunas separadas.
A exportação leva o que os filtros estão mostrando. Sem filtro, exporta todo o histórico. Para históricos muito grandes, filtre por período.
Resultado esperado: o navegador baixa um arquivo CSV com as alterações filtradas.
10. Limpe o histórico (opcional)
Há duas formas de limpar o histórico manualmente:
- Um produto: na aba Histórico de Alterações do produto, clique no botão Limpar Histórico.
- Todos os produtos: em Sistema → Configuração → Catálogo → Catálogo → Histórico de Produtos, use o campo Limpar Histórico Agora.
Na janela que abrir, escolha entre apagar o que tem mais de X dias ou todo o histórico. A janela mostra quantas alterações vão sair. Digite APAGAR no campo de confirmação, clique em Apagar e confirme em Sim, apagar.
O que for apagado sai do histórico na hora e fica 30 dias na lixeira, apenas para download em CSV. Depois desse prazo, é apagado de vez e não pode ser recuperado.
Se você fechar a janela no meio da limpeza, ela continua sozinha em até 5 minutos.
Resultado esperado: a janela mostra o progresso e, ao final, até quando o conteúdo apagado fica disponível na lixeira.
11. Acompanhe as limpezas e baixe o que foi apagado (opcional)
Acesse Catálogo → Histórico de Alterações (Todos os Produtos) e role até a lista Limpezas do Histórico. Ela mostra todas as limpezas feitas, manuais e automáticas, e as mudanças no prazo de manter o histórico, com data, quantidade apagada, usuário e IP.
Na coluna Lixeira, clique em Baixar para salvar em CSV exatamente o que aquela limpeza apagou.
Esta lista não pode ser apagada. Ela mostra sempre quem limpou o histórico e quando.
Resultado esperado: a lista mostra as limpezas feitas e o link Baixar nas que ainda estão dentro dos 30 dias. Nas mais antigas, aparece Expirado.
12. Defina quem pode ver e limpar o histórico (opcional)
Acesse Sistema → Permissões → Nível de Acesso e abra o nível de acesso do usuário. Clique na aba de recursos, a que mostra a lista de permissões do painel. Dentro de Catálogo, há duas permissões:
- Histórico de Alterações: permite ver o histórico, exportar e baixar a lixeira.
- Limpar Histórico: permite apagar o histórico.
Salve o nível de acesso.
Níveis de acesso com acesso total já têm as duas permissões. Para que um usuário veja o histórico mas não possa apagá-lo, deixe Limpar Histórico desmarcado.
Resultado esperado: os usuários desse nível de acesso passam a ver (ou deixam de ver) o menu do histórico e o botão Limpar Histórico, conforme as permissões marcadas.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Alteração feita pelo painel
Ação: abra um produto de teste, altere o nome e o preço e clique em Salvar. Abra o produto de novo e clique na aba Histórico de Alterações.
Resultado esperado: a aba mostra duas linhas, uma para o nome e outra para o preço, com o valor antes, o valor depois, a origem Painel e o seu usuário.
Teste 2 — Salvar sem alterar nada
Ação: abra o mesmo produto e clique em Salvar sem mudar nenhum campo. Confira a aba Histórico de Alterações.
Resultado esperado: nenhuma linha nova aparece. O histórico só registra o que mudou de verdade.
Teste 3 — Estoque zerado
Ação: em um produto de teste com quantidade 1, mude a quantidade para 0 e salve. Confira a aba Histórico de Alterações.
Resultado esperado: aparecem as linhas Estoque: quantidade (de 1 para 0) e Estoque: disponibilidade (de Em estoque para Fora de estoque).
Teste 4 — Venda pela loja
Ação: faça um pedido de teste pela loja com um produto que tenha estoque. Abra o produto e confira a aba Histórico de Alterações.
Resultado esperado: aparece a linha Estoque: quantidade, com origem Pedido e o detalhe Venda — pedido #[número] · Checkout da loja.
Teste 5 — Se algo não funcionar
Ação: se alguma alteração não apareceu no histórico, confira os itens abaixo.
Se não funcionar, verifique:
- Se Registrar alterações de produtos está como Sim.
- Se a origem da alteração está marcada em Origens registradas (por exemplo, Pedido para as vendas).
- Se o campo alterado não está marcado em Campos ignorados.
- Se o cache da loja foi atualizado depois de salvar a configuração.
Resultado esperado: depois de corrigir a configuração e atualizar o cache, as novas alterações passam a aparecer no histórico.
Pronto! Dessa forma realizamos a configuração do Histórico de Alterações de Produtos em sua loja virtual Magento 1.
Observações Importantes
- Configuração única para a loja toda: as opções do histórico valem para todos os sites e visões de loja. Não há configuração diferente por visão de loja.
- Alterações por visão de loja: em lojas com mais de uma visão de loja, a coluna Visão de loja mostra em qual delas o campo mudou. Quando uma visão de loja volta a usar o valor padrão, aparece (voltou a usar o valor padrão).
- O histórico começa a contar a partir da instalação: alterações feitas antes do histórico estar ativo na sua loja não aparecem.
- Importações direto no banco de dados não aparecem: algumas ferramentas de importação gravam os dados sem passar pela loja. Essas alterações não ficam registradas.
- Opções com o nome atual: se uma opção de atributo ou uma categoria for renomeada, o histórico mostra o nome novo também nas alterações antigas.
- A aba só aparece em produtos já criados: ao cadastrar um produto novo, a aba aparece depois do primeiro salvamento.
- Atualizações em massa: ao alterar atributos ou status de vários produtos de uma vez, cada produto ganha a sua própria linha no histórico.
Referências e Relacionados
- Limpeza de cache da loja: as mudanças na configuração do histórico só valem depois de atualizar o cache. Aprenda a atualizar o cache da sua loja
- Permissões e níveis de acesso dos usuários do painel: defina quem pode ver e quem pode limpar o histórico.
- Gerenciamento de estoque dos produtos: entenda os campos de quantidade e disponibilidade que aparecem no histórico.
- Credenciais de API para integrações: as alterações feitas por ERP e hub aparecem com o usuário de API cadastrado para cada integração.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br