KSeF Krajowy System e-Faktur Obowiązkowy Luty 2026: Wdrożenie, Zgodność i Integracja E-Commerce

Czym jest KSeF — Krajowy System e-Faktur

Szanowny Panie i Pani Sprzedawco, niewiele jest zmian w polskim prawie podatkowym tak fundamentalnych jak wprowadzenie KSeF. Krajowy System e-Faktur to scentralizowana platforma teleinformatyczna prowadzona przez Szefa Krajowej Administracji Skarbowej, służąca do wystawiania, otrzymywania, przechowywania i przesyłania faktur ustrukturyzowanych. System został uruchomiony jako dobrowolny już 1 stycznia 2022 roku, jednak prawdziwa rewolucja dokonuje się dopiero w 2026 roku, kiedy KSeF staje się obowiązkowy dla podatników VAT.

Podstawą prawną KSeF jest ustawa z dnia 29 października 2021 r. o zmianie ustawy o podatku od towarów i usług oraz niektórych innych ustaw (Dz.U. 2021 poz. 2076), znowelizowana następnie ustawą z 2024 roku przesuwającą termin wdrożenia obowiązkowego. Decyzja wykonawcza Rady UE z 17 czerwca 2022 r. zezwoliła Polsce na odstępstwo od dyrektywy 2006/112/WE — co było warunkiem prawnym wprowadzenia obowiązkowego e-fakturowania.

W praktyce KSeF działa jak krajowy hub fakturowy: zamiast wysyłać fakturę PDF e-mailem do kontrahenta, sprzedawca przesyła ustrukturyzowany plik XML do KSeF, system go waliduje, nadaje unikalny numer i udostępnia odbiorcy. Cały obieg jest udokumentowany przez Ministerstwo Finansów w czasie rzeczywistym, co eliminuje fikcję faktur, przyspiesza zwrot VAT i zamyka większość luk uszczelnienia.

KSeF a tradycyjna faktura papierowa i PDF

Trzeba wyraźnie odróżnić trzy formy dokumentu sprzedaży:

• Faktura papierowa — drukowana, wręczana lub wysyłana pocztą. Po 1 kwietnia 2026 dopuszczalna tylko w wyjątkowych sytuacjach (awaria KSeF, fakturowanie B2C poza systemem, transakcje wyłączone z obowiązku).
• Faktura elektroniczna (PDF, e-mail) — dotychczasowa forma popularna w e-commerce. Po wejściu KSeF traci moc faktury w obrocie B2B — może być najwyżej wizualizacją PDF generowaną z KSeF.
• Faktura ustrukturyzowana (KSeF) — XML w schemacie FA(2) przesłany do KSeF. Jedyna prawnie wiążąca forma faktury B2B od 2026.

Korzyści KSeF dla sprzedawcy e-commerce

Mimo że obowiązek bywa odbierany jako uciążliwość, KSeF niesie wymierne korzyści: skrócenie zwrotu VAT z 60 do 40 dni, wyeliminowanie potwierdzenia odbioru korekty in minus, archiwizacja 10-letnia po stronie MF, brak ryzyka utraty faktury (UPO jest dowodem prawnym), oraz docelowo automatyczne zasilanie JPK_V7M.

Harmonogram wdrożenia KSeF 2026/2027

Po kilku przesunięciach Ministerstwo Finansów ustaliło ostateczny harmonogram wejścia w życie obowiązku KSeF. Termin został zróżnicowany w zależności od skali działalności podatnika, co ma zapewnić płynne przejście dla mniejszych firm.

Co oznacza „duży podatnik" w rozumieniu KSeF

Status dużego podatnika w kontekście KSeF określa się wartością sprzedaży brutto za rok 2024. Próg 200 mln zł obejmuje całość obrotu — nie tylko sprzedaż opodatkowaną, ale również zwolnioną przedmiotowo. Lista podatników objętych pierwszym etapem nie jest publikowana — każdy podatnik sam musi zweryfikować swój status na podstawie deklaracji VAT-7/V-7M za rok 2024 lub bilansu rocznego.

