KSeF 2026
KSeF – Integracja z ERP i Systemami IT przez API 2026
Duże firmy generują faktury automatycznie z systemów ERP – w setkach lub tysiącach miesięcznie. Dla nich kluczowe pytanie nie brzmi „czy używać KSeF", ale „jak zintegrować KSeF z istniejącą infrastrukturą IT".
TL;DR: KSeF udostępnia publiczne API REST. Integracja wymaga tokena API dla uwierzytelnienia. Dostępne środowisko testowe (sandbox). Główne metody: direct API, pośrednik (hub), plugin do ERP.
1. Jak działa API KSeF?
| Endpoint | Opis |
|---|---|
POST /api/online/Invoice/Send | Wysłanie pojedynczej faktury |
POST /api/batch/Send | Wysłanie wsadowe wielu faktur |
GET /api/online/Invoice/Get/{KSeFReferenceNumber} | Pobranie faktury po numerze KSeF |
GET /api/common/Status | Status systemu (czy działa, czy tryb awaryjny) |
POST /api/online/Session/AuthorisedInit | Inicjowanie sesji autoryzowanej |
2. Token API – jak wygenerować
- Zaloguj się do KSeF przez Profil Zaufany lub podpis kwalifikowany
- W ustawieniach KSeF wybierz „Tokeny" → „Generuj token"
- Przypisz uprawnienia (co najmniej „wystawianie faktur")
- Skopiuj token i umieść w konfiguracji systemu ERP
Token to tajny klucz – jego ujawnienie daje dostęp do wystawiania faktur w imieniu Twojej firmy. Przechowuj go jak hasło do konta bankowego.
3. Trzy modele integracji – porównanie
| Model | Dla kogo | Czas | Koszt |
|---|---|---|---|
| Plugin do ERP | Użytkownicy Comarch, SAP, Dynamics, Sage | 1–4 tyg. | 5–30 tys. zł + subskrypcja |
| Pośrednik / Hub | Firmy z kilkoma systemami, biura rachunkowe | 2–6 tyg. | 200–2 000 zł/mies. |
| Direct API | Duże firmy z własnym IT, ERP na miarę | 2–6 mies. | 50–300 tys. zł |
4. Obsługa błędów w integracji
| Kod błędu | Znaczenie | Działanie |
|---|---|---|
| 400 Bad Request | Błąd walidacji XML | Popraw XML i wyślij ponownie |
| 401 Unauthorized | Błędny token lub wygasła sesja | Odnów token/sesję |
| 409 Conflict | Duplikat faktury | Sprawdź czy faktura już jest w KSeF |
| 503 Service Unavailable | KSeF niedostępny (awaria) | Przejdź w tryb awaryjny |
5. Dostępność modułów KSeF w popularnych ERP
| System ERP | Dostępność modułu KSeF |
|---|---|
| SAP S/4HANA | Moduł KSeF dostępny (SAP lub partnerzy) |
| Microsoft Dynamics 365 | Connector KSeF od Microsoft lub partnerów |
| Comarch ERP XL / Optima | Wbudowana integracja z KSeF |
| Sage | Moduł KSeF dostępny |
| wFirma / inFakt / iFirma | Wbudowana integracja (SaaS) |
Artykuł przygotowany przez online-ksiegowosc.pl na podstawie aktualnego stanu prawnego (2026 r.).
