# DataFirefly Specific Price Cleaner: limpiar precios específicos caducados, duplicados y huérfanos

> Instalación Instale el módulo desde Módulos > Gestor de módulos > Subir un módulo enviando el archivo ZIP. Al instalarse, el módulo crea sus tablas y añade la pestaña Catálogo…

- Página: <https://www.datafirefly.com/es/documentation/dfspecificpricecleaner/>
- Idioma: es
- Actualizado el: 2026-11-16
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/dfspecificpricecleaner/index.md), [en](https://www.datafirefly.com/en/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), [pt](https://www.datafirefly.com/pt/documentation/dfspecificpricecleaner/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## Instalación

Instale el módulo desde **Módulos > Gestor de módulos > Subir un módulo** enviando el archivo ZIP. Al instalarse, el módulo crea sus tablas y añade la pestaña **Catálogo > Limpieza de precios específicos**. No modifica ningún precio durante la instalación.

Para actualizar desde la 1.0.x, basta con subir el nuevo ZIP. Se conservan el historial y las copias de la 1.0.x, así como los ajustes de la tarea cron (activación, modo, frecuencia). Abra la pestaña **Programación** tras la actualización para comprobar que le convienen.

## El panel

La página **Salud** analiza la tabla de precios específicos, en todo el catálogo o en un ámbito elegido (tienda, categoría, ID de producto). Muestra:

- el número de precios específicos, incluidos los activos en este momento;
- el número de filas que se pueden limpiar sin riesgo con la limpieza por defecto (caducados, duplicados, huérfanos);
- lo que nunca se borra por defecto: precios vinculados a un carrito activo, reglas de precios del catálogo, precios futuros, precios sin fecha de fin, precios usados por otro módulo;
- el detalle por categoría de problema, con las filas eliminables y protegidas de cada una;
- los conflictos de prioridad y las reglas de catálogo caducadas, para revisar a mano;
- el tamaño actual de la tabla, medido por la base de datos.

![Panel de salud de los precios específicos: filas limpiables, categorías de problemas y protecciones](https://www.datafirefly.com/wp-content/uploads/2026/11/panel-salud-precios-especificos-dfspecificpricecleaner-es.webp)

El panel indica cuántas filas menos tendrá la tabla tras la limpieza. El efecto en la velocidad de las páginas depende de su tienda: el módulo no lo mide.

## El asistente de limpieza en 6 pasos

Haga clic en **Iniciar el asistente de limpieza**. Los pasos son: Elegir, Simular, Revisar, Guardar, Limpiar, Informe. No se borra nada antes del paso Limpiar.

### 1. Elegir

Marque las categorías que quiere limpiar. Cada contador indica las filas que se borrarían con las protecciones activas. Ajuste el plazo de los precios caducados (por ejemplo, caducados desde hace al menos 7 días) y el de los carritos terminados. Las **protecciones** quedan marcadas por defecto; desmarque una solo si sabe exactamente por qué una fila debe desaparecer. Los **filtros avanzados** limitan la limpieza a una tienda, una categoría, unos ID de producto, un cliente, un grupo, un país, una moneda, un tipo de valor o una fecha de caducidad.

![Asistente de limpieza, paso 1: elegir las categorías, protecciones y filtros avanzados](https://www.datafirefly.com/wp-content/uploads/2026/11/asistente-limpieza-elegir-categorias-dfspecificpricecleaner-es.webp)

### 2. Simular

**Lanzar la simulación** calcula el plan sin borrar nada: filas previstas y protegidas por categoría. El plan queda congelado: solo esas filas podrán borrarse. Una fila que corresponde a varias categorías se planifica una sola vez, en la primera. Puede exportar el plan en CSV.

![Resultado de la simulación: filas previstas y protegidas por categoría, no se elimina nada](https://www.datafirefly.com/wp-content/uploads/2026/11/simulacion-limpieza-precios-especificos-dfspecificpricecleaner-es.webp)

### 3. Revisar

La lista de filas previstas muestra el producto, el destino, el valor, el periodo y las señales útiles de cada fila. Desmarque una fila para conservarla: una fila excluida nunca se borra.

![Revisión fila a fila del plan fijado, cada fila se puede excluir](https://www.datafirefly.com/wp-content/uploads/2026/11/revision-filas-antes-eliminar-dfspecificpricecleaner-es.webp)

### 4. Guardar

**Crear la copia** copia cada fila prevista, columna por columna, en el historial del módulo. Puede descargar esta copia en CSV antes de continuar. Si la copia está desactivada en los ajustes, el módulo lo indica claramente: el borrado será definitivo.

![Copia de seguridad completa de las filas previstas antes de eliminar, descargable en CSV](https://www.datafirefly.com/wp-content/uploads/2026/11/copia-seguridad-antes-limpieza-dfspecificpricecleaner-es.webp)

### 5. Limpiar

Marque **He revisado la simulación y quiero eliminar estas N filas** y haga clic en **Eliminar N filas**. Sin copia, además hay que escribir el número de filas. El borrado avanza por lotes, cada uno en su propia transacción, y cada fila se vuelve a comprobar justo antes de borrarla: una fila vinculada entretanto a un carrito, regenerada por una regla o usada por un módulo se omite. Puede pausar y reanudar.

![Confirmación explícita antes de la limpieza por lotes transaccionales con reanudación](https://www.datafirefly.com/wp-content/uploads/2026/11/confirmacion-explicita-limpieza-dfspecificpricecleaner-es.webp)

### 6. Informe

El informe da, por categoría, las filas previstas, borradas, omitidas, excluidas y protegidas, y la duración. También indica lo que se hizo tras la limpieza: cachés de precios de PrestaShop vaciadas e índice de precios de la búsqueda facetada actualizado para los productos afectados. Desde el informe puede restaurar, descargar la copia o el informe detallado en CSV, o enviarse el informe por correo.

![Informe de limpieza por categoría, cachés de precios vaciadas y restauración en 1 clic](https://www.datafirefly.com/wp-content/uploads/2026/11/informe-limpieza-precios-especificos-dfspecificpricecleaner-es.webp)

Si se cierra la pestaña o se detiene el servidor durante la limpieza, nada queda a medias. El panel muestra la limpieza pendiente con **Abrir y reanudar**, o puede abandonar el resto.

## Categorías de limpieza

- **Precios caducados**: la fecha de fin ha pasado, estos precios ya no se aplican a nadie.
- **Duplicados exactos**: mismo producto, destino, fechas, cantidad y valor que una fila más antigua; se conserva la más antigua. El índice único de PrestaShop normalmente los impide: la comprobación sigue siendo útil para datos importados.
- **Huérfanos**: producto eliminado (o ausente de la tienda del precio), combinación, cliente, grupo, país, moneda, tienda o grupo de tiendas eliminado.
- **Precios sin efecto**: «conservar el precio base» sin descuento. Los que pueden anular otro descuento están protegidos.
- **Precios de carritos terminados**: precios creados para un carrito (presupuesto, negociación, regalo...) pedido o sin cambios desde el plazo elegido, o eliminado.
- **Prioridades de productos eliminados** y **prioridades idénticas a la global**.
- **Selección manual**: filas elegidas en la lista de precios.

## Protecciones

- **Generado por una regla de precios del catálogo**: PrestaShop lo regenera desde la regla. Siempre protegido: modifique o elimine la regla.
- **Vinculado a un carrito**: creado para el carrito de un cliente por un módulo de presupuestos, B2B, configurador o regalo. Solo la categoría Carritos terminados puede retirarlo.
- **Empieza en el futuro**: promociones programadas.
- **Sin fecha de fin (ilimitado)**: se conservan por defecto, aunque parezcan inútiles.
- **Usado por otro módulo**: un módulo aún lo referencia en sus propias tablas. El panel lista los módulos detectados.
- **Puede anular otro descuento**: un precio sin efecto puede imponerse a un descuento de grupo o global y anularlo para su destino.

## La lista de precios

La pestaña **Precios específicos** muestra todos los precios específicos con los mismos filtros que el asistente, y señales para los precios vinculados a un carrito, generados por una regla o usados por un módulo de terceros. Marque filas para lanzar una simulación solo sobre esa selección.

![Lista de precios específicos con filtros avanzados y señales de carrito, regla y módulo](https://www.datafirefly.com/wp-content/uploads/2026/11/lista-precios-especificos-filtros-dfspecificpricecleaner-es.webp)

## Historial y restauración

La pestaña **Historial y restauración** lista cada limpieza y cada simulación programada, con su autor, su informe y su copia. Las limpiezas se conservan con su copia durante el plazo elegido en los ajustes (90 días por defecto) y luego se purgan automáticamente.

![Historial de limpiezas y simulaciones programadas, con copias y restauración](https://www.datafirefly.com/wp-content/uploads/2026/11/historial-limpiezas-copias-dfspecificpricecleaner-es.webp)

**Restaurar** devuelve las filas con su ID original y compara cada una con la copia. El informe muestra después el número de filas restauradas y la fecha.

![Restauración en 1 clic: confirmación antes de devolver las filas con su ID original](https://www.datafirefly.com/wp-content/uploads/2026/11/restauracion-un-clic-confirmacion-dfspecificpricecleaner-es.webp)

![Restauración terminada: filas devueltas con su ID y comprobadas idénticas a la copia](https://www.datafirefly.com/wp-content/uploads/2026/11/restauracion-verificada-fila-a-fila-dfspecificpricecleaner-es.webp)

## Programación

La pestaña **Programación** configura una limpieza automática llamada por la tarea cron de su alojamiento. Las protecciones del asistente siempre están activas.

- **Modo**: _Solo simulación_ (informe, no se borra nada), recomendado para empezar, o _Limpieza_ con copia automática.
- **Frecuencia**: cada hora, día, semana o mes. Las llamadas anteriores a la siguiente fecha prevista se ignoran.
- **Categorías**, plazo de los precios caducados y de los carritos terminados, limitación a los precios reservados a un cliente o a una tienda.
- **Como máximo N filas por ejecución**: el resto se procesa en la siguiente.
- **Informe por correo** tras cada ejecución, a la dirección elegida o a la de la tienda.

Copie la **URL del cron** mostrada y llámela desde su alojamiento, por ejemplo cada hora: el módulo aplica la frecuencia elegida. Añada `&dry=1` para forzar una simulación. Mantenga esta URL privada: el token la protege y puede generar uno nuevo. Una llamada con un token incorrecto recibe un error 403; si ya hay una ejecución en curso, recibe un error 423.

![Programación: simulación o limpieza por cron, frecuencia, categorías e informe por correo](https://www.datafirefly.com/wp-content/uploads/2026/11/programacion-limpieza-cron-dfspecificpricecleaner-es.webp)

![Informe de limpieza recibido por correo, detallado por categoría](https://www.datafirefly.com/wp-content/uploads/2026/11/informe-limpieza-por-correo-dfspecificpricecleaner-es.webp)

## Ajustes

- **Copia de seguridad antes de cada eliminación**: muy recomendable, permite la restauración en un clic.
- **Conservación de las copias** en días (0 = para siempre).
- **Perfiles autorizados a limpiar y restaurar**, además del permiso «Eliminar» de la pestaña.
- **Conservar el historial y las copias al desinstalar**.
- **Eliminar mediante los objetos de PrestaShop**: sí por defecto, para que se ejecuten los hooks de borrado (ERP, feeds y módulos de sincronización quedan informados). No: SQL directo, más rápido con volúmenes muy grandes.
- **Filas por lote** (500 por defecto): cada lote es una transacción. Redúzcalo si su servidor corta las peticiones largas.
- **Actualizar el índice de precios de la búsqueda facetada** de los productos afectados (hasta 300).
- **Purgar el historial antiguo ahora**: elimina las limpiezas más antiguas que el plazo de conservación y las simulaciones nunca ejecutadas.

![Ajustes: copia de seguridad, conservación, perfiles autorizados y procesamiento por lotes](https://www.datafirefly.com/wp-content/uploads/2026/11/ajustes-seguridad-copia-dfspecificpricecleaner-es.webp)

## Bloques en la ficha de producto y de cliente

En la ficha de producto, el bloque **Salud de los precios específicos** indica el número de precios del producto, los que se pueden limpiar y el estado de cada uno (activo, caducado, futuro, carrito, regla, módulo). El botón **Simular una limpieza de este producto** abre el asistente ya filtrado.

![Bloque de la ficha de producto: salud de sus precios específicos y simulación directa](https://www.datafirefly.com/wp-content/uploads/2026/11/bloque-ficha-producto-precios-dfspecificpricecleaner-es.webp)

En la ficha de cliente, el bloque lista los precios reservados al cliente y los carritos vinculados, con una limpieza dirigida a ese cliente.

![Bloque de la ficha de cliente: precios reservados, carritos vinculados y limpieza dirigida](https://www.datafirefly.com/wp-content/uploads/2026/11/bloque-ficha-cliente-precios-dfspecificpricecleaner-es.webp)

## Permisos de los empleados

Consultar el módulo requiere el permiso «Ver» de la pestaña. Limpiar y restaurar requieren el permiso «Eliminar» de la pestaña en **Parámetros avanzados > Equipo > Permisos**, y que el perfil esté marcado en los ajustes del módulo. El perfil SuperAdmin siempre está autorizado. Un perfil sin estos derechos ve las páginas en solo lectura.

## Para desarrolladores de módulos

Justo antes de borrar un lote, el módulo ejecuta el hook `actionDfSpecificPriceCleanerBeforeDelete` con el ID de la limpieza y la lista de ID de precios. Un módulo puede añadir al array `veto` los ID de los precios que quiere conservar: esas filas se omiten y se quedan en su sitio.

## Solución de problemas

### Algunas filas se «omiten» durante la limpieza

Han cambiado desde la simulación: vinculadas a un carrito, regeneradas por una regla o usadas por un módulo. Es lo previsto. Lance una nueva simulación para volver a revisarlas.

### La simulación no prevé ninguna fila

Todas las filas correspondientes están protegidas, o ninguna corresponde a los filtros. El contador «protegidas» de cada categoría indica qué se conserva y por qué.

### La limpieza se detiene con un gran volumen

Reduzca **Filas por lote** en los ajustes y reanude la limpieza desde el panel. Los lotes ya procesados no se repiten.

### La URL del cron responde 403, 423 o SKIPPED

403: token incorrecto, vuelva a copiar la URL desde la pestaña Programación. 423: aún hay una ejecución en curso. SKIPPED: programación desactivada, fecha prevista aún no alcanzada o ninguna categoría marcada.

### El informe recomienda reconstruir el índice

Por encima de 300 productos afectados, el módulo no actualiza por sí mismo el índice de precios de la búsqueda facetada. Reconstruya el índice desde la configuración del módulo de búsqueda facetada.

## Limitaciones

- Los conflictos de prioridad y las reglas de catálogo caducadas se señalan, nunca se borran automáticamente.
- El informe por correo se envía en el idioma del empleado (botón del informe) o en el idioma por defecto de la tienda (cron).
- Sin copia de seguridad, un borrado no se puede deshacer.

## Compatibilidad

- PrestaShop 1.7.8 a 9.x con el mismo ZIP. Probado en 1.7.8.11, 8.2.1 y 9.1.5, con PHP 7.4, 8.1 y 8.5.
- Multitienda: el análisis y la limpieza pueden limitarse a una tienda.
- Arquitectura ModuleAdminController, sin dependencia de Composer.
- Interfaz traducida al francés, inglés, español, alemán, italiano, neerlandés, polaco y portugués.
