Fatturazione Riepilogativa B2B — Documentazione
Installa, configura e automatizza la fatturazione riepilogativa mensile B2B su PrestaShop 8 e 9.
Panoramica
Fatturazione Riepilogativa raggruppa tutti gli ordini di un cliente professionale su un periodo (il mese precedente, per impostazione predefinita) in un’unica fattura consolidata. Invece di una fattura per ordine, i tuoi clienti B2B ricevono un’unica fattura mensile, numerata in sequenza, con la ripartizione IVA per aliquota e il dettaglio ordine per ordine. Il modulo genera il PDF con il motore nativo di PrestaShop, lo invia via email e rimuove le fatture individuali dalle email d’ordine inviate ai clienti professionali.
Le fatture individuali di PrestaShop non vengono mai eliminate: continuano a essere generate e restano disponibili nel tuo back office e nella cronologia degli ordini. Viene alleggerita del suo PDF individuale solo l’email inviata al cliente B2B.
Installazione
Installa il modulo come qualsiasi modulo PrestaShop, da Moduli > Gestore moduli > Carica un modulo, inviando il file ZIP. All’installazione, il modulo crea le sue tabelle, la sua scheda di amministrazione e un valore di token casuale per il cron. Non è richiesta alcuna dipendenza da Composer.
Configurazione
Vai su Moduli > Gestore moduli, poi fai clic su Configura accanto a Fatturazione Riepilogativa. La pagina di configurazione raccoglie tutte le impostazioni.
Gruppi di clienti B2B
Spunta il o i gruppi di clienti considerati professionali. Solo i clienti di questi gruppi vedono i loro ordini consolidati, ricevono la fattura riepilogativa e accedono all’area «Le mie fatture riepilogative». Questa impostazione definisce il tuo perimetro B2B.
Stati d’ordine inclusi
Seleziona gli stati d’ordine che rendono un ordine idoneo alla consolidazione (per impostazione predefinita: pagamento accettato, preparazione in corso, spedito, consegnato). Un ordine il cui stato corrente non figura in questo elenco viene ignorato al momento della generazione.
Giorno di generazione
Scegli il giorno del mese (dall’1 al 28) in cui il cron attiva la generazione del mese precedente. Un giorno compreso tra 1 e 28 garantisce che la data esista in tutti i mesi.
Prefisso e numerazione
Definisci il prefisso di numerazione (predefinito REC). Le fatture riepilogative sono numerate in sequenza nel formato PREFISSO-AAAA-00042, tramite un contatore dedicato. I numeri non vengono mai riutilizzati, nemmeno dopo l’eliminazione di una fattura.
Invio automatico e pulizia delle email
Due interruttori governano il comportamento di invio:
- Invio automatico via email: al momento della generazione (cron o manuale), la fattura riepilogativa viene inviata al cliente con il PDF allegato.
- Rimuovere la fattura individuale dalle email d’ordine: per i clienti B2B, il PDF di fattura individuale viene rimosso dalle email d’ordine, in modo che resti un solo invio pulito: la fattura riepilogativa mensile.
Note legali e condizioni di pagamento
Due aree di testo multilingua ti permettono di personalizzare le note legali (per impostazione predefinita, un richiamo all’articolo 289 I-3 del Codice Generale delle Imposte francese relativo alla fattura periodica riepilogativa) e le condizioni di pagamento mostrate a piè di fattura. Questi testi possono essere inseriti in ciascuna lingua del negozio.
Automazione tramite cron
La generazione automatica si basa su una URL di cron protetta da un token. Recupera la URL completa (token incluso) nel pannello informativo della pagina di configurazione, poi programmala nello scheduler del tuo server. Esempio di voce crontab per un’attivazione giornaliera:
0 6 * * * wget -q -O /dev/null "https://iltuonegozio.tld/module/dfdeferredinvoicing/cron?token=IL_TUO_TOKEN"Il cron è idempotente: genera la fattura di un cliente solo se non esiste già per il periodo. Puoi quindi eseguirlo ogni giorno senza rischi — solo il giorno di generazione configurato attiva realmente l’elaborazione del mese precedente.
Parametri opzionali
&force=1: forza la generazione indipendentemente dal giorno del mese.&month=6&year=2026: punta a un periodo specifico (utile per rieseguire un mese passato).
La risposta viene restituita in formato JSON, con il numero di clienti elaborati, fatture create e ordini consolidati.
Per testare subito, apri la URL del cron con &force=1 nel tuo browser: otterrai il riepilogo JSON della generazione senza attendere il giorno programmato.
Uso quotidiano
Scheda «Fatture riepilogative»
Una scheda Fatture riepilogative viene aggiunta sotto Ordini. Elenca tutte le fatture riepilogative generate, con il numero, il cliente, il periodo, il numero di ordini, il totale con IVA e lo stato di invio dell’email. Ogni riga consente di scaricare il PDF, reinviare l’email o eliminare la fattura.
Generazione manuale
In cima a questa scheda, un pannello consente di generare manualmente un periodo (mese e anno, precompilati con il mese precedente) per tutti i clienti B2B o per un cliente specifico. È utile per un recupero occasionale o per emettere la fattura di un cliente su richiesta.
Area cliente
I clienti professionali dispongono di un link «Le mie fatture riepilogative» nel loro account, dove trovano e scaricano tutte le loro fatture consolidate. Questo link appare solo per i clienti dei gruppi B2B configurati.
Cosa contiene la fattura riepilogativa
Ogni fattura mostra: i dati del negozio e l’indirizzo di fatturazione del cliente (ragione sociale, partita IVA), il dettaglio ordine per ordine (data, riferimento, numero di fattura PrestaShop d’origine, importo), la ripartizione IVA per aliquota (prodotti e spese di spedizione), con una riga di rettifica arrotondamento se compare una piccola differenza, poi i totali imponibile / IVA / totale con IVA, e infine le tue condizioni di pagamento e note legali.
Gli ordini sono raggruppati per valuta: un cliente che ha ordinato in due valute diverse nello stesso periodo riceve una fattura riepilogativa per valuta.
Garanzie e limiti
- Anti-duplicati: ogni ordine viene registrato in una tabella di collegamento in cui è univoco. Un ordine già consolidato non può mai essere riutilizzato in un’altra fattura riepilogativa.
- Eliminazione: eliminare una fattura riepilogativa libera i suoi ordini, che tornano idonei a una nuova consolidazione. Il numero eliminato, tuttavia, non viene riassegnato.
- Fatture individuali: restano visibili nella cronologia ordini lato cliente; viene alleggerita solo l’email. Nasconderle romperebbe la contabilità di PrestaShop.
- Ripartizione IVA: la suddivisione per aliquota viene ricostruita a partire dalle righe d’ordine e dalla spedizione; può essere approssimativa nel raro caso in cui uno stesso prodotto accumuli più imposte sovrapposte.
Compatibilità
Fatturazione Riepilogativa è compatibile con PrestaShop 8.0 a 9.x, sia in negozio singolo sia in multinegozio, nelle cinque lingue del catalogo (francese, inglese, spagnolo, tedesco, italiano), senza alcuna dipendenza da Composer.