# DataFirefly Specific Price Cleaner: limpar preços específicos expirados, duplicados e órfãos

> Instalação Instale o módulo em Módulos > Gestor de módulos > Enviar um módulo, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas e acrescenta o separador…

- Página: <https://www.datafirefly.com/pt/documentation/dfspecificpricecleaner/>
- Idioma: pt
- Atualizado em: 2026-11-16
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dfspecificpricecleaner/index.md), [en](https://www.datafirefly.com/en/documentation/dfspecificpricecleaner/index.md), [es](https://www.datafirefly.com/es/documentation/dfspecificpricecleaner/index.md), [de](https://www.datafirefly.com/de/documentation/dfspecificpricecleaner/index.md), [it](https://www.datafirefly.com/it/documentation/dfspecificpricecleaner/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfspecificpricecleaner/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfspecificpricecleaner/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Instalação

Instale o módulo em **Módulos > Gestor de módulos > Enviar um módulo**, enviando o ficheiro ZIP. Na instalação, o módulo cria as suas tabelas e acrescenta o separador **Catálogo > Limpeza de preços específicos**. A instalação não altera nenhum preço.

Para atualizar a partir da 1.0.x, basta enviar o novo ZIP. O histórico e as cópias da 1.0.x são mantidos, assim como as definições da tarefa cron (ativação, modo, frequência). Abra o separador **Agendamento** após a atualização para verificar se lhe convêm.

## O painel

A página **Saúde** analisa a tabela de preços específicos, em todo o catálogo ou num âmbito escolhido (loja, categoria, ID de produto). Mostra:

- o número de preços específicos, incluindo os ativos neste momento;
- o número de linhas que se podem limpar sem risco com a limpeza por defeito (expirados, duplicados, órfãos);
- o que nunca é apagado por defeito: preços ligados a um carrinho ativo, regras de preços do catálogo, preços futuros, preços sem data de fim, preços usados por outro módulo;
- o detalhe por categoria de problema, com as linhas elimináveis e protegidas de cada uma;
- os conflitos de prioridade e as regras de catálogo expiradas, para rever à mão;
- o tamanho atual da tabela, medido pela base de dados.

![Painel de saúde dos preços específicos: linhas a limpar, categorias de problemas e proteções](https://www.datafirefly.com/wp-content/uploads/2026/11/painel-saude-precos-especificos-dfspecificpricecleaner-pt.webp)

O painel indica quantas linhas a menos a tabela terá após a limpeza. O efeito na velocidade das páginas depende da sua loja: o módulo não o mede.

## O assistente de limpeza em 6 passos

Clique em **Iniciar o assistente de limpeza**. Os passos são: Escolher, Simular, Verificar, Guardar, Limpar, Relatório. Nada é apagado antes do passo Limpar.

### 1. Escolher

Assinale as categorias a limpar. Cada contador indica as linhas que seriam apagadas com as proteções ativas. Defina o prazo dos preços expirados (por exemplo, expirados há pelo menos 7 dias) e o dos carrinhos terminados. As **proteções** ficam assinaladas por defeito; desmarque uma só se souber exatamente porque uma linha deve sair. Os **filtros avançados** limitam a limpeza a uma loja, uma categoria, ID de produto, um cliente, um grupo, um país, uma moeda, um tipo de valor ou uma data de expiração.

![Assistente de limpeza, etapa 1: escolher as categorias, proteções e filtros avançados](https://www.datafirefly.com/wp-content/uploads/2026/11/assistente-limpeza-escolher-categorias-dfspecificpricecleaner-pt.webp)

### 2. Simular

**Executar a simulação** calcula o plano sem apagar nada: linhas previstas e protegidas por categoria. O plano fica congelado: só essas linhas poderão ser apagadas. Uma linha que corresponde a várias categorias é planeada uma só vez, na primeira. Pode exportar o plano em CSV.

![Resultado da simulação: linhas previstas e protegidas por categoria, nada eliminado](https://www.datafirefly.com/wp-content/uploads/2026/11/simulacao-limpeza-precos-especificos-dfspecificpricecleaner-pt.webp)

### 3. Verificar

A lista das linhas previstas mostra, para cada uma, o produto, o alvo, o valor, o período e os sinais úteis. Desmarque uma linha para a manter: uma linha excluída nunca é apagada.

![Verificação linha a linha do plano fixado, cada linha pode ser excluída](https://www.datafirefly.com/wp-content/uploads/2026/11/verificacao-linhas-antes-eliminar-dfspecificpricecleaner-pt.webp)

### 4. Guardar

**Criar a cópia** copia cada linha prevista, coluna a coluna, para o histórico do módulo. Pode descarregar esta cópia em CSV antes de continuar. Se a cópia estiver desativada nas definições, o módulo indica-o claramente: a eliminação será definitiva.

![Cópia de segurança completa das linhas previstas antes de eliminar, descarregável em CSV](https://www.datafirefly.com/wp-content/uploads/2026/11/copia-seguranca-antes-limpeza-dfspecificpricecleaner-pt.webp)

### 5. Limpar

Assinale **Verifiquei a simulação e quero eliminar estas N linhas.** e clique em **Eliminar N linhas**. Sem cópia, também é preciso escrever o número de linhas. A eliminação avança por lotes, cada um na sua própria transação, e cada linha é verificada de novo mesmo antes de ser apagada: uma linha ligada entretanto a um carrinho, regenerada por uma regra ou usada por um módulo é ignorada. Pode pausar e retomar.

![Confirmação explícita antes da limpeza em lotes transacionais com retoma](https://www.datafirefly.com/wp-content/uploads/2026/11/confirmacao-explicita-limpeza-dfspecificpricecleaner-pt.webp)

### 6. Relatório

O relatório dá, por categoria, as linhas previstas, apagadas, ignoradas, excluídas e protegidas, e a duração. Mostra também o que foi feito após a limpeza: caches de preços do PrestaShop limpas e índice de preços da pesquisa facetada atualizado para os produtos afetados. A partir do relatório pode restaurar, descarregar a cópia ou o relatório detalhado em CSV, ou enviar-se o relatório por e-mail.

![Relatório de limpeza por categoria, caches de preços esvaziadas e restauro em 1 clique](https://www.datafirefly.com/wp-content/uploads/2026/11/relatorio-limpeza-precos-especificos-dfspecificpricecleaner-pt.webp)

Se o separador for fechado ou o servidor parar durante a limpeza, nada fica a meio. O painel mostra a limpeza inacabada com **Abrir e retomar**, ou pode abandonar o resto.

## Categorias de limpeza

- **Preços expirados**: a data de fim já passou, estes preços já não se aplicam a ninguém.
- **Duplicados exatos**: mesmo produto, alvo, datas, quantidade e valor que uma linha mais antiga; fica a mais antiga. O índice único do PrestaShop normalmente impede-os: a verificação continua útil para dados importados.
- **Órfãos**: produto eliminado (ou ausente da loja do preço), combinação, cliente, grupo, país, moeda, loja ou grupo de lojas eliminado.
- **Preços sem efeito**: «manter o preço base» sem desconto. Os que podem anular outro desconto estão protegidos.
- **Preços de carrinhos terminados**: preços criados para um carrinho (orçamento, negociação, oferta...) encomendado ou sem alterações desde o prazo escolhido, ou eliminado.
- **Prioridades de produtos eliminados** e **prioridades idênticas à global**.
- **Seleção manual**: linhas escolhidas na lista de preços.

## Proteções

- **Gerado por uma regra de preços do catálogo**: o PrestaShop regenera-o a partir da regra. Sempre protegido: altere ou elimine a regra.
- **Ligado a um carrinho**: criado para o carrinho de um cliente por um módulo de orçamentos, B2B, configurador ou oferta. Só a categoria Carrinhos terminados o pode remover.
- **Começa no futuro**: promoções agendadas.
- **Sem data de fim (ilimitado)**: mantidos por defeito, mesmo que pareçam inúteis.
- **Usado por outro módulo**: um módulo ainda o referencia nas suas próprias tabelas. O painel lista os módulos detetados.
- **Pode anular outro desconto**: um preço sem efeito pode prevalecer sobre um desconto de grupo ou global e anulá-lo para o seu alvo.

## A lista de preços

O separador **Preços específicos** mostra todos os preços específicos com os mesmos filtros do assistente, e sinais para os preços ligados a um carrinho, gerados por uma regra ou usados por um módulo de terceiros. Assinale linhas para lançar uma simulação só sobre essa seleção.

![Lista de preços específicos com filtros avançados e sinais de carrinho, regra e módulo](https://www.datafirefly.com/wp-content/uploads/2026/11/lista-precos-especificos-filtros-dfspecificpricecleaner-pt.webp)

## Histórico e restauro

O separador **Histórico e restauro** lista cada limpeza e cada simulação agendada, com o autor, o relatório e a cópia. As limpezas são conservadas com a sua cópia durante o prazo escolhido nas definições (90 dias por defeito) e depois purgadas automaticamente.

![Histórico das limpezas e simulações agendadas, com cópias e restauro](https://www.datafirefly.com/wp-content/uploads/2026/11/historico-limpezas-copias-dfspecificpricecleaner-pt.webp)

**Restaurar** repõe as linhas com o seu ID original e depois compara cada uma com a cópia. O relatório mostra então o número de linhas restauradas e a data.

![Restauro em 1 clique: confirmação antes de repor as linhas com o seu ID original](https://www.datafirefly.com/wp-content/uploads/2026/11/restauro-um-clique-confirmacao-dfspecificpricecleaner-pt.webp)

![Restauro concluído: linhas repostas com o seu ID e verificadas idênticas à cópia](https://www.datafirefly.com/wp-content/uploads/2026/11/restauro-verificado-linha-a-linha-dfspecificpricecleaner-pt.webp)

## Agendamento

O separador **Agendamento** configura uma limpeza automática chamada pela tarefa cron do seu alojamento. As proteções do assistente estão sempre ativas.

- **Modo**: _Apenas simulação_ (relatório, nada é apagado), recomendado para começar, ou _Limpeza_ com cópia automática.
- **Frequência**: a cada hora, dia, semana ou mês. As chamadas feitas antes da próxima data prevista são ignoradas.
- **Categorias**, prazo dos preços expirados e dos carrinhos terminados, limitação aos preços reservados a um cliente ou a uma loja.
- **No máximo N linhas por execução**: o resto é tratado na execução seguinte.
- **Relatório por e-mail** após cada execução, para o endereço escolhido ou o da loja.

Copie o **URL do cron** apresentado e chame-o a partir do seu alojamento, por exemplo a cada hora: o módulo aplica a frequência escolhida. Acrescente `&dry=1` para forçar uma simulação. Mantenha este URL privado: o token protege-o e pode gerar um novo. Uma chamada com um token errado recebe um erro 403; se já houver uma execução em curso, a chamada recebe um erro 423.

![Agendamento: simulação ou limpeza por cron, frequência, categorias e relatório por e-mail](https://www.datafirefly.com/wp-content/uploads/2026/11/agendamento-limpeza-cron-dfspecificpricecleaner-pt.webp)

![Relatório de limpeza recebido por e-mail, detalhado por categoria](https://www.datafirefly.com/wp-content/uploads/2026/11/relatorio-limpeza-por-email-dfspecificpricecleaner-pt.webp)

## Definições

- **Cópia de segurança antes de cada eliminação**: fortemente recomendada, permite o restauro num clique.
- **Conservação das cópias** em dias (0 = para sempre).
- **Perfis autorizados a limpar e restaurar**, além da permissão «Eliminar» do separador.
- **Manter o histórico e as cópias ao desinstalar**.
- **Eliminar através dos objetos do PrestaShop**: sim por defeito, para que os hooks de eliminação sejam executados (ERP, feeds e módulos de sincronização ficam informados). Não: SQL direto, mais rápido em volumes muito grandes.
- **Linhas por lote** (500 por defeito): cada lote é uma transação. Reduza o valor se o servidor cortar os pedidos longos.
- **Atualizar o índice de preços da pesquisa facetada** para os produtos afetados (até 300).
- **Purgar agora o histórico antigo**: remove as limpezas mais antigas do que o prazo de conservação e as simulações nunca executadas.

![Definições: cópia de segurança, conservação, perfis autorizados e processamento em lotes](https://www.datafirefly.com/wp-content/uploads/2026/11/definicoes-seguranca-copia-dfspecificpricecleaner-pt.webp)

## Blocos na ficha de produto e de cliente

Na ficha de produto, o bloco **Saúde dos preços específicos** indica o número de preços do produto, os que se podem limpar e o estado de cada um (ativo, expirado, futuro, carrinho, regra, módulo). O botão **Simular uma limpeza deste produto** abre o assistente já filtrado.

![Bloco da ficha de produto: saúde dos preços específicos do produto e simulação direta](https://www.datafirefly.com/wp-content/uploads/2026/11/bloco-ficha-produto-precos-dfspecificpricecleaner-pt.webp)

Na ficha de cliente, o bloco lista os preços reservados ao cliente e os carrinhos ligados, com uma limpeza dirigida a esse cliente.

![Bloco da ficha de cliente: preços reservados, carrinhos ligados e limpeza direcionada](https://www.datafirefly.com/wp-content/uploads/2026/11/bloco-ficha-cliente-precos-dfspecificpricecleaner-pt.webp)

## Permissões dos funcionários

Consultar o módulo exige a permissão «Ver» do separador. Limpar e restaurar exigem a permissão «Eliminar» do separador em **Parâmetros avançados > Equipa > Permissões**, e que o perfil esteja assinalado nas definições do módulo. O perfil SuperAdmin está sempre autorizado. Um perfil sem estes direitos vê as páginas só em leitura.

## Para programadores de módulos

Mesmo antes de apagar um lote, o módulo executa o hook `actionDfSpecificPriceCleanerBeforeDelete` com o ID da limpeza e a lista dos ID de preços. Um módulo pode acrescentar ao array `veto` os ID dos preços que quer manter: essas linhas são ignoradas e ficam no lugar.

## Resolução de problemas

### Algumas linhas são «ignoradas» durante a limpeza

Mudaram desde a simulação: ligadas a um carrinho, regeneradas por uma regra ou usadas por um módulo. É intencional. Lance uma nova simulação para as rever.

### A simulação não prevê nenhuma linha

Todas as linhas correspondentes estão protegidas, ou nenhuma corresponde aos filtros. O contador «protegidas» de cada categoria indica o que é mantido e porquê.

### A limpeza para num grande volume

Reduza **Linhas por lote** nas definições e retome a limpeza a partir do painel. Os lotes já tratados não são refeitos.

### O URL do cron responde 403, 423 ou SKIPPED

403: token errado, copie de novo o URL a partir do separador Agendamento. 423: ainda há uma execução em curso. SKIPPED: agendamento desativado, data prevista ainda não atingida ou nenhuma categoria assinalada.

### O relatório recomenda reconstruir o índice

Acima de 300 produtos afetados, o módulo não atualiza sozinho o índice de preços da pesquisa facetada. Reconstrua o índice a partir da configuração do módulo de pesquisa facetada.

## Limitações

- Os conflitos de prioridade e as regras de catálogo expiradas são assinalados, nunca apagados automaticamente.
- O relatório por e-mail é enviado no idioma do funcionário (botão do relatório) ou no idioma por defeito da loja (cron).
- Sem cópia de segurança, uma eliminação não pode ser anulada.

## Compatibilidade

- PrestaShop 1.7.8 a 9.x com o mesmo ZIP. Testado em 1.7.8.11, 8.2.1 e 9.1.5, com PHP 7.4, 8.1 e 8.5.
- Multiloja: a análise e a limpeza podem limitar-se a uma loja.
- Arquitetura ModuleAdminController, sem dependência Composer.
- Interface traduzida em francês, inglês, espanhol, alemão, italiano, neerlandês, polaco e português.