Dla typowego sklepu internetowego z obrotem 10–50 mln zł oznacza to, że start nastąpi 1 kwietnia 2026, a nie 1 lutego. Daje to dodatkowe dwa miesiące na wdrożenie integracji KSeF, testy na środowisku produkcyjnym i przeszkolenie zespołu obsługi zamówień.

Schemat FA(2) — Anatomia faktury ustrukturyzowanej

Struktura dokumentu XML

FA(2) to drugi (i obecnie obowiązujący) schemat XSD opublikowany przez Ministerstwo Finansów. Definiuje on dokładną strukturę pliku XML, który system KSeF akceptuje jako fakturę ustrukturyzowaną. Schemat zawiera ponad 300 pól podzielonych na kilkanaście sekcji logicznych:

• Naglowek — dane techniczne dokumentu (kod systemowy, wariant, data wytworzenia)
• Podmiot1 — dane sprzedawcy (NIP, nazwa, adres, REGON)
• Podmiot2 — dane nabywcy (NIP lub identyfikator zagraniczny, adres, kod kraju)
• Podmiot3 — opcjonalny podmiot trzeci (np. odbiorca dostawy różny od nabywcy)
• Fa — sekcja faktury właściwej (typ, data wystawienia, data sprzedaży, waluta)
• FaWiersz — pozycje faktury (nazwa, ilość, jednostka, cena, VAT, kwota)
• Platnosc — sposób, termin i numer rachunku
• WarunkiDostawy — warunki INCOTERMS, miejsce dostawy, rodzaj transportu
• Stopka — uwagi, klauzule, dane dodatkowe

Pola obowiązkowe vs opcjonalne

Z ponad 300 pól FA(2) tylko około 40 jest bezwzględnie obowiązkowych. Reszta to pola warunkowe — wypełniane tylko w określonych sytuacjach (faktura korygująca, mechanizm podzielonej płatności MPP, samofakturowanie, marża VAT). To duża pułapka dla integratorów: początkowo wszystko wydaje się proste, dopiero faktura w PLN z VAT 23% dla kontrahenta z UE z różnymi warunkami dostawy odsłania pełną złożoność schematu.

Walidacja XML — najczęstsze błędy

Walidacja FA(2) odbywa się w dwóch etapach: walidacja XSD (struktura pliku) i walidacja semantyczna (logika biznesowa, sumy VAT, format NIP). Najczęstsze przyczyny odrzucenia:

• Niezgodność sum VAT — różnica nawet o 0,01 zł między sumą pozycji a podsumowaniem powoduje odrzucenie. Dotyczy to klasycznego problemu zaokrągleń przy mnożeniu ceny × ilość.
• Nieprawidłowy NIP nabywcy — KSeF waliduje cyfrę kontrolną NIP. Brak cyfry, znaki specjalne, prefiks „PL" zamiast samego numeru — wszystko to powoduje błąd.
• Brak pola P_22A — kod kraju nabywcy w formacie ISO 3166 (PL, DE, CZ). Często zapominane przy fakturach krajowych, mimo że jest tam obowiązkowe.
• Niepoprawny format daty — schemat wymaga formatu YYYY-MM-DD. Każdy inny (DD.MM.YYYY, DD/MM/YYYY) skutkuje odrzuceniem.
• Nieobsługiwana stawka VAT — schemat dopuszcza wyłącznie {23, 8, 5, 0, zw, np, oo}. Stawka „NP" (wielkimi literami) zamiast „np." jest odrzucana.
• Pole P_7 dłuższe niż 256 znaków — opis pozycji ma twardy limit, którego nie da się obejść.
• Brak pola P_15 — kwota należności ogółem brutto musi się dokładnie zgadzać z sumą sekcji rozliczeniowej.

Integracja API KSeF — Token, certyfikat, środowiska

Środowiska KSeF

Ministerstwo Finansów udostępnia trzy oddzielne środowiska, z których w praktyce wykorzystuje się dwa:

