# Instalar el módulo PrestaShop

> Instalar y configurar el módulo DataFirefly Server-Side en PrestaShop 1.7.6 y superior: subida del zip, clave de conexión, consentimiento tarteaucitron.

- Página original: https://server-side.datafirefly.com/es/docs/prestashop.html
- Idioma: es
- Actualizado el: 2026-09-05
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/es/

---

Compatible con PrestaShop 1.7.6 y versiones superiores. Instalación en 5 minutos desde el gestor de módulos. Un envío fallido se pone en cola y se reenvía, con las compras primero: una caída pasajera no cuesta nada.

## Requisitos previos

- PrestaShop 1.7.6 o más reciente.
- El zip del módulo, para descargar desde la página [**Modules**](https://admin.datafirefly.com/app/connectors) de su área de cliente.
- La [clave de conexión de su sitio](https://server-side.datafirefly.com/es/docs/connect-your-site.html).

## Instalación

1. Back office de PrestaShop: **Módulos > Gestor de módulos > Subir un módulo**.
2. Suba el zip tal cual, sin descomprimirlo.
3. Haga clic en **Configurar**.

## Configuración

1. Rellene **Tenant ID**, **HMAC secret** y **Events endpoint**: los tres valores de la página de su sitio DataFirefly.
2. Opción **Require consent**: el módulo solo deja salir un evento cuando el visitante ha aceptado la publicidad. Reconoce por sí solo, sin configuración: tarteaucitron, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, en el navegador y en el servidor, la misma lista que los módulos de WooCommerce y Shopware. Recomendado si su tienda tiene un banner de consentimiento.
3. Ponga **Enable tracking** en Yes: viene desactivado por defecto.
4. Guarde y haga clic en **Send test event**.

¿Todavía no tiene banner de consentimiento en su tienda? El módulo [Cookie Manager para PrestaShop](https://www.datafirefly.com/product/cookie-manager-tarteaucitron-conformite-rgpd-cle-en-main-pour-prestashop/) instala tarteaucitron listo para usar, con Consent Mode v2.

## Verificar

1. El evento de prueba debe aparecer como **Delivered** en el Monitoring de su área de cliente.
2. Realice un pedido de prueba: el módulo envía las compras al validarse el pedido.

## Cola de reenvío

Se aplica a partir de la versión 1.29.0.

- Un envío fallido se pone en cola y se reenvía a medida que llegan visitas a la tienda: como mucho cada 30 segundos, nunca dos reenvíos a la vez, en lotes de hasta 20 eventos enviados en paralelo.
- Tienda con poco tráfico: una URL de cron opcional, protegida por un token y accesible solo por https, lanza el reenvío sin esperar a una visita.
- Las compras y los reembolsos van primero; después, los eventos más recientes.
- Un evento solo sale de la cola cuando tiene más de 7 días **y** lleva más de 7 días esperando. Entonces se contabiliza como caducado: nada desaparece sin dejar rastro.
- Si DataFirefly no responde (fallo de red, HTTP 429 o 5xx), la tienda deja de enviar directamente durante 60 segundos y pone los eventos directamente en la cola. Así, una caída de nuestro lado nunca ralentiza su tienda ni el checkout. El reenvío sigue intentándolo y, en cuanto lo consigue, se reanuda el envío directo.
- La página de su sitio en el área de cliente muestra el estado de esta cola. Los estados se explican en la guía de [resolución de problemas](https://server-side.datafirefly.com/es/docs/troubleshooting.html).

## Si algo falla

- Registros: **Parámetros avanzados > Logs**, filtre por el prefijo `[DataFirefly SS]`.
- Si utiliza una versión del módulo anterior a la 1.8.0, actualice: las versiones recientes corrigen un posible doble conteo de las compras en GA4.
- Las demás causas frecuentes están en la [guía de resolución de problemas](https://server-side.datafirefly.com/es/docs/troubleshooting.html).

Actualizado: 1 de septiembre de 2026
