Resort finansów udostępnił dokumentację API KSeF 2.0 i finalną strukturę FA(3)

Od dzisiaj, czyli 30 czerwca, przedsiębiorstwa oraz firmy tworzące oprogramowanie fakturowe mają dostęp do materiałów potrzebnych, by rozpocząć przygotowania do wdrożenia Krajowego Systemu e-Faktur w otoczeniu testowym.

API, czyli interfejs programistyczny aplikacji, to zestaw reguł i specyfikacji technicznych określających mechanizm wymiany danych pomiędzy KSeF a zewnętrznymi systemami finansowo-księgowymi. Dzięki niemu z systemem może współpracować dowolne oprogramowanie fakturujące, bez względu na producenta. Warunkiem koniecznym, by móc w KSeF 2.0 wystawiać, wysyłać czy odbierać dokumenty, jest wcześniejsze połączenie danego programu z systemem właśnie za pomocą interfejsu API.

• Dokumentacja techniczna API opracowana zgodnie ze standardem Open API, dostępna jako interaktywny portal techniczny obejmujący opisy metod, struktury danych oraz parametry wraz z przykładami
• Plik specyfikacji w formacie JSON OpenAPI, przydatny przy automatyzacji integracji, np. w generatorach kodu czy walidatorach kontraktów API

Poza tym Ministerstwo Finansów przygotowało dodatkowe materiały, które mają usprawnić pracę zespołom deweloperskim:

• Biblioteki SDK, czyli zestawy narzędzi i przykładowego kodu w dwóch językach – Java oraz .Net
• Podręcznik z instrukcjami oraz fragmentami kodu pokazującymi, jak korzystać z najważniejszych endpointów systemu
• Zestawienie głównych różnic pomiędzy API KSeF 2.0 a obecnie funkcjonującym, fakultatywnym API KSeF 1.0

Kompletna dokumentacja API dostępna jest pod adresem: ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow.

Struktura logiczna FA(3)

Resort finansów opublikował także finalny wariant struktury logicznej e-faktury oznaczonej jako FA(3). Dokument ten powstawał podczas obszernych konsultacji, w których udział wzięli eksperci podatkowi, księgowi, biegli rewidenci oraz producenci oprogramowania fakturowego, a także przyszli użytkownicy API KSeF 2.0 – między innymi przedsiębiorstwa, jednostki samorządu terytorialnego i organizacje pozarządowe.

Wzorzec struktury FA(3) można znaleźć w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na platformie ePUAP, do którego odnośniki zamieszczono 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

Marcin Łoboda, wiceminister finansów, szef Krajowej Administracji Skarbowej

Wsparcie dla integratorów

Osoby mające pytania lub wątpliwości dotyczące udostępnionej dokumentacji API KSeF 2.0, a także potrzebujące dodatkowych wyjaśnień, mogą skorzystać z formularza zgłoszeniowego pod adresem: ksef.podatki.gov.pl/formularz.

Przy wypełnianiu formularza warto zastosować następującą ścieżkę: rola – Integrator, rodzaj zgłoszenia – Techniczne, typ zgłoszenia – Prośba o informacje, aplikacja – API KSeF, środowisko – Testowe, podkategoria – Inne kwestie techniczne.

Harmonogram wdrożenia KSeF

30 września 2025 r. uruchomione zostanie środowisko testowe API KSeF 2.0, dzięki któremu dostawcy oprogramowania oraz firmy będą mogły przeprowadzić własne testy. Z kolei na listopad 2025 r. zaplanowano start testowej, przeglądarkowej wersji Aplikacji Podatnika KSeF, umożliwiającej sprawdzenie kluczowych funkcji systemu.

Natomiast od 1 lutego 2026 r. KSeF 2.0 stanie się obowiązkowy dla wszystkich użytkowników. Tego samego dnia struktura logiczna FA(3) zastąpi dotychczas obowiązującą strukturę FA(2).

Źródło: ITwiz