Vai al contenuto principale
UAE FTA E-Invoicing Connector

Errori di UAE FTA E-Invoicing Connector (PINT AE): un caso di esempio dall'inizio alla fine

I messaggi di UAE FTA E-Invoicing Connector (PINT AE) compaiono in tre momenti: quando configuri l'azienda e i suoi identificativi, quando registri la credenziale e il certificato dell'ASP e quando agisci su fatture già preparate o inviate. Ogni messaggio dice quale condizione non è soddisfatta, quindi conviene leggerlo tutto prima di fare qualsiasi cosa. Qui li ripercorri con un'azienda fittizia, con il testo esatto del modulo e cosa fare per ciascuno.

FlexigoTech · Responsabile: Víctor Gómez · Aggiornato il 4 novembre 2026

In breve

Versioni
Odoo 17, 18, 19 e 20
Verificato
nel codice del modulo, versione 20.0 · nelle fonti collegate in fondo
Lettura
5 min

Un distributore fittizio collega il suo Odoo

Esempio Caso illustrativo: l'azienda e i suoi dati sono inventati per spiegare il flusso.

Distribuzioni Duna è un'azienda inventata che fattura già con Odoo e ha appena installato il modulo. Laura, la consulente che segue l'implementazione, si occupa della configurazione; Marcos, dell'amministrazione, lavora con le fatture. Seguiamo cosa vede ciascuno e cosa fa con ogni messaggio.

Se prima vuoi capire quali componenti ha il modulo, trovi come funziona dall'interno; qui ci concentriamo sui messaggi.

Laura configura l'azienda e si scontra con i primi avvisi

Nessuna configurazione attiva

La prima cosa che Laura vede è No active UAE e-invoicing configuration found for company %s. Nel %s compare l'azienda a cui si riferisce l'avviso. C'è una variante senza azienda: No active UAE e-invoicing configuration. Entrambi dicono che non esiste una configurazione di fatturazione elettronica EAU attiva. Devi crearla o attivarla per l'azienda indicata nel messaggio e verificare di lavorare in quell'azienda e non in un'altra.

Procedura guidata UAE E-Invoicing Setup Wizard al passaggio TIN Entry con il campo UAE TIN vuoto
La procedura guidata UAE E-Invoicing Setup Wizard al passaggio TIN Entry, con l'azienda di esempio YourCompany in Company e il campo UAE TIN ancora vuoto.

TIN e TRN non passano

Laura incolla il numero fiscale con uno spazio in mezzo e il modulo risponde TIN must be exactly 10 numeric digits. Più avanti, con l'altro identificativo, riceve TRN must be exactly 15 numeric digits. Entrambi i controlli chiedono solo cifre ed esattamente quella quantità, quindi spazi, trattini o lettere non vanno bene. Pulisci il valore e salva di nuovo.

Conferma, URL dell'ASP e soglie

Quando salva senza confermare i dati compare Please confirm the information is correct before saving. Basta rivedere le informazioni e confermare che sono corrette prima di salvare.

Poi Laura esce dalla modalità sandbox e riceve ASP Endpoint URL is required when not in sandbox mode. Ha due strade: compilare l'URL dell'endpoint dell'ASP o restare in modalità sandbox finché non lo ha.

Infine lascia le soglie a zero e vede Alert threshold must be at least 1. e Failure threshold must be at least 1. Entrambe accettano come minimo 1.

La credenziale dell'ASP e il suo certificato

Con la configurazione salvata, Laura passa alla credenziale. Finché non ce n'è una attiva, il modulo avvisa con No active ASP credential configured.

Se la crea senza allegare il file compare No certificate uploaded. Quando lo carica, può trovarsi davanti Certificate validation failed: %s o Credential setup failed: %s. In entrambi i casi l'indizio è nel testo che sostituisce il %s; leggilo tutto prima di ricaricare qualcosa.

Laura vuole sostituire la credenziale con una nuova e lancia l'azione prima di prepararla. Il messaggio è No staged credential found. Upload a new credential and mark it as staged first. Il testo stesso indica l'ordine: caricare prima la nuova credenziale e contrassegnarla come staged.

Al momento di attivarla riceve Cannot activate credential "%s": the certificate expired on %s. Il primo segnaposto è la credenziale e il secondo la data in cui il certificato è scaduto. Con un certificato scaduto il modulo non permette di attivarla, quindi ne serve uno valido.

Marcos lavora con le fatture

