Integracja z KSeF dla własnego systemu, ERP i aplikacji
Od 1 kwietnia 2026 wystawianie faktur w KSeF obejmuje większość podatników VAT. Jeśli faktury powstają w Twoim ERP, programie magazynowym albo aplikacji pisanej na zamówienie, potrzebne jest niezawodne połączenie z systemem Ministerstwa Finansów.
Autor: Szymon Łakomy. Aktualizacja:
Harmonogram obowiązku w 2026 i 2027 roku
| Od kiedy | Kogo dotyczy | Co musi umieć Twój system |
|---|---|---|
| 1 lutego 2026 | firmy ze sprzedażą powyżej 200 mln zł w 2024 roku | wysyłać faktury sprzedaży do KSeF |
| 1 lutego 2026 | wszystkich podatników | odbierać faktury zakupowe przez KSeF |
| 1 kwietnia 2026 | pozostałych podatników VAT, czynnych i zwolnionych | wysyłać faktury sprzedaży do KSeF |
| 1 stycznia 2027 | najmniejszych, ze sprzedażą fakturową do około 10 tys. zł miesięcznie | wysyłać wszystko, bo wyjątek dla małej sprzedaży wygasa |
Podstawą jest ustawa z 5 sierpnia 2025. To zestawienie nie jest poradą podatkową, a terminy i progi warto potwierdzić na ksef.podatki.gov.pl.
W październiku 2026 KSeF działa już u większości firm, a mikrofirmy korzystające z wyjątku mają ostatnie tygodnie na przygotowanie.
Integracja jako kolejka zdarzeń
Każda faktura przechodzi przez te same kroki, a każdy krok zapisuje swój wynik. Po awarii wiadomo więc, gdzie dokument się zatrzymał, i nic nie zostaje wysłane dwa razy.
- Walidacja. Sprawdzam NIP nabywcy i kompletność danych, zanim dokument opuści Twój system.
- XML w strukturze FA. Dane z ERP lub aplikacji zamieniam na plik zgodny ze strukturą FA.
- Wysyłka przez API. Dokument trafia do KSeF, a integracja zapamiętuje, że czeka na odpowiedź.
- Numer KSeF i status. Przyjęta faktura dostaje numer KSeF, który zapisuję przy dokumencie w Twoim systemie.
- Błędy i ponowienia. Odrzucenie z powodu danych trafia do osoby, która może je poprawić. Problem techniczny kończy się ponowieniem, a nie utratą faktury.
Faktury zakupowe pobierane do ERP
Od 1 lutego 2026 faktury od dostawców odbiera się przez KSeF. Integracja może je regularnie pobierać i zapisywać w ERP albo programie magazynowym, na przykład jako podstawę przyjęcia towaru. Dane przychodzą w XML, więc nikt nie przepisuje ich z PDF.
Dekretacja i księgowanie kosztów to osobny etap, który opisuję na stronie automatyczne księgowanie faktur kosztowych.
Tryb offline, awaria KSeF i korekty
Tryb offline
Faktura może powstać bez połączenia z KSeF i zostać dosłana później. Integracja pamięta, które dokumenty czekają, i dosyła je bez udziału człowieka.
Awaria systemu
Gdy KSeF nie odpowiada, kolejka wstrzymuje wysyłkę i wznawia ją po powrocie systemu. Dokumenty nie znikają, a zespół dostaje powiadomienie.
Kod QR na wizualizacji
PDF przekazywany kontrahentowi poza KSeF ma kod QR do weryfikacji. Dodaję go do wydruku z Twojego systemu.
Korekty
Korekta też idzie przez KSeF. Integracja wiąże ją z fakturą pierwotną i jej numerem KSeF, a potem zapisuje numer samej korekty.
Gotowa obsługa KSeF w programie czy własne połączenie
Jeśli Twój ERP albo program do faktur ma już obsługę KSeF, zwykle wystarczy ją skonfigurować i własny kod jest zbędny. Czy obejmuje tryb offline i korekty, sprawdzam w dokumentacji producenta. Własne połączenie przez API ma sens przy:
- aplikacji pisanej na zamówienie albo starszym systemie, którego producent już nie rozwija,
- kilku systemach wystawiających faktury, które mają trafiać do KSeF jednym torem,
- potrzebie widzenia numerów KSeF i statusów tam, gdzie pracuje zespół, na przykład w CRM lub panelu B2B.
Gdy chodzi Ci głównie o to, żeby faktury wystawiały się same po płatności lub wysyłce, zacznij od strony automatyzacja fakturowania. Sprzedaż przez sklep opisuję osobno w tekście KSeF w sklepie internetowym, a szerszy kontekst łączenia programów na stronie integracja ERP i CRM.
Wycena i uruchomienie
Zaczynam od ustalenia, gdzie powstają faktury i jak system źródłowy udostępnia dane: przez API, bazę czy pliki. Potem buduję kolejkę i przepuszczam przez nią przykładowe dokumenty, w tym korekty i faktury offline, a na koniec włączam powiadomienia o odrzuceniach. Kwoty nie podaję z góry, bo zależy od systemu i liczby wyjątków. Ogólne zasady opisuję w poradniku ile kosztuje integracja API.
Najczęstsze pytania
Mój ERP nie obsługuje KSeF. Czy muszę go wymieniać?
Niekoniecznie. Integracja może działać obok programu: odczytuje dane faktury, wysyła je do KSeF i zapisuje numer z powrotem. Czy da się to zrobić bez ingerencji w program, zależy od tego, jak udostępnia dane.
Co się dzieje z fakturą, gdy KSeF ma awarię?
Dokument zostaje w kolejce ze statusem oczekującym i jest dosyłany, gdy system wróci. Na takie sytuacje przewidziano osobny tryb, a szczegóły postępowania warto uzgodnić z księgową.
Czy integracja może pobierać faktury od dostawców?
Tak. Faktury zakupowe pobieram z KSeF regularnie i zapisuję w ERP lub programie magazynowym. Numer KSeF służy jako identyfikator, który chroni przed podwójnym wprowadzeniem tej samej faktury.
Ile kosztuje integracja z KSeF?
Wycena po rozmowie. Inaczej wygląda połączenie aplikacji z czystym API, a inaczej starego programu bez interfejsu, z kilkoma rodzajami dokumentów i korektami. Po krótkiej analizie podaję kwotę i zakres.
Powiązane strony
Chcesz połączyć swój system z KSeF?
Napisz, w jakim programie powstają faktury i ile ich wystawiasz. Odpowiem, od czego zacząć.