Komunikaty KSeF

29 kwietnia 2026 r. w godzinach 18:00-18:30 na środowisku TEST zostanie przeprowadzona symulacja polegająca na czasowym braku przetwarzania zleceń eksportu faktur po stronie API KSeF 2.0. Zakres symulacji:

API pozostanie dostępne, możliwe będzie przesyłanie zleceń eksportu przez POST /invoices/exports, przyjęte zlecenia nie będą w tym czasie przetwarzane.

Efektem będzie:

brak przetwarzania zleceń eksportów paczki, po osiągnięciu limitu równoczesnych eksportów w kontekście api zacznie zwracać 400 Bad Request 21182: „Osiągnięto limit trwających eksportów. Dla uwierzytelnionego podmiotu w bieżącym kontekście osiągnięto maksymalny limit {count} równoczesnych eksportów faktur. Spróbuj ponownie później.” *

Po zakończeniu symulacji przetwarzanie eksportów zostanie wznowione, a wszystkie wcześniej przyjęte zlecenia zostaną obsłużone.

• Endpoint POST /invoices/exports inicjuje asynchroniczny eksport faktur, a w zalogowanym kontekście może działać maksymalnie 10 równoczesnych eksportów.

Przedstawiamy propozycję modelu zdarzeń biznesowych i synchronizacji zmian dla e-faktur (link do dokumentacji API KSeF https://github.com/CIRFMF/ksef-docs/issues/794), stanowiącą kolejny krok w rozwoju API KSeF 2.0. Dążymy do uzyskania uzasadnionych i konstruktywnych uwag oraz opinii dotyczących dalszego rozwoju API KSeF 2.0. Na tym etapie celem jest zebranie opinii od rynku. Po analizie zgłoszonych uwag zostanie zaproponowany ostateczny kierunek dalszych prac oraz zakres implementacji. Propozycja obejmuje dwa odrębne zagadnienia.

Zagadnienie techniczne

Celem jest wypracowanie docelowego mechanizmu wymiany informacji o zmianach, tj. sposobu synchronizacji dokumentów oraz powiązanych z nimi zdarzeń biznesowych. Przykłady zdarzeń użyte w opisie służą przede wszystkim zobrazowaniu samego zjawiska i potrzeb integracyjnych.

Katalog zdarzeń biznesowych

Drugi obszar dotyczy samego katalogu możliwych zdarzeń biznesowych. Jest to temat szerszy, wielowątkowy i wymagający osobnej dyskusji z uwzględnieniem różnych perspektyw biznesowych. Z tego względu warto, aby bardziej szczegółowe rozmowy dotyczące poszczególnych typów zdarzeń były prowadzone w odrębnych wątkach, tak aby nie zdominowały dyskusji o głównym celu tej propozycji, którym jest kierunek architektury i integracji. Opinię wraz z uzasadnieniem można przesłać do 8 maja 2026 r. na adres: konsultacje.ksef@mf.gov.pl.

W dniu 22.04.2026 r. (środa) w godzinach 18.00–18.30 zostanie przeprowadzona symulacja braku przetwarzania faktur po stronie API KSeF (środowisko TEST).W trakcie symulacji:

API będzie dostępne, możliwe będzie przesyłanie faktur oraz paczek faktur (sesja interaktywna i wsadowa), przyjęte dokumenty nie będą przetwarzane.

Efektem będzie:

brak nadawania numerów KSeF, brak generowania UPO dla faktur, brak generowania UPO dla paczek.

Po zakończeniu symulacji przetwarzanie zostanie wznowione, a wszystkie wcześniej przyjęte faktury i paczki faktur zostaną obsłużone.

19 kwietnia 2026 r. od godz. 00.00 do godz. 02.00 oraz 26 kwietnia 2026 r. od godz. 00.00 do godz. 02.00

planowane są przez Centralny Ośrodek Informatyki (COI) prace serwisowe, które mogą spowodować niedostępność usług w zakresie profilu zaufanego i węzła krajowego (login.gov.pl). W tym czasie mogą wystąpić utrudnienia w dostępie do Aplikacji Podatnika KSeF i Aplikacji Mobilnej KSeF. Przepraszamy za utrudnienia.

10 kwietnia 2026 r. od godz. 19.00 do 11 kwietnia 2026 r. do godz. 01.00 oraz 11 kwietnia 2026 r. od godz. 20.00 do 12 kwietnia 2026 r. do godz. 01.00 oraz 12 kwietnia 2026 r. od godz. 16.00 do godz. 24.00

planowane są przez Centralny Ośrodek Informatyki (COI) prace serwisowe, które mogą spowodować niedostępność usług w zakresie profilu zaufanego i węzła krajowego (login.gov.pl). W tym czasie mogą wystąpić chwilowe utrudnienia w dostępie do Aplikacji Podatnika KSeF i Aplikacji Mobilnej KSeF. Przepraszamy za utrudnienia.

Z uwagi na szczególne  potrzeby, integratorzy mogą składać wnioski o zmianę limitów żądań API KSeF 2.0. Zmodyfikowane, indywidualne limity żądań API KSeF 2.0 obejmą środowisko przedprodukcyjne (Demo) oraz środowisko produkcyjne. 

W czerwcu 2025 r. opublikowaliśmy pełną dokumentację API KSeF 2.0, umożliwiającą dostawcom systemów finansowo-księgowych rozpoczęcie prac integracyjnych z KSeF 2.0 w środowisku testowym. Dostosowanie limitów API KSeF 2.0 do indywidualnych potrzeb Ze względu na skalę działania i publiczny charakter systemu KSeF, w API KSeF 2.0 wprowadziliśmy limity – mechanizmy ograniczające liczbę żądań API dla poszczególnych integracji. Celem limitów jest:

ochrona stabilności systemu, ochrona przed cyberzagrożeniami, gwarancja stabilnych warunków dostępu dla wszystkich użytkowników.

Limity określają maksymalną liczbę zapytań, które można wykonać w określonym czasie i wspierają sposób integracji, zgodny z założeniami architektury systemu. Domyślne limity żądań API zostały określone na podstawie przewidywanych scenariuszy wykorzystania systemu i modeli obciążenia systemu. Z uwagi na zróżnicowane potrzeby poszczególnych integracji, limity mogą być w uzasadnionych przypadkach dostosowane do indywidualnych potrzeb integratorów. Jak zawnioskować o dostosowanie limitów API KSeF 2.0 do indywidualnych potrzeb Zwiększenie limitów na środowisku przedprodukcyjnym (Demo) oraz produkcyjnym jest możliwe na podstawie wniosku uzasadnionego rzeczywistą potrzebą operacyjną. Wniosek należy złożyć za pośrednictwem formularza kontaktowego, dołączając załącznik zawierający szczegółowy opis potrzeb wymagających większej intensywności operacji. Formularz zgłoszenia należy wypełnić zgodnie z parametrami:

Pełniona rola – Integrator. Rodzaj zgłoszenia – Techniczne. Typ zgłoszenia - Prośba o informację. Aplikacja, której dotyczy zgłoszenie – API KSeF. Środowisko, którego dotyczy zgłoszenie – Produkcyjne KSeF 2.0 / Przedprodukcyjne (Demo) KSeF 2.0. Podkategoria zgłoszenia - Indywidualne limity żądań API .

Indywidualne limity przyznane poszczególnym integratorom zostaną zmienione jednocześnie na środowisku przedprodukcyjnym (Demo) i środowisku produkcyjnym. Limity Pełna informacja o domyślnych limitach API KSeF 2.0 znajduje się w dokumentacji -  Limity żądań API. Wykaz limitów API możliwych do zmiany znajduje się w załączniku do wniosku. Metoda sprawdzenia obowiązujących limitów API Systemu KSeF 2.0 udostępnia usługi pozwalające na sprawdzenie aktualnych wartości limitów dla bieżącego kontekstu lub podmiotu na danym środowisku. W przypadku pytań w zakresie limitów prosimy o kontakt za pośrednictwem formularza zgłoszeniowego.

28 stycznia 2026 o g. 8:00 udostępnimy API KSeF 2.0 na środowisku produkcyjnym. Pozwoli to na weryfikację działania komercyjnych narzędzi do obiegu faktur przed uruchomieniem docelowej wersji Krajowego Systemu e-Faktur.

Od 26 do 31 stycznia trwa zaplanowana przerwa techniczna środowiska produkcyjnego KSeF. Przerwa została ujęta w harmonogramie wdrażania KSeF 2.0, Jest ona konieczna, aby dokończyć proces wdrażania docelowej wersji systemu. Wychodząc naprzeciw oczekiwaniom przedsiębiorców od środy 28 stycznia od g. 8:00 rano udostępnimy API KSeF 2.0, które umożliwi przeprowadzenie weryfikacji działania systemów komercyjnych na środowisku produkcyjnym KSeF 2.0 w zakresie:

uwierzytelniania użytkowników, uprawnień (wyszukiwanie i przeglądanie), składania wniosków o certyfikaty i odbierania tych certyfikatów, generowania tokenów.

API 2.0 można pobrać z platformy github : GitHub · Change is constant. GitHub keeps you ahead. · GitHub Dodatkowo, w trakcie przerwy technicznej, w dalszym ciągu można składać składania zawiadomienia o nadaniu lub odebraniu uprawnień do korzystania z KSeF za pomocą formularza ZAW-FA przesyłanych do właściwego Urzędu Skarbowego. Przypominamy! W czasie przerwy technicznej 26-31 stycznia 2026 r. niedostępne będą komponenty:

środowisko KSeF 1.0 usługi wykorzystujące integrację z KSeF 1.0 (w systemach komercyjnych i aplikacji e-Mikrofirma) Moduł Certyfikatów i Uprawnień do pobierania certyfikatów generowanie certyfikatów do logowania w KSeF.

Pobieranie certyfikatów zostanie przywrócone 1 lutego 2026 r. Od tego momentu będzie je można pobierać wyłącznie bezpośrednio z KSeF 2.0 poprzez API 2.0 lub Aplikacje Podatnika 2.0. Od 1 lutego KSeF 2.0 staje się jedyną wersją Krajowego Systemu e-Faktur. Jednocześnie wygasa działanie KSeF 1.0 oraz Moduł Certyfikatów i Uprawnień. W razie pytań zachęcamy do kontaktu z infolinią. Więcej informacji: podatki.gov.pl - Telefon do konsultanta Krajowej Administracji Skarbowej

Przypominamy o wcześniej planowanej przerwie technicznej funkcjonującego obecnie KSeF 1.0, w tym Modułu Certyfikatów i Uprawnień (MCU) w dniach 26-31 stycznia 2026 r., która pozwoli na dokończenie procesu wdrażania nowej wersji systemu KSeF 2.0.

W dniach 26-31 stycznia KSeF 1.0, w tym Moduł Certyfikatów i Uprawnień (MCU), będzie niedostępny z powodu wcześniej zaplanowanych prac technicznych. Przerwa techniczna jest konieczna, aby dokończyć proces wdrażania docelowej wersji systemu -KSeF 2.0. W czasie przerwy technicznej będzie dostępna możliwość wnioskowania o uprawnienia podstawowe (za pomocą ZAW-FA). Od 28 stycznia 2026 będzie możliwa również weryfikacja usług KSeF 2.0 na środowisku produkcyjnym. 1 lutego 2026 r. nastąpi udostępnienie KSeF 2.0, który będzie jedynym dostępnym i obligatoryjnym systemem. W tym dniu przestaje funkcjonować KSeF 1.0, w tym Moduł Certyfikatów i Uprawnień (MCU). Nadawanie nowych uprawnień i składanie wniosków o certyfikaty będzie możliwe ponownie w nowym systemie KSeF 2.0 od 1 lutego 2026 r.

Zgodnie z zapowiedzią, w dniach 26-31 stycznia 2026 r. planowana jest przerwa techniczna systemu KSeF 1.0. W tym czasie będzie niedostępny system KSeF 1.0, w tym jego komponenty:

Aplikacja Podatnika 1.0 Aplikacja Mobilna 1.0 Moduł Certyfikatów i Uprawnień (MCU)

oraz usługi wykorzystujące integrację z KSeF 1.0 w:

systemach komercyjnych aplikacji e-Mikrofirma.

Zgodnie z przyjętym przez Ministerstwo Finansów harmonogramem, 1 lutego zostanie udostępniona docelowa wersja systemu - KSeF 2.0. Będzie ona jedynym dostępnym i obowiązującym systemem.  Od 1 lutego 2026 r. przestaje funkcjonować KSeF 1.0, w tym Moduł Certyfikatów i Uprawnień (MCU).

8 stycznia 2026 r. będą prowadzone prace serwisowe:

na środowisku integracyjnym API Krajowego Systemu e-Faktur 2.0 od godziny 14.00 do 17.00, na środowisku przedprodukcyjnym (Demo) API Krajowego Systemu e-Faktur 2.0 od godziny 17.00 do 20.00.

W tym czasie mogą wystąpić chwilowe utrudnienia w dostępie do tych środowisk oraz do Aplikacji Podatnika KSeF. Przetwarzanie oraz odczyt dokumentów zostanie wstrzymane. Prosimy o nieprzesyłanie ponownie tych samych dokumentów i oczekiwanie na dalsze statusy przetwarzania. Po zakończonych pracach złożone dokumenty zostaną przeprocesowane oraz zostanie wznowiony odczyt. Przepraszamy za utrudnienia.

22 grudnia 2025 r. resort finansów planuje zamrożenie kontraktu API KSeF 2.0. Kontrakt API KSeF 2.0 od długiego czasu wykazuje stabilność działania, osiągając oczekiwaną dojrzałość funkcjonalną. Od tej pory API KSeF 2.0 będzie nadal utrzymywane i rozwijane w zakresie optymalizacji funkcjonalności oraz usuwania niejednoznaczności, o ile zmiany te nie wpłyną na obowiązujący kontrakt API i nie będą wymagać zasadniczych modyfikacji po stronie integratorów.

W ostatnich miesiącach API KSeF 2.0 było rozwijane w ścisłej współpracy z integratorami i dostawcami oprogramowania, w oparciu o realne scenariusze i przypadki użycia systemu spodziewane w warunkach produkcyjnych. Dzięki uporządkowaniu i doprecyzowaniu kontraktu możliwe było podniesienie jakości udostępnianych usług i zapewnienie zgodności z obowiązującymi regulacjami. Oznacza to, że takie elementy jak: lista endpointów, formaty żądań i odpowiedzi, znaczenie pól, kody odpowiedzi, czy reguły walidacji pozostają niezmienne. Od momentu udostępnienia zamrożonej wersji nazewnictwo wersji API KSeF 2.0 będzie funkcjonować bez oznaczenia RC (Release Candidate). Zmiana nazewnictwa ma charakter porządkowy i nie wpływa na sposób działania API. Każda aktualizacja w API mogąca potencjalnie wpłynąć na funkcjonowanie istniejących integracji będzie w dalszym ciągu komunikowana z odpowiednim wyprzedzeniem oraz publikowana poprzez oficjalny changelog API.

8 grudnia 2025 r. w godzinach od 16.00 do 19.00 planowane są prace serwisowe na środowisku produkcyjnym API KSeF 1.0 oraz na wersji produkcyjnej Modułu Certyfikatów i Uprawnień. W tym czasie nie będą dostępne:

środowisko produkcyjne API KSeF 1.0, Aplikacja Podatnika KSeF 1.0 oraz Moduł Certyfikatów i Uprawnień dla KSeF 2.0.

  Przepraszamy za utrudnienia.

8 grudnia 2025 r. w godzinach od 16.00 do 19.00 planowane są prace serwisowe na środowisku produkcyjnym API KSeF 1.0 oraz na wersji produkcyjnej Modułu Certyfikatów i Uprawnień. W tym czasie nie będą dostępne:

środowisko produkcyjne API KSeF 1.0, Aplikacja Podatnika KSeF 1.0 oraz Moduł Certyfikatów i Uprawnień dla KSeF 2.0.

Przepraszamy za utrudnienia.

Wychodząc naprzeciw oczekiwaniom przedsiębiorców Ministerstwo Finansów wkrótce udostępni nową funkcjonalność umożliwiającą generowanie tokenów. Dzięki temu jeszcze w tym roku będzie można wygenerować tokeny niezbędne do uwierzytelniania w systemie KSeF 2.0. Przypominamy, żeby nie udostępniać tokenów osobom nieupoważnionym.

Czym są tokeny Token jest narzędziem służącym do uwierzytelnienia i autoryzacji w KSeF. Jest on generowany przez podatnika na określony zakres uprawnień po uwierzytelnieniu w systemie (Podpisem Zaufanym, podpisem kwalifikowanym lub pieczęcią kwalifikowaną). Token zawiera w sobie uprawnienia podatnika, które są deklarowane w momencie generowania tokena. Dzięki tokenom można szybko i w prosty sposób logować się do KSeF. Zamiast każdorazowego uwierzytelniania się w systemie np. podpisem kwalifikowanym, będzie można wygenerować token i wykorzystywać go do uwierzytelniania się w aplikacjach komercyjnych zintegrowanych z KSeF. Generowanie tokenów w Module Certyfikatów i Uprawnień zostanie udostępnione do 10 grudnia 2025 r. Tokeny KSeF 1.0 Od 1 listopada 2025 r. nadawanie nowych uprawnień jest możliwe wyłącznie poprzez MCU. Oznacza to, że nadawanie nowych uprawnień nie jest już dostępne w ramach dotychczasowej Aplikacji Podatnika KSeF 1.0. Do końca stycznia 2026 r. wciąż istnieje możliwość generowania tokenów dla KSeF 1.0. Jest ona dostępna w Aplikacji Podatnika KSeF 1.0 lub przy użyciu komercyjnych programów księgowych zintegrowanych z API KSeF 1.0. Posługiwanie się nimi w MCU, a potem w docelowym KSeF 2.0 nie będzie jednak możliwe. Dlatego należy pamiętać, że tokeny wygenerowane w KSeF 1.0:

nie będą możliwe do użycia w KSeF 2.0; nie będą udostępnione w MCU i migrowane do KSeF 2.0.

UWAŻAJ! Oszuści mogą spróbować wyłudzić poufne dane i narazić cię na poważne konsekwencje finansowe i prawne. Dlatego:

traktuj tokeny jak dane szczególnie wrażliwe, nie udostępniaj ich osobom nieupoważnionym, zachowaj szczególną czujność wobec prób wyłudzenia dostępu do tokenów.

Ministerstwo Finansów apeluje, żeby tokeny i dane do logowania do MCU traktować z taką samą uwagą jak dane logowania do bankowości elektronicznej czy karty płatnicze. Nie przekazuj ich osobom nieuprawnionym.