Skip to Content

Integracja z KSeF 2.0 - Odoo 19

https://www.odoo.com.pl/web/image/product.template/111/image_1920?unique=698d482

Wysyłanie faktur do Krajowego Systemu e-Faktur - FA(3) aktualizacja 30.07.2026 v19.4.30

 Odoo 18   Odoo 19

  Odoo Community,  Odoo Enterprise,  Odoo Online

Obowiązek korzystania z Krajowego Systemu e-Faktur to wyzwanie dla wielu polskich firm. Ręczne przesyłanie faktur, śledzenie statusów i archiwizowanie potwierdzeń to proces czasochłonny i obarczony ryzykiem błędów.

Przedstawiamy dedykowany moduł integracji z KSeF dla Odoo 19 – kompleksowe rozwiązanie, które sprawia, że obowiązek staje się prostym i zautomatyzowanym elementem Twojej codziennej pracy.

Zapomnij o skomplikowanych procedurach. Nasz moduł został zaprojektowany tak, aby cała obsługa KSeF odbywała się bezpośrednio z poziomu Twojej faktury w Odoo – bez przełączania się między systemami.

Kluczowe korzyści modułu KSeF:

Pełna kontrola: Intuicyjny panel KSeF

Koniec z szukaniem opcji! Na każdej fakturze sprzedaży znajdziesz dedykowany panel, z którego jednym kliknięciem:

  • Wyślesz e-Fakturę prosto do systemu KSeF.
  • Sprawdzisz jej status w czasie rzeczywistym.
  • Pobierzesz Urzędowe Poświadczenie Odbioru (UPO), które automatycznie zapisze się jako załącznik.
  • Zarządzisz sesją, zwalniając zasoby po zakończeniu pracy.

Automatyzacja i oszczędność czasu

Nasz moduł automatycznie generuje poprawny plik XML i wysyła go do KSeF. System na bieżąco informuje Cię o statusie przetwarzania – od „Wysłano” aż po otrzymanie oficjalnego numeru KSeF. Skup się na biznesie, a nie na biurokracji.

Zgodność z polskimi przepisami

Moduł posiada specjalną zakładkę „PL Extra” na formularzu faktury. Umożliwia ona łatwe dodanie wszystkich wymaganych przez KSeF kodów i procedur specjalnych (np. B_SPV_Dostawa, B_MPV_Prowizja), zapewniając 100% zgodność Twoich dokumentów.

Bezpieczeństwo

Urzędowe Poświadczenie Odbioru (UPO) to Twój prawny dowód terminowego dostarczenia faktury. Nasze rozwiązanie automatycznie pobiera UPO i dołącza je do odpowiedniego dokumentu w Odoo, tworząc kompletną i bezpieczną historię każdej transakcji.

Błyskawiczna Konfiguracja i Prosta Obsługa

Wystarczy jednorazowo wprowadzić klucze API w ustawieniach firmy i wybrać środowisko (Testowe lub Produkcyjne), aby rozpocząć pracę. Przejrzyste komunikaty o błędach, np. w przypadku problemów z autoryzacją, pozwalają na szybką diagnozę i korektę.

Dla kogo jest ten moduł?

Dla każdej firmy w Polsce korzystającej z systemu Odoo 19, która chce:

  • Zapewnić sobie pełną zgodność z wymogami KSeF.
  • Zaoszczędzić czas i zredukować koszty związane z obsługą e-faktur.
  • Zminimalizować ryzyko ludzkich błędów i odrzucenia dokumentów.
  • Zintegrować obowiązek prawny z codziennymi procesami biznesowymi w sposób płynny i intuicyjny.

Nie czekaj na ostatnią chwilę! Zapewnij swojej firmie spokój i płynne przejście na Krajowy System e-Faktur. Wybierz nasze sprawdzone rozwiązanie dla Odoo 19 już dziś!

 Odoo 18   Odoo 19

99,65 zł 99.65 PLN 99,65 zł

Niedostępne w sprzedaży

(99,65 zł / opłata jednorazowa)
  • Instalacja i konfiguracja

Ta kombinacja nie istnieje.

Instalacja
1. Pobrany moduł rozpakój
2. Przenieś całą zwartość katalogu do twoich modułów na serwerze Odoo 19
3. Zmień właściciela zgodnie z Twoimi ustawieniami
4. W ustawieniach Odoo włącz tryb deweloperski 
5. Przeidź do aplikacji i aktualizuj listę aplikacji
6. Usuń filtr "Aplikacje" i wyszukaj frazy: ksef
7. Aktywuj

 

Instrukcja Modułu KSeF2 dla Odoo 19

