Integracja z KSeF 2.0 w praktyce: FA(3) z załącznikiem, tryb offline24, certyfikaty i co to znaczy po stronie ERP oraz sklepu

Co realnie zmienia KSeF 2.0 po stronie systemów

Integracja KSeF 2.0 z ERP przenosi punkt powstania faktury z Twojego systemu do systemu państwowego. Faktura przestaje być plikiem PDF, który wysyłasz mailem — staje się komunikatem XML przyjętym przez bramkę i opatrzonym numerem identyfikującym.

Dla ERP oznacza to trzy nowe obowiązki techniczne:

• poprawne zbudowanie dokumentu w obowiązującym schemacie,
• obsługę odpowiedzi i błędów z API bramki,
• trwałe przechowanie potwierdzenia po Twojej stronie.

Doświadczenie zespołu obejmuje 50+ zrealizowanych projektów i 20+ lat pracy przy projektach IT. Takie wdrożenia prowadzimy jak integrację, nie jak instalację modułu: zaczynamy od pytania, gdzie w Twojej firmie powstaje pojedyncza pozycja faktury, kto ją zatwierdza i co się dzieje, gdy dokument zostanie odrzucony.

Zakres wymagań publikuje Ministerstwo Finansów (gov.pl/ksef) i to ta dokumentacja, a nie żaden artykuł, jest źródłem obowiązującego stanu. Ten tekst ma charakter informacyjny i nie stanowi porady podatkowej ani prawnej. Wspieramy zgodność Twoich systemów z wymaganiami — nie zastępujemy doradcy podatkowego i nie gwarantujemy oceny prawnej.

FA(3) z załącznikiem — co musi umieć Twój system

W schemacie FA(3) Twój ERP zwykle musi obsłużyć cztery typy dokumentów z codziennej sprzedaży:

• fakturę krajową,
• korektę,
• zaliczkę,
• fakturę do paragonu.

Problem rzadko leży w samym generatorze XML. Leży w danych: brakującym NIP kontrahenta, jednostkach miary wpisywanych ręcznie, rabatach liczonych w dwóch miejscach naraz, kodach GTU nadawanych z pamięci. To są luki procesowe, które integracja tylko ujawnia — nie tworzy ich.

Osobna decyzja dotyczy załączników. Przesłanie załącznika w ramach faktury ustrukturyzowanej nie jest funkcją włączoną domyślnie — wymaga wcześniejszego zgłoszenia po stronie administracji skarbowej, a po stronie ERP przemyślenia, co w ogóle chcesz załączać: specyfikację pozycji, protokół odbioru, zestawienie zużycia. Jeśli dziś dosyłasz te dokumenty mailem, przeniesienie ich do KSeF jest zmianą procesu, nie zmianą jednego pola w bazie.

Tryb offline24: co się dzieje, gdy KSeF nie odpowiada

Tryb offline24 zakłada, że faktura trafia do KSeF najpóźniej następnego dnia roboczego po wystawieniu (stan: sierpień 2026, wg komunikatów Ministerstwa Finansów — przed decyzją zweryfikuj aktualny komunikat). Trzeba go zaprojektować, zanim będzie potrzebny: sprzedaż nie może stanąć dlatego, że bramka nie odpowiada. Faktura powstaje wtedy lokalnie, jest wydawana nabywcy z odpowiednim oznaczeniem, a do KSeF trafia po przywróceniu połączenia.

Po stronie ERP oznacza to konkretne elementy do zbudowania:

• kolejkę dokumentów oczekujących na wysyłkę,
• mechanizm ponowień,
• rozróżnienie błędu technicznego od merytorycznego,
• alert dla człowieka, gdy kolejka rośnie.

Po stronie procesu oznacza to odpowiedź na proste pytanie: kto pilnuje tej kolejki w piątek po szesnastej i co robi, gdy w poniedziałek rano wciąż nie jest pusta.

Certyfikat KSeF i uwierzytelnianie — kto i czym podpisuje

Certyfikat KSeF jest tym, czym Twój system przedstawia się bramce — to element infrastruktury, nie formalność księgowa. Uwierzytelnienie może opierać się na certyfikacie pobranym w Aplikacji Podatnika KSeF, na pieczęci kwalifikowanej albo na tokenie. Wybór zależy od tego, ile systemów u Ciebie wystawia faktury i kto ma prawo robić to w imieniu firmy.

