Quando si ha a che fare con la fatturazione elettronica, prima o poi succede: un cliente sbaglia a digitare un dato e l’Agenzia delle Entrate scarta la fattura. Il badge dell’ordine si colora di rosso e scatta il panico. Fermati e fai un bel respiro: con il mio plugin, uno scarto SDI non è mai una tragedia.
Il Sistema di Interscambio (SDI) funziona come un “buttafuori” automatico: controlla la forma del file XML e, se trova un dato palesemente errato (come una Partita IVA cessata), respinge il documento.
La buona notizia? Non devi annullare l’ordine su WooCommerce e non devi emettere nessuna Nota di Credito. Se lo SDI scarta la fattura, per il Fisco quel documento non è mai esistito. La tua numerazione fiscale è salva e intatta! Lo SDI ti permette semplicemente di correggere l’errore e reinviare lo stesso numero di fattura senza creare “buchi” contabili.
Per capire perché la fattura è stata respinta, ho integrato una vera e propria “Scatola Nera” dentro il plugin.
Di solito, per garantire l’integrità dei dati fiscali, il mio plugin blocca e rende immodificabili i campi di fatturazione del cliente non appena la fattura viene inviata. Ma ho dotato il sistema di un’intelligenza “Self-Healing” (auto-riparante): se il plugin riceve una notifica di scarto dallo SDI, sblocca magicamente e in automatico i campi dell’indirizzo in WooCommerce.
Ecco tutto quello che devi fare per risolvere il problema:
Il gioco è fatto. Il mio plugin capirà che hai gestito l’errore, salverà il nuovo dato e rimetterà automaticamente la fattura in coda (stato ready) per un nuovo invio immediato.
Ecco una lista degli errori più frequenti in cui potresti imbatterti e cosa significano realmente.
È il re indiscusso degli scarti. L’IdCodice è il campo tecnico del file XML che contiene la Partita IVA o il Codice Fiscale del cliente.
Cosa significa: C’è un problema formale. Il prefisso della nazione manca o è errato (00305), oppure la P.IVA risulta inesistente o cessata all’Anagrafe Tributaria (00306). Il controllo matematico al checkout blocca gli errori di battitura, ma se un cliente inserisce di proposito una P.IVA chiusa, lo SDI se ne accorgerà.
Come risolvere: Fatti dare la P.IVA corretta, modificala nell’ordine e aggiorna.
Cosa significa: Il cliente ha inserito un codice SDI (i famosi 7 caratteri alfanumerici) inesistente o disattivato dall’Agenzia delle Entrate (00311), oppure una PEC non valida (00312).
Come risolvere: Chiedigli di verificare il codice. Se non riesci a contattarlo, puoi forzare il codice 0000000 e cliccare su Aggiorna.
Cosa significa: Il cliente ha fornito un indirizzo PEC che risulta disattivo, errato o con la casella di posta piena (quindi non può ricevere la fattura).
💡 Attenzione alla differenza: Se un cliente privato inserisce una email normale (non PEC), lo SDI NON genererà un errore! La fattura verrà regolarmente accettata dal Fisco e lo stato diventerà “Mancata Consegna” (che è uno stato validissimo e verde). In questi casi la normativa direbbe di consegnare a mano la copia PDF al cliente… ma tu non devi fare nulla, perché il mio plugin gli ha già spedito il PDF di cortesia in automatico un minuto dopo il pagamento!
Cosa significa: Lo SDI rileva che una fattura con quello stesso identico numero è già stata inviata e accettata. Le probabilità che succeda sono quasi zero, a meno che non si modifichi l’ordine nell’esatto millisecondo in cui il server spedisce la fattura.
Come risolvere: Apri l’ordine, cambia il numero del documento (es. da 15 a 15/A o passa al 16) e clicca su “Aggiorna”.
Cosa significa: Il Codice Fiscale (00400) o la Partita IVA (00401) del tuo cliente non esistono in Anagrafe, oppure la P.IVA è chiusa/cessata (00424).
Come risolvere: Ottieni il dato corretto dal cliente, modificalo in WooCommerce e aggiorna l’ordine.
Cosa significa: Il cliente ha inserito sia il Codice Fiscale che la Partita IVA, ma per l’Agenzia delle Entrate non appartengono allo stesso soggetto (spesso capita con le ditte individuali quando si confonde il CF personale con quello aziendale).
Come risolvere: Chiedi al cliente quale dei due dati è quello primario registrato in Camera di Commercio, rimuovi quello “in eccesso” dall’ordine e aggiorna.
Cosa significa: Stai cercando di emettere un’autofattura o un’integrazione (dove la tua azienda figura sia come mittente che come destinatario), ma hai lasciato impostato il Tipo Documento di una fattura normale (TD01). Per lo SDI, in una fattura normale, chi vende e chi compra non possono essere la stessa persona.
Come risolvere: Apri l’ordine e modifica i dati del documento, assicurandoti di selezionare il Tipo Documento specifico per le autofatture (es. TD16, TD17, TD19, TD20, TD27, ecc. a seconda del tuo caso specifico). Se non sei sicuro di quale codice TD utilizzare, chiedi conferma al tuo commercialista. Una volta selezionato quello corretto, clicca su “Aggiorna”.
Cosa significa: Nel file XML ci sono dei caratteri “proibiti” che lo SDI non riesce a leggere (emoji, simboli matematici non supportati, o caratteri invisibili copiati da Word).
Come risolvere: Controlla i dati dell’ordine (nomi, indirizzi, note del cliente). Pulisci eventuali simboli strani e clicca su “Aggiorna”.