Firma z branży produkcyjnej z Mazowsza stanęła w grudniu 2025 roku przed problemem, który staje się coraz powszechniejszy: system ERP wystawiał faktury poprawnie według dotychczasowych standardów, ale po uruchomieniu modułu KSeF pierwsze testy zwróciły blisko 40 błędów walidacyjnych. Termin obowiązkowego wdrożenia zbliżał się nieuchronnie – 1 kwietnia 2026 roku dla wszystkich podatników VAT. Każdy dzień opóźnienia zwiększał ryzyko zakłóceń w fakturowaniu i potencjalnych problemów z odliczeniem podatku naliczonego przez kontrahentów.

Testowanie integracji KSeF to wieloetapowy proces techniczny i prawny. Obejmuje weryfikację zgodności systemu ERP ze schematem FA(3), testy w środowisku przedprodukcyjnym Ministerstwa Finansów oraz walidację przepływu danych przed wejściem mandatu w życie 1 kwietnia 2026 roku. Podstawa prawna obowiązku to artykuł 106na ustawy o VAT. Błędy wykryte przed wdrożeniem nie grożą sankcjami – błędy po wdrożeniu już tak, choć kary obowiązują od 1 stycznia 2027 roku.

Poniżej przedstawiamy cztery etapy tego procesu – od diagnozy technicznej po lekcje, które można zastosować w każdej organizacji. Sprawa pochodzi z naszej praktyki i została zanonimizowana.

Tło sprawy: dlaczego integracja okazała się trudniejsza niż zakładano?

Klient – spółka z o.o. z sektora produkcyjnego – korzystał z popularnego systemu ERP od ponad dziesięciu lat. Moduł fakturowania działał sprawnie. Problem polegał na tym, że FA(3) – obowiązkowy schemat strukturyzowanej faktury KSeF – wymaga pól, których poprzedni standard e-faktury nie przewidywał. Mowa o polach takich jak oznaczenia rodzaju transakcji, kody GTU czy precyzyjne identyfikatory kontrahentów.

Spółka wystawiała miesięcznie około 1 200 faktur. Część trafiała do podmiotów powiązanych, co automatycznie uruchamiało obszar cen transferowych i wymagało dodatkowej weryfikacji poprawności danych identyfikacyjnych. Dostawca systemu ERP dostarczył aktualizację, ale nie przetestował jej na rzeczywistych danych klienta. To klasyczna pułapka: aktualizacja działa w środowisku testowym producenta, ale nie w środowisku konkretnej firmy z jej specyficzną konfiguracją.

W praktyce – wiele firm o tym zapomina – środowisko przedprodukcyjne KSeF udostępnione przez Ministerstwo Finansów pozwala na pełne testy bez ryzyka. Klient nie korzystał z niego wcześniej. To był pierwszy błąd, który kosztował kilka tygodni dodatkowej pracy.

Jakie etapy obejmuje testowanie integracji KSeF?

Testowanie integracji KSeF składa się z czterech wyraźnych etapów. Każdy z nich ma określone cele, narzędzia i potencjalne pułapki. Pominięcie któregokolwiek zwiększa ryzyko błędów już po wejściu mandatu w życie – a od 1 stycznia 2027 roku grożą za to realne kary finansowe.

Etap 1 – audyt danych wyjściowych. Przed uruchomieniem jakichkolwiek testów technicznych należy sprawdzić jakość danych w systemie. Chodzi o kompletność numerów NIP kontrahentów, poprawność oznaczeń GTU, zgodność danych adresowych z KRS. W opisywanej sprawie audyt ujawnił 230 rekordów kontrahentów z brakującym lub nieprawidłowym NIP – dane te nigdy nie były wcześniej weryfikowane systemowo, bo poprzedni standard tego nie wymagał.

Etap 2 – testy w środowisku przedprodukcyjnym MF. Ministerstwo Finansów udostępnia środowisko testowe, które symuluje pełny przepływ dokumentu – od wystawienia przez podatnika, przez walidację schematu FA(3), po nadanie numeru KSeF. Klient przesłał 500 faktur testowych. Spośród nich 38 zostało odrzuconych z powodu błędów walidacyjnych. Najczęstszy problem: nieprawidłowe oznaczenie daty dostawy towaru w przypadku faktur zaliczkowych.

Etap 3 – testy regresyjne po poprawkach. Po każdej korekcie kodu ERP należy powtórzyć testy na całej próbce, nie tylko na fakturach, które wcześniej generowały błędy. Doświadczenie pokazuje, że poprawka jednego pola potrafi nieoczekiwanie wpłynąć na mapowanie innego. W opisywanej sprawie poprawka dotycząca faktur zaliczkowych spowodowała błąd w fakturach korygujących – wykryty dopiero w trzeciej iteracji testów.

