Generar Cupones de Descuento Únicos en Masa para PrestaShop 8 y 9: documentación

Presentación

El módulo crea lotes de códigos de descuento únicos que comparten las mismas reglas. Cada código es una regla de carrito nativa de PrestaShop. Los códigos se distribuyen por email, en PDF imprimible con código QR o mediante exportación CSV, y cada lote tiene sus propias estadísticas de uso.

Instalación

1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y seleccione dfbulkcoupons-1.1.0.zip.
2. La instalación crea la pestaña Catálogo > Descuentos > Códigos promocionales en masa. El botón Configurar del módulo también lleva a ella.
3. El módulo activa la función de reglas de carrito si estaba desactivada.

Crear un lote

Haga clic en Nuevo lote y rellene el formulario de arriba abajo.

Lote

El nombre del lote se usa en las estadísticas y las exportaciones. El canal indica dónde se distribuirán los códigos (email, boletín, SMS, redes sociales, influencers, afiliados, impresos, tienda física, atención al cliente, otro o un nombre libre). Sirve para comparar campañas en la tabla de rendimiento por canal.

Formato de los códigos

Un código se compone de un prefijo, una parte aleatoria y un sufijo. En la parte aleatoria, X es una letra o una cifra, A una letra y # una cifra. Los demás caracteres, como los guiones, se mantienen. Ejemplo: prefijo VERANO- y parte XXXX-XXXX dan VERANO-K7MQ-3HWD.

El juego de caracteres «Fáciles de leer» excluye 0, O, 1, I y L para evitar errores de escritura. Se necesitan al menos 4 caracteres aleatorios, y el formato debe ofrecer al menos 20 veces más combinaciones que códigos solicitados: la vista previa y el contador de combinaciones lo indican mientras escribe.

Destinatarios y cantidad

• Códigos anónimos: indique el número de códigos, de 1 a 200 000. Se distribuyen libremente.
• Un código personal por cliente de los grupos seleccionados: un código por cliente activo de los grupos marcados, con la opción «Solo suscriptores del boletín».
• Un código personal por cliente de una lista de emails: pegue las direcciones, una por línea o separadas por comas. Las direcciones sin cuenta de cliente se omiten y se muestra su número.

Un código personal solo funciona para la cuenta de cliente a la que está asignado.

Descuento

El nombre mostrado a los clientes aparece en el carrito y en la factura, en cada idioma. Tipos: porcentaje, importe fijo (con o sin IVA, en una moneda), envío gratuito o regalo (se regala la combinación por defecto del producto). Un porcentaje o un importe se aplica a todo el pedido sin envío o a un producto concreto. Un porcentaje también puede aplicarse al producto más barato o a los productos de la restricción.

Validez y uso

Fechas de inicio y fin, usos por código y usos por cliente: indique 1 y 1 para códigos de un solo uso. Importe mínimo de pedido (con moneda, impuestos y envío), prioridad, opción «No acumulable con otros descuentos», visualización del código en el carrito de su titular (solo códigos personales) y activación inmediata.

Restricciones

Restricción por productos, categorías o marcas con una cantidad mínima de productos, grupos de clientes autorizados, países de entrega autorizados y, en multitienda, tiendas autorizadas. Un campo vacío no impone ninguna restricción.

Generación de los códigos

