DataFirefly Editor fatture PDF per PrestaShop

Presentazione

Il modulo dfinvoiceeditor sostituisce l’impaginazione delle fatture PDF di PrestaShop 8 e 9 con la tua, impostata dal back-office. Non modifica alcun file .tpl e non installa override: quando PrestaShop genera una fattura, il modulo fornisce intestazione, corpo e piè di pagina propri. Disattivando il modulo o il suo interruttore principale torna la fattura originale.

Le impostazioni valgono per tutte le fatture prodotte da PrestaShop: quella allegata alle e-mail d’ordine, quella scaricata dall’account cliente e quelle stampate singolarmente o in blocco dal back-office. In opzione, i documenti di trasporto adottano la stessa presentazione.

Installazione

1. In Moduli > Gestione moduli, clicca su Carica un modulo e invia il file dfinvoiceeditor.zip.
2. Il modulo crea la sua tabella di impostazioni, la cartella img/dfinvoiceeditor per il logo e la pagina Ordini > Editor fatture.
3. Apri la pagina. L’impaginazione del modulo è attiva fin dall’installazione con impostazioni predefinite sobrie: genera un’anteprima per vederla.

L’editor

La pagina è divisa in sezioni elencate nella colonna di sinistra. Sotto l’elenco, uno schema della pagina A4 evidenzia la zona della fattura in modifica. La barra in fondo indica se ci sono modifiche non salvate e contiene il pulsante Salva.

I testi stampati esistono in ogni lingua del negozio. I pulsanti di lingua sotto l’intestazione scelgono la lingua mostrata in tutti i campi multilingua.

Anteprima e confronto

In alto nella pagina, scegli una fattura recente del negozio, poi Fattura o Documento di trasporto:

• Anteprima apre il PDF in una nuova scheda con le impostazioni sullo schermo, anche non salvate. Solo un logo appena caricato attende il salvataggio.
• Confronta con la fattura PrestaShop apre lo stesso documento con l’impaginazione originale.

Impostazioni generali

• Usa questa impaginazione per le fatture: l’interruttore principale. Disattivato, PrestaShop torna a stampare la propria fattura, senza perdere le impostazioni.
• Usa questa impaginazione anche per i documenti di trasporto: vedi la sezione dedicata.
• Lingua della fattura: quella dell’ordine (consigliato) o quella del dipendente che genera il PDF.
• Carattere: automatico per lingua, Helvetica, DejaVu Sans, Times o Courier. DejaVu Sans copre anche polacco, greco e cirillico.
• Dimensione del testo da 7 a 12 pt e quattro colori: accento (titolo, intestazione della tabella, totale da pagare, titoli di sezione), testo, testo secondario e testo sul colore di accento.

Intestazione e logo

Scegli il logo fattura del negozio, un logo dedicato alle fatture o nessun logo. Il logo dedicato accetta PNG, JPG o GIF fino a 2 MB; un PNG largo almeno 600 px si stampa nitido. Imposta la larghezza da 10 a 90 mm e la posizione a sinistra o a destra. L’altezza è limitata a 26 mm perché l’intestazione non copra mai il contenuto.

Indirizzi e riepilogo

Il blocco venditore è un testo libero con variabili, per impostazione predefinita {shop_name}, {shop_address} e {shop_details} (i dati di Parametri negozio > Contatti). Gli indirizzi di fatturazione e di consegna usano il formato del paese; quello di consegna può essere nascosto se coincide con la fatturazione. Partita IVA, telefono ed e-mail del cliente sono opzionali.

La barra di riepilogo, una fascia colorata sotto gli indirizzi, mostra a scelta riferimento e data dell’ordine, pagamento, scadenza, corriere e numero di tracciamento, più i campi personalizzati posti nella barra.

Righe prodotto

