Krajowy System e-Faktur - komunikaty techniczne
W związku z przygotowaniami do uruchomienia KSeF 2.0 w środowisku produkcyjnym oraz wdrożeniem docelowej infrastruktury teleinformatycznej i mechanizmów bezpieczeństwa, resort finansów wprowadza nową, jednolitą adresację środowisk KSeF. Zmiana ma charakter techniczny - polega na aktualizacji wykorzystywanych adresów usług i nie wpływa na zakres oraz sposób działania udostępnianych interfejsów API. Wszystkie dotychczasowe adresy pozostaną aktywne w okresie przejściowym, aby umożliwić integratorom stopniowe przełączenie systemów na nową adresację.
Harmonogram zmian 15.12.2025 - udostępnienie nowych adresów (okres przejściowy)
Udostępnienie aktywnych adresów dla środowisk testowych oraz dla środowiska produkcyjnego. Dotychczasowe adresy środowisk testowych pozostają aktywne. Do 10 stycznia 2026 r. prosimy o przełączenie integracji na nowe adresy na środowiskach testowych.
10.01.2026 - przekierowania ze starych adresów
Po 10 stycznia 2026 r. dla środowisk testowych zostaną uruchomione automatyczne przekierowania ze starych adresów na nowe. Jeżeli klient HTTP lub wykorzystywana biblioteka integracyjna nie obsługuje przekierowań, konieczna będzie ręczna aktualizacja adresów bazowych po stronie integratora.
17.01.2026 - wyłączenie starych adresów
17 stycznia 2026 r. dotychczasowe adresy środowisk KSeF zostaną całkowicie wyłączone (bez dalszych przekierowań). Po tej dacie wywołania pod stare adresy nie będą realizowane.
01.02.2026 - środowisko produkcyjne wyłącznie w nowej adresacji
Środowisko produkcyjne będzie dostępne wyłącznie z wykorzystaniem nowych adresów.
Uwaga: Adres usługi MCU pozostaje bez zmian. Nowe adresy środowisk
Środowisko API Aplikacja do wizualizacji kodów QR Aplikacja Podatnika*
Środowisko testowe (TE) https://api-test.ksef.mf.gov.pl https://qr-test.ksef.mf.gov.pl https://ap-test.ksef.mf.gov.pl
Środowisko demonstracyjne / przedprodukcyjne (TR) https://api-demo.ksef.mf.gov.pl https://qr-demo.ksef.mf.gov.pl https://ap-demo.ksef.mf.gov.pl
Środowisko produkcyjne (PRD) https://api.ksef.mf.gov.pl https://qr.ksef.mf.gov.pl https://ap.ksef.mf.gov.pl
Zgodnie z zapowiedzią Ministerstwo Finansów udostępniło funkcjonalność umożliwiającą generowanie tokenów wcześniej niż zakładał przyjęty harmonogram prac nad KSeF. Od 8 grudnia można wygenerować tokeny niezbędne do uwierzytelniania w systemie KSeF 2.0, który zacznie obowiązywać od 1 lutego 2026 r. Przypominamy, żeby tokenów nie udostępniać osobom nieupoważnionym.
Ministerstwo Finansów udostępniło możliwość generowania tokenów w Module Certyfikatów i Uprawnień. Początkowo ta funkcjonalność miała być dostępna od 1 lutego 2026 r., ale wsłuchując się w głosy przedsiębiorców, resort przyspieszył prace nad tym elementem systemu i udostępnił go szybciej niż zakładano w harmonogramie prac. Możliwość generowania tokenów została udostępniona 8 grudnia br. Czym są tokeny Token jest narzędziem służącym do uwierzytelnienia i autoryzacji w KSeF. Są one generowane 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 jego generowania. 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. 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.
Więcej informacji nt. KSeF znajduje się na stronie ksef.podatki.gov.pl.
Informujemy o pracach serwisowych w API KSeF 1.0 oraz w MCU
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.