Obowiązkowy KSeF 2026: Ministerstwo Finansów publikuje harmonogram, dokumentację API KSeF 2.0 oraz strukturę logiczną FA(3)

Kluczowe terminy wdrażania obowiązkowego KSeF / KSeF 2026: Ministerstwo Finansów publikuje dokumentację API KSeF 2.0 oraz strukturę logiczną FA(3) / Ministerstwo Finansów

W dniu 30 czerwca 2025 r. Ministerstwo Finansów opublikowało szczegółową dokumentację techniczną w zakresie implementacji Krajowego Systemu e-Faktur z narzędziami wspierającymi integrację. Od dziś firmy oraz dostawcy oprogramowania do wystawiania faktur mogą rozpocząć przygotowania do wdrożenia systemu w środowisku testowym. Materiały są dostępne pod adresem: ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow. W przypadku pytań w zakresie udostępnionej dokumentacji API KSeF 2.0 Ministerstwo Finansów prosi o kontakt za pośrednictwem formularza zgłoszeniowego: ksef.podatki.gov.pl/formularz.

Ministerstwo Finansów udostępniło narzędzia do integracji systemów IT z KSeF 2.0. Dokumentacja API KSeF 2.0 pozwoli integratorom i firmom rozpocząć przygotowania do wdrożenia systemu w środowisku testowym.

Autopromocja

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

Pełna dokumentacja API znajduje się na: ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow.

Struktura logiczna FA(3)

Ministerstwo Finansów opublikowało docelową wersję struktury logicznej e-Faktury – FA(3). Powstała ona w wyniku szerokich konsultacji z ekspertami podatkowymi, księgowymi, biegłymi rewidentami, a także z dostawcami oprogramowania do fakturowania oraz przyszłymi użytkownikami API KSeF 2.0 – w tym firmami, jednostkami samorządu terytorialnego i organizacjami pozarządowymi.
Wzór struktury logicznej FA(3) dostępny jest w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na ePUAP do których odnośniki znajdziemy na stronie: ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/struktura-logiczna-fa-3.

- Apelujemy do dostawców oprogramowania do wystawiania faktur, aby już w lipcu rozpoczęli zapoznawanie się z dokumentacją KSeF 2.0 i nie odkładali integracji na ostatnią chwilę. Od 1 lutego 2026 r. system stanie się obowiązkowy. – powiedział Marcin Łoboda wiceminister finansów, szef Krajowej Administracji Skarbowej.

Wsparcie dla integratorów

W przypadku jakichkolwiek pytań, wątpliwości lub potrzeby uzyskania dodatkowych informacji dotyczących udostępnionej dokumentacji API KSeF 2.0, Ministerstwo Finansów prosi o kontakt za pośrednictwem formularza zgłoszeniowego: ksef.podatki.gov.pl/formularz.

Wypełniając formularz zgłoszeniowy użyj następującej ścieżki kontaktu:
Rola, którą pełnisz: Integrator/ Rodzaj zgłoszenia: Techniczne/ Typ zgłoszenia: Prośba o informacje/ Aplikacja, której dotyczy zgłoszenie: API KSeF/ Środowisko, którego dotyczy zgłoszenie: Testowe/ Podkategoria zgłoszenia: Inne kwestie techniczne.

Harmonogram wdrożenia KSeF

W dniu 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. planowane jest uruchomienie testowej wersji przeglądarkowej Aplikacji Podatnika KSeF, która pozwoli użytkownikom testować najważniejsze funkcjonalności systemu KSeF.

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

oprac. Paweł Huczko
rozwiń więcej
Księgowość
Faktury ustrukturyzowanej nie da się obiektywnie (w sensie prawnym) użyć ani udostępnić poza KSeF. Co zatem będzie przedmiotem opisu i dekretacji jako dowód księgowy?
30 cze 2025

Nie da się w sensie prawnym „użyć faktury ustrukturyzowanej poza KSeF” oraz jej „udostępnić” w innej formie niż poprzez bezpośredni dostęp do KSeF – pisze prof. dr hab. Witold Modzelewski.

Obowiązkowy KSeF 2026: Ministerstwo Finansów publikuje harmonogram, dokumentację API KSeF 2.0 oraz strukturę logiczną FA(3)
30 cze 2025

W dniu 30 czerwca 2025 r. Ministerstwo Finansów opublikowało szczegółową dokumentację techniczną w zakresie implementacji Krajowego Systemu e-Faktur z narzędziami wspierającymi integrację. Od dziś firmy oraz dostawcy oprogramowania do wystawiania faktur mogą rozpocząć przygotowania do wdrożenia systemu w środowisku testowym. Materiały są dostępne pod adresem: ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow. W przypadku pytań w zakresie udostępnionej dokumentacji API KSeF 2.0 Ministerstwo Finansów prosi o kontakt za pośrednictwem formularza zgłoszeniowego: ksef.podatki.gov.pl/formularz.

