Testy integracji KSeF

Testy KSeF to sprawdzenie, czy Wasz ERP, system fakturowy albo system bankowy rozmawia z Krajowym Systemem e-Faktur tak, jak wymaga tego Ministerstwo Finansów: przy każdej fakturze, każdej korekcie, każdej awarii po stronie MF i każdej zmianie wersji API. Robimy testy integracji KSeF i automatyczną regresję, która pilnuje tej integracji po każdym wydaniu, zanim błąd zobaczy księgowość, kontrahent albo urząd skarbowy.

Termin, który warto mieć w kalendarzu, to 1 stycznia 2027 roku. Od tego dnia KSeF jest obowiązkowy dla wszystkich przedsiębiorców, także najmniejszych, a obowiązek podawania numeru KSeF przy płatności przestaje być odroczony (terminy KSeF na ksef.podatki.gov.pl). Dlatego testy KSeF nie kończą się na wdrożeniu: to początek życia z integracją, która musi działać codziennie.

Liczby faktur i wystawców pochodzą z danych Ministerstwa Finansów przekazanych mediom (Portal Spożywczy, dane MF). Przy takiej skali jeden błąd w mapowaniu pola nie jest usterką, tylko setkami odrzuconych dokumentów dziennie.

Zakres dobieramy do tego, gdzie jest Wasza integracja: w module ERP, w osobnej bramce do KSeF, w systemie bankowym albo w kilku miejscach naraz. Testy KSeF obejmują najczęściej osiem obszarów.

Schemat XML i walidacja. Czy każda faktura, którą generuje Wasz system, przechodzi walidację struktury FA, także te nietypowe: zaliczkowe, marża, waluty, wiele stawek VAT, długie opisy pozycji

Różnice między środowiskiem testowym a produkcyjnym MF. To, że integracja przeszła testy na środowisku testowym, nie znaczy, że zachowa się tak samo na produkcji. Porównujemy odpowiedzi, limity i komunikaty błędów obu środowisk

Tryby awaryjne i offline. Co robi Wasz system, gdy KSeF odpowiada HTTP 503 albo nie odpowiada w ogóle. Testujemy tryb offline24, niedostępność systemu i awarię całkowitą, kolejkowanie i ponowną wysyłkę bez dubli

Korekty. Faktury w KSeF nie da się edytować ani usunąć, błąd poprawia się wyłącznie fakturą korygującą (pytania i odpowiedzi MF). Sprawdzamy korekty do faktur z różnych okresów, korekty zbiorcze i powiązanie z numerem KSeF faktury pierwotnej

Pełnomocnictwa i uprawnienia. Kto w Waszej organizacji i w biurze rachunkowym może wystawiać, pobierać i przeglądać faktury, co się dzieje po zmianie osoby albo wygaśnięciu certyfikatu, czy nikt nie widzi więcej, niż powinien

Wydajność przy wolumenie. Wysyłka wsadowa na koniec miesiąca, pobieranie faktur zakupowych, limity po stronie API. Tu wchodzą nasze testy wydajności

Automatyzacja regresji API w CI. Zestaw testów, który uruchamia się przy każdej zmianie Waszego kodu i przy każdej zmianie po stronie MF. Budujemy go w ramach automatyzacji testów API i wpinamy w pipeline CI/CD

Monitoring po starcie. Testy syntetyczne, które co kilka minut sprawdzają, czy wysyłka i odbiór faktur działa, zanim zgłosi to dział finansów

Poza samą bramką testy KSeF obejmują procesy wokół niej: numer KSeF w module płatności, zgodność z raportowaniem JPK_VAT, które od lutego 2026 roku zawiera numer faktury z KSeF (Portal FK), i przepływ faktury zakupowej od pobrania z KSeF do zaksięgowania.

Po starcie obowiązku firmy i biura rachunkowe zgłaszają powtarzalne problemy: odrzucenia faktur przez błędy struktury XML, niezgodność ze wzorem, rozbieżności między środowiskiem testowym a produkcyjnym MF, awarie ERP, kłopoty z pełnomocnictwami, błędne korekty i faktury wystawione na przełomie miesięcy (eGospodarka, Amavat). Awaria po stronie API wygląda zwykle prozaicznie: HTTP 503 albo timeout po 30 sekundach (Kluczesoft).

Każdy z tych problemów wyłapią dobrze zaprojektowane testy KSeF, zanim trafi na produkcję. Dlatego tak naprawdę pytanie nie brzmi „czy KSeF działa”, tylko „czy nasza integracja działa po ostatniej zmianie”.

Kalendarz: terminy, które wyznaczają testy KSeF

KSeF kary 2027: co wiadomo na dziś