• Środowisko produkcyjne (PROD) — ksef.mf.gov.pl — używane do realnych faktur ustrukturyzowanych z mocą prawną. Wystawione tu faktury są wiążące podatkowo.
• Środowisko testowe (TEST) — ksef-test.mf.gov.pl — pełna replika produkcji do testów integracji. Faktury wystawione tu nie mają mocy prawnej, ale walidacja działa identycznie. Niezbędne dla każdego dewelopera.
• Środowisko demo — historyczne, zostało wycofane z momentu udostępnienia TEST.

Logowanie i autoryzacja — token autoryzacyjny

Dostęp do KSeF wymaga uwierzytelnienia: profilem zaufanym (najpopularniejsza metoda dla mikroprzedsiębiorców), podpisem kwalifikowanym (dla pracowników działów księgowych) lub pieczęcią elektroniczną kwalifikowaną (dla sp. z o.o. i S.A.). Po zalogowaniu podatnik generuje token autoryzacyjny — 64-znakowy sekret przekazywany do systemu integrującego (Zunapro, Comarch, iFirma) z okresem ważności do 24 miesięcy. Tokeny można w każdej chwili odwołać bez wpływu na już wystawione faktury.

Uprawnienia na poziomie tokenu

System KSeF pozwala precyzyjnie zawęzić zakres tokenu:

• Wystawianie faktur — najczęstsze uprawnienie dla systemów sprzedaży
• Odbiór faktur — pobieranie faktur otrzymanych od kontrahentów
• Przeglądanie — odczyt bez modyfikacji
• Nadawanie uprawnień — administracyjne, tylko dla głównego konta
• Zarządzanie korektami i notami — osobne uprawnienie

Wystawianie faktury — flow API

Standardowy przepływ wystawienia faktury w KSeF wygląda następująco:

1. Uwierzytelnienie sesji — POST do /api/v2/sessions/online/token z tokenem i podpisaniem nonce
2. Wysłanie XML faktury — POST do /api/v2/invoices/send z plikiem FA(2) (Base64 lub multipart)
3. Pobranie statusu — GET do /api/v2/invoices/status/{referenceNumber} — w odpowiedzi numer KSeF i kod statusu
4. Pobranie UPO — GET do /api/v2/invoices/upo/{ksefReferenceNumber} — zwraca XML potwierdzenia z podpisem MF
5. Zamknięcie sesji — POST do /api/v2/sessions/terminate

Całość trwa typowo od 2 do 8 sekund. W praktyce KSeF zwraca status synchronicznie dla 95% faktur — pozostałe 5% trafiają do kolejki asynchronicznej i wymagają polling'u co 30 sekund.

Rate limiting i sesje równoległe

KSeF limituje liczbę żądań na sekundę i liczbę aktywnych sesji równoległych dla jednego podatnika. Dla typowego e-commerce z 200–500 zamówień dziennie limity są w pełni wystarczające, ale dla podmiotów o obrocie powyżej 10 000 faktur dziennie konieczne jest asynchroniczne batchowanie przez kolejkę. Zunapro implementuje kolejkę BullMQ z retry i exponential backoff — przy chwilowej niedostępności KSeF wszystkie zamówienia są kolejkowane lokalnie i wysyłane po przywróceniu usługi, bez utraty.

KSeF a sprzedaż na marketplace'ach — Allegro, Amazon.pl, Empik, Erli

Sprzedaż na Allegro a obowiązek KSeF

Allegro, mimo że jest największą platformą handlową w Polsce z 22 mln klientów, nie wystawia faktur w imieniu sprzedawcy. Każdy sprzedawca na Allegro jest samodzielnym podatnikiem VAT, który odpowiada za prawidłowe zafakturowanie sprzedaży. Allegro udostępnia w API zamówienia z polem wantInvoice oraz danymi do faktury (NIP nabywcy, nazwa, adres), ale samo wystawienie i przesłanie do KSeF leży po stronie sprzedawcy.

