Español
English
Deutsch
Français
Português
Italiano
Nederlands
PolskiPer a qui és i per a qui no, en resum
Quan confirmes una factura o una factura rectificativa de client en un diari habilitat, el connector genera un XML UBL 2.1 que segueix l'estructura PINT AE, el comprova amb el validador propi del mòdul i el desa com a adjunt a la factura. Fora del mode sandbox, envia aquest XML a l'endpoint que configuris.
T'és útil si vols muntar aquest flux a Odoo, provar-lo amb el simulador i, si el teu proveïdor acreditat accepta el contracte genèric del mòdul, enviar-li les factures. No t'és útil, tal com està documentat, si necessites que l'XML compleixi les regles de PINT AE 1.0.4, si el teu proveïdor només treballa amb la seva pròpia API o si vols rebre factures de proveïdors: el mòdul no les rep.
Sis idees equivocades abans de comprar-lo
«Si l'instal·lo, les meves factures ja compleixen PINT AE»
La fitxa ho diu clar: l'XML no s'ha validat contra les regles de PINT AE 1.0.4 i en falla diverses. Les que enumera són aquestes: les factures rectificatives s'envien com a factures, falten els indicadors de tipus de transacció, les factures en divisa estrangera no porten els imports en AED i l'endpoint del comprador fa servir el TRN de 15 dígits en lloc del TIN de 10 dígits. El validador que revisa l'XML és el del mateix mòdul. Si emets factures rectificatives o factures en una altra divisa, són justament els casos que la fitxa marca com a fallits.
«Es connecta amb qualsevol proveïdor acreditat (ASP)»
No hi ha integració amb cap proveïdor acreditat per la FTA en concret. La fitxa explica que els proveïdors acreditats no comparteixen una API estàndard, així que l'opció REST només funciona amb un proveïdor que accepti el contracte genèric del mòdul: un POST a /invoices amb un bearer token i consulta periòdica de l'estat. L'altra opció és un sobre SOAP AS4 bàsic, sense WS-Security ni cerca SMP. Abans de decidir, pregunta al teu proveïdor si admet algun d'aquests dos formats.
«Si veig Accepted, la FTA ha acceptat la factura»
El mode sandbox ve activat per defecte i executa un simulador de proveïdor dins d'Odoo. En sandbox no surt res d'Odoo, i els estats Accepted i els números de referència que hi veus són simulats. Et serveix per recórrer el flux complet a la pantalla, no com a prova d'enviament real.
Accepted és simulat.«El FTA Clearance ID és l'autorització de la FTA»
El camp es diu FTA Clearance ID a l'app, però la fitxa del mòdul aclareix que només desa la referència que retorna el proveïdor. Segons aquesta mateixa fitxa, el sistema dels EAU no té un pas d'autorització prèvia (clearance): en el model dels EAU és el proveïdor qui informa les dades fiscals a la FTA, i la FTA no autoritza les factures abans que s'enviïn. La resposta i la referència del proveïdor queden a la factura i en un registre d'auditoria que no es pot editar ni esborrar.
«Amb una credencial activa, el mòdul signa les factures»
Amb una credencial activa, el mòdul insereix un element de signatura de farciment en lloc d'una signatura real. La fitxa afegeix que PINT AE no demana una signatura dins del document i que aquest element fa que l'XML no sigui vàlid.
«El QR del PDF l'exigeix la normativa i l'emet la FTA»
El codi QR al PDF de la factura és opcional. La documentació del mòdul indica que les regles dels EAU no exigeixen un QR a les factures electròniques i que aquest QR no l'emet la FTA.
El que sí que inclou i el que necessites abans d'instal·lar-lo
A més de generar i enviar l'XML, el mòdul inclou:
- Enviament immediat o per lots programats, reintents amb back-off, limitació de ritme i un webhook per a les respostes del proveïdor signat amb HMAC.
- Un assistent de configuració i ajustos per empresa: TIN, fase i les seves dates, i diaris.
- Credencials del proveïdor xifrades amb una clau que defineixes a l'entorn del servidor (
FLEXIGO_UAE_EINVOICE_FERNET_KEY) i avisos de caducitat de certificats.
- L'XML adjunt a la factura i un assistent que exporta en un ZIP les factures electròniques d'un TRN.
El README indica com a requisit Odoo 20 amb el mòdul l10n_ae (localització dels EAU). A Odoo Apps està publicat per a 17.0, 18.0, 19.0 i 20.0, i a les quatre fitxes costa 49 € sense IVA, pagament únic per versió d'Odoo. Si treballes amb la 17, la 18 o la 19, revisa la fitxa de la teva versió abans de comprar.
La posada en marxa que descriu el README és curta:
- Instal·la el mòdul des d'Apps.
- Executa l'assistent de configuració.
- Entra a
Accounting > UAE E-Invoicing > Configuration > UAE E-Invoicing Settings.
- Introdueix el TIN de l'empresa i tria la fase.
- Mantén el mode sandbox actiu per provar el flux amb el simulador.
- Activa la facturació electrònica als diaris que vulguis.
El detall de cada camp i dels estats és a la posada en marxa del connector.
Com decidir segons el teu cas
| Si et passa això | El que diu la documentació |
|---|---|
| Vols veure el flux a Odoo sense enviar res | El sandbox ve actiu i simula proveïdor, estats i referències dins d'Odoo |
El teu proveïdor accepta POST a /invoices amb bearer token, o AS4 bàsic | L'enviament real pot apuntar al seu endpoint, però l'XML conserva els errors que llista la fitxa |
| Necessites un XML que passi les regles de PINT AE 1.0.4 | No s'ha validat contra elles i en falla diverses |
| Emets factures rectificatives o factures en divisa estrangera | Les factures rectificatives surten com a factures i falten els imports en AED |
| Necessites rebre factures de proveïdors | No les rep |
| El teu proveïdor només ofereix la seva pròpia API | No hi ha integració amb cap proveïdor acreditat concret |
Si abans vols entendre quins menús afegeix i per on passa cada factura, llegeix com funciona el connector per dins.
Com t'ajuda FlexigoTech
FlexigoTech implanta Odoo 17, 18, 19 i 20 i desenvolupa connectors i integracions a mida. Si el teu proveïdor acreditat no accepta el contracte genèric del mòdul, o necessites alguna cosa que la documentació deixa fora, podem estudiar amb tu un desenvolupament a mida. Tens els detalls del mòdul a la seva pàgina a flexigotech.com i a la fitxa d'Odoo Apps.
Continua llegint
Comprovat al codi del mòdul (versió 20.0) i a les fonts enllaçades
Fonts
- Codi del mòdul: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): README.rst
- Codi del mòdul: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): static/description/index.html
- apps.odoo.com/apps/modules/20.0/flexigo_uae_fta_e_invoicing_connector
- apps.odoo.com/apps/modules/17.0/flexigo_uae_fta_e_invoicing_connector
- apps.odoo.com/apps/modules/18.0/flexigo_uae_fta_e_invoicing_connector
- apps.odoo.com/apps/modules/19.0/flexigo_uae_fta_e_invoicing_connector
- flexigotech.com/en/services.html