# DataFirefly Dunning — Documentazione > 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… - Pagina: - Lingua: it - Aggiornato il: 2026-07-16 - Altre lingue: [fr](https://www.datafirefly.com/documentation/dfdunning/index.md), [en](https://www.datafirefly.com/en/documentation/dfdunning/index.md), [es](https://www.datafirefly.com/es/documentation/dfdunning/index.md), [de](https://www.datafirefly.com/de/documentation/dfdunning/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfdunning/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfdunning/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfdunning/index.md) - Indice: ## 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 1. Colloca la cartella `dfdunning` nella directory `/modules/` del tuo negozio, oppure installa l'archivio ZIP da **Moduli > Gestore dei moduli**. 2. 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)**. 3. 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_TOKEN ``` Programma 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.