La tabella elenca le 12 colonne disponibili: immagine, riferimento, nome, EAN-13, riferimento fornitore, prezzo unitario IVA esclusa, prezzo unitario IVA inclusa, sconto, aliquota, quantità, totale IVA esclusa, totale IVA inclusa. Per ognuna, scegli se stamparla, modifica il titolo in ogni lingua, imposta larghezza relativa e allineamento e cambia l’ordine con le frecce. La striscia sopra mostra la ripartizione delle larghezze, adattate alla pagina.

• Le combinazioni («Taglia: M, Colore: Blu») passano su una seconda riga più piccola.
• Le personalizzazioni inserite dal cliente si stampano sotto il nome del prodotto.
• La miniatura del prodotto misura da 6 a 25 mm.
• Linea sotto ogni riga, griglia completa o nessun bordo; righe alternate ombreggiate opzionali.
• I titoli delle colonne si ripetono in cima a ogni pagina di una fattura lunga.

Totali

• Riepilogo IVA per aliquota: imponibile e imposta per aliquota, con prodotti, spedizione, confezione regalo ed ecotassa raggruppati.
• Nascondi le righe a zero per sconto e confezione regalo.
• Elenca i pagamenti ricevuti con metodo, importo e data.
• Contenuti aggiunti da altri moduli: ciò che altri moduli aggiungono alle fatture tramite l’hook displayPDFInvoice resta stampato, dopo i totali, dopo le righe prodotto o nascosto.

Pagamento e scadenza

Scadenza e importo da pagare

I termini di pagamento in giorni dopo la data della fattura stampano la data di scadenza nella barra di riepilogo e compilano la variabile {due_date}. Lascia 0 per non stampare la scadenza.

Quando una fattura è pagata in parte, sotto il totale IVA inclusa compaiono le righe Già pagato e Importo da pagare. L’importo pagato è la somma dei pagamenti collegati alla fattura in PrestaShop. Il timbro opzionale Pagata si stampa sotto i totali quando la fattura è saldata.

Coordinate bancarie e codice QR SEPA

Scegli quando stampare il blocco bancario: mai, solo se resta un importo da pagare, o sempre. Compila intestatario (il nome del negozio se vuoto), banca, IBAN, BIC e causale, per impostazione predefinita {invoice_number}. L’IBAN è controllato con le cifre di controllo: un IBAN errato viene segnalato e blocca il salvataggio.

Il codice QR SEPA (formato EPC069-12) contiene beneficiario, IBAN, BIC, importo ancora dovuto e causale. Il cliente lo scansiona con l’app della banca e il bonifico è già compilato. Si stampa solo sulle fatture in euro e solo se resta un importo da pagare.

Campi personalizzati

Aggiungi tutti i campi che servono: numero d’ordine d’acquisto, codice fiscale del cliente, condizioni di pagamento, messaggio del cliente. Ogni campo ha:

• un’etichetta e un contenuto in ogni lingua, con grassetto, corsivo e sottolineato;
• una posizione: barra di riepilogo, sotto gli indirizzi, sotto le righe prodotto, sotto i totali o nel piè di pagina;
• la scelta Stampa su: fatture, documenti di trasporto o entrambi;
• l’opzione Nascondi quando le sue variabili sono vuote;
• condizioni di stampa (vedi sotto).

Il pannello Variabili inserisce una variabile nell’ultimo campo modificato. Le variabili coprono il negozio (nome, indirizzo, e-mail, telefono, dati), l’ordine e la fattura (numero, date, scadenza, importo da pagare, pagamento, corriere, tracciamento, numero del documento di trasporto, valuta) e il cliente (nome, azienda, e-mail, partita IVA, SIRET, APE, DNI, telefoni, messaggio lasciato all’ordine).

Diciture legali per paese

Ogni regola contiene un testo per lingua e delle condizioni. Tutte le regole che corrispondono alla fattura vengono stampate, nell’ordine dell’elenco, in un riquadro sotto i totali o nel piè di pagina.

Condizioni

