Dokumentację API KSeF 2.0

30 czerwca 2025 r. to ważna data dla wszystkich firm i dostawców oprogramowania do fakturowania – Ministerstwo Finansów opublikowało kompletną dokumentację techniczną API KSeF 2.0, rozpoczynając tym samym kluczowy etap przygotowań do wdrożenia obowiązkowego Krajowego Systemu e-Faktur, który wejdzie w życie 1 lutego 2026 r. Od teraz integratorzy mogą rozpocząć prace nad przystosowaniem swoich systemów do nowego standardu.
Dokumentację API KSeF 2.0

Dokumentacja API KSeF 2.0 – co zawiera?


Udostępniona dokumentacja techniczna została opracowana zgodnie z formatem OpenAPI i zawiera:
  • szczegółowe opisy metod i endpointów API,
  • struktury danych, parametry i przykłady zastosowania,
  • kompletną specyfikację techniczną (plik JSON) do wykorzystania w narzędziach automatyzujących integrację (np. generatory kodu, walidatory kontraktów API).
Ministerstwo Finansów zapewniło także gotowe biblioteki SDK w językach Java i .Net, a także podręcznik dla deweloperów z przykładami kodu. Istotnym elementem jest również porównanie zmian między wersją API 1.0 (stosowaną w systemie fakultatywnym) a nową wersją 2.0.

Dokumentacja dostępna jest na stronie:

https://ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow

Struktura logiczna FA(3) – nowy standard e-Faktury


Wraz z dokumentacją API opublikowano również finalną wersję struktury logicznej FA(3), która od 1 lutego 2026 r. całkowicie zastąpi dotychczasową wersję FA(2). Nowy wzór został wypracowany w toku szeroko zakrojonych konsultacji z:
  • ekspertami podatkowymi,
  • księgowymi i biegłymi rewidentami,
  • przedstawicielami biznesu, JST i NGO,
  • dostawcami oprogramowania do fakturowania.
Dokument znajduje się w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na ePUAP – linki dostępne są na stronie:
https://ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/struktura-logiczna-fa-3

Harmonogram wdrożenia KSeF 2.0


Ministerstwo ogłosiło również harmonogram kluczowych działań:
  • 30 września 2025 r. – uruchomienie środowiska testowego API KSeF 2.0, umożliwiającego pełne testy integracyjne.
  • Listopad 2025 r. – udostępnienie testowej wersji Aplikacji Podatnika KSeF w formie przeglądarkowej.
  • 1 lutego 2026 r. – obowiązkowe wejście w życie KSeF 2.0 i zastąpienie struktury FA(2) nową FA(3).

Apel do firm i integratorów


– Apelujemy do dostawców oprogramowania, aby już w lipcu rozpoczęli analizę dokumentacji KSeF 2.0 i nie czekali z integracją na ostatni moment. Mamy czas do lutego 2026, ale warto go wykorzystać maksymalnie efektywnie – podkreśla Marcin Łoboda, wiceminister finansów i szef Krajowej Administracji Skarbowej.

Pomoc techniczna – jak zgłaszać pytania?


W przypadku pytań dotyczących integracji z API KSeF 2.0, należy skorzystać z formularza zgłoszeniowego:
https://ksef.podatki.gov.pl/formularz

Podsumowanie


Udostępnienie dokumentacji KSeF 2.0 to milowy krok w kierunku pełnej cyfryzacji fakturowania w Polsce. Dla dostawców oprogramowania i firm to ostatni moment, by rozpocząć działania przygotowawcze. Dzięki opublikowanym materiałom, SDK oraz środowisku testowemu możliwe jest sprawne i bezpieczne wdrożenie nowego systemu.