Ministerstwo Finansów - Krajowa Administracja Skarbowa

• 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.

Lista zmian w API od dnia 22 grudnia 2025 r.:

API 2.0.0

• Od tego dnia API zacznie zwracać wyłącznie UPO v4-3 – zmiana została zapowiedziana 2 grudnia 2025 r.
• Od tego dnia `subjectDetails` zacznie być wymagany – zmiana została zapowiedziana 2 grudnia 2025 r.
• Pobieranie metadanych – skrócenie okresu zapytań z 2 lat do 3 miesięcy.
• Eksport faktury – skrócenie okresu zapytań z 2 lat do 3 miesięcy.