Wersja: 19.4.30

Autor: Marius Johannes Kuc (aktualizacja FA(3):)

Licencja: OPLv1

Spis Treści

1. Wprowadzenie

Moduł KSeF2 Integration umożliwia pełną integrację systemu Odoo 19 z Krajowym Systemem e-Faktur (KSeF). Pozwala na automatyzację procesów związanych z fakturami ustrukturyzowanymi.

Kluczowe funkcjonalności:

Wysyłanie faktur zgodnie ze schematem FA(3). 

Automatyczne pobieranie numerów KSeF i statusów.

Zamykanie sesji oraz pobieranie Urzędowego Poświadczenia Odbioru (UPO).

2. Wymagania systemowe

KomponentWymaganie
OdooWersja 19.0 lub nowsza
Python3.10+
Bibliotekiaccount (Księgowość), requests

Wymagania KSeF: Aktywne konto na portalu podatnika, Token dostępowy (JWT), poprawny NIP firmy w Odoo.

3. Instalacja modułu

  1. Przygotowanie plików:
    Rozpakuj archiwum i skopiuj folder do katalogu addons:
    cp -r ksef_2_patched /opt/odoo/addons/​
  2. Aktualizacja listy aplikacji:
    Włącz Tryb deweloperski, przejdź do menu Aplikacje i kliknij Aktualizuj listę aplikacji.
  3. Instalacja:
    Wyszukaj "KSeF", znajdź KSeF2 Integration i kliknij Instaluj.

4. Konfiguracja KSeF

4.1 Ustawienia firmy

Przejdź do Ustawienia -> Firmy -> [Twoja Firma] -> Zakładka KSeF.

PoleOpisWymagane
KSeF EnvironmentŚrodowisko API (Test/Demo/Produkcja)Tak
KSeF Context IdentifierNIP firmyTak
KSeF Access TokenToken JWT wygenerowany w portaluTak

UWAGA: Zacznij od środowiska Test (TE) aby zweryfikować poprawność danych przed wysyłką na produkcję.

5. Obsługa faktur

Aby wysłać fakturę, musi być ona w stanie Zaksięgowana.

Proces wysyłki:

  1. Otwórz fakturę sprzedaży.
  2. Kliknij przycisk Send to KSeF.
  3. System wygeneruje XML FA(3) i prześle go do bramki MF.
  4. Po otrzymaniu statusu accepted, faktura otrzyma oficjalny numer KSeF.

6. Struktura FA(3) - Informacje techniczne

Namespace: http://crd.gov.pl/wzor/2025/06/25/13775/

Przykładowy szkielet XML:

<?xml version="1.0" encoding="UTF-8"?>
<Faktura xmlns="http://crd.gov.pl/wzor/2025/06/25/13775/">
  <Naglowek>...</Naglowek>
  <Podmiot1>...</Podmiot1> <!-- Sprzedawca -->
  <Podmiot2>...</Podmiot2> <!-- Nabywca -->
  <Fa>
    <KodWaluty>PLN</KodWaluty>
    <P_1>2026-01-26</P_1>
    <Adnotacje>...</Adnotacje>
  </Fa>
</Faktura>

Mapowanie Pól:

ElementOpisŹródło Odoo
P_1Data wystawieniainvoice_date
P_2Numer fakturyname
P_13_1Podstawa Netto 23%tax_totals (base)

7. Rozwiązywanie problemów

Błąd 401: Unauthorized

Token wygasł lub jest nieprawidłowy. Wygeneruj nowy token na portalu KSeF.

Błąd 400: Bad Request

XML nie jest zgodny ze schematem. Sprawdź czy NIP firmy i kontrahenta są uzupełnione oraz czy stawki VAT są przypisane do pozycji.

8. FAQ

Pytanie: Czy moduł obsługuje faktury zakupowe?

Odpowiedź: Nie, ten moduł służy do wysyłki (sprzedaży). Do faktur przychodzących wymagany jest moduł ksef_incoming.

Pytanie: Czy moduł waliduje XML przed wysłaniem?

Odpowiedź: Moduł generuje strukturę zgodną z FA(3), ale pełna walidacja biznesowa odbywa się po stronie serwerów Ministerstwa Finansów.

Dokumentacja przygotowana przez odoo.com.pl

Data aktualizacji: 2026-01-05


🧭 Gantt wewnątrz aplikacji

Zakładka Gantt obok widoków Lista i Kanban oraz osobna pozycja menu w danej aplikacji. Dane czytane wprost z modelu źródłowego.

  • ▸ Pełna wyszukiwarka i filtry Odoo
  • ▸ Respektuje reguły rekordowe i podział na firmy
  • ▸ Jedyne miejsce z przesunięciami magazynowymi
  • ▸ Limit 500 rekordów na widok
  • ▸ Włączany osobno dla każdej z siedmiu aplikacji