W praktyce oznacza to, że sprzedawca z 500 zamówieniami dziennie na Allegro musi wystawiać do 500 faktur dziennie do KSeF, jeśli wszyscy nabywcy podadzą NIP. Nawet jeśli faktycznie 70% to konsumenci (B2C), pozostałe 30% × 500 = 150 faktur dziennie staje się obowiązkiem KSeF — ręcznie nie do obsłużenia.

Amazon.pl Business — automatyczne wystawianie faktur

Amazon Business w Polsce wzbudza inny mechanizm: program Amazon Tax Invoicing Service może wystawiać faktury w imieniu sprzedawcy, ale wymaga to wcześniejszej konfiguracji i nadania pełnomocnictwa. Większość polskich sprzedawców na Amazon.pl wybiera samodzielne wystawianie — z tych samych powodów co na Allegro, czyli kontrola, numeracja, integracja z księgowością. Zunapro automatycznie identyfikuje zamówienia z Amazon.pl Business po fladze IsBusinessOrder w SP-API i wystawia fakturę KSeF.

Empik, Ceneo, Morele.net, Erli — wspólny model

Wszystkie pozostałe polskie marketplace'y działają w tym samym modelu co Allegro — sprzedawca odpowiada za wystawienie faktury. Empik dodatkowo wymaga faktury VAT dla każdego zamówienia powyżej 200 zł brutto (regulamin sprzedawcy). Morele.net w segmencie B2B (firmy IT, integratorzy) ma odsetek zamówień firmowych przekraczający 40% — co czyni integrację KSeF szczególnie krytyczną dla tego kanału.

Konsolidacja KSeF w jednym panelu

Bez systemu konsolidującego sprzedawca obsługujący 4–6 marketplace'ów musiałby logować się do każdej platformy osobno, eksportować zamówienia, importować je do oprogramowania księgowego, ręcznie wystawiać faktury KSeF i ewidencjonować numer KSeF z powrotem w marketplace. To 4–8 godzin pracy dziennie dla średniej wielkości sklepu. Zunapro robi to automatycznie:

Faktury korygujące i noty w KSeF — Rewolucja w obsłudze zwrotów

Korekta in minus bez potwierdzenia odbioru

To największa zmiana praktyczna wynikająca z KSeF dla sprzedawców e-commerce. Wcześniej wystawienie korekty in minus (np. po zwrocie towaru) wymagało uzyskania potwierdzenia odbioru korekty od nabywcy, by można było zmniejszyć VAT należny. W praktyce sklepy zbierały te potwierdzenia mailowo, telefonicznie lub jako załączniki w sklepie internetowym — proces żmudny i podatny na błędy.

W KSeF data wystawienia korekty w systemie jest datą skutku prawnego. Nie potrzeba potwierdzenia nabywcy. To eliminuje miesiące oczekiwania na potwierdzenia z dużymi kontrahentami i radykalnie skraca cykl rozliczeń VAT.

Pola specyficzne dla korekty FA(2)

Faktura korygująca w KSeF jest osobnym dokumentem FA(2) z dodatkowymi polami:

• RodzajFaktury = KOR — kod faktury korygującej
• DaneFaKorygowanej — sekcja z danymi faktury pierwotnej (data, numer, numer KSeF oryginalny)
• PrzyczynaKorekty — pole tekstowe z uzasadnieniem korekty
• OkresFaKorygowanej — okres rozliczeniowy faktury pierwotnej

Korekty zbiorcze

Schemat FA(2) dopuszcza faktury korygujące zbiorcze — jedną korektę do wielu faktur pierwotnych. To istotne dla e-commerce, gdzie regularnie pojawiają się zwroty w odniesieniu do różnych zamówień jednego kontrahenta hurtowego. Zunapro automatycznie grupuje zwroty per kontrahent i wystawia jedną zbiorczą korektę zamiast wielu pojedynczych.

Noty korygujące — co się zmienia

Tradycyjne noty korygujące (do poprawiania błędów w danych nabywcy bez zmiany kwoty) nie mają miejsca w KSeF. Zamiast tego, jeśli nabywca chce poprawić błąd w fakturze, sprzedawca wystawia nową fakturę korygującą zerową lub całkowicie nową fakturę. To upraszcza ewidencję ale wymaga przemyślenia procesu reklamacyjnego.

