Integracja z KSeF API — oficjalne repozytoria i dokumentacja
Gdzie szukać oficjalnej dokumentacji API KSeF 2.0 i gotowych klientów w Javie i C#.
Jeśli budujesz własną integrację z KSeF zamiast korzystać z gotowego narzędzia, zacznij od oficjalnych źródeł CIRF (Centrum Informatyki Resortu Finansów) — nie od przypadkowych snippetów znalezionych w internecie.
Dokumentacja API 2.0
Repozytorium ksef-docs zawiera kompletny przewodnik integratora: uwierzytelnianie, tokeny KSeF, sesje interaktywne i wsadowe, środowiska (test/produkcja), generowanie kodów QR na fakturach oraz specyfikację OpenAPI.
- github.com/CIRFMF/ksef-docs — przewodnik integratora + open-api.json
Gotowe klienty API
Ministerstwo Finansów udostępnia oficjalne biblioteki klienckie w dwóch technologiach — nie trzeba implementować komunikacji z API od zera.
- github.com/CIRFMF/ksef-client-java — oficjalny klient Java
- github.com/CIRFMF/ksef-client-csharp — oficjalny klient C#
Status i dostępność systemu
Latarnia KSeF to publiczne API informujące o planowanych niedostępnościach i awariach KSeF (zgodnie z art. 106ne ustawy o VAT) — warto podpiąć je pod monitoring własnej integracji, żeby nie dowiadywać się o przerwie dopiero po błędzie wysyłki.
- github.com/CIRFMF/ksef-latarnia — status i planowane przerwy
Zanim zaczniesz pisać własną integrację
Własna integracja z KSeF API to spora inwestycja czasu — uwierzytelnianie, obsługa sesji, retry, walidacje, środowisko testowe. Jeśli Twoim celem jest po prostu wystawianie i odbieranie faktur, gotowe narzędzie (np. ksiegai) z darmowym połączeniem do KSeF zwykle jest szybsze niż budowanie własnego klienta.
Chcesz połączyć firmę z ksiegai i wysyłać faktury do KSeF bezpłatnie?
Załóż darmowe konto