Capire il ciclo di invio fattura Aruba e l'email pro forma
Sintomo
Dopo l’invio di una fattura ad Aruba non è chiaro cosa succede in background, o il cliente riceve (o non riceve) l’email con la fattura pro forma.
Causa
Il ciclo attivo lato Aruba
Una volta inviata la fattura ad Aruba, il “ciclo attivo” segue questi passaggi (gestiti da Aruba, non dal plugin):
- Il documento XML viene inviato via web service ai canali Aruba.
- Aruba PEC controlla la conformità formale del formato.
- Aruba PEC appone la firma elettronica (qualificata, facoltativa per B2B/B2C) e la trasmette allo SDI.
- Lo SDI valida la fattura e la inoltra al destinatario (via codice destinatario o PEC), oppure a un soggetto terzo delegato dal destinatario.
- Lo SDI restituisce ad Aruba una notifica di scarto, mancata consegna o consegna.
- Il documento passa in conservazione digitale a norma (obbligatoria).
Per il significato dettagliato dei singoli codici di notifica, fai riferimento alla documentazione Aruba.
Quando parte l’email con la fattura pro forma
Allo scadere del tempo impostato per il controllo delle notifiche, il plugin verifica lo stato ricevuto da Aruba e invia automaticamente al cliente l’email con la fattura pro forma solo se si verifica una di queste condizioni:
- stato RC (Consegnata) — la fattura è stata consegnata dallo SDI; oppure
- stato MC (Non Consegnata), ma solo per clienti “privati”; oppure
- stato RC o MC quando il destinatario ha una PEC/indirizzo email valido oppure il codice
destinatario SDI è impostato a
0000000.
Fuori da questi casi (es. cliente business con codice destinatario specifico e stato diverso da RC/MC) l’email pro forma automatica non parte: non è un errore, è il comportamento previsto.
Fix
- Per inviare comunque la pro forma in un caso non coperto dalle condizioni sopra, usa il bottone manuale “Pro Forma” sull’ordine/fattura.
- Se un ordine resta a lungo senza notifica RC/MC, verifica lo stato direttamente sul portale Aruba: il plugin si limita a interrogare le notifiche già disponibili, non forza una nuova trasmissione.
Configurazione correlata
Per collegare l’account e configurare l’invio automatico, vedi aruba-connect. Per capire un rifiuto SDI, vedi sdi-invoice-rejected.