DataFirefly Dunning — Documentación

Presentación

DataFirefly Dunning automatiza el recobro amistoso de los pedidos B2B pagados por transferencia y que quedan impagados. En cuanto se valida un pedido elegible, el módulo abre un crédito, sigue su vencimiento, lanza reclamaciones graduales según un calendario que defines tú y calcula los intereses de demora y la indemnización fija de recobro de 40 € previstos por el Código de Comercio francés.

Tres niveles de reclamación se incluyen en la instalación (reclamación cordial, reclamación firme con penalizaciones y PDF, requerimiento formal) y siguen siendo totalmente configurables. Un panel dedicado centraliza el importe pendiente, la balanza por antigüedad y el historial de envíos.

Instalación

1. Coloca la carpeta dfdunning en el directorio /modules/ de tu tienda, o instala el archivo ZIP desde Módulos > Gestor de módulos.
2. Haz clic en Instalar. El módulo crea sus tablas, sus tres niveles de reclamación por defecto, su configuración inicial, un token de seguridad para el cron y la pestaña de administración en Pedidos > Reclamación de impagados (DF Dunning).
3. Vacía la caché de PrestaShop si es necesario desde Parámetros avanzados > Rendimiento.

Configuración

La configuración está disponible desde Módulos > Gestor de módulos > dfdunning > Configurar. Los ajustes principales son:

• Módulos de pago seguidos: los módulos cuyos pedidos abren un crédito. Por defecto, la transferencia bancaria (ps_wirepayment).
• Estados de pedido seguidos: los estados considerados «a la espera de pago». Por defecto, el estado A la espera de pago por transferencia.
• Plazo de pago: número de días concedidos antes del vencimiento. Por defecto 30 días.
• Tasa de las penalizaciones por demora: tasa anual aplicada. Por defecto 12,15 % (tipo del BCE incrementado en 10 puntos).
• Indemnización fija: importe fijo por factura en retraso. Por defecto 40 €.
• Intervalo mínimo entre dos reclamaciones: salvaguarda anti-spam, por defecto 3 días.
• Envío automático: activa el envío de las reclamaciones al ejecutarse el cron.
• Copia oculta (BCC): dirección que recibe una copia de cada reclamación, para el registro contable.

Los tres niveles de reclamación

Un nivel de reclamación define cuándo y cómo se reclama a un cliente. Cada nivel se configura desde los ajustes: posición en la secuencia, plazo de activación (en días tras el vencimiento), plantilla de correo, inclusión o no de las penalizaciones, adjunto PDF y activación.

Nivel 1 — Reclamación cordial (D+7)

Un recordatorio simple, sin penalizaciones ni adjunto, enviado 7 días después del vencimiento. Objetivo: señalar el olvido sin deteriorar la relación comercial.

Nivel 2 — Reclamación firme (D+15)

Una reclamación más firme, con el desglose de los intereses de demora y la indemnización fija, acompañada de una carta PDF. Enviada 15 días después del vencimiento.

Nivel 3 — Requerimiento formal (D+30)

Un requerimiento formal que recuerda las sumas adeudadas, las penalizaciones y la referencia al artículo 1231-6 del Código Civil francés, con carta PDF y un plazo de pago de 8 días. Enviado 30 días después del vencimiento.

Cálculo de las penalizaciones

Para cada crédito en retraso, el módulo calcula:

• Los intereses de demora: importe adeudado × (tasa / 100) × (días de retraso / 365).
• La indemnización fija de recobro: un importe fijo por factura (40 € por defecto), debido desde el primer día de retraso.

El importe adeudado se determina a partir del total pagado y del total realmente cobrado del pedido, lo que gestiona los pagos parciales. La base legal la constituyen los artículos L441-10 y D441-5 del Código de Comercio francés para la indemnización y las penalizaciones, y el artículo 1231-6 del Código Civil francés para el requerimiento formal.

Automatización por cron

La sincronización de los créditos y el envío automático de las reclamaciones se basan en un controlador front protegido por un token. La URL completa, con el token generado en la instalación, se muestra en la pantalla de configuración, lista para copiar. Tiene la forma siguiente:

https://tutienda.tld/index.php?fc=module&module=dfdunning&controller=cron&token=TU_TOKEN

Programa una llamada diaria, por ejemplo a las 7 de la mañana, mediante la tarea programada (crontab) de tu servidor:

0 7 * * * curl -s "https://tutienda.tld/index.php?fc=module&module=dfdunning&controller=cron&token=TU_TOKEN"

En cada ejecución, el módulo actualiza los créditos (vencimientos, cierres, exclusiones) y luego, si el envío automático está activado, expide las reclamaciones vencidas respetando el intervalo mínimo configurado.

Panel de créditos

El panel, en Pedidos > Reclamación de impagados (DF Dunning), presenta:

• Seis indicadores clave: importe pendiente total, importe vencido, créditos en retraso, expedientes abiertos, penalizaciones teóricas y reclamaciones del mes.
• Una balanza por antigüedad que reparte el importe pendiente por tramo: no vencido, 1-30, 31-60, 61-90 y más de 90 días.
• Una lista filtrable de los créditos (abiertos, en retraso, pagados, excluidos), con acciones por fila: enviar un nivel de reclamación a elegir, marcar como pagado, excluir o reincluir, descargar la carta PDF.

Un expediente se cierra automáticamente cuando el pedido pasa a un estado pagado, y se excluye si el pedido se anula, se reembolsa o queda en error de pago.

Cartas PDF y correos

Las reclamaciones se envían por correo (versiones HTML y texto) y, según el nivel, acompañadas de una carta PDF. Las cartas se generan en francés o inglés según el idioma del pedido. Las plantillas usan variables reemplazadas en el envío: nombre, apellidos, referencia del pedido, importe adeudado, fecha de vencimiento, días de retraso, penalizaciones, indemnización fija, total adeudado, tasa aplicada y nombre de la tienda.

Los correos son modificables desde Diseño > Traducciones > Traducciones de los correos, idioma por idioma, como cualquier correo de PrestaShop.

Preguntas frecuentes

¿Qué pedidos se reclaman?

Solo los que corresponden a los módulos de pago y a los estados seleccionados en la configuración. Por defecto, los pedidos pagados por transferencia a la espera de pago.

¿Se gestiona un pedido pagado parcialmente?

Sí. El importe adeudado tiene en cuenta las sumas ya cobradas; solo se reclama la parte restante, y el expediente se cierra cuando se salda el saldo.

¿Es compatible el módulo con PrestaShop 9 y multitienda?

Sí. Los controladores de administración se basan en ModuleAdminController para la compatibilidad con PrestaShop 8 y 9, sin Composer, y el módulo gestiona el contexto multitienda.

¿Puedo lanzar una reclamación manualmente?

Sí. Desde el panel, puedes enviar de inmediato el nivel que elijas para un crédito dado, con independencia del cron.