• Destinazione: tutti i paesi, paese del negozio, Unione europea, UE escluso il paese del negozio, fuori UE o un elenco di paesi. Clicca su un paese per selezionarlo o rimuoverlo.
• Cliente: qualsiasi, con o senza partita IVA, azienda o privato.
• IVA sulla fattura: con o senza IVA.

Il paese usato per le regole è per impostazione predefinita quello dell’indirizzo che PrestaShop usa per calcolare le imposte; puoi forzare l’indirizzo di fatturazione o di consegna.

Regole di esempio

Tre regole sono installate inattive: cessione intracomunitaria non imponibile (articolo 138 della direttiva 2006/112/CE, con la partita IVA del cliente), esportazione fuori UE (articolo 146) e condizioni di mora B2B in Francia (penali e indennità forfettaria di 40 EUR). Fai verificare il testo dal tuo commercialista prima di attivarle.

Piè di pagina

Il testo del piè di pagina si stampa in fondo a ogni pagina, per impostazione predefinita {shop_name}, {shop_address_inline}. Limitalo a tre righe: PrestaShop riserva poco spazio al piè di pagina, i testi lunghi vanno in un campo personalizzato sotto i totali. Si possono aggiungere il testo legale libero e il testo del piè di pagina di Ordini > Fatture.

Testi

La sezione Testi elenca ogni parola stampata sulla fattura: titolo, numero, date, titoli degli indirizzi, totali, riepilogo IVA, scadenza, coordinate bancarie, testi dei documenti di trasporto. Sono precompilati in italiano, inglese, francese, spagnolo, tedesco, olandese, polacco e portoghese, e modificabili in ogni lingua.

Documenti di trasporto

Attiva Usa questa impaginazione anche per i documenti di trasporto nelle impostazioni generali. Il documento riprende logo, colori, indirizzi, barra di riepilogo e righe prodotto, senza alcun prezzo: si stampano solo le colonne immagine, riferimento, nome, EAN-13, riferimento fornitore e quantità. Totali, coordinate bancarie, diciture legali e testo legale della fattura non compaiono. L’intestazione riporta numero del documento, data e numero di fattura.

Backup e trasferimento

Esporta le impostazioni scarica un file JSON con tutte le impostazioni del negozio, testi compresi. I testi sono identificati dal codice lingua, quindi il file si importa in un altro negozio o in un’altra installazione anche se gli ID delle lingue cambiano. Il logo non è incluso. Importa sostituisce tutte le impostazioni del negozio corrente dopo conferma.

Ripristina le impostazioni predefinite, nella barra in basso, riporta tutte le impostazioni e i testi originali mantenendo il logo caricato.

Risoluzione dei problemi

L’anteprima indica che l’editor non ha potuto gestire la fattura

Il messaggio dopo questa frase indica la causa, registrata anche in Parametri avanzati > Log. In questo caso PrestaShop produce la sua fattura originale: nessuna fattura resta bloccata.

Un dipendente ottiene la fattura originale

PrestaShop non esegue gli hook di un modulo quando il profilo del dipendente connesso non ha il permesso Visualizza su quel modulo. Concedilo in Parametri avanzati > Team > Permessi > Moduli. Le fatture inviate ai clienti e scaricate dal loro account non sono interessate.

Il piè di pagina copre il contenuto

Accorcia il testo del piè di pagina, sposta le diciture lunghe in un campo personalizzato sotto i totali o scegli la posizione «In un riquadro sotto i totali» per le diciture legali.

Il codice QR non compare

Verifica che il blocco bancario sia attivo, l’IBAN salvato, la fattura in euro e che resti un importo da pagare. In modalità «Sempre», una fattura saldata mostra le coordinate senza codice QR.

Le note di credito mantengono la vecchia impaginazione

La versione 1.0.0 copre fatture e documenti di trasporto. Le note di credito mantengono l’impaginazione di PrestaShop.