Krajowy System e-Faktur przestał być ciekawostką dla księgowych i stał się codziennością większości polskich firm. W 2026 roku obowiązek wystawiania faktur ustrukturyzowanych objął kolejne grupy podatników, a ostatni dołączą na początku 2027 roku. Jeśli Twoja firma korzysta z własnego systemu, panelu lub sklepu internetowego, ten artykuł jest dla Ciebie.
Czym właściwie jest KSeF
KSeF to rządowa platforma, przez którą przechodzi każda faktura B2B. Faktura nie jest już plikiem PDF wysyłanym mailem, tylko ustrukturyzowanym dokumentem XML, który system wystawcy wysyła do KSeF, a system odbiorcy stamtąd pobiera. Dokument otrzymuje urzędowy numer i dopiero wtedy formalnie istnieje.
Co to oznacza dla Twojego systemu
Każde oprogramowanie, które wystawia faktury, musi umieć rozmawiać z API KSeF. Dotyczy to nie tylko programów księgowych, ale też:
- paneli i systemów dedykowanych, które fakturują klientów automatycznie,
- sklepów internetowych wystawiających faktury do zamówień B2B,
- platform abonamentowych i szkoleniowych, gdzie faktura powstaje po każdej płatności,
- systemów ERP, które dotąd drukowały lub mailowały faktury samodzielnie.
Jeśli system tego nie potrafi, faktury trzeba przepisywać ręcznie do zewnętrznego programu. Przy kilku dokumentach miesięcznie to niewygoda. Przy kilkuset to etat.
Jak wygląda integracja od strony technicznej
Integracja sprowadza się do kilku elementów, które trzeba zaprojektować z głową.
- Uwierzytelnienie. System musi bezpiecznie przechowywać tokeny lub certyfikaty i odnawiać sesje z KSeF.
- Generowanie XML. Faktura musi powstać w formacie zgodnym z aktualnym schematem opublikowanym przez Ministerstwo Finansów.
- Wysyłka i odbiór statusów. Po wysłaniu dokumentu system odbiera numer KSeF i urzędowe poświadczenie. Te dane trzeba zapisać i powiązać z dokumentem źródłowym.
- Obsługa błędów i awarii. Przepisy przewidują tryb awaryjny na wypadek niedostępności platformy. Dobry system wie, co zrobić z fakturą, której nie udało się wysłać, i ponawia próbę bez udziału człowieka.
Przykład z naszej praktyki
Budowaliśmy platformę e-learningową do szkoleń BHP, w której cały obieg dokumentów dzieje się automatycznie. Kursant płaci online, system wystawia fakturę i wysyła ją do KSeF, a po zaliczeniu szkolenia generuje certyfikat. Właściciel platformy nie dotyka ani faktur, ani certyfikatów. Wszystko jest logowane, więc w każdej chwili wiadomo, co i kiedy się wydarzyło.
Od czego zacząć
Najpierw sprawdź, czy Twój obecny system w ogóle da się zintegrować. Jeśli korzystasz z rozwiązania dedykowanego, integrację dopisuje się do istniejącego kodu i testuje w środowisku testowym KSeF, zanim dotknie prawdziwych faktur. Robiliśmy to w aplikacjach własnych i przejętych po innych wykonawcach. Jeśli chcesz porozmawiać o integracji w Twoim systemie, odezwij się do nas.