eXtensible Exchange Template (XET) - KSeF, XML, EDI Integration for Odoo
by Hadron for Business https://ksef.odoo.com| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 13197 |
| Technical Name |
hfb_xmlmap_exporter |
| License | AGPL-3 |
| Website | https://ksef.odoo.com |
| Versions | 15.0 16.0 17.0 18.0 |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 13197 |
| Technical Name |
hfb_xmlmap_exporter |
| License | AGPL-3 |
| Website | https://ksef.odoo.com |
| Versions | 15.0 16.0 17.0 18.0 |
eXtensible Exchange Template - XET
Konfigurowalna platforma wymiany danych strukturalnych dla Odoo
XET to moduł Odoo zaprojektowany w celu uporządkowania i ustandaryzowania integracji z systemami zewnętrznymi, takimi jak KSeF, EDI czy platformy API. Zamiast tworzyć jednorazowe integracje oparte na kodzie, XET wprowadza przenośne szablony wymiany danych.
Jak działa XET?
- dane biznesowe pozostają w Odoo (faktury, kontrahenci),
- struktura dokumentu definiowana jest w szablonie XET,
- dokument jest walidowany przed wysyłką,
- komunikacja realizowana jest przez wyspecjalizowany provider.
Takie podejście pozwala oddzielić logikę biznesową od wymagań technicznych systemów zewnętrznych.
Szablony XET
Szablony opisują strukturę dokumentów zgodnie z XSD i mogą być wielokrotnie używane oraz przenoszone pomiędzy instancjami Odoo.
Walidacja przed wysyłką
Dokumenty są sprawdzane przed opuszczeniem systemu. Użytkownik otrzymuje jasną informację, czy dokument jest gotowy do wysyłki.
Providery komunikacyjne
Wymienna warstwa komunikacji umożliwia obsługę różnych systemów zewnętrznych bez zmiany struktury dokumentów.
Dołączony klient Java – komunikacja i bezpieczeństwo
W przypadku integracji z Krajowym Systemem e-Faktur (KSeF) wymagane są operacje kryptograficzne, takie jak podpisy, szyfrowanie oraz obsługa sesji.
Z tego powodu XET wykorzystuje dołączony klient Java, który realizuje wyłącznie warstwę technicznej komunikacji:
- podpisy i weryfikację komunikatów,
- szyfrowanie i deszyfrowanie danych,
- obsługę tokenów i sesji KSeF,
- komunikację zgodną z protokołem KSeF.
Odoo oraz XET nie przechowują kluczy kryptograficznych i nie realizują operacji podpisu – klient Java jest w pełni odseparowanym komponentem technicznym.
Użytkownik biznesowy
Waliduje dokumenty i podejmuje świadomą decyzję o ich wysyłce.
Zespół wdrożeniowy
Konfiguruje szablony i mapowania bez potrzeby tworzenia dedykowanego kodu.
Organizacja
Zyskuje stabilną i skalowalną platformę integracyjną, odporną na zmiany regulacyjne.
XET jest fundamentem długowiecznych integracji w Odoo – nie jednorazowym dodatkiem, lecz platformą, która porządkuje wymianę danych w całej organizacji.
Integracja z Krajowym Systemem e-Faktur (KSeF)
Integracja z Krajowym Systemem e-Faktur (KSeF) została w XET zaprojektowana jako kontrolowany proces biznesowo–techniczny, a nie prosty eksport pliku XML.
Punktem wyjścia są następujące założenia:
- KSeF narzuca ścisłą strukturę dokumentów (XSD),
- wymaga podpisów, szyfrowania i obsługi sesji,
- proces wysyłki jest wieloetapowy i asynchroniczny,
- błędy formalne skutkują odrzuceniem dokumentu.
W związku z tym XET rozdziela odpowiedzialności:
- Odoo / XET odpowiada za dane biznesowe, strukturę dokumentu, warunki oraz walidację przed wysyłką,
- dołączony klient Java realizuje wyłącznie techniczną komunikację z KSeF (kryptografia, sesje, protokół),
- użytkownik biznesowy podejmuje świadomą decyzję o wysyłce dokumentu po pozytywnej walidacji.
Dzięki temu dokument jest sprawdzany i oceniany zanim opuści system Odoo, a użytkownik nie wysyła danych „w ciemno”.
Integracja z Krajowym Systemem e-Faktur (KSeF)
Moduł XET umożliwia integrację Odoo z Krajowym Systemem e-Faktur (KSeF) w oparciu o konfigurowalne szablony XET oraz walidację dokumentów przed wysyłką.
XET odpowiada za przygotowanie struktury dokumentu zgodnej z XSD, kontrolę warunków występowania elementów oraz weryfikację poprawności danych po stronie Odoo.
Komunikacja z KSeF realizowana jest przez wydzielony komponent techniczny (klient Java), odpowiedzialny za obsługę protokołu KSeF oraz operacje kryptograficzne.
Proces wysyłki, odbioru statusów oraz potwierdzeń (UPO) jest rejestrowany w systemie i dostępny do dalszej analizy.
Please log in to comment on this module