MF udostępniło narzędzia do integracji systemów IT z KSeF 2.0

Ministerstwo Finansów opublikowało dokumentację techniczną dotyczącą wdrożenia Krajowego Systemu e-Faktur (KSeF), wraz z narzędziami wspierającymi integrację systemową. To istotny krok w kierunku obowiązkowego stosowania systemu od 1 lutego 2026 r. - już teraz firmy i dostawcy oprogramowania mogą rozpocząć przygotowania w środowisku testowym. Udostępnienie testowego API zaplanowano na 30 września 2025 r., a w listopadzie pojawi się wersja testowa Aplikacji Podatnika.

Dokumentacja API KSeF 2.0

API (ang. Application Programming Interface) to zbiór szczegółowych zasad oraz specyfikacji technicznych, które określają sposób, w jaki Krajowy System e-Faktur (KSeF) wymienia dane i współdziała z zewnętrznymi systemami finansowo-księgowymi. 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.

Opublikowana dokumentacja API zawiera:

• dokumentację techniczną API opisaną w standardzie Open API, w formie interaktywnego portalu technicznego, który zawiera:
• opisy metod,
• struktury danych,
• parametry i przykłady,
• specyfikację (plik JSON OpenAPI), przeznaczoną do wykorzystania w narzędziach automatyzujących integrację (np. generatory kodu, walidatory kontraktów API).

Dodatkowo, w celu ułatwienia prac zespołom programistycznym resort finansów opublikował również:

• biblioteki SDK stanowiące zbiór narzędzi i przykładów w dwóch językach programowania - Java i .Net,
• podręcznik zawierający instrukcje wraz z fragmentami kodu, które ilustrują sposób korzystania z kluczowych endpointów systemu,
• przegląd kluczowych zmian między KSeF API 2.0. a KSeF API 1.0 (system fakultatywny działający obecnie).

30 września 2025 r. zostanie udostępnione środowisko testowe API KSeF 2.0, które umożliwi dostawcom oprogramowania oraz przedsiębiorstwom przeprowadzenie testów. Na listopad 2025 r. MF planuje uruchomienie testowej wersji przeglądarkowej Aplikacji Podatnika KSeF, która pozwoli użytkownikom testować najważniejsze funkcjonalności systemu KSeF.

Pełna dokumentacja API znajduje się na: ksef.podatki.gov.pl »

Struktura logiczna e-Faktury FA (3)

Od 1 lutego 2026 r. KSeF 2.0 zostanie udostępniony w wersji obowiązkowej dla wszystkich użytkowników. Tego samego dnia struktura logiczna FA(3) zastąpi obecnie obowiązującą strukturę logiczną FA(2). Oznacza to, że do wszystkich faktur ustrukturyzowanych wystawianych od 1 lutego 2026 r. w KSeF będziemy stosowali nową strukturę. Do tego czasu stosujemy strukturę FA(2). Jak poinformowało Ministerstwo Finansów, strukturę logiczną e-faktury w wersji FA(3) będziemy wykorzystywać od 1 lutego 2026 r. także do wystawienia:

• faktur korygujących, w sytuacji gdy faktura pierwotna, której dotyczy faktura korygująca, została wystawiona przed 1 lutego 2026 r. przy użyciu struktury FA(2) lub FA(1),
• faktur rozliczających, w przypadku gdy faktura zaliczkowa została wystawiona przed 1 lutego 2026 r. przy użyciu struktury FA(2) lub FA(1).

Struktura logiczna logiczną FA(3) została opublikowana w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na ePUAP »

Komunikat MF "Publikacja dokumentacji API KSeF 2.0 oraz struktury logicznej FA(3)" - opubl. 30 czerwca 2025 r.