KSeF 2.0 - Przewodnik dla Integratorów

22.12.2025

Niniejszy dokument stanowi kompendium wiedzy dla deweloperów, analityków i integratorów systemów, którzy realizują integrację z Krajowym Systemem e-Faktur (KSeF) w wersji 2.0. Przewodnik koncentruje się na aspektach technicznych i praktycznych związanych z komunikacją z API systemu KSeF.

Wprowadzenie do KSeF 2.0

Krajowy System e-Faktur (KSeF) to centralny system teleinformatyczny służący do wystawiania i pobierania faktur ustrukturyzowanych w postaci elektronicznej.

Spis treści

Przewodnik został podzielony na tematyczne sekcje, odpowiadające kluczowym funkcjom i obszarom integracyjnym w API KSeF:

• Przegląd kluczowych zmian w KSeF 2.0
• Changelog
• Uwierzytelnianie
  • Uzyskiwanie dostępu
  • Zarządzanie sesjami
• Uprawnienia
• Certyfikaty KSeF
• Tryby offline
  • Tryby offline
  • Korekta techniczna
• Kody QR
• Sesja interaktywna
• Sesja wsadowa
• Pobieranie faktur
  • Pobieranie faktur
  • Przyrostowe pobieranie faktur
• Zarządzanie tokenami KSeF
• Limity
• Dane testowe

Dla każdego obszaru przewidziano:

• szczegółowy opis działania,
• przykład wywołania w językach C# i Java,
• powiązania ze specyfikacją OpenAPI i kodem biblioteki referencyjnej.

Przykłady kodu prezentowane w przewodniku zostały przygotowane w oparciu o oficjalne biblioteki open source:

• ksef-client-csharp – biblioteka w języku C#
• ksef-client-java – biblioteka w języku Java

Obie biblioteki są utrzymywane i rozwijane przez zespoły Ministerstwa Finansów oraz udostępniane publicznie na zasadach open source. Zapewniają pełne wsparcie funkcjonalności API KSeF 2.0, w tym obsługę wszystkich endpointów, modeli danych oraz przykładowych scenariuszy wywołań. Wykorzystanie tych bibliotek pozwala znacząco uprościć proces integracji oraz minimalizuje ryzyko błędnej interpretacji kontraktów API.

Środowiska Systemu

Zestawienie środowisk KSeF API 2.0 zostało opisane w dokumencie Środowiska KSeF API 2.0