KSeF 2026: do końca roku bez kar. Potem błędy zaczynają kosztować

Co się zmienia 1 lutego 2026: w trzech zdaniach

Wszystkie faktury B2B w Polsce muszą trafiać do centralnego systemu Ministerstwa Finansów (KSeF) przez API. Twoja faktura PDF wysłana mailem nie jest fakturą prawną dopóki nie pojawi się w KSeF z numerem KSeF (UID). Klient B2B nie ma prawa odebrać faktury, której nie ma w KSeF, nie odliczy VAT-u i może odrzucić płatność.

Kto musi się wpiąć (i kiedy)

• Firmy, które w 2024 miały sprzedaż powyżej 200 mln zł (z VAT): od 1 lutego 2026.
• Pozostałe firmy: od 1 kwietnia 2026. Do 31 grudnia 2026 można jeszcze wystawiać faktury poza KSeF, jeśli ich suma z VAT w danym miesiącu nie przekracza 10 000 zł; od 1 stycznia 2027 ten wyjątek znika.
• Faktury B2C (do osoby fizycznej): nadal poza KSeF, można wystawiać tradycyjnie.
• Faktury międzynarodowe / eksport: KSeF nieobowiązkowy, ale można dobrowolnie.

Co dokładnie robi KSeF API

KSeF to nie jest aplikacja w którą się logujesz i klikasz "wystaw fakturę". To zewnętrzny system, do którego Twój ERP / księgowa wysyła ustrukturyzowany plik XML (format FA(3)). KSeF go waliduje, przydziela unikalny numer KSeF i archiwizuje na 10 lat. Klient odbiorca dostaje fakturę bezpośrednio z KSeF. Ty wystawiasz, on odbiera, Urząd widzi w czasie rzeczywistym.

Od 1 lutego 2026 faktury w KSeF wystawia się w strukturze FA(3), która zastąpiła FA(2) (Ministerstwo Finansów, ksef.podatki.gov.pl, odczyt 24.09.2026). Jeśli Twój program albo integracja generuje jeszcze plik według starej struktury, to pierwsza rzecz do sprawdzenia u dostawcy.

Flow techniczny: 4 kroki

1. Twój ERP generuje fakturę XML w formacie FA(3) (struktura zdefiniowana przez MF).
2. ERP autoryzuje się w KSeF tokenem (certyfikat kwalifikowany lub Token API z e-Urząd).
3. POST /api/online/Session/InitSigned + POST /api/online/Invoice/Send. XML trafia do KSeF.
4. KSeF zwraca status (Accepted / Rejected) + numer KSeF. Ten numer ZASTĘPUJE Twój numer faktury.

Co musisz zrobić w swoim ERP

Każdy popularny polski ERP ma już moduł KSeF albo pracuje nad nim, ale wersje i sposób rozliczenia różnią się między producentami: u jednych to funkcja w podstawie, u innych płatny dodatek do konkretnej wersji programu. Nie przepisuję tu numerów wersji ani cen licencji, bo zmieniają się szybciej niż ten wpis. Zadzwoń do swojego dostawcy ERP i zapytaj o trzy rzeczy: od której wersji jest KSeF, ile kosztuje dodatek i czy obsługuje faktury spoza tego programu.

Subiekt GT: czego potrzebujesz

• Subiekt GT v1.81+ (sprawdź "Pomoc → O programie")
• Moduł KSeF dla Subiekt (zakupujesz osobno u insERT lub partnera)
• Certyfikat kwalifikowany lub Token e-Urzędu firmy
• Konto testowe na ksef-test.mf.gov.pl (do testów przed produkcją)

Comarch: czego potrzebujesz

• Comarch ERP XL 2024.0+ lub Optima 2025.4+
• Modul "Faktury elektroniczne KSeF" aktywowany w licencji
• Token dostępu KSeF (jednorazowa konfiguracja w Konfiguracji → KSeF)
• Mapowanie pól (NIP, JPK_FA, kody GTU): sprawdź czy dane klientów są kompletne

Kiedy potrzebna jest automatyzacja (i kiedy nie)

Jeśli wystawiasz do 50 faktur miesięcznie i wszystkie są w ERP, moduł natywny wystarczy. Klikasz w Subiekt "wyślij do KSeF", on robi POST i odbiera UID. Koniec. Problem zaczyna się gdy faktury są wystawiane w wielu miejscach:

• Sklep Shopify / WooCommerce wystawia faktury proforma dla klientów B2B
• BaseLinker generuje paragony/faktury dla Allegro
• Subiekt obsługuje hurt + sklep stacjonarny
• Księgowa zewnętrzna wystawia faktury dla niektórych klientów ręcznie

W takim setupie każde z tych źródeł musi się komunikować z KSeF: albo każde osobno (4 integracje), albo wszystkie przez wspólny hub. Hub-and-spoke (jeden centralny middleware → KSeF) jest tańsze, łatwiejsze do debugowania i nie wymaga zmian w każdym systemie osobno.

Architektura: n8n jako hub dla KSeF

Najczęstszy setup który wdrażam dla klientów z 200+ fakturami/mc: workflow w n8n nasłuchuje na webhooki z każdego źródła (Shopify, Subiekt, BaseLinker), normalizuje dane do struktury FA(3), strzela do KSeF API, zapisuje UID z powrotem w źródłowym systemie. Wszystko w 6 sekund.

Konkretny flow: przykład hurtowni

