Firma produkcyjna z Dolnego Śląska odkryła w lutym 2026 roku, że jej system ERP generuje faktury w formacie niezgodnym ze schematem FA(3). Do obowiązkowego KSeF dla wszystkich podatników VAT zostało mniej niż dwa miesiące. Integracja, którą dział IT szacował na tydzień, zajęła ostatecznie cztery tygodnie – i tylko dzięki wcześniej przeprowadzonym testom udało się uniknąć paraliżu sprzedaży.

Testowanie integracji z Krajowym Systemem e-Faktur (KSeF) to etap, który decyduje o tym, czy wdrożenie zakończy się sukcesem przed terminem 1 kwietnia 2026 roku. Obowiązek wystawiania faktur ustrukturyzowanych wynika z artykułu 106na ustawy o VAT. Kary za naruszenia obowiązują od 1 stycznia 2027 roku – ale opóźnienie w wystawieniu faktury oznacza brak możliwości odliczenia VAT przez kontrahenta już od pierwszego dnia mandatu.

Poniższe studium przypadku opisuje trzy etapy procesu: diagnozę środowiska, wykonanie testów i wdrożenie produkcyjne. Każdy etap zawiera konkretne działania, terminy i pułapki, które można przenieść na własną organizację – niezależnie od branży i wielkości firmy.

Tło sprawy – dlaczego testy okazały się niezbędne?

Klient – producent komponentów przemysłowych z Dolnego Śląska – wystawiał miesięcznie około 800 faktur sprzedażowych. Część trafiała do odbiorców krajowych, część do podmiotów powiązanych w ramach grupy. Spółka stosowała samofakturowanie w systemie KSeF, co dodatkowo komplikowało integrację. System ERP był wdrożony pięć lat wcześniej i nie przewidywał pola dla numeru KSeF ani znacznika czasu wymaganego przez schemat FA(3).

Dział finansowy zakładał, że aktualizacja oprogramowania rozwiąże problem automatycznie. W praktyce – wiele firm o tym zapomina – dostawca ERP dostarcza aktualizację, ale konfiguracja pod konkretne procesy biznesowe leży po stronie klienta. Pierwsze wywołanie API środowiska testowego KSeF zwróciło błąd walidacji w 34% faktur. To był sygnał alarmowy.

Spółka skontaktowała się z doradcą podatkowym z Warszawy w połowie lutego 2026 roku. Czas do wejścia obowiązku wynosił 45 dni. Pierwszym krokiem była diagnoza – nie wdrożenie.

Jak przebiegał proces testowania integracji KSeF?

Testowanie podzielono na trzy fazy, każda trwająca około 10 dni roboczych. Faza pierwsza obejmowała mapowanie pól danych. Schemat FA(3) wymaga kilkudziesięciu atrybutów – część z nich nie istniała w dotychczasowej strukturze faktur. Brakujące pola to m.in. kod waluty w formacie ISO 4217, znacznik rodzaju transakcji i numer KSeF dla faktur korygujących.

Faza druga to testy jednostkowe. Każdy typ dokumentu – faktura zwykła, faktura zaliczkowa, korekta, faktura do paragonu – był wysyłany osobno do środowiska testowego Ministerstwa Finansów. Środowisko testowe jest bezpłatne i dostępne pod adresem API wskazanym przez MF. Wyniki walidacji wracają w czasie rzeczywistym z kodem błędu i ścieżką do problematycznego pola XML.

Faza trzecia obejmowała testy obciążeniowe. Spółka wysłała 500 faktur jednocześnie, symulując szczyt sprzedaży końca miesiąca. Czas odpowiedzi API wzrósł do 8 sekund na dokument. Dla 800 faktur miesięcznie to akceptowalne – ale wymagało dostosowania kolejki zadań w ERP, aby nie blokować innych procesów. Cały cykl testów zamknął się w 30 dniach roboczych.

Warto zaznaczyć, że kwestie podatkowe – takie jak prawidłowe stosowanie stawek VAT, ceny transferowe dla transakcji z podmiotami powiązanymi czy kwalifikacja kosztów zgodnie z art. 15 ust. 1 ustawy o CIT – były weryfikowane równolegle z testami technicznymi. Błąd w danych podatkowych na fakturze nie jest błędem integracji, ale może skutkować kontrolą KAS.

Jakie lekcje wynikają z tego wdrożenia?

