Integracja sklepu z KSeF: aplikacja, program czy integrator

KSeF w sklepie internetowym · Aktualizacja: 2026-10-19

W skrócie: integracja z KSeF w sklepie internetowym to połączenie, które z zamówienia z NIP robi fakturę FA(3), wysyła ją do KSeF i zapisuje numer KSeF przy zamówieniu. Masz trzy typowe drogi: aplikację w platformie sklepu, program do faktur z wtyczką albo system do obsługi zamówień połączony z programem do faktur. Wybór zależy od tego, ile masz kanałów sprzedaży i gdzie pracuje Twoja księgowa.

Integracja z KSeF: co właściwie trzeba połączyć

KSeF nie ma „wtyczki do sklepu”. Ministerstwo Finansów udostępnia API KSeF 2.0 z dokumentacją, środowiskiem testowym, przedprodukcyjnym (demo) i produkcyjnym oraz oficjalnymi bibliotekami w C# i Javie (Wsparcie dla integratorów). Z KSeF korzysta się przez program zintegrowany przez API albo przez bezpłatne narzędzia MF (FAQ MF, kategoria „Podstawowe informacje o KSeF”, pyt. 2).

Każda integracja sklepu, niezależnie od dostawcy, musi zrobić te same kroki:

1. wziąć z zamówienia NIP, dane firmy, pozycje, stawki VAT, dostawę i datę zapłaty,
2. zbudować plik XML zgodny ze strukturą FA(3),
3. uwierzytelnić się w KSeF Twoim certyfikatem KSeF albo tokenem i wysłać plik,
4. odebrać numer KSeF i UPO albo informację o odrzuceniu,
5. zapisać numer przy zamówieniu i dać kupującemu PDF z kodem QR, jeśli przekazujesz fakturę poza KSeF (FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 34),
6. przy zwrocie wystawić korektę z numerem KSeF faktury pierwotnej.

Różnice między drogami polegają na tym, kto robi który krok.

Droga 1: aplikacja w platformie sklepu

Aplikacja lub moduł instalowany w samym sklepie robi wszystkie kroki od 1 do 6. Nie potrzebujesz osobnego programu do faktur, a faktura i korekta są widoczne przy zamówieniu.

• Plusy: jedno narzędzie, dane nie są przepisywane, zwrot w panelu sklepu może od razu tworzyć korektę.
• Minusy: obsługuje tylko ten jeden sklep; faktury spoza sklepu (np. za usługi) wystawiasz gdzie indziej.
• Gdzie występuje: aplikacje w Shopify App Store, moduły do PrestaShop, wtyczki do WooCommerce, moduły wbudowane w część platform abonamentowych, np. Shoper Faktury i Magazyn z integracją KSeF 2.0 (Shoper Learn, 22.01.2026). Zakres i cenę zawsze sprawdź u dostawcy.

Dla Shopify robimy taką aplikację: KSeF Faktury wystawia FA(3) dla opłaconych zamówień z NIP i korekty przy zwrotach (premiera w Shopify App Store zaplanowana na grudzień 2026 r.). Inne platformy dziś nie są przez nas obsługiwane. Porównanie aplikacji dla Shopify znajdziesz w artykule aplikacje KSeF do Shopify.

Droga 2: program do faktur i wtyczka

Sklep przekazuje zamówienia do programu do faktur (przez wtyczkę, aplikację albo API programu), a fakturę do KSeF wysyła program. Sklep robi krok 1, program kroki 2 do 4, a krok 5 i 6 zależą od tego, jak dobra jest wtyczka.

• Plusy: wszystkie faktury firmy w jednym miejscu, księgowa często już zna program.
• Minusy: dwa abonamenty; trzeba sprawdzić, czy zwrot w sklepie sam tworzy korektę w programie i czy numer KSeF wraca do zamówienia.

Na co patrzeć przy wyborze programu, piszemy w artykule jak wybrać program do faktur KSeF dla sklepu.

Droga 3: system zamówień albo ERP

Systemy do obsługi zamówień z wielu kanałów, np. Base (dawniej BaseLinker), zbierają zamówienia ze sklepu i marketplace'ów i przekazują je do połączonego programu do faktur albo własnego modułu fakturowego. Większe firmy robią to samo przez ERP.

• Plusy: jedna numeracja i jedno miejsce dla sklepu, Allegro i innych kanałów. Co KSeF zmienia przy sprzedaży na Allegro, opisujemy w tekście KSeF a Allegro.
• Minusy: najwięcej konfiguracji; błąd w mapowaniu statusów (np. który status oznacza „opłacone”) daje faktury w złym momencie albo w ogóle.

Jest też droga własna: integracja napisana przez programistę bezpośrednio z API KSeF. Ma sens przy nietypowym procesie, ale oznacza samodzielne śledzenie zmian w API, które MF publikuje w changelogu na GitHubie.

Koszt i czas wdrożenia