1. Klient B2B składa zamówienie na sklepie Shopify (15 000 zł netto).
2. Shopify wysyła webhook order.created do n8n.
3. n8n walidate NIP przez API GUS (REGON), dopisuje dane do CRM Laravel.
4. n8n generuje XML FA(3) z templatu (dane firmy, klient, pozycje, kwoty, GTU).
5. n8n autoryzuje się w KSeF tokenem, POST /Invoice/Send.
6. KSeF zwraca status + UID (np. "20260514-12345-ABC123-FF").
7. n8n zapisuje UID w Subiekt GT (przez insERT API) i w Shopify order metafields.
8. Klient dostaje mail z linkiem do faktury w KSeF + numer UID do księgowości.

Co się dzieje gdy KSeF padnie (i tak, czasem pada)

Ministerstwo Finansów przewidziało "tryb offline", gdy KSeF jest niedostępny (zaplanowane przerwy techniczne lub awaria), masz prawo wystawić fakturę offline z czasowym numerem i przesłać ją do KSeF w ciągu 7 dni roboczych po przywróceniu serwisu. W praktyce: Twój workflow musi mieć fallback queue (np. Redis lub PostgreSQL), który łapie nieprzesłane faktury i retry po przywróceniu połączenia.

Realne koszty wdrożenia, bez waterglasów

Koszt zależy od liczby źródeł faktur i od tego, czy Twój program ma już moduł KSeF. Poniżej lista pozycji, o które warto zapytać, zanim ustawisz budżet. Kwoty sprawdzaj u swojego dostawcy ERP, bo zmieniają się z wersją programu.

• Moduł KSeF do Twojego ERP: opłata licencyjna producenta, sprawdź w cenniku swojego programu
• Certyfikat kwalifikowany, jeśli go nie masz: opłata roczna u wystawcy
• Wdrożenie modułu natywnego i szkolenie: zwykle partner producenta Twojego programu
• Integracja kilku źródeł faktur (sklep, marketplace, własny system): wycena po rozmowie i rozpisaniu zakresu
• Infrastruktura pod automatyzacje (n8n, monitoring): serwer w UE, koszt miesięczny po stronie firmy

Przy jednym źródle faktur wpięcie w KSeF zwykle zamyka się w dwóch tygodniach, przy kilku źródłach naraz (ERP plus sklep plus marketplace) w trzech do czterech. Cenę podaję po rozmowie i rozpisaniu zakresu, na piśmie, nie z tabelki.

Czego dostawca ERP Ci nie powie

• Moduł natywny obsługuje TYLKO faktury z tego ERP. Faktury z Shopify, BaseLinker, Allegro: pomijane.
• Mapping NIP do KSeF wymaga aktualizacji bazy klientów. Nie podam Ci tu procentu, bo zależy od tego, jak długo baza rosła i ilu ludzi ją uzupełniało. Policz to u siebie jednym zapytaniem: ile kontrahentów ma pusty kraj, pusty kod pocztowy albo NIP w formacie z myślnikami. Ta liczba, a nie średnia z internetu, mówi, ile pracy jest przed Tobą.
• Format FA(3) jest sztywny: pola opcjonalne w starym formacie są tu wymagane (np. kod GTU dla niektórych branż).
• Faktury korygujące w KSeF mają inny flow niż zwykłe: potrzebny osobny endpoint i osobna logika.
• Wystawienie błędnej faktury w KSeF NIE jest cofalne. Korekta = nowa faktura korygująca z odwołaniem do UID oryginału.

Checklist: czy jesteś gotowy

1. Czy znasz aktualny status modułu KSeF w swoim ERP? (Zadzwoń do dostawcy)
2. Czy masz certyfikat kwalifikowany lub Token e-Urzędu? Jeśli nie, wyrobienie trwa 5 do 10 dni roboczych.
3. Czy Twoja baza klientów ma kompletne dane (pełny NIP, kraj, kod pocztowy)?
4. Czy wiesz ile masz źródeł wystawiających faktury? (ERP, sklep online, BaseLinker, marketplace, ręcznie)
5. Czy masz plan B na awarię KSeF? (Fallback queue, monitoring, alerty)
6. Czy księgowa była przeszkolona z korekt w KSeF i obsługi statusów (Accepted / Rejected / Processing)?

Najczęstsze błędy w pierwszych miesiącach

• "Rejected: invalid GTU code": produkty z branży medycznej, alkoholowej, IT mają wymagane kody GTU. Wpisz je w karcie produktu w ERP.
• "Rejected: invalid NIP format". KSeF wymaga 10 cyfr bez myślników. Stare karty klientów często mają "522-300-13-91".
• "Timeout": KSeF czasem zwraca timeout przy peak hours. Implementacja retry z exponential backoff (3 próby, 2s/8s/30s).
• Faktura wystawiona przez 2 systemy jednocześnie (Shopify wysłał i Subiekt też → duplikat). Lock na zamówieniu w bazie middleware.
• Brak archiwizacji UID po stronie klienta: przy reklamacjach księgowa nie wie który UID był na pierwotnej fakturze.

Co dalej: od jutra

Jeśli jeszcze nie zacząłeś, pierwsze 3 kroki: (1) Zadzwoń do dostawcy ERP i zapytaj o moduł KSeF: wersja, cena, dostępność. (2) Sprawdź w bazie klientów ile pozycji ma niepełne dane (NIP/kraj/kod). (3) Policz ile masz źródeł wystawiających faktury. Jeśli więcej niż 2, rozważ hub-and-spoke zamiast 4 osobnych integracji.

FAQ: najczęstsze pytania