Przejdź do głównej treści
KSeF · faktury

Faktury w KSeF: wystawianie, odbiór, numer KSeF i kod QR

W KSeF faktura istnieje dopiero wtedy, gdy system nada jej numer KSeF. Plik XML w strukturze FA(3) wysyłasz z programu do fakturowania albo z bezpłatnej Aplikacji Podatnika KSeF. W trybie online fakturę uznaje się za wystawioną w dniu wysłania, jeśli zgadza się on z datą w polu P_1, a za otrzymaną przez nabywcę w dniu nadania numeru, bez żadnej akceptacji. Konsumentowi i firmie zagranicznej przekazujesz ją w uzgodniony sposób, z kodem QR.

FlexigoTech · Odpowiada: Víctor Gómez · Aktualizacja: 17 listopada 2026

Najważniejsze

Moduł
KSeF 2.0
Wersje
Odoo 17, 18, 19 i 20
Sprawdzone
w kodzie źródłowym modułu, wersja 17.0, 18.0, 19.0 i 20.0 · w źródłach podanych na końcu
Czas czytania
5 min

Jak wystawić fakturę w KSeF

  1. Przygotuj fakturę w programie do fakturowania, w ERP albo w Aplikacji Podatnika KSeF. Powstaje z niej plik XML w strukturze FA(3) z NIP sprzedawcy, który jest obowiązkowy.
  2. Wyślij plik do KSeF w ramach otwartej sesji, tego samego dnia, który wpisujesz w polu P_1. Wysyłka następnego dnia oznacza fakturę w trybie offline24.
  3. KSeF sprawdza, czy plik jest zgodny z obowiązującym wzorem e-Faktury i czy wysyłająca osoba ma uprawnienia.
  4. Jeśli plik jest poprawny, KSeF nadaje mu numer KSeF i od tej chwili jest to faktura ustrukturyzowana. Jeśli ma błędy, system go odrzuca: faktura nie powstała, więc poprawiasz plik i wysyłasz go ponownie.
  5. Pobierz UPO. W polu „Data przyjęcia dokumentu do systemu teleinformatycznego MF” jest data, w której nabywca otrzymał fakturę.

Do wystawiania nie potrzebujesz płatnego programu: Ministerstwo Finansów udostępnia Aplikację Podatnika KSeF i Aplikację Mobilną KSeF. Program lub ERP przydaje się, gdy faktury mają trafiać do KSeF automatycznie.

Data wystawienia i numer KSeF

SytuacjaData wystawieniaData otrzymania
Online, wysłana w dniu z pola P_1dzień przesłania do KSeFdzień nadania numeru KSeF
Wysłana później niż data z pola P_1data z pola P_1 (tryb offline24)dzień nadania numeru KSeF
Przekazana konsumentowi lub firmie zagranicznej poza KSeFjak wyżejdzień faktycznego otrzymania

Jeśli wyślesz fakturę 1 lutego, a numer KSeF przyjdzie 2 lutego, data wystawienia to nadal 1 lutego: liczy się dzień, w którym plik zarejestrował się na bramce KSeF. Numeru KSeF nie musisz wysyłać nabywcy, bo faktura sama pojawia się w jego części systemu.

Jak odebrać fakturę w KSeF

Od 1 lutego 2026 r. wszyscy podatnicy odbierają faktury od polskich sprzedawców w KSeF. Faktura jest otrzymana w dniu nadania jej numeru, a nabywca nie musi jej akceptować. KSeF nie wysyła powiadomień o nowych fakturach: program księgowy musi sam regularnie sprawdzać, czy coś przyszło, albo ktoś zagląda do Aplikacji Podatnika KSeF lub aplikacji mobilnej. Automatyczne pobieranie faktur jest możliwe przez integrację z KSeF. Sprzedawca nie dowie się z systemu, czy nabywca pobrał fakturę.

Faktura dla konsumenta i dla firmy z zagranicy

Faktury dla konsumentów możesz wystawiać w KSeF, ale nie musisz. Firma z zagranicy bez polskiego NIP nie zaloguje się do KSeF, więc fakturę wystawioną w systemie przekazujesz jej w uzgodniony sposób, na przykład jako PDF mailem albo na papierze.

Taka wizualizacja może mieć własny wygląd i może być po angielsku albo dwujęzyczna, ale musi zgadzać się z danymi w pliku XML. Jeśli faktura wychodzi poza KSeF, ma kod QR: przy fakturze online jeden, prowadzący do faktury w systemie. Faktury w trybie offline przekazane przed wysłaniem do KSeF i faktury z trybu awaryjnego mają dwa kody, „OFFLINE” i „CERTYFIKAT”; więcej w poradniku KSeF awaria i tryby offline.

Błąd na fakturze: korekta zamiast edycji

Faktury przyjętej do KSeF nie da się zmienić ani anulować. Błąd poprawia się fakturą korygującą. KSeF nie liczy kwot za Ciebie: faktura z błędnie policzoną sumą zostanie przyjęta i też wymaga korekty. Inaczej jest z plikiem odrzuconym przez KSeF: on nie stał się fakturą, więc nie koryguje się go, tylko wysyła poprawiony plik. Najczęstsze odrzucenia opisujemy w poradnikach o kodzie 450, o duplikacie faktury 440 i o wyjątkach przy wysyłce.

Załączniki i numer KSeF w płatnościach

