Integracja KSeF z własnym systemem: co trzeba zrobić i ile to trwa

8 listopada 2026, Vyral Studio

Krótka odpowiedź: system musi umieć zbudować plik faktury w strukturze FA(3), wysłać go do KSeF, odebrać numer KSeF i UPO oraz zapisać je przy fakturze. Dla typowego systemu na zamówienie to praca na 2–5 tygodni, w zależności od tego, czy oprócz wysyłki chcesz pobierać faktury zakupowe i wystawiać korekty.

Kogo dotyczy obowiązek

Największe firmy wystawiają faktury w KSeF od 1 lutego 2026 r., a pozostali podatnicy od 1 kwietnia 2026 r. Z dniem 1 stycznia 2027 r. kończy się okres przejściowy dla najmniejszych firm (sprzedaż do 10 tys. zł miesięcznie) oraz wystawianie faktur z kasy fiskalnej. Paragon z NIP przestaje być fakturą uproszczoną, więc do sprzedaży dla firmy zarejestrowanej na kasie trzeba wystawić fakturę w KSeF.

Co musi umieć Twój system

• Zbudować poprawny plik XML w strukturze FA(3) i sprawdzić go przed wysyłką.
• Uwierzytelnić się w KSeF tokenem lub certyfikatem KSeF.
• Wysłać fakturę, odczytać jej status i obsłużyć odrzucenie.
• Zapisać numer KSeF i UPO przy fakturze. Numer KSeF przyda się do korekt i płatności.
• Wystawić korektę, która zawiera numer KSeF faktury pierwotnej.
• Działać w trybach offline przewidzianych w przepisach, gdy KSeF jest niedostępny.
• Opcjonalnie: pobierać faktury zakupowe wystawione na Twój NIP.

Trzy sposoby podłączenia

Ręcznie w aplikacji Ministerstwa Finansów

Aplikacja Podatnika KSeF i Aplikacja Mobilna KSeF są bezpłatne. Sprawdzą się przy kilku fakturach miesięcznie. Przy większej liczbie przepisywanie danych zabiera czas i grozi pomyłkami.

Moduł od dostawcy systemu

Jeśli korzystasz z popularnego programu księgowego lub ERP, zwykle wystarczy włączyć moduł KSeF i skonfigurować uprawnienia.

Własna integracja z API KSeF

To droga dla systemów na zamówienie, starszych ERP bez wsparcia i oprogramowania branżowego. Integracja działa jako osobna usługa albo moduł w kodzie i komunikuje się z API KSeF w Twoim imieniu.

Ile to trwa i od czego zależy koszt

Sama wysyłka faktur trwa zwykle 2–3 tygodnie, pełna integracja z pobieraniem faktur zakupowych i korektami 3–5 tygodni. Koszt zależy głównie od tego, jak system przechowuje dane faktur i ile ich rodzajów trzeba obsłużyć: zwykłe, zaliczkowe, korekty, faktury do paragonów. Dlatego każdy system wyceniamy osobno, jako stałą kwotę za cały zakres. Warianty opisujemy na stronie integracji z KSeF.

O co zapytać wykonawcę

1. Czy testy odbędą się na środowisku testowym MF, na Twoich prawdziwych fakturach?
2. Co się stanie z fakturą, gdy KSeF nie odpowiada?
3. Gdzie zapisany będzie numer KSeF i UPO?
4. Kto przechowuje token lub certyfikat i z jakimi uprawnieniami?
5. Kto ma prawa do kodu i kto zaktualizuje integrację po zmianie schematu?

Najczęstsze błędy

• Brak walidacji przed wysyłką. Odrzucone faktury wychodzą dopiero po fakcie.
• Przyjęcie, że data wystawienia to data w polu P_1. Dla faktury w KSeF liczy się co do zasady data przesłania do systemu.
• Brak zapisu numeru KSeF przy fakturze. Bez niego nie wystawisz poprawnej korekty.