Connettere Aruba a WooCommerce e attivare l'invio automatico

Obiettivo

Collegare WooCommerce al servizio di fatturazione elettronica Aruba e attivare l’invio automatico delle fatture dopo il completamento di un ordine.

Prerequisiti

• Addon Aruba installato e attivo.
• Un account di fatturazione Aruba Premium, oppure un account base collegato a un account Premium tramite delega — è un requisito dell’account Aruba, non una verifica fatta dal plugin.
• Solo una integrazione di invio fatture può essere attiva alla volta: se Fatture in Cloud o SDI via PEC sono già attivi, disattivali prima di collegare Aruba.

Passi

1. Collega l’account

Nella scheda Aruba del plugin, inserisci utente e password del tuo account di fatturazione Aruba nell’apposito pannello di login. Non serve altro: il plugin autentica direttamente con quelle credenziali.

2. Configura l’invio automatico

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): la fattura viene inviata ad Aruba, che dopo i propri controlli la inoltra allo SDI.
3. In caso di fattura non valida l’invio si blocca e va completato manualmente dopo aver corretto gli errori.

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. Aggiungi un Cron di sistema 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 scheduling ed esecuzione degli invii, aggiungi in wp-config.php:

define("WP_FATT_ARUBA_LOG", true);

Verifica

Con il log attivo, genera un ordine di prova e verifica nel file di log che l’invio sia stato schedulato ed eseguito; controlla poi che il documento compaia sul portale Aruba.

Errori comuni

• Il login non funziona pur con credenziali corrette — verifica che l’account sia effettivamente Premium o correttamente delegato: un account base non delegato non è abilitato all’invio via API.
• L’invio automatico non parte — quasi sempre WP-Cron non si attiva per mancanza di traffico: aggiungi il Cron di sistema descritto sopra.
• La fattura resta bloccata dopo l’invio ad Aruba — Aruba l’ha segnata come non valida in fase di controllo: correggi i dati e reinvia manualmente una volta risolti gli errori.

Configurazione correlata

Per il ciclo di consegna allo SDI e la logica delle email di notifica, vedi aruba-invoice-flow. Per il contratto dei dati fattura, vedi api/sdi.