UAE FTA E-Invoicing Connector (PINT AE): co obejmuje, czego nie i czy pasuje do Twojego Odoo

Dla kogo jest, a dla kogo nie, w skrócie

Gdy zatwierdzasz fakturę sprzedaży lub notę kredytową w włączonym dzienniku, konektor generuje XML UBL 2.1 zgodny ze strukturą PINT AE, sprawdza go własnym walidatorem modułu i zapisuje jako załącznik do faktury. Poza trybem sandbox wysyła ten XML na skonfigurowany endpoint.

Przyda Ci się, jeśli chcesz zbudować ten proces w Odoo, przetestować go w symulatorze i, jeśli Twój akredytowany dostawca akceptuje ogólny kontrakt modułu, wysyłać mu faktury. Zgodnie z dokumentacją nie przyda Ci się, jeśli XML musi spełniać reguły PINT AE 1.0.4, jeśli Twój dostawca pracuje tylko z własnym API albo jeśli chcesz odbierać faktury od dostawców: moduł ich nie odbiera.

Sześć błędnych założeń przed zakupem

„Po instalacji moje faktury są zgodne z PINT AE”

Karta aplikacji mówi to wprost: XML nie został zwalidowany względem reguł PINT AE 1.0.4 i kilku z nich nie spełnia. Wymienia te: noty kredytowe są wysyłane jako faktury, brakuje wskaźników typu transakcji, faktury w walucie obcej nie zawierają kwot w AED, a endpoint nabywcy używa 15-cyfrowego TRN zamiast 10-cyfrowego TIN. Walidator sprawdzający XML jest walidatorem samego modułu. Jeśli wystawiasz noty kredytowe lub faktury w innej walucie, to dokładnie te przypadki, które karta oznacza jako niezgodne.

„Łączy się z każdym akredytowanym dostawcą (ASP)”

Nie ma integracji z żadnym konkretnym dostawcą akredytowanym przez FTA. Karta wyjaśnia, że akredytowani dostawcy nie mają wspólnego standardowego API, więc opcja REST działa tylko z dostawcą, który akceptuje ogólny kontrakt modułu: POST na /invoices z bearer tokenem i okresowe sprawdzanie statusu. Druga opcja to podstawowa koperta SOAP AS4, bez WS-Security i bez wyszukiwania SMP. Zanim zdecydujesz, zapytaj dostawcę, czy obsługuje któryś z tych formatów.

„Jeśli widzę Accepted, FTA przyjął fakturę”

Tryb sandbox jest domyślnie włączony i uruchamia w Odoo symulator dostawcy. W sandboxie nic nie wychodzi z Odoo, a statusy Accepted i numery referencyjne, które tam widzisz, są symulowane. Pozwala to przejść cały proces na ekranie, ale nie jest dowodem rzeczywistej wysyłki.

„FTA Clearance ID to autoryzacja FTA”

Pole w aplikacji nazywa się FTA Clearance ID, ale karta modułu wyjaśnia, że przechowuje jedynie referencję zwracaną przez dostawcę. Według tej samej karty system ZEA nie ma etapu wcześniejszej autoryzacji (clearance): w modelu ZEA to dostawca raportuje dane podatkowe do FTA, a FTA nie autoryzuje faktur przed ich wysłaniem. Odpowiedź i referencja dostawcy są zapisywane na fakturze oraz w dzienniku audytu, którego nie można edytować ani usunąć.

„Przy aktywnym poświadczeniu moduł podpisuje faktury”

Przy aktywnym poświadczeniu moduł wstawia zastępczy element podpisu zamiast prawdziwego podpisu. Karta dodaje, że PINT AE nie wymaga podpisu wewnątrz dokumentu, a ten element sprawia, że XML jest nieprawidłowy.

„Kod QR na PDF jest wymagany przepisami i wydaje go FTA”

Kod QR na PDF faktury jest opcjonalny. Dokumentacja modułu podaje, że przepisy ZEA nie wymagają kodu QR na e-fakturach i że ten QR nie jest wydawany przez FTA.

Co moduł faktycznie zawiera i czego potrzebujesz przed instalacją

Oprócz generowania i wysyłania XML moduł zawiera:

• Wysyłkę natychmiastową lub w zaplanowanych partiach, ponowienia z back-offem, ograniczanie częstotliwości i webhook na odpowiedzi dostawcy podpisany HMAC.

• Kreator konfiguracji i ustawienia per firma: TIN, faza i jej daty oraz dzienniki.

• Poświadczenia dostawcy szyfrowane kluczem ustawianym w środowisku serwera (FLEXIGO_UAE_EINVOICE_FERNET_KEY) i ostrzeżenia o wygasaniu certyfikatów.

• XML dołączony do faktury oraz kreator eksportujący do ZIP e-faktury danego TRN.

README podaje jako wymaganie Odoo 20 z modułem l10n_ae (lokalizacja ZEA). W Odoo Apps moduł jest opublikowany dla 17.0, 18.0, 19.0 i 20.0, a na wszystkich czterech kartach kosztuje 49 € netto (bez VAT), jednorazowa płatność za wersję Odoo. Jeśli pracujesz na 17, 18 lub 19, przed zakupem sprawdź kartę swojej wersji.

Uruchomienie opisane w README jest krótkie:

1. Zainstaluj moduł z Apps.

1. Uruchom kreator konfiguracji.

1. Wejdź w Accounting > UAE E-Invoicing > Configuration > UAE E-Invoicing Settings.

1. Wpisz TIN firmy i wybierz fazę.

1. Zostaw włączony tryb sandbox, aby przetestować proces w symulatorze.

1. Włącz e-fakturowanie w wybranych dziennikach.

Szczegóły każdego pola i statusu znajdziesz w przewodniku po uruchomieniu konektora.

Jak zdecydować w Twoim przypadku

Jeśli wolisz najpierw zrozumieć, jakie menu dodaje moduł i przez co przechodzi każda faktura, przeczytaj, jak konektor działa od środka.

Jak pomaga FlexigoTech

FlexigoTech wdraża Odoo 17, 18, 19 i 20 oraz tworzy konektory i integracje na zamówienie. Jeśli Twój akredytowany dostawca nie akceptuje ogólnego kontraktu modułu albo potrzebujesz czegoś, czego dokumentacja nie obejmuje, możemy razem przeanalizować rozwiązanie szyte na miarę. Szczegóły modułu znajdziesz na jego stronie w flexigotech.com i na karcie w Odoo Apps.

Czytaj dalej

Sprawdzone w kodzie źródłowym modułu (wersja 20.0) i w podlinkowanych źródłach

Źródła

• Kod modułu: flexigo_uae_fta_e_invoicing_connector 20.0 (bd3e6ed9): README.rst
• Kod modułu: 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