Nie podajemy cen konkretnych dostawców, bo zmieniają się często. Składniki kosztu są za to zawsze te same:

Niezależnie od drogi zaplanuj jeden pełny test: zamówienie z NIP, faktura, zwrot części towaru, korekta. Najlepiej na środowisku testowym KSeF, na którym nie wolno używać prawdziwych danych firm (Środowiska KSeF API 2.0).

Ryzyka: podwójne faktury i rozjazdy

• Dwie faktury do jednego zamówienia. KSeF odrzuca drugą fakturę tylko wtedy, gdy ma ten sam numer, ten sam NIP sprzedawcy i ten sam rodzaj (błąd 440, weryfikacja faktury). Dwa narzędzia z różnymi numeracjami wyślą obie faktury, a każdą przyjętą trzeba potem korygować, bo faktury w KSeF nie da się anulować. Dla jednego zamówienia faktury wysyła jedno narzędzie.
• Wspólna numeracja. Unikalność numeru liczy się dla NIP sprzedawcy. Jeśli faktury wystawia kilka narzędzi, każde musi mieć własną serię, np. FV/SKLEP/... i FV/USLUGI/....
• NIP. KSeF nie sprawdza, czy NIP należy do kupującego, ani statusu w Wykazie podatników VAT (FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 21 i 27). Sprawdzenie sumy kontrolnej w koszyku musi zrobić integracja.
• Przerwy w KSeF. Zapytaj, co integracja robi, gdy KSeF nie odpowiada: czy faktury czekają w kolejce i czy pilnuje terminu dosłania w trybach offline (FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 10).
• Dostęp. Integracja działa na Twoim certyfikacie KSeF (ważnym do 2 lat, FAQ MF, kategoria „Certyfikaty KSeF”, pyt. 2) albo tokenie. MF zapowiedziało, że logowanie tokenem zostanie także po 2026 r. (FAQ MF, kategoria „Uprawnienia i autoryzacja”, pyt. 39), ale rozporządzenie w sprawie korzystania z KSeF (§ 13) wciąż mówi o 31 grudnia 2026 r. i na 19 października 2026 r. nie zostało zmienione. Jakie uprawnienia dać aplikacji, opisujemy w artykule uprawnienia KSeF dla aplikacji sklepu.

Drzewko decyzji

1. Sprzedajesz w kilku kanałach (sklep plus Allegro, Amazon, inne marketplace'y) i masz już system zamówień? Droga 3.
2. Wystawiasz dużo faktur spoza sklepu (usługi, sprzedaż hurtowa) albo księgowa pracuje w konkretnym programie? Droga 2.
3. Większość faktur pochodzi z jednego sklepu? Droga 1, a resztę faktur wystawiaj w osobnej serii.
4. Masz kilka faktur miesięcznie? Możesz wystawiać je ręcznie w bezpłatnej Aplikacji Podatnika KSeF (FAQ MF, kategoria „Wystawianie i otrzymywanie faktur”, pyt. 35), pamiętając, że każda korekta to też ręczna praca.

Najczęstsze pytania

Mam integrację z KSeF 1.0. Czy nadal działa?

Nie. MF wymaga integracji z API KSeF 2.0, bo dopiero ono obsługuje FA(3), tryb offline24 i certyfikaty KSeF (FAQ MF, kategoria „Rozwiązania informatyczne, integracje i struktura KSeF”, pyt. 25).

Czy integrator potrzebuje mojego hasła do Profilu Zaufanego?

Nie. Program wysyła faktury na podstawie tokenu albo certyfikatu KSeF wygenerowanego przez osobę z odpowiednimi uprawnieniami, bez dodatkowych podpisów (FAQ MF, kategoria „Uprawnienia i autoryzacja”, pyt. 22).

Czy mogę połączyć dwie drogi naraz?

Tak, jeśli każda obsługuje inne faktury i ma własną serię numerów. Nie podłączaj dwóch narzędzi do tych samych zamówień.

Artykuł ma charakter ogólnej informacji i nie jest poradą podatkową.

Źródła

• Pytania i odpowiedzi KSeF 2.0, Ministerstwo Finansów: kategoria „Podstawowe informacje o KSeF”, pyt. 2; kategoria „Wystawianie i otrzymywanie faktur”, pyt. 10, 21, 27, 34, 35; kategoria „Rozwiązania informatyczne, integracje i struktura KSeF”, pyt. 25; kategoria „Uprawnienia i autoryzacja”, pyt. 22, 39; kategoria „Certyfikaty KSeF”, pyt. 2
• KSeF: wsparcie dla integratorów (API KSeF 2.0, środowiska, biblioteki)
• Dokumentacja KSeF API 2.0, Ministerstwo Finansów (GitHub CIRFMF): środowiska, weryfikacja faktury; changelog API
• Rozporządzenie w sprawie korzystania z KSeF, Dz.U. 2025 poz. 1815: § 13

Stan prawny na 19 października 2026 r.