Nowość w Endora Commerce: wbudowany CRM z szansami sprzedażowymi Zobacz →
Endora Commerce

Integracja z KSeF

KSeF, Krajowy System e-Faktur, obowiązuje etapami od 1 lutego 2026 roku. Endora Commerce wysyła do niego faktury i korekty własnym, natywnym modułem, bez pośredniczącego systemu fakturowego.

Czym jest KSeF i kogo dotyczy

KSeF to system Ministerstwa Finansów, przez który przechodzą faktury ustrukturyzowane: zamiast PDF-a wysłanego mailem sprzedawca przekazuje plik XML w strukturze FA(3). System weryfikuje plik, nadaje mu numer KSeF i udostępnia fakturę nabywcy. Obowiązek wchodzi etapami:

Od kiedyKogo dotyczy
1 lutego 2026 r.firmy, których sprzedaż z podatkiem w 2024 r. przekroczyła 200 mln zł
1 kwietnia 2026 r.pozostali przedsiębiorcy
1 stycznia 2027 r.najmniejsi, czyli sprzedaż na fakturach do 10 tys. zł brutto miesięcznie

Faktury dla konsumentów można wystawiać w KSeF dobrowolnie. Dla dystrybutora czy producenta sprzedającego firmom oznacza to w praktyce, że przez KSeF przechodzi niemal każdy dokument sprzedaży. Aktualne zasady i terminy publikuje serwis KSeF Ministerstwa Finansów.

Droga faktury: z zamówienia do KSeF i z powrotem

  1. Wystawienie. Faktura powstaje w platformie: ręcznie z poziomu zamówienia albo automatycznie po jego potwierdzeniu, z numerem według wzorca ustawionego dla kanału sprzedaży.
  2. Wysyłka. Moduł KSeF generuje dokument w formacie FA(3) i odkłada wysyłkę do trwałej kolejki opartej na Redisie, tej samej, która obsługuje webhooki i pocztę transakcyjną. Gdy KSeF chwilowo nie odpowiada, zadanie ponawia próby z rosnącym opóźnieniem, a zamówienia przetwarzają się dalej. Przy dłuższej awarii faktury czekają w kolejce oznaczone jako wystawione w trybie offline i po jej zakończeniu wysyłają się same, bez duplikatów. Faktury proforma nigdy nie trafiają do KSeF, bo nie są fakturami VAT.
  3. Numer KSeF. Po przyjęciu dokumentu numer KSeF i czas przetworzenia zapisują się na fakturze. Widać je na karcie faktury w panelu, a system finansowy może je odczytać przez API.
  4. UPO. Urzędowe Poświadczenie Odbioru jest do pobrania po wystawieniu.
  5. PDF. Na wydruku pojawia się numer KSeF i kod QR do weryfikacji. KSeF jest jedną z sekcji w edytorze szablonów faktur, więc o jej miejscu na dokumencie decydujesz sam.

Korekty idą tą samą drogą i wskazują numer KSeF faktury pierwotnej. To istotne, bo faktury przyjętej przez KSeF nie da się edytować ani usunąć: błąd poprawia się wyłącznie fakturą korygującą.

Konfiguracja i monitoring w panelu

Moduł KSeF ma w panelu administracyjnym własną sekcję. Ustawiasz w niej:

  • Środowisko: testowe (domyślne, bez skutków prawnych), przedprodukcyjne (demo) albo produkcyjne. Test połączenia sprawdza zapisane poświadczenie w wybranym środowisku i opisuje wynik zwykłym językiem, na przykład wygasły certyfikat albo niewłaściwe środowisko.
  • Poświadczenia: wgrywasz certyfikat uwierzytelniający KSeF z kluczem prywatnym, opcjonalnie także certyfikat do trybu offline, albo generujesz je kreatorem, który tworzy parę kluczy i wniosek CSR i rejestruje go w KSeF. Token KSeF jest akceptowany jako rozwiązanie przejściowe.
  • Ważność certyfikatów: panel pokazuje okres ważności i ostrzega o zbliżającym się wygaśnięciu, zanim wysyłki zaczną się nie udawać. Klucze prywatne i tokeny są przechowywane w postaci zaszyfrowanej i żadne API ich nie zwraca.