🗺️ Globalna oś czasu

Menu Globalny Gantt → Oś czasu (Gantt). Jeden ekran dla wszystkich typów dokumentów, ułożonych w poziome sekcje z kolorem typu.

  • ▸ Osiem typów dokumentów w jednym widoku
  • ▸ Strzałki zależności w sekcji Zadanie
  • ▸ Wyszukiwanie tekstowe po nazwie, bez panelu filtrów
  • ▸ Dostępna dla każdego użytkownika wewnętrznego
  • ▸ Bez przesunięć magazynowych

Zakres modułu

Co dostajesz na ekranie

Po instalacji nie ma czego konfigurować: siedem przełączników jest domyślnie włączonych, a zakładka Gantt pojawia się sama przy listach i kanbanach siedmiu aplikacji.

🖱️

Przeciąganie i rozciąganie

Chwyt w środku paska przesuwa termin, chwyt za krawędź zmienia długość. Zapis idzie do dokumentu źródłowego, więc widać go w historii zmian i czaterze.

komunikat: Harmonogram zaktualizowany


🔍

Skale i przybliżanie

Dzień, Tydzień, Miesiąc plus płynny zoom przyciskami plus i minus w obrębie wybranej skali. Pionowa linia Now pokazuje bieżącą chwilę.

zakres osi: -3 dni … +5 dni

⌨️

Filtrowanie w locie

Pole wyszukiwania w lewej górnej komórce zawęża widoczne wiersze po nazwie, bez przeładowania ekranu.

lewa kolumna = nazwy rekordow 

📍

Kamienie milowe

Pozycje jednodatowe rysowane są jako wąski znacznik. Na osi globalnej to faktury oraz szanse CRM z prawdopodobieństwem 100%; w trybie aplikacyjnym — rekordy bez daty końcowej.

bez uchwytow do rozciagania

🔗

Linie zależności

Strzałki zakończenie → rozpoczęcie dla poprzedników zadań projektu. Widoczne na osi globalnej w sekcji Zadanie i w Ganttcie aplikacji Projekt.

charakter informacyjny

🎛️

Siedem przełączników

W Ustawienia → PERP Gantt włączasz Gantta osobno dla CRM, Sprzedaży, Projektu, Produkcji, Zakupów, Fakturowania i Magazynu. Wyłączenie chowa zakładkę i pozycję menu tej aplikacji.

menu Globalny Gantt zostaje zawsze

Zakres danych

Które daty widać i które da się zmienić

Pasek rysuje się między dwiema datami, ale przeciąganie nie zawsze zapisuje obie. To jest tabela, którą warto przeczytać przed zakupem.


Globalna oś czasu
SekcjaPoczątek paskaKoniec paskaCo zapisuje przeciąganie
CRM — szansaData utworzeniaTermin zamknięciatylko termin zamknięcia
Sprzedaż — zamówienieData zamówieniaData dostawyobie daty
ProjektData rozpoczęciaData zakończeniaobie daty
Zadanie projektuData utworzeniaTermin realizacjitylko termin realizacji
Zlecenie produkcyjneData rozpoczęciaData zakończeniaobie daty
Zlecenie operacyjneData rozpoczęciaData zakończeniaobie daty
Zakup — zamówienieData zamówieniaPlanowana dostawaobie daty
Faktura sprzedaży / zakupuTermin płatnościTermin płatnościtermin płatności

Gantt wewnątrz aplikacji
AplikacjaDokumentPoczątekKoniec
CRMSzansaData utworzeniaTermin zamknięcia
SprzedażZamówienie sprzedażyData zamówieniaData dostawy
ProjektZadanieData utworzeniaTermin realizacji
ProdukcjaZlecenie produkcyjneData rozpoczęciaData zakończenia
ZakupyZamówienie zakupuData zamówieniaPlanowana dostawa
FakturowanieFakturaData fakturyTermin płatności
MagazynPrzesunięcieData planowanaTermin ostateczny

UCZCIWIE: dla CRM i Zadań początkiem paska jest data utworzenia rekordu, której nie da się zmienić. Przeciągnięcie takiego paska w prawo nie przesunie go w całości — wydłuży go, bo zapisze się wyłącznie nowy termin końcowy. Chwycenie lewej krawędzi nie zmieni niczego, a komunikat o powodzeniu pojawi się mimo to.