Anulowanie faktury vs korekta

W KSeF nie ma operacji „usuń fakturę" — każdy dokument przesłany do systemu pozostaje w archiwum. Aby cofnąć fakturę błędną, wystawia się korektę zerującą (kwota brutto −X) lub korektę in minus do oryginalnej. Anulowanie zamówienia w marketplace po wystawieniu faktury KSeF wymaga zatem zawsze faktury korygującej — Zunapro robi to automatycznie z momentu zarejestrowania zwrotu w systemie marketplace.

Integracja KSeF z polskimi systemami księgowymi

Comarch ERP Optima i XL

Comarch ERP Optima jest najpopularniejszym systemem księgowym dla MŚP w Polsce (ponad 200 000 firm). Posiada wbudowany moduł KSeF, który wystawia faktury i odbiera UPO bezpośrednio z poziomu Optimy. Zunapro integruje się z Comarch Optima przez Comarch ERP XML (export/import) lub Comarch ERP API — zamówienia z marketplace'ów są ewidencjonowane jako sprzedaż, a faktury KSeF wystawiane są jednorazowo w Optimie zbiorczym importem.

iFirma — księgowość online

iFirma.pl to lider księgowości online dla samozatrudnionych i mikrofirm (ponad 150 000 użytkowników). Posiada gotowy moduł KSeF już od 2022 roku jako tester wczesny. Integracja z Zunapro polega na przesyłaniu zamówień e-commerce jako pozycji sprzedaży, a iFirma wystawia automatycznie faktury KSeF i ewidencjonuje VAT w deklaracji JPK_V7M.

Wfirma — alternatywa dla iFirma

Wfirma.pl oferuje analogiczny model SaaS dla samozatrudnionych. Posiada moduł KSeF i pełną integrację z polskimi marketplace'ami przez Zunapro. Szczególnie polecana dla freelancerów i drobnych sprzedawców na Allegro do 200 zamówień miesięcznie.

inFakt — księgowość premium

inFakt łączy księgowość online z usługą księgowego osobistego. Integracja KSeF od stycznia 2026, a integracja z Zunapro pozwala księgowym automatycznie pobierać zamówienia z marketplace'ów do faktur KSeF, bez potrzeby manualnego księgowania.

Subiekt GT i Symfonia

Subiekt GT (InsERT) i Symfonia (Sage) to dwa duże systemy desktopowe dla średnich firm. Oba mają moduły KSeF wbudowane natywnie. Zunapro eksportuje zamówienia e-commerce w formatach Subiekt EPP i Symfonia XML, które są następnie importowane jednorazowo dla wystawienia faktur KSeF w odpowiednim systemie.

Porównanie systemów księgowych pod KSeF

System	Cena miesięczna	Wbudowany KSeF	API + Zunapro
Comarch ERP Optima	od 99 zł netto	Tak (od 2024)	XML / API
iFirma.pl	od 45 zł netto	Tak (od 2022)	REST API
Wfirma.pl	od 39 zł netto	Tak (od 2023)	REST API
inFakt	od 89 zł netto + księgowy	Tak (od 2026)	REST API
Subiekt GT	jednorazowo ~1 500 zł	Tak (moduł e-Sprzedaż)	EPP import
Symfonia Finanse i Księgowość	od 199 zł netto	Tak (od 2024)	XML import

Jak czytać tabelę: Każdy z tych systemów posiada natywną integrację KSeF, ale żaden nie integruje się bezpośrednio z marketplace'ami. To rola Zunapro — pobieranie zamówień z Allegro/Amazon.pl/Empik, przygotowanie danych faktury, przekazanie do systemu księgowego, który następnie wystawia fakturę w KSeF. Alternatywnie Zunapro może wystawiać faktury KSeF samodzielnie i tylko ewidencjonować je w księgowości — model szybszy, eliminuje pośredni krok.

Sankcje karne i kary skarbowe — Co grozi za niestosowanie KSeF

