# Fatture Proforma PDF per WooCommerce — Documentazione

> Panoramica Il plugin Fatture Proforma PDF per WooCommerce genera fatture proforma professionali in formato PDF direttamente dai tuoi ordini WooCommerce. Ogni documento include automaticamente i prodotti con i loro attributi…

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

## Panoramica

Il plugin **Fatture Proforma PDF per WooCommerce** genera fatture proforma professionali in formato PDF direttamente dai tuoi ordini WooCommerce. Ogni documento include automaticamente i prodotti con i loro attributi (dimensioni, opzioni, personalizzazioni), la totalità degli importi WooCommerce (subtotale, spedizione, sconti, IVA) e i dati della tua azienda.

Una fattura proforma è un documento non vincolante emesso prima del pagamento. Non sostituisce la fattura definitiva.

## Installazione

### 1. Installare il plugin

1. Nell'amministrazione WordPress vai su **Plugin → Aggiungi nuovo → Carica plugin**.
2. Seleziona l'archivio ZIP del plugin e fai clic su **Installa ora**.
3. Attiva il plugin.

### 2. Requisiti

- WordPress 6.0 o superiore
- WooCommerce 7.0 o superiore (compatibile HPOS)
- PHP 8.0 o superiore

## Configurazione

Le impostazioni si trovano in **WooCommerce → Proforma**, organizzate in tre schede.

### Scheda Azienda

Inserisci i dati che appariranno nel blocco emittente del PDF: logo (dalla libreria media), ragione sociale, indirizzo completo, telefono, e-mail, partita IVA intracomunitaria e numero di iscrizione al registro delle imprese.

### Scheda Documento

- **Prefisso numerazione**: ad esempio `PRO-` produce PRO-00001, PRO-00002, ecc. Il contatore si incrementa automaticamente e ogni numero resta legato al proprio ordine.
- **Validità**: numero di giorni di validità della proforma (la data di scadenza viene stampata sul documento).
- **Simbolo e posizione della valuta**: 10,00 € oppure € 10,00.
- **Colore accento**: colore delle bande, dei titoli e delle intestazioni di tabella del PDF.
- **Testo a piè di pagina**: dicitura legale stampata in fondo a ogni pagina.

### Scheda E-mail

Attiva **Allega automaticamente** per allegare la proforma alle e-mail di conferma ordine (nuovo ordine, ordine in lavorazione, ordine in sospeso).

## Generare una proforma

### Dalla scheda ordine

Un riquadro **Fattura Proforma** appare nella colonna laterale di ogni ordine. Permette di generare il PDF, scaricarlo e rigenerarlo dopo la modifica dell'ordine. L'azione è disponibile anche nel menu a tendina _Azioni ordine_.

### Dall'elenco ordini

- **Colonna dedicata**: un'icona indica se esiste una proforma (blu) o meno (grigia); un clic la scarica o la genera.
- **Azione di massa**: seleziona più ordini e scegli _Genera proforma_ per l'elaborazione in blocco.

Dopo la modifica di un ordine (aggiunta di un prodotto, applicazione di uno sconto), usa il pulsante **Rigenera** per aggiornare il PDF: il numero proforma resta invariato.

## Contenuto del PDF

- Blocchi emittente / destinatario con indirizzi completi
- Tabella prodotti con riferimento, denominazione e **attributi del prodotto** (dimensioni, opzioni di personalizzazione…)
- Totali completi identici a WooCommerce: subtotale, spedizione, sconti e coupon, IVA, totale
- Metodo di pagamento e note cliente (opzionale)
- Numerazione, data di emissione e data di validità

## Archiviazione e sicurezza

I PDF vengono salvati in `wp-content/uploads/df-proforma/`, una directory protetta dall'elenco pubblico. Solo gli utenti con la capacità `manage_woocommerce` possono generare o scaricare i documenti.

## Domande frequenti

### Il PDF non viene generato

Verifica che la libreria PDF sia installata (in caso di assenza appare un avviso nell'amministrazione) e che la directory `uploads` sia scrivibile.

### Posso modificare il numero di una proforma esistente?

Il numero viene fissato alla prima generazione e memorizzato nell'ordine per garantire la tracciabilità. Rigenerare il documento mantiene lo stesso numero.

### Sconti e spese di spedizione vengono mostrati?

Sì, il documento riprende esattamente le righe dei totali calcolate da WooCommerce, incluse le spedizioni gratuite e i coupon.