Przeciąganie działa z dokładnością do pełnych dni; godziny ustawia się w formularzu dokumentu. Pozycje pomijane przez oś globalną: szanse, projekty i zadania zarchiwizowane, faktury anulowane oraz dokumenty inne niż faktury i korekty sprzedaży/zakupu.

Uprawnienia

Kto co widzi i kto co zapisze

Jeden punkt wymaga świadomej decyzji administratora przed udostępnieniem osi globalnej szerszemu gronu.

✓ Zapis respektuje uprawnienia Odoo
  • Zmiana wykonywana jest w imieniu zalogowanego użytkownika, na dokumencie źródłowym
  • Brak prawa edycji dokumentu albo stan blokujący zmianę daty = zapis odrzucony, oś wraca do stanu z bazy
  • Usuwanie krzyżykiem działa tylko tam, gdzie użytkownik ma prawo usuwania
  • W samym zestawieniu nie da się tworzyć ani usuwać pozycji
  • Gantt wewnątrz aplikacji czyta dane wprost z modeli źródłowych, więc respektuje pełne reguły widoczności
— Do decyzji administratora
  • Zestawienie zasilające oś globalną nie stosuje reguł rekordowych ani podziału na firmy
  • Mogą pojawić się paski dokumentów, których użytkownik nie ma prawa otworzyć — nazwa wyświetli się jako „Bez nazwy", ale typ i daty będą widoczne
  • W instancjach wielofirmowych na osi pojawią się dokumenty innych firm
  • Dostęp do osi globalnej ma każdy użytkownik wewnętrzny
  • Jeśli to niepożądane: ograniczyć dostęp do menu Globalny Gantt i korzystać wyłącznie z Ganttów wewnątrz aplikacji

Zakres zakupu

Co dostajesz za 95 €, a czego nie

Cena jednorazowa, netto. Wolimy powiedzieć to przed zakupem niż po.

✓ W cenie modułu
  • Moduł gant_view_perp w wersji 19.0.7.0.1 dla Odoo 19 Community
  • Globalna oś czasu i zakładka Gantt w siedmiu aplikacjach
  • Instrukcja obsługi w PDF
  • Interfejs w języku polskim i niemieckim
  • Bez opłat cyklicznych za sam moduł
  • Bez licencji Odoo Enterprise
— Poza zakresem modułu
  • Planowanie zasobów i wykrywanie przeciążeń
  • Przeliczanie terminów zależnych, ścieżka krytyczna i bufory
  • Wydruk PDF i eksport osi czasu
  • Przesunięcia magazynowe na osi globalnej
  • Wdrożenie, hosting i SLA — wyceniane osobno

Wymagania techniczne

Zanim klikniesz „Dodaj do koszyka"

Instalacja modułu pociągnie brakujące aplikacje automatycznie.

 
// WYMAGANE APLIKACJE

▸ crm
▸ sale_management
▸ sale_stock
▸ stock
▸ project
▸ mrp
▸ purchase
▸ account

 
// MODUL

 gant_view_perp
▸ wersja 19.0.7.0.1
▸ Odoo 19 Community
▸ licencja OPL-1
▸ autor: Nexus Digital
▸ bez web_gantt
▸ bez Odoo Enterprise
▸ interfejs PL / DE

 
// INSTALACJA

▸ katalog do addons
▸ restart uslugi Odoo
▸ Aktualizuj liste aplikacji
▸ instalacja z Aplikacji
▸ lub: odoo -i gant_view_perp
▸ aktualizacja: odoo -u
▸ potem Ctrl+F5
▸ PWA: okno prywatne

Deinstalacja z ekranu Aplikacje usuwa widoki, menu i zestawienie danych, a zakładki doklejone do natywnych ekranów odpina automatycznie. Dane biznesowe zostają bez zmian — terminy przesunięte na osi są zapisane w dokumentach, moduł nie trzymał ich u siebie.

Granice zakresu

Czego moduł nie obejmuje

Świadome granice. Jeśli szukasz planowania zdolności produkcyjnych albo ścieżki krytycznej — to nie jest to narzędzie.

 

Planowanie
  • Brak planowania zasobów — moduł nie pokazuje obciążenia pracowników ani gniazd produkcyjnych, nie wykrywa przeciążeń
  • Brak przeliczania zależności: bez ścieżki krytycznej, buforów i automatycznego przesuwania następników
  • Powiązań nie da się utworzyć ani usunąć przeciągnięciem — tylko w formularzu zadania
  • Granulacja do pełnego dnia; przy zdarzeniach blisko północy pasek może wypaść po drugiej stronie granicy dnia

 