Tras validar, la página de generación crea los códigos en bloques de 250 con una barra de progreso. Mantenga la página abierta. Si se cierra, la generación continúa donde se detuvo la próxima vez que abra el lote (enlace Reanudar en la lista). Cada código es una regla de carrito cuya descripción empieza por [DFBC#id], visible en Catálogo > Descuentos.

Página del lote

Estadísticas

Códigos generados, códigos usados y tasa de uso, pedidos validados, pedidos de clientes nuevos (clientes sin pedido validado anterior), facturación sin IVA y pedido medio, descuento concedido sin IVA y relación facturación / descuento, códigos aún utilizables. Después, un gráfico de usos por día, los 15 códigos más usados y los 30 últimos pedidos. Solo los pedidos validados cuentan en la facturación y el descuento, convertidos a la moneda por defecto.

Gestionar el lote

• Datos: nombre, canal y nota interna. El nuevo nombre se copia en la descripción de las reglas de carrito.
• Fin de validez: se aplica a todos los códigos del lote.
• Añadir códigos: para un lote de códigos anónimos, con el mismo formato y las mismas reglas.
• Desactivar o activar todos los códigos, eliminar los códigos nunca usados, duplicar o eliminar el lote. Los pedidos anteriores conservan su descuento.

Lista de códigos

El botón Ver los códigos muestra los códigos de 50 en 50, con pestañas por estado: disponible, usado, agotado, caducado, desactivado. La búsqueda se hace por el inicio del código o el email del cliente. Para cada código: copia del código o de su enlace directo, usos, usos restantes, fecha de envío, último pedido, activación o desactivación y enlace a la regla de carrito nativa.

Enviar los códigos por email

Disponible para los lotes de códigos personales, desde el panel Distribución de la página del lote.

1. Para cada idioma, modifique el asunto y el mensaje. Variables disponibles: {firstname}, {lastname}, {code}, {discount}, {valid_until}, {shop_name}, {link}. El email muestra siempre el código enmarcado, el descuento, la fecha de fin y un botón que aplica el código al carrito.
2. Haga clic en Enviarme un email de prueba: llega a su dirección de empleado, en su idioma, con un código del lote.
3. Elija los destinatarios: códigos aún no enviados (y los fallidos), o todos los códigos otra vez como recordatorio. La opción «Solo los clientes que aceptaron el boletín» está marcada por defecto.
4. Ajuste el número de emails por minuto para no superar el límite de su servidor de correo o proveedor SMTP y haga clic en Guardar y enviar.

El envío se hace en paquetes de 10 con una barra de progreso y un botón de pausa. Cada cliente recibe la versión en el idioma de su cuenta. Los códigos ya usados, desactivados o caducados y las cuentas eliminadas o desactivadas se omiten. Los emails rechazados por el servidor se listan y se reintentan en el siguiente envío de códigos no enviados.

Imprimir los códigos

El botón Imprimir los códigos genera un PDF A4:

• Tarjetas: 10 por página (95 x 55 mm), con líneas de corte.
• Etiquetas: 21 por hoja (63,5 x 38,1 mm, hojas 3 x 7 habituales).
• Folletos: 4 por página en formato A6, con líneas de corte.

Elija los códigos (no usados nunca impresos, todos los no usados o todos), cuántos (hasta 2000 por archivo) y cuántos omitir al principio. Ajuste el titular, las condiciones (variables {valid_until}, {shop_name}, {customer}), el color de acento, el código QR, el nombre de la tienda y, para los códigos personales, el nombre del cliente. La opción «Marcar estos códigos como impresos» evita imprimir dos veces los mismos códigos.

Enlace directo y código QR

Cada código tiene una dirección del tipo https://su-tienda.com/module/dfbulkcoupons/apply?code=CODIGO. Abre la tienda y aplica el código al carrito. Si el visitante aún no tiene carrito, o el carrito no cumple las condiciones (importe mínimo, productos, cuenta del titular), el código se guarda 30 días en su cookie y se aplica en cuanto el carrito las cumple. Este enlace está detrás de los códigos QR impresos, en el botón de los emails, en la lista de códigos y en la exportación CSV.

Exportaciones CSV

Los archivos están en UTF-8 con separador punto y coma y se abren directamente en Excel.

• Códigos (todos, no usados o usados): código, estado, usos, usos restantes, fechas de validez, email, nombre y apellidos del cliente, último uso, último pedido, fecha de envío, fecha de impresión, enlace directo.
• Uso por pedido: fecha, ID, referencia y estado del pedido, pedido validado o no, código, cliente, descuento y total con y sin IVA, moneda.

Rendimiento por canal

En cuanto se usan varios canales, la lista de lotes muestra una tabla por canal: número de lotes y de códigos, códigos usados, tasa, pedidos, facturación y descuento sin IVA, ordenada por facturación.

Desinstalación

La desinstalación elimina las tablas del módulo (lotes, historial de envío e impresión). Los códigos ya generados siguen siendo reglas de carrito activas en Catálogo > Descuentos.

Solución de problemas

• La generación se detiene: vuelva a abrir el lote y la generación continúa. Si la base de datos rechaza las inserciones, se muestra un mensaje de error preciso.
• «Este formato deja muy pocas combinaciones»: añada caracteres aleatorios o use el alfabeto completo.
• Emails fallidos: compruebe Parámetros avanzados > Correo electrónico con un email de prueba y vuelva a enviar los códigos no enviados.
• El código QR no reduce el carrito: abra el carrito, el código se aplica en cuanto se cumplen sus condiciones. Para un código personal, el cliente debe haber iniciado sesión en su cuenta.