Ministerstwo Finansów udostępniło pełną dokumentację techniczną dotyczącą implementacji Krajowego Systemu e-Faktur w wersji 2.0, obejmującą zarówno interfejs API, jak i nową strukturę logiczną faktury FA(3). Publikacja ta stanowi istotny krok w kierunku obowiązkowego wdrożenia KSeF od 1 lutego 2026 roku i otwiera drogę dla przedsiębiorców oraz dostawców oprogramowania do rozpoczęcia przygotowań w środowisku testowym. Zaktualizowane materiały dostępne są na oficjalnej stronie Ministerstwa Finansów, gdzie znaleźć można m.in. dokumentację API, narzędzia wspierające integrację oraz odnośniki do Centralnego Repozytorium Wzorów Dokumentów Elektronicznych.
Publikacja dokumentacji API KSeF 2.0
Na wstępie wskazania wymaga, że KSeF będzie obowiązkowy od 1 lutego 2026 roku dla podmiotów dużych (tj. które w roku 2024 przekroczyły 200 mln złotych obrotów), natomiast od 1 kwietnia 2026 roku – dla wszystkich pozostałych podmiotów, z marginalnymi wyjątkami.
Dokumentacja API KSeF 2.0 została przygotowana w formacie OpenAPI i udostępniona jako interaktywny portal techniczny, zawierający szczegółowe opisy metod, struktur danych, parametrów oraz przykładowych zapytań i odpowiedzi. Dodatkowo udostępniono plik JSON OpenAPI, który może być bezpośrednio wykorzystywany w narzędziach programistycznych do automatycznego generowania kodu lub walidacji kontraktów API. W celu usprawnienia pracy integratorów resort finansów przygotował także zestaw bibliotek SDK w językach Java i .Net oraz podręcznik z przykładami kodu, ilustrujący sposób korzystania z kluczowych punktów końcowych systemu. Integralną częścią publikacji jest także zestawienie różnic pomiędzy aktualną wersją API 2.0 a dotychczas stosowaną wersją 1.0, która funkcjonowała w systemie fakultatywnym. Dzięki tym materiałom przedsiębiorcy i dostawcy systemów ERP mogą już teraz rozpocząć proces integracji oraz testowania wymiany danych z KSeF, zanim system stanie się obowiązkowy.
Struktura logiczna FA(3)
Równolegle z dokumentacją techniczną API, Ministerstwo Finansów opublikowało także ostateczną wersję struktury logicznej faktury ustrukturyzowanej FA(3). Nowy wzór został wypracowany w toku szeroko zakrojonych konsultacji z praktykami – ekspertami podatkowymi, księgowymi, biegłymi rewidentami, a także z producentami oprogramowania do fakturowania i przedstawicielami przyszłych użytkowników systemu. FA(3) zastąpi dotychczas obowiązującą strukturę FA(2) i będzie jedyną akceptowaną wersją faktury w KSeF po 1 lutego 2026 roku. Nowa struktura zawiera szereg usprawnień mających na celu lepsze odwzorowanie rzeczywistości gospodarczej, w tym dodatkowe pola pozwalające precyzyjniej oznaczać rodzaj transakcji, dane kontrahenta czy informacje o płatności. Udoskonalenia te mają na celu poprawę jakości danych przekazywanych do administracji skarbowej oraz zwiększenie transparentności i automatyzacji procesów księgowych.
Ministerstwo Finansów podkreśla, że dostawcy oprogramowania oraz zespoły IT powinny już teraz zapoznać się z opublikowanymi materiałami i nie odkładać integracji systemów na ostatnią chwilę. 30 września 2025 roku zostanie udostępnione środowisko testowe API KSeF 2.0, w którym będzie można przeprowadzić próby przesyłania danych oraz testy zgodności. W listopadzie 2025 roku planowane jest natomiast uruchomienie testowej wersji przeglądarkowej Aplikacji Podatnika KSeF, która pozwoli na testowanie funkcjonalności systemu w sposób zbliżony do produkcyjnego. W przypadku pytań dotyczących dokumentacji technicznej, Ministerstwo udostępniło dedykowany formularz kontaktowy, w którym należy wskazać, że zgłoszenie dotyczy środowiska testowego API KSeF 2.0, a jego charakter jest techniczny.
Wobec tego, opublikowanie dokumentacji API KSeF 2.0 oraz struktury logicznej FA(3) to kluczowy etap przygotowań do pełnego wdrożenia obowiązkowego systemu e-Faktur. Dzięki dostępnym narzędziom integracyjnym, szczegółowym instrukcjom i aktywnemu wsparciu technicznemu Ministerstwa Finansów, firmy mają realną szansę na sprawne dostosowanie się do nadchodzących zmian. Wdrożenie KSeF w obowiązkowej formule stanowi istotny krok w cyfryzacji rozliczeń podatkowych w Polsce i ma przynieść wymierne korzyści w zakresie uszczelnienia systemu VAT oraz uproszczenia obiegu dokumentów w obrocie gospodarczym.
Publikacja dokumentacji API 2.0 oraz struktury FA(3) otwiera zatem etap końcowych testów i przygotowań technicznych, które będą kluczowe w kontekście nadchodzącego obowiązku powszechnego stosowania KSeF. Ministerstwo Finansów zachęca wszystkich zainteresowanych do zapoznania się z dokumentacją, prowadzenia testów integracyjnych w środowisku preprodukcyjnym oraz zgłaszania ewentualnych uwag. Jednocześnie wskazuje, że do końca 2025 roku będzie prowadzić działania informacyjne i szkoleniowe mające na celu wsparcie przedsiębiorców w dostosowaniu się do nowych wymogów. Wdrożenie API KSeF 2.0 oraz struktury FA(3) to kolejny krok w cyfryzacji rozliczeń podatkowych i budowie nowoczesnego systemu raportowania VAT w Polsce.
Dołącz do Programu KSeF PRO i wdrażaj z nami KSeF w swojej firmie https://platforma.ikidp.pl/produkt/program-ksef-pro-dla-dzialow-ksiegowych-i-biur-rachunkowych/
Autor
Monika Wolska-Bryńska
Radca prawny, specjalizacja – procedura podatkowa, w tym postępowania podatkowe i sądowo-administracyjne
Menedżer w Zespole Postępowań w Mariański Group Kancelaria Prawno-Podatkowa Sp.k., odpowiada za prowadzenie spraw klientów w ramach postępowań podatkowych oraz wtórnych do nich – postępowań zabezpieczających i egzekucyjnych, reprezentuje klientów w sporach przed organami podatkowymi oraz przed sądami administracyjnymi oraz występuje w postępowaniach karno-skarbowych. MarianskiGroup
Redaktor prowadzący
Adrian Szydlik
Radca prawny, entuzjasta rozwiązań edukacyjnych w prawie i podatkach
Właściciel Kancelarii AS Legal&Tax, platformy z kursami online dla studentów prawa ,,Prawo dla Ciebie” oraz współwłaściciel centrum szkoleń ,,S&G Akademia”. Z Instytutem Księgowości i Doradztwa Podatkowego współpracuje od 2023 roku, odpowiada za dobór tematyczny publikowanych treści, aktywnie wspiera proces ich powstawania i publikowania. LinkedIn
Redaktor naczelny
prof. Adam Mariański
Przewodniczący Rady Programowej Instytutu Księgowości i Doradztwa Podatkowego
Lider i założyciel Mariański Group oraz Instytutu Księgowości i Doradztwa Podatkowego. Doświadczony doradca polskich firm rodzinnych, w tym także w procesie sukcesji biznesu, współtwórca ostatecznej wersji ustawy o fundacjach rodzinnych. Najlepszy w Polsce doradca podatkowy w dziedzinie podatku dochodowego według 13. ,14. oraz 17. edycji rankingu „Rzeczpospolitej”. Specjalizuje się w sukcesji podatkowej, fundacji rodzinnej, podatkach dochodowych, kontrolach i postępowaniu podatkowym oraz w ochronie praw jednostki w prawie podatkowym i planowaniu podatkowym. LinkedIn