Logo Sysmo.pl

Odoo a KSeF: jak wysyłać faktury z Odoo do KSeF 2.0

Autor: Kamil, Senior Developer w Sysmo.pl · Aktualizacja: 2026-11-15

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 AppsIntegracja dedykowana / własny moduł
Wersja Odoo18, 19 i nowszetakże starsze wersje, zależnie od dostawcy modułudowolna, w tym 16 i 17
Co obejmujewysyłka FA(3), status, UPO, import faktur kosztowych, kody QRzależnie od modułudokładnie Twój proces: wiele spółek, obieg akceptacji, korekty, wyjątki
Kosztw cenie Odoo + konfiguracjalicencja modułu + konfiguracjaprojekt wyceniany indywidualnie
Kiedy wybraćjedna spółka, typowe faktury, aktualne Odoostarsza wersja, a proces jest typowywiele spółek lub oddziałów, faktury z innych systemów (sklep, TMS), własny obieg dokumentów
Ryzykotrzeba aktualizować kod Odoo, bo moduł jest rozwijanyzależność od dostawcy modułu przy zmianach API Ministerstwa Finansówpo 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:

  1. Firma — kraj „Polska” i poprawny NIP w ustawieniach firmy (wymóg modułu).
  2. Kontrahenci — kraj i NIP u każdego klienta, któremu wystawiasz faktury przez KSeF.
  3. Podatki i pozycje fiskalne — stawki VAT, zwolnienia, odwrotne obciążenie, waluty.
  4. Certyfikat KSeF — wgrany w ustawieniach, z zapisanym hasłem i kluczem prywatnym.
  5. 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:

  1. Analiza — wersja Odoo, liczba spółek, rodzaje faktur, skąd biorą się dokumenty i kto je zatwierdza.
  2. Decyzja: standard, moduł czy integracja — według tabeli z początku artykułu. Jeśli wystarczy standard, nie piszemy kodu.
  3. Porządek w danych — firma, kontrahenci, podatki, pozycje fiskalne.
  4. Konfiguracja lub moduł — certyfikat, ustawienia lokalizacji albo własny moduł dla Odoo 16–17 i procesów wielospółkowych.
  5. Testy w środowisku testowym KSeF — wysyłka, odrzucenia, korekty, import kosztów.
  6. 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.

Logo Sysmo.pl

Powiązane tematy:

  • Fakturownia a KSeF – jak przygotować firmę na e-fakturowanie?
  • Fakturownia – Profesjonalna Integracja z Systemem Fakturującym dla Twojej Firmy
  • Nowoczesne systemy informatyczne – automatyzacja, AI, optymalizacja