# 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…

- Pagina: <https://www.datafirefly.com/it/documentation/dfproforma/>
- Lingua: it
- Aggiornato il: 2026-08-02
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfproforma/index.md), [en](https://www.datafirefly.com/en/documentation/dfproforma/index.md), [es](https://www.datafirefly.com/es/documentation/dfproforma/index.md), [de](https://www.datafirefly.com/de/documentation/dfproforma/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfproforma/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfproforma/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfproforma/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## 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.

**Caso d'uso principale:** contesti B2B in cui il cliente deve ottenere una proforma prima di confermare il pagamento o di far approvare una spesa internamente.

## 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_.

Compatibilità: PrestaShop da 8.0 a 8.x, PHP da 7.4 a 8.3, multinegozio.

## 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.

Raccomandazione: attivare sullo stato _Pagamento accettato_ per i flussi standard, oppure su _In attesa di pagamento_ per i contesti B2B (la proforma precede il pagamento).

### 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`.

In multinegozio la numerazione è isolata per negozio: la chiave composta `proforma_number + id_shop` garantisce l'unicità senza duplicati tra negozi.

### 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.