Sankcja administracyjna do 100% VAT

Najpoważniejsza sankcja przewidziana w ustawie o VAT za nieuczynienie obowiązkowi KSeF to kara pieniężna do 100% kwoty VAT wykazanej na fakturze wystawionej poza KSeF, nie mniej jednak niż 18,7% kwoty należności brutto. Naczelnik urzędu skarbowego nakłada karę w drodze decyzji administracyjnej, od której przysługuje odwołanie do dyrektora izby administracji skarbowej.

Przykład: faktura 10 000 zł netto + 2 300 zł VAT poza KSeF = sankcja do 2 300 zł (100% VAT).

Odpowiedzialność karna skarbowa

Równolegle do sankcji administracyjnej obowiązuje odpowiedzialność karna skarbowa z art. 62 Kodeksu karnego skarbowego. Niewystawienie faktury, wystawienie jej w sposób wadliwy lub nieterminowo zagrożone jest karą grzywny do 240 stawek dziennych. Stawka dzienna w 2026 wynosi od 158 zł do 63 200 zł, więc maksymalna grzywna może sięgnąć kilku milionów złotych — w skrajnych przypadkach.

W praktyce dla drobnych uchybień (jedna lub kilka faktur poza KSeF) urzędnicy stosują pouczenie lub minimalne grzywny — ale przy systematycznym omijaniu obowiązku konsekwencje stają się bardzo dotkliwe.

Okres przejściowy — moratorium na sankcje do 31 grudnia 2026

Ministerstwo Finansów zapowiedziało, że do końca 2026 roku sankcje administracyjne za drobne uchybienia techniczne KSeF nie będą stosowane. Dotyczy to wyłącznie sytuacji, w których podatnik faktycznie próbował wystawić fakturę KSeF, ale wystąpił błąd techniczny po jego stronie (np. nieprawidłowy XML, problemy z certyfikatem). Sankcje za świadome omijanie obowiązku — wystawianie tylko PDF mimo posiadania KSeF — będą stosowane od razu.

Awarie KSeF — procedura zastępcza

Ustawa przewiduje procedurę zastępczą na wypadek awarii systemu KSeF. W okresie ogłoszonej awarii (komunikat Ministerstwa Finansów) podatnik wystawia faktury w trybie offline — papierowo lub elektronicznie poza KSeF — i ma obowiązek przesłania ich do KSeF w terminie 7 dni od ustania awarii. Faktury otrzymują wówczas datę wystawienia z dnia rzeczywistego, ale numer KSeF nadawany jest dopiero po imporcie.

Dla typowego e-commerce oznacza to konieczność wdrożenia trybu awaryjnego w systemie sprzedaży — Zunapro implementuje to automatycznie: w razie wykrycia awarii API KSeF (HTTP 5xx, timeout) zamówienia są zapisywane lokalnie z flagą „KSeF pending", a po przywróceniu usługi automatycznie wysyłane.

UPO, archiwum i przechowywanie dokumentów KSeF

UPO — Urzędowe Poświadczenie Odbioru

UPO to elektroniczne potwierdzenie wystawione przez KSeF natychmiast po pomyślnej walidacji XML faktury. Zawiera następujące elementy:

• Data i godzina przyjęcia — z dokładnością do milisekundy
• Numer KSeF — 10-znakowy unikalny identyfikator dokumentu
• Hash SHA-256 faktury — kryptograficzny odcisk palca pliku XML
• Podpis elektroniczny Ministerstwa Finansów — XAdES
• Numer referencyjny sesji — do śledzenia w logach KSeF

UPO ma moc dokumentu urzędowego w rozumieniu Kodeksu postępowania administracyjnego. W razie sporu z urzędem skarbowym to UPO udowadnia, że faktura została wystawiona w terminie i w prawidłowej formie.

Okres przechowywania — 5 lat plus rok