Zakładka wysyłek pokazuje liczbę dokumentów w każdym statusie i listę z filtrami. Przy każdej wysyłce widać liczbę prób i pełną historię błędów. Przyjęte dokumenty mają przycisk pobrania UPO, a odrzucone opis przyczyny i przycisk ponowienia. Poprzednia próba zostaje wtedy w historii.

Ograniczenie: stawki VAT

Struktura FA(3) w module obsługuje stawki VAT 23%, 8%, 5% i 0%. Dokument z pozycją w innej stawce jest odrzucany jeszcze przed wysyłką, a komunikat wskazuje fakturę i stawkę, żeby można ją było poprawić u źródła. Jeśli sprzedajesz towary w innych stawkach, omów to przed wdrożeniem.

Po co kod QR na PDF-ie

Polski nabywca z NIP-em odbiera fakturę w KSeF. Są jednak odbiorcy, którym przekazuje się ją poza systemem, w uzgodniony sposób: kontrahenci zagraniczni, podmioty bez NIP-u i konsumenci. Taki dokument musi mieć kod QR z numerem KSeF, który prowadzi do faktury w systemie i pozwala sprawdzić jej dane. PDF pobierany z konta klienta w sklepie albo wysyłany mailem ma ten kod, więc kopię papierową również da się zweryfikować w KSeF.

Natywnie czy przez program księgowy

O tym, kto wysyła faktury do KSeF, decyduje jedno ustawienie w panelu: „Księga faktur”, zakładka „Trasowanie”. Obowiązuje dla całej instancji i można je nadpisać dla wybranego kanału sprzedaży.

  • Natywny moduł KSeF: platforma sama wysyła dokument. Jest to moduł płatny, poza otwartym rdzeniem platformy; we wdrożeniach prowadzonych przez Endorę jego koszt jest wliczony w cenę wdrożenia. To wygodne, gdy faktury powstają w platformie, a ERP dostaje je później, albo gdy sprzedaż idzie kilkoma kanałami naraz.
  • Wysyłka u dostawcy: kopia faktury trafia do programu księgowego, czyli wFirma, inFakt albo Subiekt 123, i to on przesyła ją do KSeF. Natywny moduł wtedy tej faktury nie wysyła, więc dokument nie trafia do systemu dwa razy.

W obu wariantach numer KSeF jest zapisywany na tej samej fakturze w platformie. Trzeci układ to ERP jako jedyne miejsce wystawiania dokumentów sprzedaży, na przykład Comarch ERP Optima z własną obsługą KSeF. Wtedy platforma nie musi wysyłać niczego. Żadne z tych podejść nie jest z zasady lepsze: wybór zależy od tego, gdzie w firmie powstaje faktura.

Co przygotować po stronie KSeF

Te wymagania wynikają z samego KSeF, niezależnie od systemu, który wystawia faktury:

  • Uprawnienia. System wysyłający faktury w imieniu firmy musi się uwierzytelnić. API KSeF 2.0 dopuszcza token KSeF, certyfikat KSeF oraz kwalifikowany podpis lub pieczęć. Token ma zestaw uprawnień nadany przy generowaniu, na przykład do wystawiania faktur. Zmiana zakresu wymaga nowego tokenu, a istniejący można unieważnić.
  • Środowiska. Ministerstwo udostępnia trzy: testowe, przedprodukcyjne (demo) i produkcyjne. Są rozdzielone, a poświadczenia z jednego nie działają w drugim. Na środowiska testowe nie wolno wysyłać prawdziwych faktur ani danych firmy.

Szczegóły techniczne opisuje oficjalna dokumentacja API KSeF 2.0.

KSeF trafił do platformy w jednej z aktualizacji, razem z integracjami z Comarch ERP Optima i Subiektem GT.

Sprawdźmy, co da się podłączyć u Ciebie

Umów bezpłatną konsultację. Przejdziemy przez Twój ERP, magazyn i procesy sprzedaży, i pokażemy, jak wygląda ścieżka integracji krok po kroku.

Michał Zabielski, założyciel i CEO Endory

Michał Zabielski

Założyciel i CEO Endory

Odpowiadamy w ciągu jednego dnia roboczego.