Skip to Content

Integracja z KSeF - Odoo 18

https://www.odoo.com.pl/web/image/product.template/84/image_1920?unique=5b81af8

Krajowy System e-Faktur (KSeF) w Odoo 18!

Zbliżający się 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 18 – 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 18, 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 18 już dziś!

97,97 zł 97.97 PLN 97,97 zł

Niedostępne w sprzedaży

(0,00 zł / Sztuk(a))

Ta kombinacja nie istnieje.

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

 

Integracja z KSeF – instrukcja obsługi (Odoo 18) 
Wysyłka e‑Faktur do KSeF, sprawdzanie statusu, pobieranie UPO oraz zamykanie sesji KSeF.

Spis treści

  1. Wymagania
  2. Konfiguracja firmy
  3. Faktura i „PL Extra”
  4. Panel KSEF na fakturze
  5. Wysyłka i status
  6. UPO oraz zamykanie sesji
  7. Rozwiązywanie problemów

1. Wymagania

  • Odoo 18, aplikacja Fakturowanie (i opcjonalnie Sprzedaż).
  • Aktywne klucze API KSeF (dla Testowego lub Produkcyjnego środowiska).

2. Konfiguracja firmy – zakładka „KSeF”

Ustawienia → Użytkownicy i firmy → Firmy → [Twoja firma] → zakładka KSeF.

Rys. 1. Wybór środowiska: Testowe/Produkcyjne.

Rys. 2. ID klucza API KSeF (publiczny identyfikator).

Rys. 3. Tajny klucz API KSeF.

3. Tworzenie faktury i pola „PL Extra”

Fakturowanie → Faktury → Nowa. Uzupełnij KlientaPozycjeDatęDziennik. W polskich ustawieniach dostępna jest zakładka PL Extra.

Rys. 4. Zakładka „PL Extra”.

Rys. 5. Przykład: B_SPV_Dostawa.

Rys. 6. Przykład: B_MPV_Prowizja.

Rys. 7. Przykład: B_SPV.

4. Panel „KSEF” na fakturze

Rys. 8. Panel z polami i przyciskami: Wyślij do KSeFSprawdź statusPobierz UPOZamknij sesję KSeF.

5. Wysyłka i status

  1. Wyślij do KSeF – otwiera sesję, wysyła XML, status: „Wysłano”.
  2. Sprawdź status KSeF – odczyt bieżącego stanu; po akceptacji pojawia się numer KSeF.
  3. „Wysłano” = w toku; „Błąd” = popraw fakturę i wyślij ponownie.

6. UPO oraz zamykanie sesji

Rys. 9. Pobierz UPO – zapisuje plik (PDF/XML) jako załącznik do faktury.

Rys. 10. Zamknij sesję KSeF – kończy interaktywną sesję.

7. Rozwiązywanie problemów

  • 401/403 – sprawdź ID/klucz API i wybrane środowisko.
  • Odrzucenie – najczęściej niekompletny lub niezgodny XML.
  • Panel KSEF nie widoczny – dotyczy tylko faktur sprzedaży i korekt.

Uwagi:

W Krajowym Systemie e-Faktur (KSeF), oznaczenia B_SPV_Dostawa, B_MPV_Prowizja i B_SPV to specjalne kody identyfikujące transakcje związane z bonami. Kody te, choć technicznie pochodzą ze struktury JPK_VAT, mają bezpośrednie zastosowanie przy wystawianiu faktur ustrukturyzowanych w KSeF, ponieważ e-faktura musi zawierać wszystkie elementy wymagane przepisami, w tym odpowiednie oznaczenia procedur podatkowych.

Poniżej znajduje się szczegółowe wyjaśnienie każdego z tych oznaczeń.

B_SPV: Transfer bonu jednego przeznaczenia

Kod B_SPV stosuje się do oznaczenia transferu bonu jednego przeznaczenia (SPV - Single-Purpose Voucher), dokonywanego przez podatnika działającego we własnym imieniu.

  • Co to jest bon jednego przeznaczenia? To taki bon, w przypadku którego już w momencie jego emisji znane jest miejsce dostawy towarów lub świadczenia usług, których dotyczy, oraz kwota należnego podatku VAT.
  • Kiedy stosować? Oznaczenie to jest używane, gdy firma sprzedaje taki bon (np. kartę podarunkową na konkretną usługę lub towar). Zgodnie z przepisami, już sam transfer (sprzedaż) takiego bonu jest traktowany jak dostawa towaru lub świadczenie usługi i podlega opodatkowaniu VAT.

B_SPV_Dostawa: Dostawa towarów lub usług związanych z bonem SPV

Oznaczenie B_SPV_Dostawa jest używane w sytuacji, gdy następuje faktyczna dostawa towarów lub świadczenie usług, których dotyczy bon jednego przeznaczenia, ale transakcji tej dokonuje podatnik inny niż ten, który wyemitował bon i działał we własnym imieniu.

  • Kluczowa sytuacja: Ten kod stosuje firma, która realizuje (akceptuje) bon jednego przeznaczenia, ale go nie wyemitowała. Jest to informacja dla organów skarbowych, że dana sprzedaż jest związana z wcześniej opodatkowanym bonem.
  • Przykład: Restauracja A sprzedaje bony na konkretne danie. Sprzedaż tego bonu jest oznaczona jako B_SPV. Jeśli restauracja B (działająca np. w ramach tej samej sieci franczyzowej) zrealizuje ten bon, to swoją usługę (wydanie posiłku) oznaczy na fakturze kodem B_SPV_Dostawa.

B_MPV_Prowizja: Usługi pośrednictwa dotyczące bonu różnego przeznaczenia

Kod B_MPV_Prowizja odnosi się do świadczenia usług pośrednictwa lub innych usług związanych z transferem bonu różnego przeznaczenia (MPV - Multi-Purpose Voucher).

  • Co to jest bon różnego przeznaczenia? To każdy bon, który nie jest bonem jednego przeznaczenia. Oznacza to, że w momencie jego emisji nie jest znana kwota podatku VAT (np. bon można wymienić na towary o różnych stawkach VAT). Opodatkowanie następuje dopiero w momencie wymiany bonu na towar lub usługę.
  • Kiedy stosować? Oznaczenie to stosuje podmiot, który świadczy usługi pośrednictwa w sprzedaży bonów różnego przeznaczenia i otrzymuje z tego tytułu wynagrodzenie (prowizję). Faktura dokumentująca taką usługę prowizyjną powinna zawierać kod B_MPV_Prowizja.
  • Przykład: Firma X zajmuje się dystrybucją kart podarunkowych do różnych sklepów (bony MPV). Za sprzedaż tych kart pobiera prowizję od emitentów. Faktura wystawiona na tę usługę pośrednictwa będzie oznaczona kodem B_MPV_Prowizja.

© 2025 – Instrukcja modułu KSeF Integration. Wersja 1.0.

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