Integracja z KSeF: jak przygotować ERP, sklep i fakturowanie

Integracja z KSeF to w praktyce kilka projektów naraz: każdy system, który wystawia faktury, musi wysyłać je do Krajowego Systemu e-Faktur i odbierać numer KSeF, a system księgowy musi pobierać z KSeF faktury zakupowe. Do tego dochodzą uprawnienia, obsługa trybów awaryjnych i testy. Jeśli dziś faktury powstają w ERP, w sklepie internetowym i w osobnym programie, to masz trzy miejsca do przygotowania, nie jedno. Poniżej opisuję terminy według ustawy w brzmieniu z listopada 2025 r. i kolejność prac, którą uważam za najbezpieczniejszą.

Terminy KSeF według obowiązującej ustawy

Obowiązek wystawiania faktur ustrukturyzowanych zaczyna się 1 lutego 2026 r., ale część firm ma okres przejściowy. Najważniejsze daty po nowelizacji z sierpnia 2025 r. wyglądają tak:

Data	Co się dzieje
od 1 listopada 2025 r.	podatnicy mogą pobierać certyfikaty KSeF, potrzebne m.in. do oznaczania faktur w trybie offline
od 1 lutego 2026 r.	obowiązek KSeF dla podatników, u których sprzedaż z podatkiem w 2024 r. przekroczyła 200 mln zł
od 1 kwietnia 2026 r.	obowiązek dla pozostałych podatników, którzy do 31 marca 2026 r. mogą wystawiać faktury dotychczasowe
do 31 grudnia 2026 r.	poza KSeF mogą zostać faktury podatników ze sprzedażą udokumentowaną fakturami do 10 000 zł brutto miesięcznie oraz faktury z kas rejestrujących
od 1 stycznia 2027 r.	zaczynają działać przepisy o karach za naruszenia obowiązków KSeF

Daty i progi w tabeli wynikają z ustawy z 5 sierpnia 2025 r. o zmianie ustawy o VAT (Dz.U. z 2025 r. poz. 1203), która ustaliła okresy przejściowe opisane w art. 145l, 145m i 145n ustawy o VAT oraz termin pobierania certyfikatów KSeF. Limit miesięczny przestaje obowiązywać od faktury, którą go przekroczono.

Jedna rzecz łatwo umyka: odbiór. Faktura ustrukturyzowana trafia do nabywcy przez KSeF, więc od 1 lutego 2026 r. część faktur kosztowych, od dostawców, którzy już będą w systemie, przyjdzie właśnie tą drogą. Nawet firma, która sama zaczyna wystawiać w kwietniu, powinna mieć gotowy odbiór na luty.

Mapa systemów: gdzie w firmie powstają faktury

Pierwszy krok to lista wszystkich miejsc, w których powstaje albo trafia faktura. W wielu firmach okazuje się, że jest ich więcej, niż wynika z deklaracji działu IT.

• ERP lub system handlowy: faktury sprzedaży, korekty, faktury zaliczkowe, przyjmowanie faktur zakupowych.
• Sklep internetowy: faktury do zamówień, często generowane przez moduł lub wtyczkę, osobno dla firm i dla konsumentów.
• Programy dziedzinowe: serwis, wynajem, abonamenty, systemy rezerwacyjne, które wystawiają faktury same.
• Kasy rejestrujące: faktury do paragonów, z okresem przejściowym do końca 2026 r.
• Biuro rachunkowe: jeśli księguje faktury zakupowe, potrzebuje do nich dostępu w KSeF.

Przy każdym systemie zapisz, kto go dostarcza, czy dostawca zapowiedział obsługę KSeF i w jakiej wersji, oraz kto po stronie firmy odpowiada za wdrożenie. Taka tabela w jednym arkuszu wystarczy, żeby zobaczyć, gdzie jest największe ryzyko.

KSeF integracja przez API: co musi umieć system

System połączony z KSeF musi wysłać fakturę w wymaganej strukturze, odebrać jej numer albo informację o odrzuceniu i zapisać to przy dokumencie. Samo wygenerowanie pliku nie wystarcza, bo faktura istnieje dla odbiorcy dopiero po nadaniu numeru KSeF.

Ministerstwo Finansów publikuje dokumentację interfejsu, strukturę faktury i informacje o środowiskach testowych na portalu KSeF. Przy KSeF 2.0 interfejs różni się od wcześniejszej wersji, więc integracja napisana dla starej wersji wymaga przeglądu. W specyfikacji dla wykonawcy lub dostawcy oprogramowania wymagam co najmniej tych funkcji:

1. mapowanie danych z systemu na pola struktury faktury, z walidacją przed wysyłką,
2. wysyłka z kolejką i automatycznym ponawianiem, gdy KSeF nie odpowiada,
3. zapis numeru KSeF i statusu przy każdej fakturze, widoczny dla księgowości,
4. czytelna obsługa odrzuceń: komunikat, kto ma poprawić, jak wysłać ponownie,
5. pobieranie faktur zakupowych i przekazanie ich do obiegu akceptacji,
6. wizualizacja faktury z kodem QR dla klientów spoza KSeF, na przykład konsumentów,
7. dziennik zdarzeń: co, kiedy i z jakim wynikiem zostało wysłane.