Elenco Compliance Dashboard raggruppato per stato con importi e totali
Invoicing › Compliance Dashboard raggruppato per stato (Accepted, Not Transmitted, Queued, Rejected, Transmitted), con imponibile, totale e riga dei totali.

Riprovare, sincronizzare e annullare

Marcos apre una fattura accettata e chiede di ritrasmetterla. Risposta: Only rejected or failed invoices can be retried. Si possono ritrasmettere solo le fatture rifiutate o non riuscite.

Poi chiede di sincronizzare lo stato di una fattura non ancora inviata: Status sync is only relevant for transmitted or queued invoices. La sincronizzazione ha senso solo per fatture trasmesse o in coda.

Quindi prova ad annullarne una in coda: Only accepted or rejected invoices can be voided. Si annullano solo le fatture accettate o rifiutate, e questa non lo è.

Su un'altra fattura compare No e-invoice XML has been generated for this invoice. Quella fattura non ha ancora il suo XML di fattura elettronica generato.

Fattura cliente registrata con la sezione UAE E-Invoice in stato Accepted
Fattura cliente registrata: la sezione UAE E-Invoice mostra lo stato Accepted, l'ID di liquidazione della FTA e l'ultima trasmissione; nel chatter, un'attività pianificata e il cambio di stato.

Cosa il modulo non permette di eliminare

Marcos vuole fare pulizia di una fattura vecchia e riceve Invoice %s cannot be deleted: FTA retention period of %d years has not elapsed (expires %s). Il modulo controlla un periodo di conservazione e non permette di eliminare la fattura fino alla data indicata nel messaggio.

Non può nemmeno toccare il registro di audit: E-invoice audit logs are immutable and cannot be modified. e E-invoice audit logs are immutable and cannot be deleted. L'app conserva questi registri senza consentire modifiche né eliminazioni.

Infine chiede gli XML archiviati di un periodo e vede No e-invoice XML archives found for TRN %s in the specified date range. Verifica che il TRN del messaggio sia quello giusto e amplia o correggi l'intervallo di date.

Percorso tra l'elenco per stato, la coda di trasmissione, la procedura guidata di configurazione e una fattura accettata
Dal Compliance Dashboard raggruppato per stato alla Transmission Queue, la procedura guidata al passaggio TIN Entry e una fattura in stato Accepted.

Cosa insegna il caso di Distribuzioni Duna

  • Leggi il messaggio per intero, compreso quello che compare in ogni %s: lì trovi l'azienda, la credenziale, la data o il dettaglio dell'errore.
  • Gli avvisi di configurazione (No active UAE e-invoicing configuration..., No active ASP credential configured.) dicono che manca una configurazione o una credenziale attiva.
  • TIN e TRN accettano solo cifre e la lunghezza esatta indicata nel messaggio.
  • Per cambiare credenziale, l'ordine lo indica No staged credential found...: caricare la nuova e contrassegnarla come staged; per attivarla, il certificato non deve essere scaduto.
  • Ritrasmettere, sincronizzare e annullare dipendono dallo stato della fattura; controlla lo stato prima di cliccare.
  • Eliminare fatture entro il periodo di conservazione o modificare l'audit non è consentito dal modulo.

Per compilare ogni impostazione senza inciampare in questi avvisi, trovi la configurazione passo passo.

Come ti aiuta FlexigoTech

FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura, quindi possiamo rivedere con te la configurazione, la credenziale dell'ASP o un messaggio specifico che non riesci a eliminare. Il modulo costa 49 € IVA esclusa, pagamento unico per versione di Odoo, per 17, 18, 19 e 20; trovi i dettagli nella pagina del modulo.

Continua a leggere

Come funziona UAE FTA E-Invoicing Connector (PINT AE) in Odoo: menu, job e recordMenu, azioni pianificate e modelli di UAE FTA E-Invoicing Connector (PINT AE) in Odoo: cosa aggiunge, ogni quanto gira ogni job e cosa vedi in fattura.UAE FTA E-Invoicing Connector (PINT AE): checklist per metterlo in funzione in OdooQuali campi compilare in UAE FTA E-Invoicing Connector (PINT AE) per Odoo, quali stati vedrai nel pannello e cosa controllare nella prima settimana.UAE FTA E-Invoicing Connector (PINT AE): cosa copre, cosa no e se fa per il tuo OdooCosa copre e cosa no il connettore UAE FTA E-Invoicing (PINT AE) per Odoo secondo la sua documentazione, i requisiti prima di installarlo e le versioni.
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate

Fonti