Od 1 lutego 2026 r. można wystawiać w KSeF faktury z załącznikiem, ale najpierw trzeba zgłosić taki zamiar w e-Urzędzie Skarbowym; zgłoszenia przyjmowano od 1 stycznia 2026 r. Od 1 stycznia 2027 r. w płatnościach między czynnymi podatnikami VAT i w mechanizmie podzielonej płatności podaje się numer KSeF faktury albo identyfikator zbiorczy.

Faktury w KSeF z Odoo

W Odoo 18, 19 i 20 faktury do KSeF wysyła moduł l10n_pl_edi z Odoo Community. Odoo 17 nie ma takiego modułu, więc fakturę trzeba wysłać innym narzędziem. Nasz moduł KSeF 2.0 Validator Odoo niczego nie wysyła: przed wysyłką sprawdza plik FA(3) względem oficjalnego schematu w FlexigoTech Cloud oraz NIP nabywcy, pozycje i dane korekty, a po wysyłce śledzi status i numer KSeF, które zostawia l10n_pl_edi. Dzięki temu błąd schematu widać w Odoo, zanim KSeF odrzuci plik. Kosztuje 9 € w Odoo Apps za każdą wersję Odoo i wymaga subskrypcji FlexigoTech Cloud od 29 € miesięcznie netto, z 14 dniami za darmo. Kogo i od kiedy obowiązuje KSeF, opisujemy w przewodniku po KSeF.

Przebieg walidacji w widoku formularza z przyciskami Run i Export checklist, uzyskanym wynikiem punktowym, a poniżej wiersz dla każdej faktury z wynikiem, kodem błędu i powodem
Zrzut z danymi demonstracyjnymi: sprawdzenie faktur przed wysyłką. Faktura, która nie przeszła, ma przy sobie kod błędu i powód.
Lista Submission Queue z sześcioma rekordami Wawel Digital sp. z o.o.
Zrzut z danymi demonstracyjnymi: stan każdej faktury w module, na przykład gotowa do wysłania albo przyjęta przez KSeF. Faktury wysyła l10n_pl_edi w Odoo 18, 19 i 20, a moduł tylko śledzi ich stan.

Najczęstsze pytania

Czy fakturę online trzeba wysłać do KSeF tego samego dnia?

Tak. Jeśli wyślesz ją następnego dnia, KSeF potraktuje ją jako fakturę w trybie offline24 z datą wystawienia z pola P_1.

Czy nabywca musi zaakceptować fakturę w KSeF?

Nie. Faktura jest otrzymana w dniu, w którym KSeF nada jej numer.

Czy można poprawić fakturę już wysłaną do KSeF?

Nie. Fakturę przyjętą do KSeF poprawia się fakturą korygującą. Plik odrzucony przez KSeF nie jest fakturą: wystarczy wysłać poprawiony.

Czy wizualizacja faktury może być po angielsku?

Tak. Może być w innym języku albo dwujęzyczna, jeśli zgadza się z danymi w pliku XML.

Czy KSeF powiadomi mnie o nowej fakturze od dostawcy?

Nie. KSeF nie wysyła powiadomień, więc nowe faktury trzeba pobierać programem albo sprawdzać w Aplikacji Podatnika KSeF.

Dane z tej strony sprawdziliśmy 17 listopada 2026 r. w pytaniach i odpowiedziach o KSeF 2.0 oraz na stronach o fakturze ustrukturyzowanej i kodach QR na ksef.podatki.gov.pl.

Czytaj dalej

KSeF, czyli Krajowy System e-Faktur: kogo obowiązuje i od kiedyKSeF obowiązuje od 1 lutego 2026 r. przy sprzedaży powyżej 200 mln zł, od 1 kwietnia 2026 r. pozostałych. Co zmienia 1 stycznia 2027 r., tryby offline, kary i Odoo.KSeF nie działa: awaria, niedostępność i tryby offlineGdy KSeF nie działa: offline24 (następny dzień roboczy), niedostępność, tryb awaryjny (7 dni roboczych) i awaria całkowita. Terminy, kody QR i kary od 2027 r.Faktura ustrukturyzowana i struktura FA(3)Co to jest faktura ustrukturyzowana, od kiedy obowiązuje FA(3), z czego się składa, które pola są obowiązkowe, jak korygować faktury z FA(2) i jak sprawdzić plik.Kod 440 w KSeF: „Duplikat faktury”Kod 440 KSeF: faktura z tym samym NIP sprzedawcy, rodzajem i numerem już jest w systemie. Jak KSeF to liczy, co pokazuje Odoo 18, 19 i 20 i jak to rozwiązać.Kod 450 w KSeF: „Błąd weryfikacji semantyki dokumentu faktury”Kod 450 oznacza, że KSeF odrzucił fakturę FA(3) po sprawdzeniu treści. Gdzie jest prawdziwa przyczyna, czego nie pokazuje Odoo 18, 19 i 20 i jak wysłać fakturę ponownie.Wyjątki KSeF przy wysyłce faktury: 21405, 21180, 21184 i resztaWyjątki KSeF przy wysyłce faktury: 21405, 21001, 21155, 21166, 21167, 21173, 21180, 21184, 21402 i 21403. Co znaczą i jak je widać w Odoo 18, 19 i 20.
Sprawdzone w kodzie źródłowym modułu (wersja 17.0, 18.0, 19.0 i 20.0) i w podlinkowanych źródłach

Źródła