Najczęstsze potknięcia są organizacyjne, nie programistyczne: certyfikat przypisany do osoby, która odchodzi z firmy; brak monitoringu daty ważności; jedno konto techniczne wspólne dla ERP, sklepu i biura rachunkowego, przez które nie da się ustalić, który system wysłał wadliwy dokument. Uprawnienia rozpisujemy per system i per rola, zanim powstanie pierwsza linia integracji.

Co to znaczy dla ERP, a co dla sklepu internetowego

Sklep internetowy prawie nigdy nie powinien rozmawiać z KSeF bezpośrednio. Faktura ma mieć jedno źródło prawdy — ERP — a sklep dostarcza do niego zamówienie z kompletem danych: NIP, forma płatności, adres, zwroty, korekty. Kiedy sklep wystawia własne dokumenty równolegle, powstają dwie numeracje i dwie wersje tej samej sprzedaży, a uzgadnianie ich bywa droższe niż sama integracja.

Większość pracy w projekcie „KSeF w sklepie” to w praktyce naprawa ścieżki zamówienie → ERP: walidacja NIP w koszyku, obsługa faktury do paragonu, korekty przy zwrotach, mapowanie stawek dla sprzedaży zagranicznej. Sam kanał do KSeF jest końcówką, nie sednem.

Dokładnie o tym mówi podejście założyciela Primessio, Dariusza Wtykły: „Zaczynam od Twojego procesu i sposobu pracy: porządkuję je, a dopiero potem dobieram albo buduję technologię szytą na miarę”.

Doświadczenie zespołu obejmuje system dla Komendy Głównej Państwowej Straży Pożarnej — 22 000 użytkowników przy budżecie projektu 20,3 mln zł. Obejmuje też projekty m.in. dla UKE oraz integrację systemów przy fuzji banków BGŻ i BNP Paribas, a więc tę samą klasę problemu, w której dwa systemy muszą uzgodnić jedną wersję dokumentu.

Doświadczenie zespołu obejmuje również prowadzenie zespołów wdrożeniowych liczących od 5 do 75 osób — w projektach w bankowości, telekomunikacji i administracji publicznej. Ta sama dyscyplina obowiązuje przy integracji fakturowej w małej firmie: jeden właściciel rezultatu, jasny zakres, wyłapane ryzyko, zanim stanie się kosztem.

Checklista gotowości: osiem punktów do sprawdzenia u siebie

Checklista gotowości poniżej ma osiem punktów — odpowiedzi na nie wystarczą, żeby ustalić zakres prac bez zgadywania. Przejdź ją, zanim zamówisz jakąkolwiek wycenę:

1. Czy ERP ma udokumentowane API albo dostęp do bazy z kompletem danych faktury?
2. Które systemy wystawiają dziś dokumenty sprzedaży — ERP, sklep, panel, arkusz?
3. Czy NIP kontrahenta jest polem wymaganym i walidowanym przy zamówieniu?
4. Jak dziś powstaje korekta i kto ją zatwierdza?
5. Czy używasz załączników do faktur — jakich i po co?
6. Kto odpowiada za certyfikat i jego odnowienie, gdy ta osoba jest na urlopie?
7. Co się dzieje z fakturą, gdy wysyłka się nie uda i kto to zobaczy?
8. Kto po Twojej stronie jest właścicielem tego wdrożenia?

Wypełnioną checklistę wyślij formularzem kontaktowym albo na info@primessio.com — odpowiemy punkt po punkcie, wskazując, co u Ciebie jest luką techniczną, a co luką procesową.

Jak prowadzimy takie wdrożenie

Pracujemy fazowo: najpierw rozumiemy cel i procesy, potem dobieramy narzędzia, następnie powstaje koncepcja i wdrożenie, a na końcu obsługa i rozwój rozwiązania. Dane trzymamy w UE, a RODO i bezpieczeństwo wbudowujemy od podstaw — to warunek brzegowy, nie dodatek.

Założyciel Primessio, Dariusz Wtykło, opisuje ten sposób pracy jednym zdaniem: „Jasny zakres na starcie, krótkie cykle i empiryczna weryfikacja każdej zmiany”.

Działamy z Warszawy i obsługujemy firmy ze stolicy oraz całego województwa mazowieckiego — zdalnie i na miejscu, jeśli zakres tego wymaga. Jesteśmy software house’em, który optymalizuje zamiast komplikować: nie dostaniesz od nas sztywnego, „pudełkowego” rozwiązania ani prac bez odpowiedzialności za wynik końcowy. Najpierw rozumiemy biznes, potem technikę.

