KSeF 2.0 — co zmienia się dla integratorów w 2026 roku
KSeF 2.0 to największa zmiana w Krajowym Systemie e-Faktur od jego uruchomienia. Dla firm oznacza nowe obowiązki, a dla zespołów utrzymujących integracje — konkretną listę rzeczy do przebudowania. Poniżej podsumowujemy zmiany, które w naszej ocenie mają największy wpływ na architekturę integracji.
Nowe API i wersjonowanie schematu FA
Wersja 2.0 przynosi przebudowane API: inne uwierzytelnianie sesji, nowe limity i zmienioną strukturę odpowiedzi o statusie dokumentu. Jeśli Twoja integracja odpytywała stare endpointy bez warstwy pośredniczącej, czeka Cię migracja — i to z twardym terminem wyłączenia starych wersji.
Schemat FA również dostał nową wersję. W praktyce oznacza to okres przejściowy, w którym system musi poprawnie obsłużyć dwa schematy jednocześnie: dokumenty wystawione przed zmianą i po niej. W KSeF Integratorze rozwiązujemy to negocjacją wersji per dokument, bez zmian po stronie klienta.
Tryb offline24 i załączniki
Nowością jest tryb offline24, który pozwala wystawiać faktury przy planowanej niedostępności platformy i dosyłać je w ciągu doby. Brzmi prosto, ale wymaga przemyślanej kolejki: dokument musi dostać numer w systemie klienta natychmiast, a numer KSeF i UPO — później, bez blokowania sprzedaży.
Załączniki do faktur (np. specyfikacje dostaw) to z kolei zmiana, która dotyka rozmiarów żądań, limitów API i… wizualizacji. Czytelne renderowanie dokumentu z załącznikami opisaliśmy przy okazji prac nad KSeF Visualizatorem.
Co warto zrobić teraz
- Zinwentaryzuj, które elementy integracji odwołują się bezpośrednio do API KSeF.
- Sprawdź obsługę podwójnego schematu FA w okresie przejściowym.
- Przetestuj scenariusze offline na środowisku testowym MF — zanim zrobi to za Ciebie awaria.
Jeśli wolisz, żeby tym wszystkim zajął się zespół, który robi to na co dzień — porozmawiajmy. A jeśli dopiero planujesz wdrożenie, zacznij od tekstu o przygotowaniu ERP na obowiązkowy KSeF.