Faktury KSeF i UPO podlegają standardowemu okresowi przechowywania dokumentów księgowych: 5 lat licząc od końca roku kalendarzowego, w którym minął termin płatności podatku. Praktycznie oznacza to faktyczne 5–6 lat archiwum. Co istotne, Ministerstwo Finansów archiwizuje faktury KSeF przez 10 lat we własnym systemie — sprzedawca nie ma więc bezwzględnego obowiązku przechowywania oryginałów, jeśli ma dostęp do KSeF. Jednak praktyka i kontrole skarbowe wymagają posiadania lokalnej kopii.

Format archiwum w Zunapro

Zunapro archiwizuje każdą fakturę KSeF w trzech formatach jednocześnie:

• XML FA(2) oryginalny — plik wysłany do KSeF, z podpisem nadawcy
• XML UPO — potwierdzenie z KSeF z podpisem Ministerstwa Finansów
• PDF wizualizacja — czytelna dla człowieka wersja faktury, generowana z FA(2) zgodnie ze wzorem MF

Każdy dokument jest zaszyfrowany AES-256, podpisany hashem SHA-256 i przechowywany w obiektowej przestrzeni S3 z replikacją między regionami. Eksport ZIP dla kontroli skarbowej generuje się w 30 sekund i zawiera wszystkie trzy formaty plus indeks CSV z numerami KSeF, datami i kwotami.

Indeks faktur i wyszukiwanie

Praktyczne archiwum musi być przeszukiwalne. Zunapro indeksuje każdą fakturę po: numerze KSeF, numerze własnym, NIP nabywcy, dacie wystawienia, kwocie brutto i statusie (wystawiona, korygowana, anulowana). Wyszukiwarka działa w czasie rzeczywistym — typowy zapytanie „faktury z marca 2026 do firmy NIP 5252345678" zwraca wyniki w pół sekundy.

KSeF a JPK_V7M — Dwa równoległe obowiązki

Czym jest JPK_V7M

JPK_V7M (Jednolity Plik Kontrolny dla VAT — wariant miesięczny) to miesięczny plik XML zawierający ewidencję VAT (sprzedaż i zakupy) oraz deklarację VAT-7 podatnika. Składany do końca 25. dnia miesiąca następującego po miesiącu rozliczenia. Obowiązuje od 1 października 2020 r. (zastąpił JPK_VAT + VAT-7) i pozostaje w mocy w 2026 roku równolegle z KSeF.

Relacja KSeF do JPK_V7M

KSeF i JPK_V7M to dwa odrębne systemy z różnymi celami:

• KSeF dotyczy pojedynczych faktur — wystawienie, walidacja, archiwum dokumentu
• JPK_V7M dotyczy zbiorczej ewidencji — sumy sprzedaży i zakupów, deklaracja VAT

W 2026 roku obydwa obowiązki istnieją niezależnie: podatnik wystawia każdą fakturę w KSeF, a równolegle co miesiąc generuje i wysyła JPK_V7M. Ministerstwo Finansów docelowo planuje automatyczne zasilanie JPK_V7M przez KSeF — co wyeliminuje podwójne księgowanie — ale termin nie został jeszcze ustalony (prawdopodobnie 2027 lub 2028).

Schemat JPK_V7M(3) — najnowsza wersja

Aktualnie obowiązuje schemat JPK_V7M w wersji 3 opublikowany w 2024 roku. Zawiera m.in.:

• Ewidencję sprzedaży VAT z podziałem na stawki
• Ewidencję zakupów VAT z podziałem na cele związane / niezwiązane ze sprzedażą opodatkowaną
• Kody GTU (grupy towarów i usług) — 13 oznaczeń specjalnych dla wybranych kategorii
• Kody procedur (MPP, EE, IED, TP, B_SPV, B_MPV i inne) — oznaczające specjalne mechanizmy transakcji
• Deklarację VAT-7 z polami P_10 do P_55

Eksport JPK_V7M z Zunapro

