Na papierze integracja systemu ERP z KSeF wygląda prosto: podłącz API, wyślij fakturę, odbierz numer referencyjny. W praktyce – wiele firm odkrywa dopiero w trakcie testów, że ich dane podstawowe są niekompletne, schematy numeracji faktur nie pasują do formatu FA(3), a środowisko produkcyjne zachowuje się inaczej niż demo. Czas na odkrycie tych błędów kończy się 1 kwietnia 2026 r.

Testowanie integracji KSeF to obowiązkowy etap wdrożenia Krajowego Systemu e-Faktur przed uruchomieniem produkcyjnym. Podstawą prawną obowiązku jest artykuł 106na ustawy o VAT, który nakłada na podatników VAT obowiązek wystawiania faktur ustrukturyzowanych w formacie FA(3). Termin dla podatników z obrotem powyżej 200 mln PLN w 2024 r. to 1 lutego 2026 r. Dla pozostałych podatników VAT – 1 kwietnia 2026 r.

Ten alert wyjaśnia, co konkretnie należy przetestować, jakie środowiska udostępnia Ministerstwo Finansów i które błędy najczęściej blokują przejście do produkcji. Omawia też, kto powinien zaangażować się w proces – dział IT, księgowość czy zewnętrzny doradca podatkowy Warszawa.

Co się zmieniło i kogo dotyczy obowiązek KSeF?

Obowiązek wystawiania faktur ustrukturyzowanych przez KSeF dotyczy wszystkich podatników VAT czynnych zarejestrowanych w Polsce. Ministerstwo Finansów udostępniło środowisko testowe (demo) oraz przedprodukcyjne (pre-prod), które pozwalają weryfikować integrację przed uruchomieniem na żywych danych. Kontrola KAS może sprawdzić, czy podatnik podjął działania wdrożeniowe – brak dokumentacji testów to ryzyko, które warto eliminować z wyprzedzeniem.

Progi są następujące. Podatnicy, których obrót w 2024 r. przekroczył 200 mln PLN, muszą wystawiać faktury przez KSeF od 1 lutego 2026 r. Pozostałe podmioty – od 1 kwietnia 2026 r. Kary za naruszenia wchodzą w życie od 1 stycznia 2027 r., co daje rok na dostosowanie po uruchomieniu obowiązku. Ten rok nie jest jednak buforem na testy – to czas na dopracowanie procesów już działającego systemu.

Warto pamiętać, że mikroprzedsiębiorcy z miesięcznym obrotem poniżej 10 000 PLN są zwolnieni z obowiązku do 1 stycznia 2027 r. Dla fundacji rodzinnych wystawiających faktury VAT obowiązek stosuje się na zasadach ogólnych. Ceny transferowe i dokumentacja TP nie są bezpośrednio powiązane z KSeF, ale faktury KSeF będą stanowić dowód w kontrolach KAS dotyczących transakcji wewnątrzgrupowych.

Spółka produkcyjna z Mazowsza, testująca integrację jesienią 2025 r., wykryła, że jej system ERP generował pole „nabywca" bez obowiązkowego numeru NIP w formacie akceptowanym przez FA(3). Poprawka wymagała 6 tygodni prac programistycznych. Bez testów błąd ujawniłby się dopiero przy pierwszej fakturze produkcyjnej.

Jak przebiega testowanie integracji KSeF krok po kroku?

Testowanie integracji KSeF składa się z czterech etapów. Każdy etap wymaga udokumentowania wyników – to ważne zarówno dla wewnętrznego audytu, jak i dla ewentualnej kontroli KAS. Schemat FA(3) jest publicznie dostępny w repozytorium Ministerstwa Finansów i stanowi punkt wyjścia do każdego testu.

Etap 1 – środowisko demo. Ministerstwo Finansów udostępnia środowisko demo bez uwierzytelnienia tokenem produkcyjnym. Można tu wysyłać faktury testowe i sprawdzać, czy format FA(3) jest poprawnie generowany przez system ERP. Błędy walidacji schematu XSD są widoczne natychmiast. To etap dla działu IT – bez udziału księgowości.

Etap 2 – środowisko pre-prod. Środowisko przedprodukcyjne wymaga już uwierzytelnienia tokenem testowym. Tutaj testuje się pełny przepływ: wystawienie faktury, odebranie numeru KSeF, pobranie faktury przez nabywcę. Czas odpowiedzi API w pre-prod bywa dłuższy niż w produkcji – nie należy tego traktować jako normy. Doradca podatkowy Warszawa powinien na tym etapie zweryfikować poprawność danych podatkowych w strukturze FA(3).

