Ministerstwo Finansów udostępniło dokumentację API KSeF 2.0 – teraz czas na działania integratorów! Ministerstwo Finansów opublikowało dokumentację interfejsu API dla Krajowego Systemu e-Faktur w wersji 2.0. Dzięki temu integratorzy mogą już rozpocząć przygotowania do wdrażania systemu KSeF na środowisku testowym.
Dokumentacja API KSeF 2.0 i struktura FA(3) już opublikowana – co musisz wiedzieć?
Ministerstwo Finansów udostępniło dokumentację API KSeF 2.0 oraz strukturę logiczną e-Faktury FA(3). To kluczowy moment dla integratorów i dostawców systemów fakturowych – udostępnione materiały pozwalają już dziś rozpocząć prace nad wdrożeniem nowego systemu na środowisku testowym. Sprawdź, co się zmienia i jak przygotować się do obowiązkowego KSeF od 2026 roku.
Korzyści
Po przeczytaniu tekstu:
- Dowiesz się, jak już teraz przygotować systemy do obowiązkowego KSeF 2.0 – poznasz nowe API, terminy wdrożeń i dostępne narzędzia dla integratorów.
- Poznasz strukturę FA(3) – sprawdzisz, co się zmienia i jak dostosować swoje rozwiązania do nowego formatu e-faktury, który będzie obowiązywać od 1 lutego 2026 r.
Dokumentacja API KSeF 2.0 już dostępna
Dokumentacja API KSeF 2.0: Dlaczego to ważne
Na obecnym etapie kluczowa jest rola integratorów oprogramowania do fakturowania – to właśnie z tych systemów korzystają tysiące przedsiębiorców i firm. Odpowiednie przygotowanie ich do wymogów KSeF 2.0 ma zasadnicze znaczenie dla płynnego przejścia na obowiązkowy system fakturowania elektronicznego.
Co zawiera dokumentacja API KSeF 2.0
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).
Gdzie znaleźć dokumentację API KSeF 2.0
Pełna dokumentacja API znajduje się na: ksef.podatki.gov.pl/ksef-na-okres-obligatoryjny/wsparcie-dla-integratorow.
Kluczowe terminy wdrożenia KSeF 2.0:
- 30 września 2025 r. zostanie udostępniony interfejs programistyczny API KSeF 2.0 do otwartych testów dla wszystkich integratorów i przedsiębiorstw. Udostępnione obecnie materiały umożliwiają już dziś zaplanowanie architektury integracji, przygotowanie zmian oraz opracowanie prototypów. Wszystkie dokumenty będą na bieżąco rozwijane i aktualizowane aż do momentu uruchomienia środowiska testowego.
- Listopad 2025 r. planowane jest udostępnienie testowej wersji Aplikacji Podatnika KSeF 2.0, implementującej pełny zakres funkcji dostępnych przez interfejs API KSeF 2.0.
- 1 lutego 2026 r. zostanie udostępniona produkcyjna wersja systemu, umożliwiająca wystawianie faktur ustrukturyzowanych w obrocie gospodarczym.
Struktura logiczna e-Faktury FA(3) już dostępna
Ministerstwo Finansów udostępniło też strukturę logiczną FA(3) wraz z jej dokumentacją oraz broszurą informacyjną i przykładowymi plikami.
Zapamiętaj!
Od 1 lutego 2026 r. struktura FA(3) zastąpi dotychczasową FA(2).
Zmiany obejmują:
- dodatkowe pola wymagane przez system,
- doprecyzowane reguły walidacyjne,
- lepszą kompatybilność z JPK.
Struktura logiczna logiczną FA(3) została opublikowana w Centralnym Repozytorium Wzorów Dokumentów Elektronicznych na ePUAP.
Podsumowanie
Dokumentacja API KSeF 2.0 i struktura FA(3) to fundamenty nowego systemu fakturowania, który stanie się obowiązkowy od 2026 roku. Przedsiębiorcy i integratorzy powinni jak najszybciej zapoznać się z udostępnionymi materiałami i rozpocząć przygotowania techniczne, aby uniknąć błędów w momencie wejścia przepisów w życie.
Źródło: Krajowy System e-Faktur (KSeF)
Podobne artykuły
Zobacz również
Nasz magazyn Pokaż listę wydań »
Nr 288 / Lipiec 2025 r.
Dostępny w wersji elektronicznej
Zapisz się na bezpłatny newsletter