Zunapro generuje JPK_V7M(3) bezpośrednio na podstawie zamówień marketplace'ów i wystawionych faktur KSeF. Plik jest gotowy do importu w Comarch Optima, iFirma, Wfirma lub bezpośredniego wysłania do e-Urząd Skarbowy przez ePUAP. Kody GTU są przydzielane automatycznie na podstawie kategorii produktów (np. GTU_06 dla elektroniki, GTU_07 dla pojazdów, GTU_13 dla usług transportowych). Sprzedawca może ręcznie nadpisać kod GTU dla wybranych SKU.

Jak wdrożyć KSeF w sklepie internetowym — Krok po kroku

1. Audyt obecnego stanu

Pierwszym krokiem jest sprawdzenie, na jakim etapie znajduje się obecna infrastruktura fakturowania:

• Czy posiada Pan/Pani już konto KSeF? Można je założyć za darmo w portalu MF, zalecane jeszcze w 2025
• Czy system sprzedaży (Shopify, WooCommerce, PrestaShop) ma plugin KSeF? Większość pluginów obsługuje tylko podstawowe scenariusze
• Czy biuro rachunkowe wystawia faktury w KSeF? Jeśli tak, mogą być potrzebne zmiany w procesie
• Czy obecny system księgowy (Comarch, iFirma) jest gotowy? Wszystkie duże systemy mają już moduł KSeF

2. Decyzja: KSeF samodzielnie czy przez Zunapro

Sprzedawca z 10–50 zamówieniami miesięcznie może wystawiać faktury KSeF ręcznie przez panel MF lub przez moduł KSeF w księgowości online. Sprzedawca z 100+ zamówieniami miesięcznie powinien wdrożyć automatyzację przez Zunapro lub równoważne rozwiązanie — ręczne wystawianie staje się fizycznie niemożliwe.

3. Generowanie tokenu KSeF

1. Logowanie do ksef.mf.gov.pl profilem zaufanym lub podpisem kwalifikowanym
2. Menu „Tokeny" → „Generuj nowy token"
3. Wybór uprawnień: „Wystawianie faktur" + „Odbiór UPO" + „Przeglądanie"
4. Wybór okresu ważności (zalecane 12 miesięcy z rotacją)
5. Skopiowanie 64-znakowego tokenu (jeden raz, nigdy więcej nie wyświetlany)
6. Wklejenie tokenu do panelu Zunapro w sekcji „Integracja KSeF"

4. Testy na środowisku ksef-test

Przed go-live należy obowiązkowo wykonać testy na ksef-test.mf.gov.pl. Zunapro wystawi 5–10 testowych faktur, sprawdzi walidację XSD, status zwracany przez API i odebranie UPO. To eliminuje ryzyko surprise'ów po przełączeniu na PROD.

5. Mapowanie pól między marketplace a FA(2)

Zunapro automatycznie mapuje pola Allegro/Amazon.pl/Empik na FA(2):

• NIP nabywcy ← Allegro buyer.companyId / Amazon BuyerTaxInfo.CompanyId
• Nazwa nabywcy ← Allegro buyer.companyName / Amazon BuyerName
• Pozycje faktury ← lineItems z mapowaniem ceny brutto na netto + VAT 23%
• Sposób płatności ← payment.method z konwersją na kody P_56_1 (przelew, BLIK, karta)
• Data sprzedaży ← data realizacji zamówienia (status SHIPPED)

6. Konfiguracja serii numeracji

Pomimo że numer KSeF jest unikalny, faktura zachowuje również własną numerację sprzedawcy (np. FA/2026/04/0001). Zunapro pozwala skonfigurować serię numeracji per sklep, per marketplace lub per typ dokumentu (faktura, korekta, faktura zaliczkowa). Zalecane jest stosowanie schematu rocznego z miesięcznym dzielnikiem.

7. Go-live i monitoring

Po przełączeniu z TEST na PROD Zunapro automatycznie wystawia faktury KSeF z każdego nowego zamówienia firmowego. Panel monitoring pokazuje status każdej faktury w czasie rzeczywistym: walidacja → wysłanie → numer KSeF → UPO. Błędy walidacji są podświetlane czerwoną flagą i wymagają interwencji księgowego.

Najczęściej zadawane pytania o KSeF 2026