20/01/2026

Novo Módulo – Limpeza Automática de Movimentação de Estoque

Patch Notes – Limpeza Automática de Movimentação de Estoque

Descrição da atualização

Disponibilizamos o módulo Limpeza Automática de Movimentações de Estoque, desenvolvido para realizar a exclusão controlada de registros antigos da tabela movimentações de estoque, evitando crescimento excessivo do banco de dados em lojas com alto volume de pedidos e movimentações de estoque.

O módulo atua de forma automática, segura e configurável, respeitando o período de retenção definido no painel administrativo e garantindo que apenas movimentações mais antigas sejam removidas, sem impacto na operação diária da loja.

A solução foi projetada especialmente para ambientes com grande fluxo, utilizando exclusão em lotes para reduzir riscos de lentidão, locks prolongados e sobrecarga no banco de dados.

O que o módulo faz

• Realiza a limpeza automática da tabela de movimentações de estoque;

• Remove apenas registros mais antigos do que o período configurado;

• Executa a exclusão de forma gradual (em lotes), evitando impacto no banco;

• Funciona através de cron (agendamento), sem necessidade de intervenção manual;

• Respeita integralmente as configurações definidas no painel;

• Não altera a estrutura da tabela nem interfere no módulo de origem.

Funcionamento da limpeza

O módulo executa periodicamente um cron que segue o fluxo abaixo:

1. Verifica se a limpeza automática está habilitada no painel;

2. Lê o período de retenção configurado (em dias);

3. Calcula a data limite com base nesse período;

4. Identifica registros com data de criação anterior à data limite;

5. Remove os registros antigos em lotes controlados, evitando exclusões massivas de uma só vez;

6. Encerra automaticamente quando não há mais registros elegíveis ou quando atinge o limite de segurança por execução.

Esse processo garante que somente movimentações fora do período de retenção sejam excluídas, preservando totalmente os dados recentes.

Onde fica

Sistema → Configuração → Catálogo → Estoque → Controle de Estoque

Configurações disponíveis (resumo)

Ativar limpeza automática de movimentações de estoque:
Ativa ou desativa a execução automática do cron de limpeza.

Período de retenção (dias):
Define por quantos dias as movimentações de estoque devem ser mantidas no banco.
Registros mais antigos do que esse período serão removidos automaticamente.

Exemplo:

• Valor 35 → remove movimentações com mais de 35 dias.

Principais vantagens

• Performance do banco: evita crescimento descontrolado da tabela de movimentações;

• Execução segura: exclusão feita em lotes, reduzindo riscos de lock e lentidão;

• Totalmente automatizado: não exige limpeza manual ou scripts externos;

• Configuração simples: todo o controle é feito via painel administrativo;

• Compatível com alto volume: projetado para lojas com grande fluxo de pedidos;

• Não invasivo: não altera estrutura de tabelas nem impacta outros módulos.

Observações importantes

• O módulo não altera a estrutura da tabela, apenas remove registros antigos conforme configuração;

• Apenas registros com data mais antiga que o período configurado são excluídos;

• Movimentações recentes permanecem intactas;

• A limpeza ocorre via cron, conforme agendamento padrão do sistema;

• Em bases muito grandes, a exclusão pode ser distribuída ao longo de múltiplas execuções, garantindo estabilidade;

• O módulo atua exclusivamente como rotina de manutenção de dados, sem interferir em regras de estoque, pedidos ou integrações.