Etap 3 – testy akceptacyjne UAT. Użytkownicy końcowi – księgowi, pracownicy działu sprzedaży – testują faktury w warunkach zbliżonych do produkcyjnych. Sprawdzane są scenariusze brzegowe: faktury korygujące, zaliczkowe, do paragonów. IP Box i inne ulgi podatkowe nie wpływają na strukturę faktury KSeF, ale dane dotyczące stawki VAT muszą być precyzyjne.

Etap 4 – testy równoległe. Przez minimum 30 dni przed uruchomieniem produkcyjnym warto wystawiać faktury równolegle – tradycyjnie i przez KSeF. Pozwala to wykryć rozbieżności w numeracji i archiwizacji. Środowisko produkcyjne KSeF wymaga tokenu produkcyjnego, który wydawany jest przez Ministerstwo Finansów po złożeniu wniosku.

  • Pobierz aktualny schemat FA(3) z repozytorium MF i zweryfikuj mapowanie pól w ERP
  • Uzyskaj token testowy i przetestuj pełny przepływ w środowisku pre-prod
  • Przeprowadź testy UAT z udziałem księgowości – minimum 50 faktur testowych różnych typów
  • Udokumentuj wyniki testów i zachowaj logi błędów
  • Złóż wniosek o token produkcyjny z minimum 4-tygodniowym wyprzedzeniem

Firma IT z Małopolski, wdrażająca KSeF latem 2025 r., odkryła podczas testów UAT, że faktury korygujące do faktur zaliczkowych wymagają odrębnego mapowania pola „przyczyna korekty". Bez tego etapu testów błąd trafiłby bezpośrednio do systemu produkcyjnego MF.

Konkretna sytuacja Państwa firmy – liczba systemów ERP, rodzaje wystawianych faktur, struktura grup VAT – decyduje o złożoności testów. Pominięcie któregokolwiek etapu może prowadzić do nieodwracalnych błędów w numeracji faktur produkcyjnych, których korekta wymaga kontaktu z KAS. Szczegółowe informacje o wymogach regulacyjnych dla podmiotów finansowych znajdą Państwo w materiale o DORA – kto musi wdrożyć i do kiedy.

Jeśli Państwa spółka nie zakończyła jeszcze etapu testów pre-prod lub zbliża się termin 1 kwietnia 2026 r. – przeprowadzimy audyt gotowości KSeF, weryfikację struktury FA(3) i wsparcie w kontaktach z MF: info@kordeckipartners.com.

Często zadawane pytania

P: Czy środowisko testowe KSeF jest bezpłatne i jak uzyskać do niego dostęp?

O: Tak, środowisko demo i pre-prod są bezpłatne. Dostęp do środowiska demo nie wymaga rejestracji – wystarczy pobrać schemat FA(3) i korzystać z publicznego endpointu API Ministerstwa Finansów. Środowisko pre-prod wymaga złożenia wniosku o token testowy przez bramkę e-PUAP lub bezpośrednio przez portal podatki.gov.pl. Czas oczekiwania na token testowy wynosi zazwyczaj od 5 do 10 dni roboczych.

P: Czy brak testów KSeF przed uruchomieniem grozi karą finansową?

O: Przepisy nie przewidują kary bezpośrednio za brak testów. Kary – obowiązujące od 1 stycznia 2027 r. – dotyczą wystawiania faktur z naruszeniem obowiązku KSeF lub wystawiania faktur niezgodnych ze schematem FA(3). W praktyce jednak brak testów zwiększa ryzyko błędów w produkcji, które mogą skutkować właśnie takimi naruszeniami. Kontrola KAS może też oceniać staranność podatnika przy wdrożeniu jako okoliczność łagodzącą lub obciążającą.

P: Czy doradca podatkowy musi uczestniczyć w testach technicznych KSeF?

O: Testy techniczne na poziomie schematu XSD i API to zadanie dla działu IT lub dostawcy ERP. Jednak weryfikacja poprawności danych podatkowych w strukturze FA(3) – stawki VAT, numery NIP, oznaczenia GTU, dane nabywcy i sprzedawcy – wymaga udziału doradcy podatkowego lub doświadczonego głównego księgowego. Błąd w danych podatkowych na etapie testów jest tani do naprawienia. Ten sam błąd w środowisku produkcyjnym może wymagać wystawienia faktur korygujących i wyjaśnień wobec KAS.

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 VAT 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.