Español
English
Català
Deutsch
Français
Português
Italiano
PolskiVoor wie hij is en voor wie niet, in het kort
Als je een klantfactuur of creditfactuur bevestigt in een ingeschakeld dagboek, genereert de connector een UBL 2.1-XML volgens de PINT AE-structuur, controleert die met de eigen validator van de module en slaat hem op als bijlage bij de factuur. Buiten de sandboxmodus verstuurt hij die XML naar het endpoint dat je instelt.
Je hebt er iets aan als je die flow in Odoo wilt opzetten, hem met de simulator wilt testen en, als je geaccrediteerde provider het generieke contract van de module accepteert, je facturen naar die provider wilt sturen. Zoals het gedocumenteerd is, heb je er niets aan als de XML moet voldoen aan de regels van PINT AE 1.0.4, als je provider alleen met een eigen API werkt of als je leveranciersfacturen wilt ontvangen: die ontvangt de module niet.
Zes misverstanden voordat je hem koopt
«Als ik hem installeer, voldoen mijn facturen aan PINT AE»
De productpagina is er duidelijk over: de XML is niet gevalideerd tegen de regels van PINT AE 1.0.4 en faalt op meerdere ervan. Deze worden genoemd: creditfacturen worden als facturen verstuurd, de indicatoren voor het transactietype ontbreken, facturen in vreemde valuta bevatten geen bedragen in AED en het endpoint van de koper gebruikt het TRN van 15 cijfers in plaats van het TIN van 10 cijfers. De validator die de XML controleert, is die van de module zelf. Geef je creditfacturen of facturen in een andere valuta uit, dan zijn dat precies de gevallen die de productpagina als falend aanmerkt.
«Hij koppelt met elke geaccrediteerde provider (ASP)»
Er is geen integratie met een specifieke door de FTA geaccrediteerde provider. De productpagina legt uit dat geaccrediteerde providers geen standaard-API delen, dus de REST-optie werkt alleen met een provider die het generieke contract van de module accepteert: een POST naar /invoices met een bearer token en periodieke statuscontrole. De andere optie is een basis-SOAP-envelop via AS4, zonder WS-Security en zonder SMP-lookup. Vraag je provider voordat je beslist of hij een van die twee formaten ondersteunt.
«Als ik Accepted zie, heeft de FTA de factuur geaccepteerd»
De sandboxmodus staat standaard aan en draait een providersimulator binnen Odoo. In sandbox verlaat er niets Odoo, en de statussen Accepted en de referentienummers die je daar ziet, zijn gesimuleerd. Je kunt er de hele flow mee op het scherm doorlopen, maar het is geen bewijs van een echte verzending.
Accepted gesimuleerd.«De FTA Clearance ID is de goedkeuring van de FTA»
Het veld heet FTA Clearance ID in de app, maar de productpagina van de module verduidelijkt dat het alleen de referentie bevat die de provider teruggeeft. Volgens diezelfde pagina kent het systeem van de VAE geen voorafgaande goedkeuringsstap (clearance): in het VAE-model is het de provider die de fiscale gegevens aan de FTA rapporteert, en de FTA keurt facturen niet goed voordat ze worden verstuurd. Het antwoord en de referentie van de provider worden opgeslagen op de factuur en in een auditlog dat je niet kunt bewerken of verwijderen.
«Met een actieve credential ondertekent de module de facturen»
Met een actieve credential voegt de module een opvulelement voor de handtekening in, geen echte handtekening. De productpagina voegt eraan toe dat PINT AE geen handtekening binnen het document vraagt en dat dit element de XML ongeldig maakt.
«De QR-code op de pdf is wettelijk verplicht en wordt door de FTA uitgegeven»
De QR-code op de pdf van de factuur is optioneel. Volgens de documentatie van de module vereisen de VAE-regels geen QR-code op e-facturen en wordt deze QR-code niet door de FTA uitgegeven.
Wat hij wel biedt en wat je nodig hebt voor de installatie
Naast het genereren en versturen van de XML bevat de module:
- Directe verzending of verzending in geplande batches, nieuwe pogingen met back-off, rate limiting en een met HMAC ondertekende webhook voor de antwoorden van de provider.
- Een configuratiewizard en instellingen per bedrijf: TIN, fase en de bijbehorende data, en dagboeken.
- Providercredentials versleuteld met een sleutel die je in de serveromgeving instelt (
FLEXIGO_UAE_EINVOICE_FERNET_KEY) en waarschuwingen wanneer certificaten verlopen.
- De XML als bijlage bij de factuur en een wizard die de e-facturen van een TRN als ZIP exporteert.
De README noemt als vereiste Odoo 20 met de module l10n_ae (VAE-lokalisatie). In Odoo Apps is hij gepubliceerd voor 17.0, 18.0, 19.0 en 20.0, en op alle vier de productpagina's kost hij € 49 excl. btw, eenmalige betaling per Odoo-versie. Werk je met 17, 18 of 19, bekijk dan de productpagina van jouw versie voordat je koopt.
De ingebruikname die de README beschrijft, is kort:
- Installeer de module via Apps.
- Doorloop de configuratiewizard.
- Ga naar
Accounting > UAE E-Invoicing > Configuration > UAE E-Invoicing Settings.
- Vul het TIN van het bedrijf in en kies de fase.
- Laat de sandboxmodus aan om de flow met de simulator te testen.
- Schakel e-facturatie in op de dagboeken die je wilt.
De details van elk veld en elke status vind je in de handleiding voor de ingebruikname van de connector.
Zo beslis je voor jouw situatie
| Als dit op jou van toepassing is | Wat de documentatie zegt |
|---|---|
| Je wilt de flow in Odoo zien zonder iets te versturen | De sandbox staat standaard aan en simuleert provider, statussen en referenties binnen Odoo |
Je provider accepteert een POST naar /invoices met bearer token, of basis-AS4 | De echte verzending kan naar hun endpoint gaan, maar de XML houdt de fouten die de productpagina noemt |
| Je hebt een XML nodig die de regels van PINT AE 1.0.4 doorstaat | Hij is er niet tegen gevalideerd en faalt op meerdere |
| Je geeft creditfacturen of facturen in vreemde valuta uit | Creditfacturen gaan als facturen de deur uit en de bedragen in AED ontbreken |
| Je moet leveranciersfacturen ontvangen | Die ontvangt hij niet |
| Je provider biedt alleen een eigen API | Er is geen integratie met een specifieke geaccrediteerde provider |
Wil je eerst begrijpen welke menu's hij toevoegt en welke stappen elke factuur doorloopt, lees dan hoe de connector van binnen werkt.
Hoe FlexigoTech je helpt
FlexigoTech implementeert Odoo 17, 18, 19 en 20 en ontwikkelt connectoren en integraties op maat. Accepteert je geaccrediteerde provider het generieke contract van de module niet, of heb je iets nodig wat buiten de documentatie valt, dan kunnen we samen met jou een maatwerkontwikkeling bekijken. De details van de module vind je op de pagina op flexigotech.com en op de productpagina in Odoo Apps.
Lees verder
Gecontroleerd in de broncode van de module (versie 20.0) en in de gelinkte bronnen
Bronnen
- Broncode van de module: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): README.rst
- Broncode van de module: 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