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

A to oznacza, że od dziś (30 czerwca) firmy oraz dostawcy oprogramowania do wystawiania faktur mogą rozpocząć przygotowania do wdrożenia systemu w środowisku testowym.

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 również 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, można skontaktować się za pośrednictwem formularza zgłoszeniowego: ksef.podatki.gov.pl/formularz

Wypełniając formularz zgłoszeniowy należy użyć 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

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