Salta al contingut principal
UAE FTA E-Invoicing Connector

Errors d'UAE FTA E-Invoicing Connector (PINT AE): un cas d'exemple de principi a fi

Els missatges d'UAE FTA E-Invoicing Connector (PINT AE) apareixen en tres moments: quan configures l'empresa i els seus identificadors, quan dones d'alta la credencial i el certificat de l'ASP, i quan actues sobre factures ja preparades o enviades. Cada missatge diu quina condició no es compleix, així que val la pena llegir-lo sencer abans de fer res. Aquí els recorres amb una empresa fictícia, amb el text literal del mòdul i què fer amb cadascun.

FlexigoTech · Responsable: Víctor Gómez · Actualitzat el 4 de novembre de 2026

L'essencial

Versions
Odoo 17, 18, 19 i 20
Comprovat
al codi del mòdul, versió 20.0 · a les fonts enllaçades al final
Lectura
5 min

Una distribuïdora fictícia connecta el seu Odoo

Exemple Cas il·lustratiu: l'empresa i les seves dades són inventades per explicar el flux.

Distribucions Duna és una empresa inventada que ja factura amb Odoo i acaba d'instal·lar el mòdul. La Laura, la consultora que porta la implantació, s'encarrega de la configuració; en Marcos, d'administració, treballa amb les factures. Seguirem el que veu cadascú i què fa amb cada missatge.

Si abans vols entendre quines peces té el mòdul, tens com funciona per dins; aquí ens quedem amb els missatges.

La Laura configura l'empresa i topa amb els primers avisos

No hi ha cap configuració activa

El primer que veu la Laura és No active UAE e-invoicing configuration found for company %s. Al %s apareix l'empresa a què es refereix l'avís. Hi ha una variant sense empresa: No active UAE e-invoicing configuration. Totes dues diuen que no hi ha cap configuració de factura electrònica dels EAU activa. El que cal és crear-la o activar-la per a l'empresa que surt al missatge, i comprovar que treballes en aquesta empresa i no en una altra.

Assistent UAE E-Invoicing Setup Wizard al pas TIN Entry amb el camp UAE TIN buit
L'assistent UAE E-Invoicing Setup Wizard al pas TIN Entry, amb l'empresa d'exemple YourCompany a Company i el camp UAE TIN encara buit.

El TIN i el TRN no passen

La Laura enganxa el número fiscal amb un espai al mig i el mòdul respon TIN must be exactly 10 numeric digits. Més endavant, amb l'altre identificador, li surt TRN must be exactly 15 numeric digits. Totes dues comprovacions demanen només xifres i exactament aquesta quantitat, així que espais, guions o lletres no serveixen. Neteja el valor i torna a desar.

Confirmar, URL de l'ASP i llindars

Quan desa sense confirmar les dades apareix Please confirm the information is correct before saving. N'hi ha prou de revisar la informació i confirmar que és correcta abans de desar.

Després, la Laura surt del mode sandbox i rep ASP Endpoint URL is required when not in sandbox mode. Té dues sortides: omplir la URL de l'endpoint de l'ASP o continuar en mode sandbox mentre no la tingui.

Finalment, deixa els llindars a zero i veu Alert threshold must be at least 1. i Failure threshold must be at least 1. Tots dos admeten com a mínim 1.

La credencial de l'ASP i el seu certificat

Amb la configuració desada, la Laura passa a la credencial. Mentre no n'hi hagi cap d'activa, el mòdul avisa amb No active ASP credential configured.

En crear-la sense adjuntar el fitxer surt No certificate uploaded. Quan el puja, es pot trobar Certificate validation failed: %s o Credential setup failed: %s. En tots dos casos la pista és al text que substitueix el %s; llegeix-lo sencer abans de tornar a pujar res.

La Laura vol substituir la credencial per una de nova i prem l'acció abans de preparar-la. El missatge és No staged credential found. Upload a new credential and mark it as staged first. El mateix text diu l'ordre: pujar la credencial nova i marcar-la com a staged primer.

En activar-la li surt Cannot activate credential "%s": the certificate expired on %s. El primer buit és la credencial i el segon, la data en què va caducar el certificat. Amb un certificat caducat el mòdul no deixa activar-la, així que en necessita un de vigent.

En Marcos treballa amb les factures