Sklep internetowy ma dodatkowy problem: faktury powstają w nim w momencie zamówienia lub wysyłki, często w nocy i w weekend. Jeśli sklep wystawia faktury, a ERP je księguje, trzeba ustalić, który system wysyła je do KSeF, żeby ta sama faktura nie trafiła tam dwa razy. To ta sama decyzja o źródle prawdy, którą opisałem przy temacie integracja ERP ze sklepem internetowym.

Uprawnienia i dostęp do KSeF

Dostęp, od którego zależy cała integracja z KSeF, trzeba zaplanować jak dostęp do konta bankowego firmy: konkretne osoby, konkretne zakresy i konkretne poświadczenia dla systemów. Wspólne konto, którego używa pół działu, to proszenie się o kłopoty przy pierwszej kontroli albo odejściu pracownika.

Do ustalenia przed startem:

• kto w firmie nadaje i odbiera uprawnienia w KSeF,
• które osoby wystawiają faktury, a które tylko je przeglądają,
• jakie uprawnienia dostaje biuro rachunkowe,
• jakimi poświadczeniami łączą się systemy (osobne dla ERP, osobne dla sklepu) i kto pilnuje ich ważności,
• gdzie są przechowywane certyfikaty i kto ma do nich dostęp.

Ostatni punkt to temat bezpieczeństwa, a nie księgowości. Certyfikat albo token integracyjny nie powinien leżeć w mailu ani w repozytorium kodu.

Tryb offline, niedostępność i awaria KSeF

Ustawa przewiduje sytuacje, w których faktura powstaje poza KSeF i trafia do niego później, a system firmy musi je obsłużyć bez ręcznego przepisywania. To element, który najczęściej wypada z pierwszych wycen.

W trybie offline podatnik może wystawić fakturę w postaci elektronicznej zgodnej ze wzorem i musi przesłać ją do KSeF najpóźniej w następnym dniu roboczym po dniu wystawienia (nowy art. 106nda ustawy o VAT). Przy niedostępności KSeF ogłoszonej przez Ministerstwo Finansów termin liczy się od zakończenia niedostępności. Dla awarii ogłoszonej komunikatem są osobne zasady. Faktury przekazane klientowi poza KSeF w takich trybach oznacza się kodami, w tym kodem z certyfikatu KSeF.

Dla systemu oznacza to konkretne wymagania: faktura musi mieć status oczekuje na wysyłkę, kolejka musi wysłać ją automatycznie po powrocie połączenia, a ktoś musi dostać alert, gdy termin się zbliża, a faktura wciąż nie ma numeru. Te reguły warto zapisać także w umowie SLA na utrzymanie systemu, bo awaria KSeF w piątek po południu to typowy moment, w którym potrzebna jest szybka reakcja.

Testy integracji z KSeF przed startem obowiązku

Integrację z KSeF trzeba sprawdzić na środowisku testowym na prawdziwych przypadkach z firmy, a nie na jednej przykładowej fakturze. Najwięcej błędów wychodzi przy dokumentach nietypowych.

Minimalny zestaw scenariuszy:

• faktura krajowa, zaliczkowa, końcowa i korekta,
• faktura dla konsumenta ze sklepu i jej wizualizacja z kodem QR,
• faktura w walucie obcej i z różnymi stawkami VAT,
• odrzucenie przez KSeF i ponowna wysyłka po poprawce,
• praca w trybie offline i dosłanie faktur po przywróceniu połączenia,
• pobranie faktury zakupowej i jej przejście przez obieg akceptacji.

Jeśli faktury kosztowe mają być potem rozpoznawane i dekretowane automatycznie, KSeF bardzo to ułatwia, bo dane przychodzą w strukturze, a nie jako skan. Więcej o tym, jak łączyć to z obiegiem dokumentów, piszę w tekście o automatyzacji obiegu dokumentów z AI.

Plan prac na najbliższe tygodnie

Przy terminie 1 lutego 2026 r. dla odbioru i 1 kwietnia 2026 r. dla wystawiania większości firm zostało niewiele czasu na projekt, testy i poprawki. Kolejność, którą proponuję:

1. Lista systemów, które wystawiają i odbierają faktury, z odpowiedzialnymi osobami.
2. Potwierdzenie od każdego dostawcy oprogramowania: wersja z obsługą KSeF 2.0 i data jej udostępnienia.
3. Decyzja, który system wysyła faktury do KSeF, gdy dokument przechodzi przez kilka systemów.
4. Plan uprawnień i poświadczeń, w tym certyfikaty KSeF.
5. Testy na środowisku testowym według listy scenariuszy.
6. Procedura na tryb offline i awarię: kto robi co, gdzie widać faktury bez numeru.
7. Szkolenie dla osób wystawiających faktury i dla księgowości.

Najwięcej ryzyka widzę tam, gdzie faktury powstają w systemach dedykowanych i w sklepach z własnymi modyfikacjami, bo tam nikt nie dostarczy gotowej aktualizacji. Jeśli to Twój przypadek i chcesz ocenić zakres prac, którego wymaga KSeF integracja w Twoich systemach, skontaktuj się ze mną bezpośrednio.