# DataFirefly Auction — Guía completa

> Presentación El módulo DataFirefly Auction convierte cualquier producto de tu catálogo en una verdadera subasta en línea. Incorpora un motor de pujas automáticas estilo eBay (proxy bidding), un sistema anti-sniping,…

- Página: <https://www.datafirefly.com/es/documentation/datafirefly-auction-3/>
- Idioma: es
- Actualizado el: 2026-06-24
- Otros idiomas: [fr](https://www.datafirefly.com/documentation/datafirefly-auction/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-auction-2/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-auction-4/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-auction-5/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-auction/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-auction/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-auction/index.md)
- Índice: <https://www.datafirefly.com/es/documentation/llms.txt>

## Presentación

El módulo **DataFirefly Auction** convierte cualquier producto de tu catálogo en una verdadera subasta en línea. Incorpora un motor de pujas automáticas estilo eBay (proxy bidding), un sistema anti-sniping, un precio de reserva oculto, una opción de compra inmediata, una lista de seguimiento, y un cierre automático por cron que designa al ganador y le genera un cupón para pedir al precio aguardado.

El módulo es compatible con PrestaShop 8.0 a 9.x, multitienda, traducido a cinco idiomas (francés, inglés, español, alemán, italiano), sin Composer ni dependencia externa.

## Instalación

1. En tu back-office, abre **Módulos** y luego **Gestor de módulos**.
2. Haz clic en **Subir un módulo** y suelta el archivo `dfauction.zip`.
3. Una vez instalado, haz clic en **Configurar** para ajustar los parámetros generales.

Durante la instalación, el módulo crea sus tablas, sus hooks y un menú **Vender > Subastas** en el back-office. También genera un token de seguridad único para la URL del cron.

## Ajustes del módulo

La página de configuración reúne los parámetros globales, aplicados por defecto a todas las subastas:

- **Incremento por defecto**: paso mínimo entre dos pujas (puja mínima).
- **Ventana anti-sniping**: duración, en minutos, antes del cierre durante la cual toda puja nueva activa una prolongación.
- **Prolongación anti-sniping**: duración, en minutos, añadida al cierre cuando una puja cae dentro de la ventana.
- **Anonimización RGPD**: muestra a los pujadores bajo un seudónimo estable («Bidder #1234») en el historial público.
- **Lista de seguimiento**: activa el botón «Seguir» para seguir una subasta sin pujar.
- **Notificaciones por correo**: activa los correos de superación y de victoria.
- **Validez del cupón del ganador**: duración, en horas, del cupón emitido al ganador.
- **Token cron**: token de seguridad incluido en la URL del cron (ver más abajo).

## Crear una subasta

Ve a **Vender > Subastas** y haz clic en **Añadir una subasta**. Los campos disponibles son:

- **Producto**: el producto subastado (seleccionado del catálogo).
- **Precio inicial**: el importe de la primera puja posible.
- **Precio de reserva** (opcional): precio mínimo oculto. Mientras no se alcance, el lote no se vende.
- **Precio de compra inmediata** (opcional): importe que permite llevarse el lote en el acto.
- **Incremento**: paso de puja propio de esta subasta (sustituye al incremento global).
- **Fecha de inicio** y **Fecha de fin**: periodo de apertura de la subasta.
- **Ventana / prolongación anti-sniping**: valores específicos de la subasta (si no, se aplican los valores globales).
- **Compra inmediata permitida**: activa o no la opción Buy-Now para esta subasta.
- **Estado**: Pendiente, Activa, Finalizada, Vendida o Cancelada.

Deja el estado en **Pendiente** e indica una fecha de inicio futura: el cron pasará automáticamente la subasta a **Activa** a la hora prevista. No hace falta activarla a mano.

## Cómo funcionan las pujas automáticas (proxy bidding)

El corazón del módulo es un motor de pujas automáticas inspirado en eBay. El pujador no introduce una puja fija, sino el **importe máximo** que está dispuesto a pagar. Ese tope permanece confidencial.

1. El módulo solo muestra la puja mínima necesaria para que el pujador se mantenga en cabeza.
2. Cuando un competidor puja, el módulo vuelve a pujar automáticamente por cuenta del líder, por escalones de incremento, hasta alcanzar su tope.
3. Si el recién llegado supera el tope del líder, toma la cabeza, y el precio mostrado sube justo por encima del antiguo tope.

Como resultado, el pujador no necesita vigilar la venta de forma continua. Fija su máximo una vez, y el módulo defiende su posición por él.

## Anti-sniping y precio de reserva

El **sniping** consiste en pujar en el último segundo para que nadie tenga tiempo de reaccionar. Para neutralizarlo, toda puja depositada dentro de la ventana anti-sniping prolonga automáticamente el cierre durante la duración configurada. La venta solo termina, por tanto, cuando ninguna puja más llega dentro de la ventana final.

El **precio de reserva** es un mínimo oculto. Si no se alcanza al cierre, el lote no se vende. En cuanto un pujador introduce un máximo capaz de cubrir la reserva, el precio mostrado sube automáticamente a la reserva, para que gane el lote al precio justo.

## Compra inmediata y lista de seguimiento

Si la **compra inmediata** está permitida, un cliente puede llevarse el lote al instante al precio fijo definido, lo que cierra la subasta en el acto y dispara la generación del cupón del ganador.

La **lista de seguimiento** permite a un cliente conectado seguir una subasta mediante un botón «Seguir», sin pujar, para encontrarla fácilmente.

## Cierre automático: configurar el cron

El módulo se apoya en una tarea cron para iniciar las subastas programadas y cerrar las que han llegado a su fin. La URL del cron, protegida por el token, se muestra en la página de configuración. Se parece a:

```
https://www.tutienda.com/index.php?fc=module&module=dfauction&controller=cron&token=TU_TOKEN
```

Programa su llamada a intervalos regulares (por ejemplo cada 5 minutos) mediante el cron de tu alojamiento o un servicio de cron externo:

```
*/5 * * * * wget -q -O /dev/null "https://www.tutienda.com/index.php?fc=module&module=dfauction&controller=cron&token=TU_TOKEN"
```

Sin un cron activo, las subastas no se cerrarán automáticamente y los ganadores no recibirán su cupón. La frecuencia del cron también determina la precisión del cierre: un cron cada 5 minutos cierra las subastas con un desfase máximo de 5 minutos.

## Lado del cliente

En la ficha del producto subastado, el cliente ve un widget de puja que muestra el precio actual, una cuenta atrás en directo, el número de pujas y de pujadores, y un campo para introducir su puja máxima. El precio y la cuenta atrás se actualizan automáticamente. El historial de pujas se muestra bajo seudónimos si la anonimización está activa.

## El ganador y el cupón

Al cierre, si la reserva se alcanza (o en caso de compra inmediata), el módulo designa al ganador y genera para él un **cupón privado y nominativo**, restringido a su cuenta. Este cupón le permite pedir el producto al precio exacto que ganó. Su validez corresponde al ajuste «Validez del cupón del ganador».

## Correos enviados

- **Has sido superado**: enviado a un pujador cuando un competidor pasa por delante de él.
- **Has ganado**: enviado al ganador al cierre, con el código del cupón.

Las plantillas se proporcionan en francés e inglés y se pueden personalizar desde la traducción de correos de PrestaShop.

## RGPD y privacidad

Cuando la anonimización está activa, el historial público de pujas muestra un seudónimo estable por pujador («Bidder #1234») en lugar de su nombre real. Se preserva la transparencia de la venta sin exponer la identidad de los participantes.

## Preguntas frecuentes

### ¿El precio de reserva es visible para los clientes?

No. Permanece oculto. Los clientes solo ven si la reserva se alcanza o no.

### ¿Qué ocurre si no se alcanza la reserva?

El lote no se vende y no se genera ningún cupón. La subasta se cierra sin ganador.

### ¿Pueden dos pujadores introducir el mismo máximo?

Sí. En caso de empate en el tope, la primera puja registrada conserva la cabeza.

### ¿Puedo tener ventanas anti-sniping diferentes por subasta?

Sí. Cada subasta puede definir su propia ventana y su propia prolongación, si no se aplican los valores globales.

## Desinstalación

La desinstalación desde el Gestor de módulos elimina las tablas de subastas, pujas y seguimientos, así como la configuración y las pestañas de menú. Haz una copia de seguridad de tus datos previamente si deseas conservarlos.
