Ministerstwo Finansów opublikowało finalną wersję struktury FA(3) oraz dokumentację API KSeF 2.0

W związku z nadchodzącym obowiązkowym wdrożeniem Krajowego Systemu e-Faktur (KSeF) od 1 lutego 2026 r., Ministerstwo Finansów opublikowało finalne wersje kluczowych elementów technicznych systemu. Wśród nich znajdują się: docelowa struktura logiczna e-Faktury FA(3), kompletna dokumentacja API KSeF 2.0 oraz rozszerzone materiały pomocnicze dla integratorów i użytkowników systemu.
Ostateczna wersja struktury FA(3)
Zgodnie z zapowiedziami, Ministerstwo Finansów opublikowało ostateczną wersję struktury logicznej e-faktury FA(3). Od 1 lutego 2026 r. zastąpi ona dotychczasowy schemat FA(2).
Nowa struktura została opracowana w oparciu o wyniki konsultacji podatkowych oraz postulaty zgłaszane przez przedsiębiorców, księgowych, biegłych rewidentów oraz przedstawicieli sektora IT. Wprowadza ona szereg zmian, w tym nowe kody stawek VAT oraz możliwość dodawania załączników do faktur.
Wraz ze strukturą FA(3) udostępniono szczegółową dokumentację, broszurę informacyjną oraz przykładowe pliki faktur. Wszystkie dokumenty są dostępne w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych (ePUAP).
Kompletna dokumentacja API dla KSeF 2.0
Równolegle z nową strukturą udostępniono szczegółową dokumentację API KSeF 2.0, której celem jest wsparcie integratorów systemów fakturowania w przygotowaniach do wdrożenia nowego systemu w środowisku testowym.
Opublikowane materiały obejmują:
- Specyfikację API w formacie OpenAPI 3.0.4 – stanowiącą podstawowy kontrakt integracyjny, w pełni zgodny z narzędziami do testowania i generowania kodu;
- Interaktywną dokumentację online – zawierającą opisy endpointów, parametrów, schematów danych, kodów odpowiedzi i przykładów wywołań;
- Przewodnik dla integratorów po KSeF 2.0 – szczegółowe scenariusze użycia API, takie jak uwierzytelnianie, przesyłanie faktur w sesjach interaktywnych i wsadowych oraz pobieranie UPO, z przykładami w językach C# i Java;
- Omówienie kluczowych zmian w API KSeF 2.0 – wskazujące na główne usprawnienia względem poprzednich wersji;
- Biblioteki integracyjne w .NET i Java – gotowe komponenty umożliwiające implementację klienta KSeF 2.0 oraz aplikacje demonstracyjne.
Dokumentacja ta pozwala na wcześniejsze rozpoczęcie planowania architektury integracyjnej oraz budowę prototypów jeszcze przed udostępnieniem środowiska testowego.
Harmonogram wdrożenia KSeF 2.0
- 30 września 2025 r. – udostępnienie środowiska testowego API KSeF 2.0 dla integratorów i przedsiębiorców;
- Listopad 2025 r. – planowane uruchomienie testowej wersji Aplikacji Podatnika KSeF 2.0 z pełną funkcjonalnością API;
- 1 lutego 2026 r. – uruchomienie produkcyjnej wersji systemu oraz rozpoczęcie obowiązku wystawiania faktur ustrukturyzowanych zgodnie z FA(3).
Dodatkowe materiały o KSeF 2.0
Ministerstwo Finansów przygotowało również zbiór materiałów edukacyjnych i informacyjnych, które szerzej wyjaśniają m.in.:
- Podstawy prawne wdrożenia KSeF,
- Zakres obowiązkowego KSeF,
- Szczegóły dotyczące trybów pracy systemu (offline24, awaria częściowa i całkowita),
- Zasady stosowania kodów weryfikujących QR,
- Sposób uzyskiwania certyfikatów KSeF,
- Rolę numeru KSeF oraz identyfikatora zbiorczego.
Materiały te są dostępne na stronie internetowej Ministerstwa Finansów poświęconej KSeF.