Załączniki w KSeF tylko dla wybranych? Nowa funkcja może wykluczyć małych przedsiębiorców
27 cze 2025

Nowa funkcja w Krajowym Systemie e-Faktur (KSeF) pozwala na dodawanie załączników do faktur, ale wyłącznie w ściśle określonej formie i po wcześniejszym zgłoszeniu. Eksperci ostrzegają, że rozwiązanie dostępne będzie głównie dla dużych firm, a mali przedsiębiorcy mogą zostać z dodatkowymi obowiązkami i bez realnej możliwości skorzystania z tej opcji.

Kontrola podatkowa - fiskus ma 98% skuteczności. Adwokat radzi jak się przygotować i ograniczyć ryzyko kary
26 cze 2025

Choć liczba kontroli podatkowych w Polsce od 2023 roku spada, ich skuteczność jest wyższa niż kiedykolwiek. W 2024 roku aż 98,1% kontroli podatkowych oraz 94% kontroli celno-skarbowych zakończyło się wykryciem nieprawidłowości. Urzędy skarbowe, dzięki wykorzystaniu narzędzi analitycznych takich jak STIR, JPK czy big data, trafnie typują podmioty do weryfikacji, skupiając się na firmach obecnych na rynku i rzeczywiście dostępnych dla egzekucji zobowiązań. W efekcie kontrola może spotkać każdego podatnika, który nieświadomie popełnił błąd lub padł ofiarą nieuczciwego kontrahenta.

Rewolucja w podatkach i inwestycjach! Sejm przegłosował pakiet deregulacyjny – VAT do 240 tys. zł, łatwiejszy dostęp do kapitału dla MŚP
26 cze 2025

Sejm uchwalił przełomowy pakiet ustaw deregulacyjnych. Wyższy limit zwolnienia z VAT (do 240 tys. zł), tańszy dostęp do kapitału dla małych firm, koniec obowiązkowego pośrednictwa inwestycyjnego przy ofertach do 1 mln euro i uproszczenia w kontrolach celno-skarbowych – wszystko to z myślą o przedsiębiorcach i podatnikach. Sprawdź, co się zmienia od 2026 roku!

Sejm zdecydował. Fundamentalna zmiana w ustawie o podatku od spadków i darowizn
26 cze 2025

Sejm uchwalił właśnie nowelizację ustawy o podatku od spadków i darowizn. Celem nowych regulacji jest ograniczenie obowiązków biurokratycznych m.in. przy sprzedaży rzeczy uzyskanych w drodze spadku.

Fiskus przegrał przez własny błąd. Podatnik uniknął 84 tys. zł podatku, bo urzędnicy nie znali terminu przedawnienia
26 cze 2025

Fundacja wygrała przed WSA w Gliwicach spór o 84 tys. zł podatku, bo fiskus nie zdążył przed upływem terminu przedawnienia. Kontrola trwała ponad 5 lat, a urzędnicy nie przestrzegali procedur. Sprawa pokazuje, że przepisy podatkowe działają w obie strony – także na korzyść podatnika.

W 2026 r. wdrożenie obowiązkowego KSeF - czy pamiętamy o VIDA? Czym jest VIDA i jakie zmiany wprowadza?
26 cze 2025

W 2026 roku wdrożymy w końcu w Polsce Krajowy System e-Faktur (KSeF) w wersji obowiązkowej. Prace nad KSeF trwają od wielu lat. Na początku tych prac Polska była w awangardzie państw unijnych pod względem e-fakturowania, wyprzedzaliśmy rozmachem i pomysłem inne państwa, jedni z pierwszych wnioskowaliśmy w 2021 r. o pozwolenie na obowiązkowy KSeF dla wszystkich podatników i transakcji. Administracja utknęła jednak w realizacji swojego pomysłu, reszta jest historią. W międzyczasie pojawiły się nowe, niezwykle istotne okoliczności, a więc VIDA (VAT in the Digital Age). Pojawia się zatem fundamentalne pytanie: czy obecne wdrożenie KSeF nie powinno już dziś uwzględniać przyszłych wymogów VIDA?

Minister finansów zapowiada nowy podatek: W kogo uderzy?
25 cze 2025

Ministerstwo Finansów pracuje nad podatkiem dotyczącym odsetek od rezerwy obowiązkowej utrzymywanej przez banki w Narodowym Banku Polskim - poinformował minister finansów Andrzej Domański. Dodał, że przychody do budżetu w 2026 r. z tego tytułu mogłyby sięgnąć 1,5-2 mld zł.

Zwrot VAT: Tylko organ I instancji może przedłużyć termin – przełomowy wyrok WSA
25 cze 2025

Wojewódzki Sąd Administracyjny w Łodzi orzekł, że termin zwrotu VAT może zostać przedłużony wyłącznie przez organ I instancji i tylko w trakcie trwającego postępowania. Przedłużenie nie jest dopuszczalne po uchyleniu decyzji i przekazaniu sprawy do ponownego rozpatrzenia.

pokaż więcej
Proszę czekać...