# Richiesta Preventivo B2B (Express Quote) — Guida completa

> Panoramica Il modulo Richiesta Preventivo B2B Multi-Prodotto (dfexpressquote) aggiunge un pulsante « Richiedi un preventivo » nel piè di pagina del carrello. Con un clic, il tuo cliente professionale trasforma…

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

## Panoramica

Il modulo **Richiesta Preventivo B2B Multi-Prodotto** (`dfexpressquote`) aggiunge un pulsante **« Richiedi un preventivo »** nel piè di pagina del carrello. Con un clic, il tuo cliente professionale trasforma il suo carrello in un **preventivo PDF** pulito, ricevuto via email, senza dover creare un account. Una copia viene inviata al tuo negozio e ogni preventivo è monitorato nel back-office con i suoi stati.

Il PDF viene generato con TCPDF, già incluso in PrestaShop: nessuna libreria esterna né dipendenza da Composer. Il documento non viene mai salvato sul server, viene rigenerato su richiesta da un'istantanea del carrello salvata nel database.

## Compatibilità

- PrestaShop 8.0 a 9.x
- PHP 7.4 a 8.3
- Negozio singolo e multinegozio
- 5 lingue: FR, EN, ES, DE, IT
- Tema Classic e temi personalizzati (finestra modale in JavaScript nativo, indipendente dal tema)
- Senza dipendenze (né Composer né framework)

## Installazione

1. Nel back-office, apri **Moduli > Gestore dei moduli**.
2. Clicca su **Carica un modulo** e seleziona il file `dfexpressquote.zip`.
3. Una volta installato, clicca su **Configura**.

All'installazione, il modulo crea la sua tabella dei preventivi, registra i suoi hook (`actionFrontControllerSetMedia`, `displayShoppingCartFooter`, `displayExpressCheckout`), aggiunge una scheda **Express Quote** sotto il menu Ordini e inizializza le sue impostazioni predefinite.

## Configurazione

### Visualizzazione e pulsante

- **Etichetta del pulsante**: testo mostrato nel piè di pagina del carrello, personalizzabile.
- **Richiedi i dati di contatto**: attiva la modalità modulo di contatto. Disattivata, il modulo passa alla modalità 1 clic istantanea (il preventivo PDF viene generato senza alcun modulo).

### Preventivo

- **Prefisso del riferimento**: prefisso dei numeri di preventivo (predefinito `DEV`), seguito dalla data e da un contatore.
- **Periodo di validità**: numero di giorni di validità del preventivo, usato per calcolare la data di scadenza.
- **Mostra IVA**: mostra le colonne e i totali IVA sul PDF.
- **Mostra indirizzo**: aggiunge il blocco indirizzo del destinatario al PDF.
- **Note legali IVA** e **Condizioni**: testi liberi aggiunti in fondo al preventivo.

### Email

- **Email al cliente**: invia automaticamente il preventivo PDF in allegato al cliente.
- **Email al negozio**: invia una notifica al tuo team.
- **Indirizzo email di notifica**: destinatario interno (per impostazione predefinita l'email del negozio).

## Funzionamento

### Due modalità di richiesta

In **modalità modulo**, un clic apre una finestra modale leggera in cui il cliente indica la sua azienda, il suo nome, la sua email e, facoltativamente, il suo telefono, la sua partita IVA intracomunitaria e un messaggio. In **modalità 1 clic istantanea**, il preventivo PDF viene prodotto immediatamente, senza modulo. Non è richiesta la creazione di un account in nessuno dei due casi.

### Il preventivo PDF

Il PDF riprende l'identità del tuo negozio: logo, recapiti, riferimento univoco, date di emissione e validità, blocco destinatario, tabella dei prodotti (riferimento, descrizione, quantità, prezzo unitario al netto, IVA, totale al netto) e totali al netto, IVA e lordo, seguiti dalle tue note e condizioni. Non viene mai salvato su disco: viene rigenerato su richiesta dall'istantanea del carrello salvata nel database, il che evita l'accumulo di file e garantisce un documento sempre coerente.

### Email automatiche

In base alla tua configurazione, il cliente riceve il suo preventivo in allegato e il tuo negozio viene notificato all'indirizzo che scegli. I modelli di email sono forniti in francese e inglese.

### Monitoraggio nel back-office

La scheda **Express Quote** elenca tutti i preventivi con il loro riferimento, destinatario, importo lordo, stato e data. Apri un preventivo per vederne il dettaglio, modifichi il suo stato (nuovo, inviato, accettato, rifiutato, convertito) e rigeneri o scarichi il PDF in qualsiasi momento.

### Sicurezza

Il download del PDF è protetto da un token deterministico derivato dalla chiave del tuo negozio. Ogni richiesta è protetta da un'esca anti-bot e da un token legato al carrello corrente, e agisce solo sul carrello della sessione in corso.

## FAQ e risoluzione dei problemi

### Il cliente ha bisogno di un account?

No. La richiesta di preventivo funziona in modalità ospite. La modalità 1 clic istantanea genera persino il PDF senza alcun modulo.

### Bisogna installare una libreria PDF?

No. Il preventivo viene generato con TCPDF, già incluso in PrestaShop 8 e 9. Nessuna dipendenza da Composer.

### Il pulsante non appare nella pagina del carrello

Svuota la cache di PrestaShop (Parametri avanzati > Prestazioni) e, durante i test, disattiva la combinazione/compressione (CCC). Il pulsante appare solo quando il carrello contiene almeno un articolo. Se il tuo tema non attiva l'hook `displayShoppingCartFooter`, il pulsante viene inserito tramite il caricamento delle risorse sul front.

### I file PDF si accumulano sul server?

No. Il preventivo non viene salvato su disco: viene rigenerato su richiesta dall'istantanea del carrello nel database.

### È compatibile con PrestaShop 9?

Sì. Il modulo è compatibile con PrestaShop 8 e 9, in multinegozio e multilingua.