Etap 4 – testy akceptacyjne z kontrahentami. Ostatni etap to weryfikacja, czy faktury wystawione przez klienta są prawidłowo odbierane po stronie kontrahentów. Szczególnie istotne w przypadku podmiotów powiązanych, gdzie błąd w danych identyfikacyjnych może wpłynąć na rozliczenia cen transferowych i dokumentację TP. Klient przeprowadził testy z trzema głównymi odbiorcami – w tym z podmiotem zagranicznym, który korzystał z polskiego numeru VAT.

Jak wdrożyć poprawki i co sprawdzić przed startem produkcyjnym?

Proces naprawczy trwał sześć tygodni. W tym czasie zespół techniczny dostawcy ERP, wewnętrzny dział IT klienta i nasz zespół podatkowy pracowali równolegle. Podział ról jest istotny: dostawca ERP odpowiada za kod, dział IT za infrastrukturę i tokeny autoryzacyjne, doradca podatkowy za poprawność interpretacji przepisów i weryfikację, czy dane wyjściowe odpowiadają wymogom art. 106na ustawy o VAT.

Szczególnie skomplikowany okazał się obszar faktur wystawianych przez podmiot powiązany w imieniu klienta – tzw. samofakturowanie. Ten mechanizm podlega dodatkowym ograniczeniom w środowisku KSeF. Więcej o zasadach i ograniczeniach samofakturowania w KSeF można przeczytać w dedykowanym opracowaniu na temat samofakturowania w systemie KSeF.

Przed uruchomieniem środowiska produkcyjnego rekomendujemy sprawdzenie poniższej listy kontrolnej:

  • Weryfikacja tokenów autoryzacyjnych – czy uprawnienia zostały nadane właściwym użytkownikom systemowym
  • Test pełnego cyklu faktury: wystawienie, walidacja, nadanie numeru KSeF, pobranie UPO (Urzędowego Poświadczenia Odbioru)
  • Sprawdzenie obsługi faktur korygujących – schemat FA(3) wymaga innego mapowania niż faktura pierwotna
  • Weryfikacja procedury awaryjnej – co system robi, gdy API KSeF jest niedostępne
  • Potwierdzenie, że faktury dla podmiotów powiązanych zawierają prawidłowe identyfikatory wymagane dla celów cen transferowych

Warto przy tym pamiętać, że integracja z KSeF to nie tylko kwestia techniczna. Każda faktura ustrukturyzowana jest dokumentem podatkowym. Błąd w polu GTU może wpłynąć na prawo do odliczenia VAT po stronie nabywcy. Błąd w identyfikacji kontrahenta może utrudnić kontrolę KAS. Doradca podatkowy Warszawa powinien uczestniczyć w testach od etapu audytu danych – nie dopiero po wystąpieniu problemów.

Firmy wdrażające nowe technologie regulacyjne – takie jak KSeF – mogą też skorzystać z mechanizmu IP Box przy ewentualnym tworzeniu własnych narzędzi do integracji. Jeśli spółka wytwarza oprogramowanie integracyjne we własnym zakresie, warto zweryfikować, czy dochody z tego tytułu kwalifikują się do opodatkowania stawką 5% na podstawie art. 24d–24s ustawy o CIT. Zagadnienie to wykracza poza KSeF, ale wpisuje się w szerszy kontekst optymalizacji podatkowej przy wdrożeniach IT. Analogicznie, firmy korzystające z fundacji rodzinnej jako struktury holdingowej powinny sprawdzić, jak przepływy fakturowe między fundacją a spółkami operacyjnymi będą obsługiwane w KSeF.

Regulacje technologiczne – KSeF, ale też DORA czy AI Act – mają wspólną cechę: wymagają synchronizacji działań prawnych, podatkowych i technicznych. Wdrożenie jednej regulacji często ujawnia luki w innych obszarach. Więcej o harmonogramach wdrożeń regulacji technologicznych można znaleźć w analizie AI Act i harmonogramu wdrożenia dla polskich firm.

Jakie lekcje wynikają z tej sprawy?

Opisywana sprawa dostarcza kilku wniosków, które można bezpośrednio zastosować w każdej organizacji wdrażającej KSeF. Środowisko testowe MF powinno być uruchamiane nie w ostatnich tygodniach przed deadlinem, lecz co najmniej trzy miesiące wcześniej. Testy na rzeczywistych danych – nie na danych syntetycznych dostawcy ERP – ujawniają błędy, których nie widać w środowisku laboratoryjnym.