Pierwsza lekcja: nie ufaj aktualizacji ERP bez własnych testów. Dostawca oprogramowania odpowiada za zgodność ze schematem FA(3), ale nie zna Twoich procesów biznesowych. Samofakturowanie, faktury w walutach obcych, faktury do paragonów – każdy niestandardowy typ dokumentu wymaga osobnego scenariusza testowego.

Druga lekcja: środowisko testowe MF jest bezpłatne – używaj go intensywnie. Firma z regionu Mazowsza, która wdrożyła KSeF w grudniu 2025 roku, przeprowadziła ponad 2 000 wywołań testowych przed przejściem na produkcję. Efekt: zero błędów w pierwszym tygodniu działania na żywo.

Trzecia lekcja: testy to nie tylko IT. Sprawdź, czy Twoja polityka ochrony sygnalistów i procedury wewnętrzne uwzględniają nowe obowiązki związane z KSeF – polityka ochrony sygnalistów powinna obejmować zgłoszenia dotyczące nieprawidłowości w wystawianiu faktur. To wymóg wynikający z ustawy o sygnalistach z 14 czerwca 2024 roku dla firm zatrudniających ponad 50 pracowników.

Czwarta lekcja: zaplanuj czas buforowy. Nawet jeśli testy przebiegają sprawnie, urząd skarbowy lub system MF może być niedostępny przez kilka godzin. Prawo przewiduje tryb awaryjny – fakturę wystawia się offline i przesyła do KSeF w ciągu 1 dnia roboczego od przywrócenia dostępności systemu.

  • Zmapuj wszystkie typy faktur i przypisz do nich scenariusze testowe
  • Uruchom testy w środowisku MF minimum 30 dni przed wdrożeniem produkcyjnym
  • Zweryfikuj pola podatkowe (stawki VAT, NIP, dane kontrahenta) niezależnie od walidacji technicznej
  • Przetestuj tryb awaryjny – offline i ponowne wysłanie do KSeF
  • Udokumentuj wyniki testów na potrzeby ewentualnej kontroli KAS

Często zadawane pytania

P: Czy środowisko testowe KSeF jest identyczne z produkcyjnym?

O: Środowisko testowe MF odwzorowuje schemat FA(3) i logikę walidacji środowiska produkcyjnego, ale nie generuje numerów KSeF mających skutki prawne. Faktury wysłane testowo nie są widoczne dla urzędu skarbowego ani kontrahentów. Zalecamy przeprowadzenie co najmniej 100 wywołań testowych przed przejściem na produkcję – obejmujących wszystkie typy dokumentów stosowanych w firmie.

P: Czy błędy w testach mogą skutkować karą?

O: Błędy popełnione wyłącznie w środowisku testowym nie rodzą żadnych konsekwencji prawnych ani podatkowych. Kary, o których mowa w przepisach ustawy o VAT, dotyczą wyłącznie faktur wystawianych po 1 stycznia 2027 roku w środowisku produkcyjnym – bez zachowania wymaganego formatu FA(3). Środowisko testowe istnieje właśnie po to, aby eliminować błędy przed tym terminem.

P: Jak długo powinno trwać testowanie integracji dla małej firmy wystawiającej 50 faktur miesięcznie?

O: Dla małego podatnika VAT wystawiającego standardowe faktury sprzedażowe w jednej walucie, bez samofakturowania i bez transakcji z podmiotami powiązanymi, wystarczy 10–14 dni roboczych testów. Obejmuje to mapowanie pól, testy jednostkowe dla każdego typu dokumentu i co najmniej jeden test obciążeniowy. Doradca podatkowy z Warszawy specjalizujący się we wdrożeniach KSeF może skrócić ten czas o połowę dzięki gotowym listom kontrolnym.

Konkretna sytuacja Państwa firmy – liczba typów faktur, stopień złożoności procesów, powiązania kapitałowe wymagające weryfikacji cen transferowych czy korzystanie z ulgi IP Box – wymaga indywidualnej oceny. Opóźnienie wdrożenia KSeF to nieodwracalna utrata możliwości odliczenia VAT przez Państwa kontrahentów od pierwszego dnia obowiązku.

Jeśli Państwa spółka nie zakończyła jeszcze testów integracji KSeF lub napotkała błędy walidacji FA(3) – przeprowadzimy audyt środowiska, zidentyfikujemy przyczyny błędów i wdrożymy poprawki przed terminem 1 kwietnia 2026 roku: info@kordeckipartners.com.

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 CIT, kontroli KAS oraz sporów podatkowych przed WSA i NSA. 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.