Logs de produtos: como rastrear alterações nos cadastros de produtos no ERP

Coluna	Descrição
Data	Data em que a ação foi realizada.
Horário	Horário em que a ação ocorreu.
Origem	Identifica de onde partiu a ação que alterou o produto.
Usuário	Identifica o usuário responsável pela ação.
Ação	Indica se o produto foi criado, editado ou excluído.
Descrição	Apresenta informações adicionais sobre a ação realizada, conforme sua origem.

Como funciona cada coluna?

1. Coluna Origem

A coluna Origem indica de onde partiu a ação responsável pela alteração no cadastro do produto.

Alguns exemplos de origem são:

• Manual: alterações realizadas diretamente por um usuário no ERP;
• Planilha: alterações realizadas por meio da importação de planilhas;
• Multiempresa: alterações originadas por operações entre empresas vinculadas;
• Sistema: ações executadas automaticamente pelo ERP;
• Integração: alterações originadas por integrações com plataformas externas;
• API: alterações realizadas por meio de requisições à API do ERP.

A origem permite entender se a alteração foi realizada diretamente no cadastro ou se ocorreu como consequência de outra operação.

2. Coluna Usuário

A coluna Usuário identifica quem realizou a ação que resultou na alteração do produto.

Esse usuário pode ter realizado a alteração diretamente no cadastro ou executado outra operação que modificou o produto indiretamente.

Os registros podem identificar diferentes tipos de usuários, como usuários da conta e usuários de suporte, conforme o responsável pela ação.

3. Coluna Ação

A coluna Ação indica o tipo de operação registrada no produto:

• Criação: quando um novo produto é cadastrado;
• Atualização: quando um produto existente é alterado;
• Exclusão: quando ocorre a exclusão de um produto.

4. Coluna Descrição

A coluna Descrição apresenta informações adicionais para ajudar a entender o que motivou a alteração no produto.

O nível de detalhamento depende de como a ação foi realizada.

Alterações realizadas diretamente no cadastro: Quando um usuário acessa o cadastro de um produto, realiza uma edição e salva as informações, o ERP registra a ação com a descrição:

"Produto salvo pela tela de cadastro": Isso significa que o produto foi salvo diretamente pela tela de cadastro, mas não indica quais campos foram modificados.

Atualmente, os logs não apresentam o detalhamento individual dos campos alterados manualmente nessa tela.

Alterações realizadas por ações indiretas: Quando um produto é alterado como consequência de outra operação no ERP, a descrição pode apresentar informações mais específicas sobre o que gerou a alteração.

Isso inclui ações como importação de planilhas, atualizações por integrações, operações por API e alterações em outros cadastros que impactam o produto.

Dessa forma, é possível identificar com mais detalhes a operação que originou a modificação.

---

Por quanto tempo os logs ficam disponíveis?

Os logs de produtos ficam disponíveis para consulta por 30 dias. Após esse período, os registros mais antigos são excluídos automaticamente do sistema.

Por exemplo, no dia 14 de outubro, é possível consultar os logs registrados a partir de 14 de setembro. Os registros de 13 de setembro e datas anteriores já terão sido excluídos.

Essa limitação tem como objetivo preservar a performance do ERP, evitando o acúmulo excessivo de dados e garantindo mais eficiência nas consultas e no gerenciamento dos produtos.

---

Exemplos de funcionamento

1. Edição manual de produto

Quando um usuário acessa o cadastro de um produto, altera uma informação e salva, o sistema registra:

• O usuário responsável;
• A data e o horário da ação;
• A origem manual;
• A ação de edição;
• A descrição "Produto salvo pela tela de cadastro".

Importante: nesse caso, o log não informa exatamente quais campos foram alterados, apenas que o produto foi salvo pela tela de cadastro.

2. Atualização por importação de planilha

Quando um usuário importa uma planilha que atualiza informações de produtos, o sistema registra a operação e identifica a origem como planilha.

A descrição pode apresentar informações sobre a operação que gerou a atualização.

3. Atualização de produto por integração

Imagine que um usuário importe um anúncio de um canal de venda e selecione a opção de atualizar o cadastro do produto com as informações desse anúncio.

Nesse caso, a alteração não foi realizada diretamente na tela de cadastro do produto, mas como consequência de uma operação de integração.

O log permite identificar a origem da atualização e apresentar uma descrição mais detalhada sobre a ação que modificou o produto.

4. Exclusão de categoria vinculada ao produto

Algumas alterações podem ocorrer indiretamente, mesmo sem que o usuário acesse o cadastro do produto.

Por exemplo, quando um usuário acessa a central de categorias e exclui uma categoria que estava vinculada a determinados produtos.

Nesse cenário, os produtos são modificados porque a categoria excluída deixa de estar vinculada a eles.

O ERP registra essa alteração nos logs dos produtos impactados, permitindo identificar que a modificação foi consequência da exclusão da categoria.

5. Alterações por processos automáticos

Quando uma rotina automática do ERP realiza uma ação que modifica o cadastro de um produto, a alteração também pode ser registrada.

O histórico permite identificar a origem da operação e consultar as informações disponíveis sobre a ação realizada.

---

Perguntas frequentes — Logs de produtos

Como habilitar a permissão para um usuário?

Para permitir que um usuário visualize os logs de produtos:

1. Acesse Menu > Configurações > Configurações ERP > aba Geral > Cadastro de usuários do sistema.
2. Abra o cadastro do usuário desejado.
3. Acesse Permissões e ações > Editar permissões adicionais > aba Cadastros
4. Localize e habilite a permissão Logs de atualização de produto.
5. Salve as alterações.

Observação: após o ajuste, o usuário deverá sair e entrar novamente no ERP para que a nova permissão seja aplicada.

É possível identificar exatamente quais informações foram alteradas no produto?

Depende da origem da alteração.

Quando a edição é realizada diretamente pela tela de cadastro, o sistema registra a descrição "Produto salvo pela tela de cadastro", sem detalhar quais campos foram modificados.

Já nas alterações indiretas, como importações, integrações e outras operações do ERP, a descrição pode apresentar informações mais detalhadas sobre a ação que originou a mudança.

Por que aparece "Produto salvo pela tela de cadastro" na descrição?

Essa informação indica que um usuário acessou a tela de cadastro do produto e salvou as informações.

O registro identifica a operação realizada, mas não apresenta o histórico individual dos campos editados nessa tela.

Uma alteração realizada fora do cadastro do produto também gera log?

Sim. Ações realizadas em outros módulos ou cadastros do ERP também podem gerar logs quando resultam em alterações nos produtos.

Um exemplo é a exclusão de uma categoria na central de categorias, que provoca a desvinculação dessa categoria dos produtos associados.

Os logs registram apenas alterações manuais?

Não. Os logs contemplam ações manuais e alterações originadas por processos externos ou automáticos, como planilhas, integrações, APIs e rotinas do ERP.

Os logs alteram alguma informação dos produtos?

Não. A funcionalidade tem como objetivo apresentar o histórico das ações realizadas, sem modificar as informações cadastradas nos produtos.

Posso consultar logs de produtos com mais de 30 dias?

Não. Os registros ficam disponíveis por até 30 dias e são excluídos automaticamente após esse período.

A exclusão é realizada para otimizar o armazenamento de informações e preservar o desempenho do seu ERP.