Español
English
Català
Deutsch
Français
Português
Nederlands
PolskiPer chi è e per chi no, in breve
Quando confermi una fattura o una nota di credito cliente in un registro abilitato, il connettore genera un XML UBL 2.1 che segue la struttura PINT AE, lo controlla con il validatore interno del modulo e lo salva come allegato della fattura. Fuori dalla modalità sandbox, invia quell'XML all'endpoint che configuri.
Ti serve se vuoi impostare questo flusso in Odoo, provarlo con il simulatore e, se il tuo fornitore accreditato accetta il contratto generico del modulo, inviargli le fatture. Non ti serve, così come è documentato, se hai bisogno che l'XML rispetti le regole di PINT AE 1.0.4, se il tuo fornitore lavora solo con la propria API o se vuoi ricevere le fatture fornitore: il modulo non le riceve.
Sei malintesi prima di acquistarlo
«Se lo installo, le mie fatture sono già conformi a PINT AE»
La scheda lo dice chiaramente: l'XML non è stato validato rispetto alle regole di PINT AE 1.0.4 e ne viola diverse. Quelle elencate sono queste: le note di credito vengono inviate come fatture, mancano gli indicatori del tipo di transazione, le fatture in valuta estera non riportano gli importi in AED e l'endpoint dell'acquirente usa il TRN a 15 cifre invece del TIN a 10 cifre. Il validatore che controlla l'XML è quello del modulo stesso. Se emetti note di credito o fatture in un'altra valuta, sono proprio i casi che la scheda segnala come non superati.
«Si collega a qualsiasi fornitore accreditato (ASP)»
Non esiste un'integrazione con uno specifico fornitore accreditato dalla FTA. La scheda spiega che i fornitori accreditati non condividono un'API standard, quindi l'opzione REST funziona solo con un fornitore che accetti il contratto generico del modulo: una POST a /invoices con un bearer token e il controllo periodico dello stato. L'altra opzione è una busta SOAP AS4 di base, senza WS-Security né ricerca SMP. Prima di decidere, chiedi al tuo fornitore se supporta uno di questi due formati.
«Se vedo Accepted, la FTA ha accettato la fattura»
La modalità sandbox è attiva di default ed esegue un simulatore di fornitore dentro Odoo. In sandbox nulla esce da Odoo, e gli stati Accepted e i numeri di riferimento che vedi sono simulati. Ti serve per percorrere l'intero flusso a schermo, non come prova di un invio reale.
Accepted è simulato.«Il FTA Clearance ID è l'autorizzazione della FTA»
Il campo si chiama FTA Clearance ID nell'app, ma la scheda del modulo chiarisce che contiene solo il riferimento restituito dal fornitore. Secondo la stessa scheda, il sistema EAU non prevede un passaggio di autorizzazione preventiva (clearance): nel modello EAU è il fornitore a trasmettere i dati fiscali alla FTA, e la FTA non autorizza le fatture prima dell'invio. La risposta e il riferimento del fornitore restano sulla fattura e in un registro di audit che non si può modificare né cancellare.
«Con una credenziale attiva, il modulo firma le fatture»
Con una credenziale attiva, il modulo inserisce un elemento di firma segnaposto invece di una firma reale. La scheda aggiunge che PINT AE non richiede una firma all'interno del documento e che quell'elemento rende l'XML non valido.
«Il QR sul PDF è obbligatorio per legge e lo emette la FTA»
Il codice QR sul PDF della fattura è facoltativo. La documentazione del modulo indica che le regole EAU non richiedono un QR sulle fatture elettroniche e che questo QR non è emesso dalla FTA.
Cosa include e cosa ti serve prima di installarlo
Oltre a generare e inviare l'XML, il modulo include:
- Invio immediato o a lotti programmati, nuovi tentativi con back-off, limitazione della frequenza e un webhook per le risposte del fornitore firmato con HMAC.
- Una procedura guidata di configurazione e impostazioni per azienda: TIN, fase con le relative date e registri.
- Credenziali del fornitore cifrate con una chiave che definisci nell'ambiente del server (
FLEXIGO_UAE_EINVOICE_FERNET_KEY) e avvisi di scadenza dei certificati.
- L'XML allegato alla fattura e una procedura guidata che esporta in un ZIP le fatture elettroniche di un TRN.
Il README indica come requisito Odoo 20 con il modulo l10n_ae (localizzazione EAU). Su Odoo Apps è pubblicato per 17.0, 18.0, 19.0 e 20.0, e in tutte e quattro le schede costa 49 € IVA esclusa, pagamento unico per versione di Odoo. Se lavori su 17, 18 o 19, controlla la scheda della tua versione prima di acquistare.
L'avvio descritto nel README è breve:
- Installa il modulo da Apps.
- Avvia la procedura guidata di configurazione.
- Vai in
Accounting > UAE E-Invoicing > Configuration > UAE E-Invoicing Settings.
- Inserisci il TIN dell'azienda e scegli la fase.
- Lascia attiva la modalità sandbox per provare il flusso con il simulatore.
- Attiva la fatturazione elettronica nei registri che vuoi.
Il dettaglio di ogni campo e degli stati è nella guida all'avvio del connettore.
Come decidere in base al tuo caso
| Se ti trovi in questa situazione | Cosa dice la documentazione |
|---|---|
| Vuoi vedere il flusso in Odoo senza inviare nulla | La sandbox è attiva di default e simula fornitore, stati e riferimenti dentro Odoo |
Il tuo fornitore accetta una POST a /invoices con bearer token, o AS4 di base | L'invio reale può puntare al suo endpoint, ma l'XML mantiene i difetti elencati nella scheda |
| Ti serve un XML che superi le regole di PINT AE 1.0.4 | Non è stato validato rispetto a esse e ne viola diverse |
| Emetti note di credito o fatture in valuta estera | Le note di credito escono come fatture e mancano gli importi in AED |
| Devi ricevere le fatture fornitore | Non le riceve |
| Il tuo fornitore offre solo la propria API | Non c'è integrazione con nessun fornitore accreditato specifico |
Se prima vuoi capire quali menu aggiunge e che percorso fa ogni fattura, leggi come funziona il connettore dall'interno.
Come ti aiuta FlexigoTech
FlexigoTech implementa Odoo 17, 18, 19 e 20 e sviluppa connettori e integrazioni su misura. Se il tuo fornitore accreditato non accetta il contratto generico del modulo, o ti serve qualcosa che la documentazione lascia fuori, possiamo valutare insieme uno sviluppo su misura. Trovi i dettagli del modulo nella sua pagina su flexigotech.com e nella scheda di Odoo Apps.
Continua a leggere
Verificato nel codice del modulo (versione 20.0) e nelle fonti collegate
Fonti
- Codice del modulo: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): README.rst
- Codice del modulo: 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