Instrukcja Użytkowania: KSeF w Odoo 18

 Pro EXTREME

 Pro ULTIMATE

​ Midi BUSINESS

 Mini FREE

Zakup KSeF tutaj

KSeF – instrukcja obsługi (Odoo 18)

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

Wysyłka e‑Faktur do KSeF, sprawdzanie statusu, pobieranie UPO oraz zamykanie sesji KSeF.

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 Klienta, Pozycje, Datę, 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 KSeF, Sprawdź status, Pobierz UPO, Zamknij 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.