Configurare l'invio allo SDI via PEC

Integrazioniwordpresssdi-via-pec2026-07-01

Obiettivo

Inviare fatture elettroniche valide (B2B e B2C) al Sistema di Interscambio tramite una casella PEC, usando l’addon SDI via PEC.

Prerequisiti

Addon SDI via PEC installato e attivo.
Una casella PEC con accesso SMTP (host, porta/sicurezza, utente, password).
Solo una integrazione di invio fatture può essere attiva alla volta: disattiva Fatture in Cloud o Aruba prima di attivare questa.

Passi

1. Configura la casella PEC (SMTP)

Nella scheda SDI via PEC del plugin, inserisci i parametri della tua casella PEC: host SMTP, tipo di sicurezza della connessione, utente e password. Il plugin traccia anche una data di scadenza della password, utile come promemoria per rinnovarla prima che smetta di funzionare.

Se il tuo provider PEC richiede l’autenticazione a due fattori per l’accesso SMTP (es. Aruba PEC), dovrai generare una password applicativa dedicata dal pannello del provider (per Aruba PEC: gestione account > Password per programmi di posta) e usare quella al posto della password normale — è un requisito del provider PEC, non un’impostazione del plugin.

2. Verifica/personalizza l’indirizzo destinatario SDI

Il campo destinatario PEC del Sistema di Interscambio ha come default sdi20@pec.fatturapa.it; puoi sovrascriverlo solo se il tuo caso richiede un indirizzo diverso.

3. Configura l’invio automatico

Stato ordine che attiva l’invio — default “Completato”, configurabile su un altro stato ordine WooCommerce.
Abilita l’invio automatico — alla scadenza di un ritardo impostabile in ore (default 12 ore) dal raggiungimento dello stato configurato, la fattura viene inviata via PEC allo SDI.

Affidabilità di WP-Cron

Gli eventi automatici dipendono da WP-Cron, che si attiva solo con traffico sul sito. Se il tuo sito riceve poche visite, aggiungi un Cron di sistema (es. ogni 30 minuti):

cd <document_root>/public_html; wp cron event run --due-now >/dev/null 2>&1

Log diagnostico

Per tracciare scheduling ed esecuzione degli invii, aggiungi in wp-config.php:

define("WP_FATT_SDI_LOG", true);

Invio manuale

Usa il bottone “Invia” sulla fattura per trasmetterla subito via PEC; il plugin la contrassegna come inviata al termine dell’operazione.

Verifica

Controlla la casella PEC configurata: deve mostrare il messaggio inviato al destinatario SDI, e la fattura nel plugin deve risultare marcata come inviata.

Errori comuni

La connessione SMTP fallisce con “credenziali non valide” — se hai attivato l’autenticazione a due fattori sulla casella PEC, la password normale non basta: genera una password applicativa dedicata.
L’invio automatico non parte — verifica prima WP-Cron/il Cron di sistema; è la causa più frequente.
La password SMTP è scaduta — il plugin traccia la data di scadenza inserita: se il provider l’ha cambiata, aggiornala nella configurazione SMTP.

Configurazione correlata

Per l’alternativa nativa senza casella PEC, vedi sdi-via-pop. Per capire un rifiuto SDI, vedi sdi-invoice-rejected.