Invio automatico e test XML con l'addon Fatture in Cloud

Obiettivo

Attivare l’invio automatico delle fatture a Fatture in Cloud dopo il completamento di un ordine, e verificare il flusso con un ordine di prova prima di affidarti all’automazione.

Prerequisiti

• Connessione Fatture in Cloud già attiva.

Passi

Configurare l’invio automatico

Nella scheda Fatture in Cloud:

1. Stato ordine che attiva l’invio — per default è “Completato”, ma è configurabile su un altro stato ordine WooCommerce.
2. Abilita l’invio automatico delle fatture — quando un ordine raggiunge lo stato configurato, viene schedulato un evento che parte dopo un ritardo impostabile in ore (default 12 ore).
3. Alla scadenza del ritardo: la fattura viene caricata su Fatture in Cloud, poi ne viene verificata la validità formale; solo se valida viene inoltrata allo SDI. In caso di fattura non valida l’invio si blocca e va completato manualmente dopo aver corretto gli errori.
4. Disabilita l’invio automatico delle fatture allo SDI — se attivo, ferma il processo dopo il caricamento/verifica su Fatture in Cloud e non esegue l’inoltro automatico allo SDI (utile se vuoi che sia sempre Fatture in Cloud, non il plugin, a decidere quando inviare allo SDI).
5. Notifica email in caso di mancata creazione — c’è un’opzione dedicata per ricevere un’email se la creazione automatica della fattura fallisce.

Affidabilità di WP-Cron

Gli eventi di invio automatico sono gestiti da WP-Cron, che si attiva solo quando qualcuno apre una pagina del sito. Su siti con poco traffico gli invii possono ritardare o non partire. Per renderli puntuali, aggiungi un vero Cron di sistema (via hosting, VPS o server dedicato) che richiami periodicamente (es. ogni 30 minuti):

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

dove <document_root> è la root del dominio.

Log diagnostico

Per tracciare lo scheduling e l’esecuzione degli invii (inclusi gli stati ordine attraversati e il motivo per cui un invio automatico viene saltato), aggiungi in wp-config.php:

define("WP_FATT_CLOUD_LOG", true);

Generare un XML di prova

Prima di affidarti all’automazione, verifica il flusso con un ordine di prova:

1. Assicurati che l’addon sia connesso (vedi fatture-in-cloud-connect).
2. Disattiva temporaneamente sia “Abilita l’invio automatico delle fatture” sia “Disabilita l’invio automatico delle fatture allo SDI”, così nessun invio parte da solo.
3. Fai un acquisto di prova e porta l’ordine allo stato configurato come trigger (default “Completato”). Vai nella sezione Fatture del plugin: troverai l’XML generato, scaricabile per controllarne la struttura.
4. Controllato l’XML, usa il bottone “Carica” sulla fattura per inviarla manualmente a Fatture in Cloud: dopo l’invio la vedrai comparire tra i documenti del tuo account.

Verifica

• Con il log attivo, il file registra la creazione, verifica e invio (o il motivo dello skip) per ogni ordine.
• Il documento compare su Fatture in Cloud con lo stato di validità/invio coerente con quanto visto nel plugin.

Errori comuni

• L’invio automatico non parte mai — quasi sempre è WP-Cron che non si attiva per mancanza di traffico: aggiungi il Cron di sistema descritto sopra.
• La fattura resta bloccata dopo il caricamento — la verifica formale su Fatture in Cloud l’ha segnata come non valida: correggi i dati dell’ordine/fattura e reinvia manualmente.
• Vuoi testare senza rischiare un invio reale — segui la procedura “Generare un XML di prova” sopra: disattivando entrambe le opzioni di invio automatico nessun documento parte da solo finché non lo carichi tu manualmente.

Configurazione correlata

Per il contratto dei dati fattura (payload, mapping campi), vedi api/sdi. Per capire un rifiuto SDI dopo l’inoltro, vedi sdi-invoice-rejected.