dfproforma: generazione automatica di fatture proforma

Presentazione

dfproforma automatizza la generazione di fatture proforma in PrestaShop 8. Non appena un ordine raggiunge uno stato configurato, il modulo crea un PDF personalizzato (logo, numerazione, piè di pagina multilingua) e lo mette a disposizione del cliente nella sua area account. La generazione manuale dalla scheda ordine resta disponibile in qualsiasi momento.

Installazione

1. Nel back office PrestaShop, vai su Moduli > Gestore moduli.
2. Clicca su Carica un modulo e seleziona il file dfproforma.zip.
3. Clicca su Installa. Le tabelle SQL vengono create automaticamente.
4. Il modulo compare nell’elenco con il nome Proforma Invoice Generator.

Configurazione generale

Accedi alla configurazione da Moduli > Gestore moduli > dfproforma > Configura.

Stati che attivano la generazione

Seleziona gli stati d’ordine che devono attivare la generazione automatica della proforma. Non appena un ordine passa a uno di questi stati, il PDF viene creato e archiviato sul server.

Logo PDF

Carica un logo dedicato alle proforma (formati accettati: PNG, JPG). Se questo campo resta vuoto, viene usato per impostazione predefinita il logo del negozio.

Allegato email

Attiva l’opzione Allega la proforma alle email di conferma perché il PDF venga allegato automaticamente alle email d’ordine (order_conf, bankwire, cheque, payment).

Numerazione delle proforma

La numerazione è configurabile per ogni lingua installata. Per ciascuna lingua:

• Prefisso: testo aggiunto prima del numero (ad esempio PROFORMA, PRO).
• Numero di partenza: intero da cui parte il contatore (ad esempio 1 o 1000).
• Numero di cifre: lunghezza del contatore con zeri di riempimento (ad esempio 6 dà 000001).

Esempio: prefisso PROFORMA, partenza 1, 6 cifre, quindi la prima proforma è numerata PROFORMA-000001.

Piè di pagina PDF

Inserisci il testo del piè di pagina per ogni lingua attiva. Questo testo compare in fondo a ogni proforma generata nella lingua corrispondente.

Generazione manuale dal back office

Su ogni scheda ordine compare una card Fattura proforma nel pannello laterale:

• Se esiste una proforma: link di download diretto del PDF.
• Se non esiste alcuna proforma: pulsante Genera la proforma per crearla immediatamente, qualunque sia lo stato dell’ordine.

Download lato cliente

Il cliente accede alle sue proforma dall’area account:

• Pagina di dettaglio dell’ordine: un pulsante Scarica la proforma compare direttamente sotto le informazioni d’ordine.
• Storico degli ordini: i link proforma sono integrati via JavaScript senza richiesta AJAX aggiuntiva (aggiunto in v1.0.2).

L’accesso è protetto dalla chiave sicura dell’ordine (secure_key): un cliente può scaricare solo le proprie proforma.

Struttura del PDF

Ogni proforma generata contiene:

• Numero di proforma (secondo la numerazione configurata)
• Data di generazione
• Logo del negozio (o logo personalizzato)
• Dati del negozio e dell’acquirente
• Tabella dei prodotti con quantità e prezzi unitari IVA esclusa e IVA inclusa
• Totali (imponibile, IVA, totale, spese di spedizione)
• Piè di pagina personalizzato nella lingua dell’ordine

Multinegozio

dfproforma è nativamente compatibile con la modalità multinegozio di PrestaShop 8:

• La configurazione (stati, logo, numerazione, piè di pagina) è indipendente per negozio.
• I file PDF sono archiviati in una cartella separata per negozio.
• La numerazione è univoca per combinazione numero più negozio.

Disinstallazione

La disinstallazione elimina la tabella SQL df_proforma e tutte le chiavi di configurazione con prefisso DFPROFORMA_. I file PDF già generati restano sul server.

Changelog

• v1.0.2: integrazione nello storico degli ordini tramite l’hook actionFrontControllerSetMedia; visualizzazione dei link senza AJAX aggiuntivo.
• v1.0.1: correzioni minori di stabilità.
• v1.0.0: versione iniziale, generazione per stato, PDF personalizzabile, allegato email, download lato cliente.