DataFirefly Dunning — Documentazione
Installare, configurare e usare i solleciti insoluti B2B: scenari su 3 livelli, calcolo degli interessi di mora e dell'indennità di 40 €, lettere PDF, cron e dashboard dei crediti.
Panoramica
DataFirefly Dunning automatizza il recupero amichevole degli ordini B2B pagati tramite bonifico e rimasti insoluti. Non appena un ordine idoneo è convalidato, il modulo apre un credito, ne segue la scadenza, avvia solleciti graduali secondo un calendario che definisci tu e calcola gli interessi di mora e l’indennità forfettaria di recupero di 40 € previsti dal Codice di commercio francese.
Tre livelli di sollecito sono forniti all’installazione (sollecito cortese, sollecito fermo con penali e PDF, messa in mora) e restano interamente configurabili. Una dashboard dedicata centralizza l’importo in essere, il bilancio per anzianità e lo storico degli invii.
Installazione
- Colloca la cartella
dfdunningnella directory/modules/del tuo negozio, oppure installa l’archivio ZIP da Moduli > Gestore dei moduli. - Clicca su Installa. Il modulo crea le sue tabelle, i suoi tre livelli di sollecito predefiniti, la sua configurazione iniziale, un token di sicurezza per il cron e la scheda di amministrazione in Ordini > Solleciti insoluti (DF Dunning).
- Svuota la cache di PrestaShop se necessario da Parametri avanzati > Prestazioni.
Configurazione
La configurazione è disponibile da Moduli > Gestore dei moduli > dfdunning > Configura. Le impostazioni principali sono:
- Moduli di pagamento monitorati: i moduli i cui ordini aprono un credito. Per impostazione predefinita, il bonifico bancario (
ps_wirepayment). - Stati d’ordine monitorati: gli stati considerati «in attesa di pagamento». Per impostazione predefinita, lo stato In attesa di pagamento tramite bonifico.
- Termine di pagamento: numero di giorni concessi prima della scadenza. Per impostazione predefinita 30 giorni.
- Tasso delle penali di mora: tasso annuo applicato. Per impostazione predefinita 12,15 % (tasso della BCE maggiorato di 10 punti).
- Indennità forfettaria: importo fisso per fattura in ritardo. Per impostazione predefinita 40 €.
- Intervallo minimo tra due solleciti: salvaguardia anti-spam, per impostazione predefinita 3 giorni.
- Invio automatico: attiva l’invio dei solleciti all’esecuzione del cron.
- Copia nascosta (BCC): indirizzo che riceve una copia di ogni sollecito, per la traccia contabile.
Il tasso predefinito corrisponde al tasso di rifinanziamento della BCE maggiorato di 10 punti. Questo tasso evolve: ricordati di rivederlo ogni semestre (gennaio e luglio) nella configurazione.
I tre livelli di sollecito
Un livello di sollecito definisce quando e come un cliente viene sollecitato. Ogni livello si configura dalle impostazioni: posizione nella sequenza, termine di attivazione (in giorni dopo la scadenza), modello di e-mail, aggiunta o meno delle penali, allegato PDF e attivazione.
Livello 1 — Sollecito cortese (G+7)
Un semplice promemoria, senza penali né allegato, inviato 7 giorni dopo la scadenza. Obiettivo: segnalare la dimenticanza senza compromettere la relazione commerciale.
Livello 2 — Sollecito fermo (G+15)
Un sollecito più fermo, con il dettaglio degli interessi di mora e dell’indennità forfettaria, accompagnato da una lettera PDF. Inviato 15 giorni dopo la scadenza.
Livello 3 — Messa in mora (G+30)
Una messa in mora formale che ricorda le somme dovute, le penali e il riferimento all’articolo 1231-6 del Codice civile francese, con lettera PDF e un termine di pagamento di 8 giorni. Inviata 30 giorni dopo la scadenza.
I termini e il contenuto di ogni livello sono indicativi: adattali alla tua politica di recupero e alle tue condizioni generali di vendita.
Calcolo delle penali
Per ogni credito in ritardo, il modulo calcola:
- Gli interessi di mora: importo dovuto × (tasso / 100) × (giorni di ritardo / 365).
- L’indennità forfettaria di recupero: un importo fisso per fattura (40 € per impostazione predefinita), dovuto dal primo giorno di ritardo.
L’importo dovuto è determinato a partire dal totale pagato e dal totale effettivamente incassato sull’ordine, il che gestisce i pagamenti parziali. La base giuridica è costituita dagli articoli L441-10 e D441-5 del Codice di commercio francese per l’indennità e le penali, e dall’articolo 1231-6 del Codice civile francese per la messa in mora.
I modelli di lettera riflettono il quadro giuridico francese in vigore. Falli validare dal tuo consulente legale e adattali alla tua attività prima della fase di messa in mora. DataFirefly non fornisce consulenza legale.
Automazione tramite cron
La sincronizzazione dei crediti e l’invio automatico dei solleciti si basano su un controller front protetto da un token. L’URL completo, con il token generato all’installazione, è mostrato nella schermata di configurazione, pronto da copiare. Ha la forma seguente:
https://tuonegozio.tld/index.php?fc=module&module=dfdunning&controller=cron&token=IL_TUO_TOKENProgramma una chiamata quotidiana, ad esempio alle 7 del mattino, tramite l’attività pianificata (crontab) del tuo server:
0 7 * * * curl -s "https://tuonegozio.tld/index.php?fc=module&module=dfdunning&controller=cron&token=IL_TUO_TOKEN"A ogni esecuzione, il modulo aggiorna i crediti (scadenze, chiusure, esclusioni) e poi, se l’invio automatico è attivato, spedisce i solleciti giunti a scadenza rispettando l’intervallo minimo configurato.
Il token protegge l’accesso al cron: senza di esso, l’URL restituisce un errore. Rigeneralo se ritieni che sia stato esposto.
Dashboard dei crediti
La dashboard, in Ordini > Solleciti insoluti (DF Dunning), presenta:
- Sei indicatori chiave: importo in essere totale, importo scaduto, crediti in ritardo, pratiche aperte, penali teoriche e solleciti del mese.
- Un bilancio per anzianità che ripartisce l’importo in essere per fascia: non scaduto, 1-30, 31-60, 61-90 e oltre 90 giorni.
- Un elenco filtrabile dei crediti (aperti, in ritardo, pagati, esclusi), con azioni per riga: inviare un livello di sollecito a scelta, contrassegnare come pagato, escludere o reincludere, scaricare la lettera PDF.
Una pratica si chiude automaticamente quando l’ordine passa a uno stato pagato, e viene esclusa se l’ordine è annullato, rimborsato o in errore di pagamento.
Lettere PDF ed e-mail
I solleciti sono inviati per e-mail (versioni HTML e testo) e, a seconda del livello, accompagnati da una lettera PDF. Le lettere sono generate in francese o inglese secondo la lingua dell’ordine. I modelli usano variabili sostituite all’invio: nome, cognome, riferimento dell’ordine, importo dovuto, data di scadenza, giorni di ritardo, penali, indennità forfettaria, totale dovuto, tasso applicato e nome del negozio.
Le e-mail sono modificabili da Design > Traduzioni > Traduzioni delle e-mail, lingua per lingua, come qualsiasi e-mail di PrestaShop.
FAQ
Quali ordini vengono sollecitati?
Solo quelli che corrispondono ai moduli di pagamento e agli stati selezionati nella configurazione. Per impostazione predefinita, gli ordini pagati tramite bonifico in attesa di pagamento.
Un ordine pagato parzialmente è gestito?
Sì. L’importo dovuto tiene conto delle somme già incassate; viene sollecitata solo la parte restante, e la pratica si chiude quando il saldo è regolato.
Il modulo è compatibile con PrestaShop 9 e multi-negozio?
Sì. I controller di amministrazione si basano su ModuleAdminController per la compatibilità con PrestaShop 8 e 9, senza Composer, e il modulo gestisce il contesto multi-negozio.
Posso avviare un sollecito manualmente?
Sì. Dalla dashboard, puoi inviare immediatamente il livello che preferisci per un dato credito, indipendentemente dal cron.