Według obecnych przepisów kary pieniężne za błędy w stosowaniu KSeF mają być nakładane od 1 stycznia 2027 roku. Naczelnik urzędu skarbowego może nałożyć karę do 100 procent kwoty podatku wykazanego na fakturze, a przy fakturze bez podatku do 18,7 procent kwoty należności ogółem (pytania i odpowiedzi MF). 16 września 2026 roku Ministerstwo Finansów zapowiedziało przedłużenie odroczenia kar do 31 grudnia 2027 roku i rozpoczęło prace nad projektem ustawy (komunikat Krajowej Informacji Skarbowej). Resort pisze wprost, że odroczenie kar nie oznacza braku obowiązku stosowania KSeF.

Dla zespołu IT wniosek jest prosty: termin kar może się przesunąć, termin obowiązku nie, więc testy KSeF warto zrobić teraz. Faktura odrzucona w styczniu 2027 roku to nadal faktura, której kontrahent nie dostał, i przelew, który nie przyszedł.

Jesteście software house’em albo dostawcą ERP i Wasz moduł KSeF działa u dziesiątek albo setek klientów, więc jeden błąd w wydaniu mnoży się przez całą bazę

Jesteście integratorem, a integracja KSeF z ERP (SAP, Oracle, Comarch albo system własny) to Wasz projekt, za który odpowiadacie przed klientem

Jesteście bankiem albo dostawcą systemów płatności, a numer KSeF w płatnościach od 2027 roku zmienia dane, które przechodzą przez Wasze systemy przelewów i płatności masowych

Jesteście dużą firmą z własną integracją, a po starcie w lutym albo kwietniu zostało kilka obejść, które działają, dopóki nikt ich nie dotyka

Obsługujecie mikrofirmy, które od 2027 roku wchodzą do KSeF w całości, i spodziewacie się fali nowych użytkowników

Nie macie automatycznej regresji integracji i każda zmiana po stronie MF oznacza ręczne sprawdzanie przez kilka osób

Zajmujemy się wyłącznie testowaniem i jakością oprogramowania. Nie sprzedajemy ERP ani bramki do KSeF, więc testy KSeF robimy bez oceniania własnego produktu. To ma znaczenie, gdy wynik testu ma przekonać zarząd albo klienta

Automatyzacja testów API to nasza codzienność. Zespół Quality Island napisał ponad 450 000 testów automatycznych. Integracja z KSeF to z punktu widzenia testera API z dobrze opisanym kontraktem, tylko ze stawką wyższą niż zwykle

Umiemy skracać regresję. U Argos, w e-commerce, regresja przed wydaniem skróciła się z 5 dni do 10 godzin dzięki automatyzacji i uporządkowaniu procesów QA. Jak to wyglądało, opisujemy w case study Argos

Znamy sektor regulowany. Dla PKO BP przygotowaliśmy i wdrożyliśmy strategię jakości oprogramowania dla całej organizacji. Wiemy, że w banku test bez dokumentacji to test, którego nie było

Zaufało nam ponad 100 firm, w tym Asseco Group, Billennium, VSoft, ITEO, Pekao SA, Santander i BNP Paribas. Za nami ponad 152 zrealizowane projekty, a zespół ma certyfikaty ISTQB

Uczymy tego, co robimy. Po projekcie Wasz zespół może przejąć testy. Prowadzimy szkolenie REST Assured: testy integracyjne API, z którego korzystał między innymi Centralny Ośrodek Informatyki, oraz wprowadzenie do testowania API w Postmanie

Testy KSeF możecie zamówić w całości albo w części.

Listę realnych ryzyk w Waszej integracji, uporządkowaną według tego, ile kosztuje błąd, a nie według tego, co łatwo przetestować

Zestaw automatycznych testów regresji API, który zostaje u Was i działa w Waszym pipeline

Dokumentację, że testy KSeF zostały wykonane, gotową dla zarządu, audytora albo klienta, który pyta, czy Wasz moduł jest sprawdzony

Scenariusze awaryjne przećwiczone przed awarią, a nie w trakcie

Nie obiecujemy liczby błędów, której jeszcze nie znamy. Testy KSeF kończą się konkretnymi produktami pracy i jasnym obrazem sytuacji.

Szkolenie zespołu z testów API możecie sfinansować z dofinansowania. Jeśli Wasza firma się kwalifikuje, obsługę wniosku bierzemy na siebie bez dodatkowej opłaty, szczegóły na stronie dofinansowania i rabaty. Wolicie stały zespół testerów zamiast projektu? Zobaczcie modele współpracy.

Automatyzacja testów API

Testy regresyjne

Testy wydajności

Zgodność regulacyjna: testy pod wymogi prawne

Testy end to end

Testy regresyjne: rodzaje i jak skrócić regresję z dni do godzin

Testowanie API dla początkujących

Szkolenie: REST Assured, testy integracyjne API dla testerów