Wsparcie dla integratorów
Krajowy System e-Faktur - dokumentacja dla nowej wersji systemu KSeF 2.0
30.06.2025
Udostępniamy dokumentację API KSeF 2.0, która pozwoli integratorom rozpocząć przygotowania do wdrożenia systemu na środowisku testowym.
Szczególnie ważna na tym etapie będzie rola integratorów, tworzących systemy informatyczne służące do wystawiania faktur, z których korzysta wiele firm i osób prowadzących działalność gospodarczą.
Zachęcamy już dziś do zapoznania się z udostępnioną dokumentacją.
Zapoznaj się ze strukturą logiczną FA(3)
Rodzaj dokumentacji
Opis
Lokalizacja
Plik kontraktu openapi.json
Specyfikacja API w formacie OpenAPI 3.0.4 (JSON), stanowiąca jednoznaczny kontrakt, zrozumiała dla programistów i w pełni obsługiwana przez narzędzia do dokumentowania, testowania oraz automatycznego generowania kodu.
Dokumentacja on-line
Interaktywna dokumentacja wygenerowana z kontraktu OpenAPI – prezentuje wszystkie endpointy, parametry, schematy danych, kody odpowiedzi oraz przykłady wywołań.
KSeF 2.0 przewodnik dla integratorów (dokumentacja rozszerzona)
Zawiera zestawy scenariuszy użycia API, np. uwierzytelnienie, wysyłka faktur w sesji interaktywnej lub batchowej, pobranie UPO. Każdy scenariusz opisuje pełen ciąg kroków, wskazuje właściwe endpointy oraz pokazuje wywołania i odpowiedzi w C# i Java.
Przegląd kluczowych zmian w API KSeF 2.0
Omówienie najważniejszych usprawnień wprowadzonych w API KSeF 2.0
Biblioteka .NET
Implementacja klienta KSeF 2.0, aplikacja demonstracyjna oraz implementacja scenariuszy użycia w .NET
W przypadku pytań lub wątpliwości w zakresie udostępnionej dokumentacji API KSeF 2.0 prosimy o kontakt za pośrednictwem formularza zgłoszeniowego udostępnionego w zakładce Kontakt - Napisz do nas.
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.
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.
Opublikowano: 30.06.2025
Zmodyfikowano: 30.06.2025
Opracowanie: Redakcja Portalu Podatkowego