Drugi wniosek dotyczy podziału odpowiedzialności. Integracja KSeF to projekt wielozespołowy. Brak jasnego podziału ról między IT, księgowością i doradcą podatkowym prowadzi do sytuacji, w której każdy zakłada, że ktoś inny sprawdził krytyczny element. W opisywanej sprawie przez trzy tygodnie nikt nie zweryfikował poprawności tokenów autoryzacyjnych dla kont systemowych – bo IT myślało, że zrobiła to księgowość, a księgowość – że IT.

Trzeci wniosek: kontrola KAS po wejściu mandatu będzie opierać się na danych z KSeF. Każda rozbieżność między fakturą w KSeF a deklaracją JPK_VAT stanie się automatycznym sygnałem do weryfikacji. Dlatego poprawność danych w KSeF ma bezpośrednie przełożenie na ryzyko kontroli podatkowej. Firmy, które zadbają o jakość danych teraz, zmniejszają to ryzyko na lata.

Czwarty wniosek dotyczy procedury awaryjnej. Ustawa przewiduje możliwość wystawiania faktur poza KSeF w przypadku niedostępności systemu – ale tylko przy spełnieniu określonych warunków i z obowiązkiem późniejszego przesłania faktury do KSeF. Brak przetestowanej procedury awaryjnej oznacza, że awaria API w poniedziałek rano paraliżuje fakturowanie całej firmy.

Konkretna sytuacja każdej spółki – jej system ERP, wolumen faktur, struktura kontrahentów, obecność podmiotów powiązanych – wymaga indywidualnej oceny ryzyka. Błędy wykryte po 1 kwietnia 2026 roku mogą mieć nieodwracalne konsekwencje dla rozliczeń VAT i relacji z kontrahentami.

Jeśli Państwa spółka nie zakończyła jeszcze testów integracji KSeF lub napotkała błędy walidacyjne w środowisku przedprodukcyjnym – przeprowadzimy audyt danych, weryfikację mapowania FA(3) i ocenę ryzyka podatkowego: info@kordeckipartners.com.

Często zadawane pytania

P: Ile czasu zajmuje pełne testowanie integracji KSeF dla firmy wystawiającej kilkaset faktur miesięcznie?

O: Przy sprawnie działającym systemie ERP i aktualnej aktualizacji dostawcy – minimum sześć tygodni. Czas ten obejmuje audyt danych wyjściowych, testy w środowisku przedprodukcyjnym Ministerstwa Finansów, iteracje poprawek i testy akceptacyjne z kontrahentami. Firmy z dużą liczbą podmiotów powiązanych lub skomplikowaną strukturą GTU powinny zaplanować osiem do dwunastu tygodni.

P: Czy błędy w KSeF mogą wpłynąć na wynik kontroli KAS?

O: Tak. Powszechnym nieporozumieniem jest przekonanie, że KSeF to wyłącznie kwestia techniczna. Tymczasem dane przesyłane do KSeF będą automatycznie porównywane z deklaracjami JPK_VAT. Rozbieżność – nawet wynikająca z błędu mapowania pola w systemie ERP – może stać się podstawą do wszczęcia czynności sprawdzających przez Krajową Administrację Skarbową. Poprawność merytoryczna faktury w schemacie FA(3) jest tak samo istotna jak poprawność techniczna.

P: Czy firma korzystająca z samofakturowania musi przeprowadzić odrębne testy integracji?

O: Tak, i jest to jeden z bardziej złożonych obszarów wdrożenia KSeF. Samofakturowanie w KSeF wymaga dodatkowych uprawnień i specyficznego mapowania danych – wystawca faktury działa w imieniu sprzedawcy, co musi być odzwierciedlone w schemacie FA(3). Artykuł 106na ustawy o VAT przewiduje ten mechanizm, ale jego techniczna implementacja wymaga osobnych testów, niezależnych od standardowego przepływu faktur wystawianych przez sprzedawcę.

O kancelarii: KORDECKI & Partners to kancelaria prawna z siedzibą w Warszawie i Krakowie, doradzająca klientom biznesowym w 30 jurysdykcjach. Zespół łączy doświadczenie w prawie polskim i międzynarodowym z praktycznym podejściem do wdrożeń KSeF, doradztwa podatkowego i obsługi kontroli KAS. Pracujemy z polskimi przedsiębiorcami, inwestorami zagranicznymi i działami prawnymi korporacji. W sprawie Państwa sytuacji: info@kordeckipartners.com.

Zastrzeżenie: Niniejsza publikacja służy wyłącznie celom informacyjnym i nie stanowi porady prawnej. Informacje zawarte w materiale nie powinny być traktowane jako substytut profesjonalnej porady prawnej dostosowanej do konkretnych okoliczności. KORDECKI & Partners nie ponosi odpowiedzialności za działania podjęte lub zaniechane na podstawie treści tego materiału. W sprawie porady dotyczącej Państwa konkretnej sytuacji prosimy o kontakt: info@kordeckipartners.com.