Llista Compliance Dashboard agrupada per estat amb imports i totals
Invoicing › Compliance Dashboard agrupat per estat (Accepted, Not Transmitted, Queued, Rejected, Transmitted), amb import sense impostos, total i fila de totals.

Reintentar, sincronitzar i anul·lar

En Marcos obre una factura acceptada i demana reintentar-la. Resposta: Only rejected or failed invoices can be retried. Només es reintenten les rebutjades o fallides.

Després demana sincronitzar l'estat d'una que encara no s'ha enviat: Status sync is only relevant for transmitted or queued invoices. La sincronització només té sentit amb factures transmeses o en cua.

Tot seguit intenta anul·lar-ne una que és en cua: Only accepted or rejected invoices can be voided. Només s'anul·len les acceptades o rebutjades, i aquesta no ho és.

En una altra factura li apareix No e-invoice XML has been generated for this invoice. Aquesta factura encara no té generat el seu XML de factura electrònica.

Factura de client publicada amb la secció UAE E-Invoice en estat Accepted
Factura de client publicada: la secció UAE E-Invoice mostra l'estat Accepted, l'ID de liquidació de la FTA i l'última transmissió; al chatter, una activitat planificada i el canvi d'estat.

El que el mòdul no deixa esborrar

En Marcos vol netejar una factura antiga i rep Invoice %s cannot be deleted: FTA retention period of %d years has not elapsed (expires %s). El mòdul comprova un període de conservació i no deixa esborrar la factura fins a la data que indica el missatge.

Tampoc no pot tocar el registre d'auditoria: E-invoice audit logs are immutable and cannot be modified. i E-invoice audit logs are immutable and cannot be deleted. L'app guarda aquests registres sense permetre canvis ni esborrat.

Al final demana els XML arxivats d'un període i veu No e-invoice XML archives found for TRN %s in the specified date range. Revisa que el TRN del missatge és el correcte i amplia o corregeix el rang de dates.

Recorregut per la llista per estat, la cua de transmissió, l'assistent de configuració i una factura acceptada
Del Compliance Dashboard agrupat per estat a la Transmission Queue, l'assistent al pas TIN Entry i una factura en estat Accepted.

Què aprendre del cas de Distribucions Duna

  • Llegeix el missatge sencer, també el que apareix a cada %s: allà hi van l'empresa, la credencial, la data o el detall de l'error.
  • Els avisos de configuració (No active UAE e-invoicing configuration..., No active ASP credential configured.) diuen que falta una configuració o una credencial activa.
  • TIN i TRN només accepten xifres i la longitud exacta del missatge.
  • Per canviar de credencial, l'ordre el marca No staged credential found...: pujar la nova i marcar-la com a staged; per activar-la, el certificat no pot estar caducat.
  • Reintentar, sincronitzar i anul·lar depenen de l'estat de la factura; mira l'estat abans de prémer.
  • Esborrar factures dins del període de conservació o tocar l'auditoria no ho permet el mòdul.

Per omplir cada ajust sense ensopegar amb aquests avisos, tens la posada en marxa pas a pas.

Com t'ajuda FlexigoTech

FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida, així que podem revisar amb tu la configuració, la credencial de l'ASP o un missatge concret que no aconsegueixis treure. El mòdul costa 49 € sense IVA, pagament únic per versió d'Odoo, per a 17, 18, 19 i 20; tens els detalls a la pàgina del mòdul.

Continua llegint

Com funciona UAE FTA E-Invoicing Connector (PINT AE) a Odoo: menús, tasques i registresMenús, tasques programades i models d'UAE FTA E-Invoicing Connector (PINT AE) a Odoo: què afegeix, cada quant s'executa cada tasca i què veus a la factura.UAE FTA E-Invoicing Connector (PINT AE): checklist per posar-lo en marxa a OdooQuins camps has d'omplir a UAE FTA E-Invoicing Connector (PINT AE) per a Odoo, quins estats veuràs al tauler i què has de revisar la primera setmana.UAE FTA E-Invoicing Connector (PINT AE): què cobreix, què no i si encaixa al teu OdooQuè cobreix i què no el connector UAE FTA E-Invoicing (PINT AE) per a Odoo segons la seva documentació, què necessites abans d'instal·lar-lo i en quines versions és.
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades

Fonts