Zakres i filtrowanie
  • Przesunięć magazynowych nie ma na osi globalnej — tylko w Ganttcie aplikacji Magazyn
  • Limit 500 rekordów w Ganttcie wewnątrz aplikacji; nadmiar nie zostanie narysowany
  • Grupuj wg działa, ale wiersze pozostają płaską listą — sekcje są wyłącznie na osi globalnej i stałe, według typu dokumentu
  • Oś globalna nie ma panelu filtrów; filtry i grupowania dostępne są w widoku Kalendarz / Lista na tych samych danych

 

Dane, wydruk, język
  • Kolumna „Odpowiedzialny" nie jest wypełniona dla zadań, zleceń produkcyjnych i operacji — grupowanie po opiekunie zbierze je w grupie pustej
  • Brak raportu PDF i eksportu osi czasu; eksport danych możliwy z widoku listy
  • Część etykiet interfejsu pozostaje po angielsku (m.in. Task, New, Search, Now, komunikaty pustego ekranu)
  • Nazwy pól, menu, filtrów i komunikaty o zapisie są przetłumaczone na polski i niemiecki

Najczęstsze pytania

Zanim kupisz


Czy potrzebuję Odoo Enterprise?

Nie. Oś czasu jest własnym komponentem — moduł nie korzysta z Odoo Enterprise ani z modułu web_gantt. Wystarczy Odoo 19 Community z zainstalowanymi aplikacjami z sekcji wymagań.


Oś czasu jest pusta — co sprawdzić?

Dwie typowe przyczyny: dokumenty nie mają wypełnionych dat albo wszystko odfiltrowało pole wyszukiwania. Wyczyścić pole, a potem sprawdzić w widoku listy, czy rekordy w ogóle mają daty.


W aplikacji nie ma zakładki Gantt

Albo przełącznik tej aplikacji jest wyłączony w Ustawienia → PERP Gantt, albo używany jest niestandardowy widok lub akcja, do której moduł zakładki nie dokłada, albo przeglądarka trzyma stary interfejs — wtedy odświeżenie z pominięciem pamięci podręcznej.


Pasek wraca na stare miejsce po puszczeniu

Zapis został odrzucony. Zwykle chodzi o brak uprawnień do dokumentu, zamknięty okres księgowy albo stan dokumentu blokujący zmianę daty. Otworzyć dokument dwuklikiem i sprawdzić, czy pole daty jest edytowalne.


Komunikat o powodzeniu, ale nic się nie zmieniło

Zapisywalna była tylko jedna z dwóch dat — najczęściej w CRM i w zadaniach, gdzie początkiem paska jest niezmienialna data utworzenia. Szczegóły w tabeli wyżej.

Co oznacza procent w etykiecie paska?

W Ganttcie zadań projektu to stopień ukończenia liczony z podzadań. Wszędzie indziej — upływ czasu, czyli jaka część zaplanowanego okresu już minęła. To nie jest postęp prac.


Dlaczego nie widać strzałek zależności?

Strzałka pojawia się tylko wtedy, gdy oba zadania są widoczne na ekranie — odfiltrowanie poprzednika ukrywa też połączenie. Sprawdzić również, czy zadania mają wypełnione pole „Poprzedniki" i czy funkcja zależności zadań jest w instancji włączona.


Czy mogę zobaczyć moduł przed zakupem?

Tak. Uruchamiamy bezpłatną instancję testową na 14 dni, na realnych danych — z Twoimi zamówieniami, projektami i zleceniami.

Licencje


Niektóre moduły wydanego przez nas Odoo oparte są o licencję OPL1. Tekst licencji w języku angielskim znajduje się tutaj: OPL v1

Oprogramowanie Open Source jest publikowane na Licencji LGPL 3, licencja ta nie posiada oficjalnego tłumaczenia i jest dostępna na stronie: https://www.gnu.org/licenses/lgpl-3.0.en.html 

Nieoficjalne tłumaczenia

Na stronie projektu GNU można znaleźć informacje o nieoficjalnych tłumaczeniach. Można tam sprawdzić, czy społeczność przygotowała nieoficjalne tłumaczenie, oraz zapoznać się z zasadami dotyczącymi takich przekładów.

Zaleca się, aby w celach prawnych i przy tworzeniu lub dystrybucji oprogramowania zawsze opierać się na oryginalnej, angielskiej wersji licencji.

Logo Odoo


 Używamy logo Odoo, które jest dostępne na licencji Creative Commons. Twórcą logo jest Odoo S.A. Do logo został dodany opis COMMUNITY.

Więcej informacji o licencji Creative Commons i uznanie autorstwa 4.0 znajdziesz tutaj: Link do licencji



Update cookies preferences