Masz ERP, sklep albo oba naraz i nie wiesz, gdzie w Twoim procesie powstanie problem z KSeF? Przejdź ośmiopunktową checklistę z tego artykułu i wyślij odpowiedzi formularzem kontaktowym lub na info@primessio.com — odniesiemy się do każdego punktu i pokażemy, co jest luką techniczną, a co procesową. Umów rozmowę: primessio.com/pl/kontakt/

Autor merytoryczny: Dariusz Wtykło, właściciel i CEO Primessio (PRINCE2, Agile, IPMA). Stan artykułu: sierpień 2026. Wymagania KSeF zmieniają się wraz z komunikatami Ministerstwa Finansów — przed decyzją sprawdź aktualną dokumentację na gov.pl/ksef.

Najczęstsze pytania

Czy KSeF wymaga wymiany systemu ERP?

Zwykle nie. Jeśli Twój ERP ma udokumentowane API albo dostęp do bazy, z której da się pobrać komplet danych faktury, integracja jest warstwą nad nim, a nie zastąpieniem go. Wymiana systemu bywa uzasadniona tylko wtedy, gdy ERP nie potrafi w ogóle wyprodukować wymaganej struktury dokumentu ani udostępnić danych — i wtedy jest to osobna decyzja biznesowa, nie konsekwencja samego KSeF.

Czy do faktury w KSeF można dołączyć załącznik?

Faktura ustrukturyzowana przewiduje możliwość przesłania załącznika, ale nie jest to funkcja włączona domyślnie — korzystanie z niej wymaga wcześniejszego zgłoszenia po stronie administracji skarbowej. Po stronie ERP trzeba osobno rozstrzygnąć, co realnie chcesz załączać: specyfikację pozycji, protokół odbioru, zestawienie zużycia. Aktualne warunki publikuje Ministerstwo Finansów na gov.pl/ksef — sprawdź je przed decyzją, bo komunikaty się zmieniają.

Co zrobić, gdy KSeF jest niedostępny?

Do tego służy tryb offline24: faktura powstaje lokalnie, jest wydawana nabywcy z odpowiednim oznaczeniem, a do KSeF trafia po przywróceniu połączenia — w terminie wskazanym przez Ministerstwo Finansów (dla offline24 jest to następny dzień roboczy; stan na sierpień 2026, zweryfikuj aktualny komunikat MF). Po stronie systemu musi istnieć kolejka dokumentów oczekujących, mechanizm ponowień i alert dla człowieka, gdy kolejka rośnie.

Do czego służy certyfikat KSeF?

Certyfikat KSeF jest tym, czym Twój system przedstawia się bramce — to element infrastruktury, nie formalność księgowa. Uwierzytelnienie może opierać się na certyfikacie pobranym w Aplikacji Podatnika KSeF, na pieczęci kwalifikowanej albo na tokenie. Wybór zależy od tego, ile systemów u Ciebie wystawia faktury i kto ma prawo je wystawiać w imieniu firmy.

Jak podłączyć sklep internetowy do KSeF?

Najczęściej wcale nie bezpośrednio. Faktura powinna mieć jedno źródło prawdy — ERP — a sklep dostarcza do niego zamówienie z kompletem danych: NIP, forma płatności, adres, zwroty, korekty. Jeśli sklep wystawia dokumenty równolegle do ERP, powstają dwie numeracje i dwie wersje tej samej sprzedaży. Większość pracy w takim projekcie to poprawienie ścieżki zamówienie → ERP.

Ile trwa integracja z KSeF?

Nie podajemy terminu bez zbadania Twojego środowiska, bo to byłaby liczba wzięta z powietrza. Zakres zależy od liczby systemów wystawiających dokumenty, jakości danych kontrahentów, obecności korekt i faktur do paragonu oraz od tego, czy chcesz używać załączników. Harmonogram ustalamy po przeglądzie tych punktów — na wspólnej rozmowie, nie w cenniku.

Powiązana usługa: Oprogramowanie i systemy IT →

Zobacz też

Oprogramowanie i systemy IT →Strony i sklepy →Zarządzanie projektami →Dedykowane oprogramowanie vs gotowe — kiedy się opłaca? →Sklep internetowy: jaki silnik wybrać (i ile kosztuje wdrożenie) →