Tak, Odoo może wysyłać faktury do KSeF 2.0 bez zewnętrznego programu. Od wersji 18 polska lokalizacja Odoo ma moduł „Polish – E-Invoicing FA (3)”, który generuje fakturę w schemacie FA(3), wysyła ją do KSeF, pobiera status i UPO oraz importuje faktury kosztowe. W starszych wersjach (16, 17) albo przy nietypowych procesach potrzebny jest dodatkowy moduł. Poniżej wyjaśniamy, kiedy wystarczy standard, kiedy gotowy moduł, a kiedy integracja dedykowana — i jak to robimy w projektach wdrożenia Odoo.
KSeF w Odoo: standard, gotowy moduł czy integracja dedykowana?
Wybór zależy od wersji Odoo i od tego, jak skomplikowane jest fakturowanie w Twojej firmie. Najprościej porównać trzy drogi:
| Standard Odoo (polska lokalizacja) | Gotowy moduł z Odoo Apps | Integracja dedykowana / własny moduł | |
|---|---|---|---|
| Wersja Odoo | 18, 19 i nowsze | także starsze wersje, zależnie od dostawcy modułu | dowolna, w tym 16 i 17 |
| Co obejmuje | wysyłka FA(3), status, UPO, import faktur kosztowych, kody QR | zależnie od modułu | dokładnie Twój proces: wiele spółek, obieg akceptacji, korekty, wyjątki |
| Koszt | w cenie Odoo + konfiguracja | licencja modułu + konfiguracja | projekt wyceniany indywidualnie |
| Kiedy wybrać | jedna spółka, typowe faktury, aktualne Odoo | starsza wersja, a proces jest typowy | wiele spółek lub oddziałów, faktury z innych systemów (sklep, TMS), własny obieg dokumentów |
| Ryzyko | trzeba aktualizować kod Odoo, bo moduł jest rozwijany | zależność od dostawcy modułu przy zmianach API Ministerstwa Finansów | po stronie wdrożeniowca — wymaga utrzymania |
W praktyce zaczynamy od standardu. Własny moduł piszemy dopiero wtedy, gdy standard nie obsługuje procesu albo firma pracuje na wersji, w której modułu KSeF nie ma.
Co potrafi wbudowany moduł KSeF w Odoo
Moduł polskiej lokalizacji (nazwa techniczna l10n_pl_edi) obsługuje cały podstawowy obieg e-faktury. Według dokumentacji Odoo:
- generuje fakturę w schemacie FA(3) i wysyła ją do KSeF z poziomu przycisku „Wyślij” na fakturze;
- zapisuje kopię pliku XML w historii faktury i pozwala go wyeksportować;
- pokazuje status przetwarzania faktury i pobiera Urzędowe Poświadczenie Odbioru (UPO);
- co 3 godziny (domyślnie) pobiera z KSeF faktury od dostawców — częstotliwość można zmienić;
- łączy się bezpośrednio z API KSeF 2.0 Ministerstwa Finansów (środowisko produkcyjne i testowe).
Moduł jest częścią kodu Odoo Community (licencja LGPL-3), więc działa w Odoo Community i Enterprise od wersji 18. Pobieranie faktur kosztowych na żądanie i kody QR na wydruku faktury dodano w aktualizacjach w 2026 r. — dlatego instalacja Odoo 18, która nie była aktualizowana, może ich nie mieć.
Źródła: dokumentacja Odoo 19 — Polska, dokumentacja Odoo 18 — Polska, repozytorium github.com/odoo/odoo (moduł l10n_pl_edi).
Oficjalny moduł KSeF w Odoo to l10n_pl_edi z polskiej lokalizacji; inne moduły KSeF w Odoo Apps pochodzą od firm zewnętrznych.
Certyfikat czy token — jak Odoo łączy się z KSeF 2.0
Dokumentacja Odoo opisuje połączenie certyfikatem KSeF. Certyfikat (plik .pem) i klucz prywatny generujesz w Aplikacji Podatnika KSeF, a potem wgrywasz je w Odoo: Księgowość → Konfiguracja → Ustawienia → sekcja „Polish Localization” → „Allow KSeF integration”.
Tokeny KSeF nadal działają w KSeF 2.0. Według Ministerstwa Finansów zostały utrzymane bezterminowo i działają równolegle z certyfikatami (certyfikat jest ważny maksymalnie 2 lata). Kod modułu Odoo obsługuje oba sposoby uwierzytelnienia, ale rekomendujemy certyfikat, bo tak opisuje to producent. Źródło: Pytania i odpowiedzi KSeF 2.0.
Klucz prywatny chroń jak hasło: nie wysyłaj go mailem i nie trzymaj w ogólnodostępnym folderze. Pamiętaj też o dacie ważności certyfikatu — po jej upływie wysyłka do KSeF przestanie działać.
Co trzeba przygotować w Odoo przed pierwszą wysyłką
Zanim pierwsza faktura trafi do KSeF, trzeba uporządkować dane w Odoo:
- Firma — kraj „Polska” i poprawny NIP w ustawieniach firmy (wymóg modułu).
- Kontrahenci — kraj i NIP u każdego klienta, któremu wystawiasz faktury przez KSeF.
- Podatki i pozycje fiskalne — stawki VAT, zwolnienia, odwrotne obciążenie, waluty.
- Certyfikat KSeF — wgrany w ustawieniach, z zapisanym hasłem i kluczem prywatnym.
- Testy — kilka faktur (zwykła, korekta, waluta obca, zaliczka) w środowisku testowym KSeF przed uruchomieniem produkcyjnym.
Najwięcej problemów sprawiają niekompletne dane kontrahentów i nietypowe pozycje faktury, a nie sama technika połączenia.
Kiedy standard Odoo nie wystarczy
Standard Odoo wystarcza większości firm, które mają jedną spółkę, typowe faktury i aktualną wersję Odoo. Integracji dedykowanej albo własnego modułu potrzebujesz zwykle, gdy:
- pracujesz na Odoo 16 lub 17 i nie planujesz jeszcze migracji — wtedy dopisujemy moduł KSeF dla Twojej wersji albo łączymy KSeF z migracją;
- masz nietypowy proces w kilku spółkach lub oddziałach — np. wspólny obieg dokumentów, osobne certyfikaty i uprawnienia (wtedy może być potrzebny dodatkowy moduł);
- faktury powstają poza Odoo — w sklepie internetowym, systemie TMS lub platformie B2B — i muszą trafić do KSeF z poprawnym numerem i statusem w Odoo;
- faktury kosztowe mają przechodzić obieg akceptacji (kto zatwierdza, do jakiego centrum kosztów, kiedy księgować), a nie tylko pojawić się w Odoo;
- masz dużo wyjątków: korekty zbiorcze, faktury zaliczkowe i końcowe, refakturowanie, faktury w walutach obcych.
W firmach transportowych KSeF jest zwykle częścią większego systemu — faktura za fracht powstaje w TMS, a księgowanie w Odoo. Takie połączenia opisujemy na stronie oprogramowanie dla transportu (TMS).
Jak wdrażamy KSeF w Odoo
W Odoo 18 i nowszych konfigurujemy standardową lokalizację KSeF (Community i Enterprise); dla Odoo 16–17 i nietypowych procesów robimy własny moduł. Proces wygląda tak:
- Analiza — wersja Odoo, liczba spółek, rodzaje faktur, skąd biorą się dokumenty i kto je zatwierdza.
- Decyzja: standard, moduł czy integracja — według tabeli z początku artykułu. Jeśli wystarczy standard, nie piszemy kodu.
- Porządek w danych — firma, kontrahenci, podatki, pozycje fiskalne.
- Konfiguracja lub moduł — certyfikat, ustawienia lokalizacji albo własny moduł dla Odoo 16–17 i procesów wielospółkowych.
- Testy w środowisku testowym KSeF — wysyłka, odrzucenia, korekty, import kosztów.
- Uruchomienie i opieka — pierwsze faktury pod kontrolą, potem aktualizacje przy zmianach API i schematów Ministerstwa Finansów.
Podstawową konfigurację KSeF obejmuje już nasz najmniejszy pakiet wdrożenia Odoo. Szczegóły zakresu i kosztów: wdrożenie i modyfikacje Odoo.
Jeśli faktury powstają w systemie innym niż Odoo, zobacz też integrację z KSeF przez API.
Od czego zacząć automatyzację faktur w firmie, piszemy w artykule automatyzacja faktur i KSeF — od czego zacząć.
Listę kontrolną konfiguracji KSeF w Odoo znajdziesz w naszym otwartym playbooku wdrożeń Odoo.
Terminy KSeF — przypomnienie
KSeF jest obowiązkowy od 2026 r. Największe firmy (sprzedaż powyżej 200 mln zł w 2024 r., wraz z VAT) wystawiają faktury w KSeF od 1 lutego 2026 r., pozostali podatnicy VAT od 1 kwietnia 2026 r. Firmy, których sprzedaż fakturowa nie przekracza 10 tys. zł brutto miesięcznie, mogą wystawiać faktury poza KSeF do 31 grudnia 2026 r. Od 1 stycznia 2027 r. obowiązek obejmuje także je i mogą być nakładane kary za błędy w KSeF.
FAQ
Czy Odoo obsługuje KSeF?
Tak. Od wersji 18 polska lokalizacja Odoo ma moduł l10n_pl_edi, który wysyła faktury FA(3) do KSeF 2.0, pobiera status i UPO oraz importuje faktury kosztowe. W Odoo 16 i 17 potrzebny jest dodatkowy moduł lub integracja, a przy nietypowych procesach (np. wspólny obieg dla kilku spółek, faktury z innych systemów) może być potrzebny dodatkowy moduł.
Czy KSeF działa w Odoo Community?
Tak, od wersji 18. Moduł KSeF jest częścią kodu Odoo Community (licencja LGPL-3), więc nie wymaga Enterprise. W Odoo 18+ konfigurujemy standardową lokalizację KSeF (Community i Enterprise); dla Odoo 16–17 i nietypowych procesów robimy własny moduł.
Czy Odoo jest gotowe na KSeF 2.0?
Tak. Moduł Odoo łączy się z API KSeF 2.0 Ministerstwa Finansów i generuje faktury w schemacie FA(3). Warto mieć aktualny kod Odoo, bo moduł jest rozwijany — np. kody QR na fakturach i pobieranie kosztów na żądanie doszły w aktualizacjach w 2026 r.
Czym połączyć Odoo z KSeF — certyfikatem czy tokenem?
Certyfikatem KSeF — tak opisuje to dokumentacja Odoo. Tokeny KSeF nadal działają w KSeF 2.0 bezterminowo, równolegle z certyfikatami, ale w konfiguracji Odoo wgrywasz certyfikat (.pem) i klucz prywatny z Aplikacji Podatnika KSeF.
Czy Odoo pobiera faktury kosztowe z KSeF?
Tak. Standardowo co 3 godziny Odoo pobiera z KSeF faktury od dostawców i tworzy z nich dokumenty zakupowe. Jeśli faktury kosztowe mają przechodzić obieg akceptacji, dobudowujemy go w Odoo.
Ile kosztuje wdrożenie KSeF w Odoo?
Podstawowa konfiguracja KSeF mieści się w naszym pakiecie startowym wdrożenia Odoo (15–40 tys. zł netto za całe wdrożenie do 3 modułów). Własny moduł KSeF lub integracja wielu spółek i systemów to wycena indywidualna, zwykle jako część większego projektu. Jeśli masz już Odoo, konfigurację KSeF albo moduł KSeF wykonujemy jako pojedynczą modyfikację — wycena indywidualna. Szczegóły kosztów wdrożenia Odoo
Masz Odoo i chcesz uruchomić KSeF albo sprawdzić, czy obecna konfiguracja jest poprawna?
Zaczynamy od krótkiej analizy wersji i procesu fakturowania.




