Ministerstwo Finansów opublikowało szczegółową dokumentację techniczną KSeF 2.0 – firmy i dostawcy oprogramowania mogą rozpocząć przygotowania do integracji.
30 czerwca 2025 r. Ministerstwo Finansów ogłosiło publikację kompleksowej dokumentacji technicznej dotyczącej wdrożenia Krajowego Systemu e-Faktur (KSeF) 2.0 wraz z narzędziami wspierającymi integrację systemową. To przełomowy moment dla przedsiębiorców i dostawców oprogramowania, którzy od teraz mogą rozpocząć intensywne przygotowania do obowiązkowego wdrożenia KSeF, zaplanowanego na 1 lutego 2026 r.
Co zawiera opublikowana dokumentacja?
Opublikowane materiały obejmują:
-
Dokumentację techniczną API KSeF 2.0 opisaną w standardzie Open API, dostępną w formie interaktywnego portalu technicznego. Zawiera ona szczegółowe opisy metod, struktur danych, parametrów i przykładów, a także specyfikację w pliku JSON OpenAPI, umożliwiającą wykorzystanie w narzędziach automatyzujących integrację (np. generatory kodu, walidatory kontraktów API).
-
Biblioteki SDK w dwóch językach programowania (Java i .Net), które ułatwiają zespołom programistycznym szybkie rozpoczęcie prac integracyjnych.
-
Podręcznik dla programistów z instrukcjami i fragmentami kodu, ilustrującymi korzystanie z kluczowych endpointów systemu.
-
Przegląd kluczowych zmian między KSeF API 2.0 a wcześniejszą wersją 1.0, która funkcjonuje obecnie w trybie fakultatywnym.
-
Docelową wersję struktury logicznej e-Faktury FA(3), która będzie obowiązywać od lutego 2026 r.
Dostępność i wsparcie dla integratorów
Materiały są dostępne na oficjalnej stronie KSeF w sekcji wsparcia dla integratorów. W przypadku pytań dotyczących dokumentacji API KSeF 2.0, Ministerstwo Finansów udostępniło dedykowany formularz kontaktowy.
Harmonogram wdrożenia i środowisko testowe
-
Środowisko testowe: Firmy oraz dostawcy oprogramowania mogą już rozpocząć przygotowania w dedykowanym środowisku testowym.
-
Testowe API: Udostępnienie testowego API zaplanowano na 30 września 2025 r., a w listopadzie pojawi się testowa wersja Aplikacji Podatnika.
-
Obowiązkowe wdrożenie: KSeF 2.0 stanie się obligatoryjny od 1 lutego 2026 r.
Znaczenie dla rynku IT i podatników
Publikacja dokumentacji technicznej i narzędzi integracyjnych stanowi fundament do zrozumienia wymagań technicznych i funkcjonalnych nowego systemu. Umożliwia to zarówno dużym firmom, jak i mniejszym podmiotom oraz dostawcom oprogramowania rozpoczęcie niezbędnych prac dostosowawczych, które pozwolą na płynne przejście do nowego modelu wystawiania i odbierania faktur elektronicznych w Polsce.
„Współpraca z KSeF 2.0 jest możliwa dla różnych programów do fakturowania, niezależnie od ich producenta. Aby użytkownik mógł wystawiać, przesyłać bądź odbierać faktury, niezbędne jest wcześniejsze zintegrowanie oprogramowania z KSeF 2.0 za pośrednictwem interfejsu API.”
Ministerstwo Finansów podkreśla, że to dopiero początek wzmożonego okresu prac dla podatników oraz dostawców oprogramowania, którzy muszą odpowiednio przygotować się do nadchodzących zmian i obowiązkowej cyfryzacji fakturowania w Polsce
