1. Il Colpo d’Occhio: La Lista Ordini di WooCommerce

Vai su WooCommerce > Ordini. Noterai subito due grandi novità:

• La Colonna Dedicata: Ho aggiunto una colonna chiamata “fatture.help”. Per ogni ordine vedrai una “Card” completa e un badge colorato che ti indicherà immediatamente lo stato della fattura. Non devi più entrare dentro ogni singolo ordine per capire se la fattura è partita o meno.
• Filtri Intelligenti: In alto, accanto ai classici filtri per data di WooCommerce, troverai un nuovo menu a tendina. Puoi usarlo per filtrare gli ordini in base allo stato fiscale. Ad esempio, a fine mese puoi selezionare “Errore durante la generazione” per trovare subito le fatture scartate, oppure “Ricevuta dal cliente” per fare un rapido export. Un salvavita per la contabilità.

2. Il Widget fatture.help: Dentro (e fuori) l’ordine

La cosa bella è che la “Card” riepilogativa che vedi nella lista ordini è esattamente la stessa che ritroverai entrando dentro il dettaglio del singolo ordine. Le funzioni sono attive e identiche in entrambe le schermate:

• Dati in chiaro e “Click-to-Copy”: La card ti mostra subito i dati essenziali: Ragione Sociale (o Nome/Cognome), Partita IVA / Codice Fiscale, e l’indirizzo PEC o Codice SDI.
  Se clicchi su uno qualsiasi di questi testi, il dato verrà automaticamente copiato negli appunti del tuo computer (Click-to-Copy). Comodissimo se devi incollarlo in una mail o al telefono con il cliente!
• I Pulsanti di Visualizzazione e Download: Se la fattura è stata generata, vedrai comparire dei comodi pulsanti:
  • Fattura di Cortesia (PDF): Cliccando, il PDF si aprirà comodamente in una nuova scheda del tuo browser, pronto da visualizzare o stampare.
  • XML / P7M: Scarica direttamente sul tuo computer il vero e proprio file elettronico originale (il formato informatico richiesto dall’Agenzia delle Entrate).
  • DDT: Scarica direttamente il file PDF dell’eventuale Documento di Trasporto.

3. Il Ciclo di Vita della Fattura (Tempistiche di Annullamento e Correzione)

Per proteggerti dagli errori umani, ho programmato il plugin in modo che non faccia nulla in modo istantaneo e irreversibile. Ecco le tre fasi di sicurezza:

• ⏳ Fase 1: I 60 secondi di respiro
  Quando un ordine passa in stato “Completato” o “In Lavorazione”, il mio plugin riceve il segnale per generare la fattura, ma aspetta intenzionalmente 1 minuto prima di muoversi. Perché? Immagina di aver confermato per sbaglio un bonifico mai arrivato. Hai 60 secondi di tempo per rimettere l’ordine in “In Sospeso” o “Cancellato”. Se lo fai, la fattura viene annullata prima ancora di nascere, evitandoti di dover emettere una noiosa Nota di Credito!
• 📝 Fase 2: La Finestra di Cortesia (Le 24 Ore)
  Passato il minuto, il documento viene generato come Bozza sui server di fatture.help. Da questo momento, hai 24 ore di tempo prima che il file XML venga spedito irreversibilmente all’Agenzia delle Entrate. In questa finestra, il cliente riceve il suo PDF di cortesia: se si accorge di aver sbagliato a digitarti la P.IVA, hai tutto il tempo di correggerla in WooCommerce e far aggiornare la bozza.
• 🔒 Fase 3: Il Blocco Fiscale
  Scadute le 24 ore, la fattura parte per lo SDI. A questo punto, per garantirti la coerenza assoluta tra il tuo e-commerce e il tuo cassetto fiscale, il plugin blocca la modifica dei dati di fatturazione all’interno dell’ordine WooCommerce.

4. Leggere i Badge (Cosa significano i colori)

Nella colonna degli ordini o dentro il widget, vedrai dei badge colorati che indicano lo stato esatto del documento:

• ⚪ Grigio (In Attesa / Neutro): “In attesa di pagamento” (il plugin aspetta che l’ordine sia pagato prima di attivarsi) oppure “Ricevuta Non Fiscale”.
• 🟡 Giallo (In Lavorazione): “In coda” (il sistema sta per generare il documento) o “Inviato allo SDI” (Siamo in attesa della ricevuta di ritorno dall’Agenzia delle Entrate).
• 🟢 Verde (Successo): “Consegnata” (Tutto perfetto, il cliente ha ricevuto la fattura), o “Accettata” (dalla Pubblica Amministrazione).
• 🔴 Rosso (Allarme): “Errore” (Documento scartato dallo SDI, richiede il tuo intervento).

5. Lo Storico SDI e la correzione degli Scarti (Il “Self-Healing”)

Cosa succede se un cliente inserisce un Codice Fiscale di una persona defunta o una Partita IVA inesistente? Lo SDI scarterà la fattura, e il badge diventerà Rosso. Niente panico!

1. Leggi l’errore: Nel widget fatture.help del singolo ordine (o dalla lista ordini), clicca sul pulsante azzurro “Info” (quello con l’icona “i”). Si aprirà un popup con la “Scatola Nera” (il log di tutte le comunicazioni con lo SDI). Qui potrai leggere l’esatto messaggio di scarto restituito dall’Agenzia delle Entrate (es. “IdCodice non valido”).
2. Correggi il dato: Quando una fattura viene scartata, il mio plugin capisce la situazione e sblocca in automatico i campi dell’indirizzo in WooCommerce che prima aveva blindato.
3. Aggiorna l’ordine: Inserisci la P.IVA corretta (dopo averla chiesta al cliente) e clicca sul normale pulsante “Aggiorna” di WooCommerce. Il plugin prenderà il nuovo dato e rimetterà automaticamente la fattura in coda per l’invio immediato.

(Nel menu della lista Ordini, puoi anche selezionare più ordini e usare la tendina “Azioni di gruppo” per “Mettere in coda per generazione fattura” ordini vecchi o bloccarli in massa).