KSeF w sklepie - wtyczka czy własna integracja przez API?

Wybór połączenia z KSeF zacznij od rozmowy z księgowością: jakie dokumenty wystawia firma, które podlegają obowiązkowi i gdzie mają powstawać. Nie każdy zakup konsumencki oznacza obowiązkowe wystawienie faktury w KSeF. Zwolnienie z VAT również nie jest automatycznym wyłączeniem z systemu. Sama platforma sklepu nie rozstrzyga sytuacji podatnika.

Według informacji Ministerstwa Finansów o zakresie KSeF obowiązek objął od 1 lutego 2026 r. podatników ze sprzedażą wraz z podatkiem przekraczającą 200 mln zł w 2024 r., a od 1 kwietnia pozostałych, z przewidzianymi wyjątkami. Do końca 2026 r. obowiązuje wyjątek przy sprzedaży dokumentowanej fakturami do 10 000 zł brutto miesięcznie. Faktury B2C nie są objęte obowiązkowym wystawianiem. Warunki swojej sytuacji potwierdź z księgowością.

Następnie wskaż system wystawiający dokument: sklep, program księgowy lub ERP. Sklep może przekazywać dane zamówienia, a faktura powstawać dalej. Nie buduj drugiego niezależnego generatora tylko dlatego, że dostępna jest wtyczka. Ustal źródło numeracji i odpowiedzialność za poprawność danych, zanim zamówisz prace techniczne.

Wtyczka także może korzystać z API KSeF. Porównujemy więc zakup gotowego rozwiązania z budową połączenia dopasowanego do własnego procesu, a nie dwie przeciwstawne technologie. Gotowy konektor może obsługiwać korekty, waluty, alerty i program księgowy, jeśli jego producent przewidział te funkcje. Trzeba to sprawdzić, zamiast przypisywać całej kategorii ograniczenia jednego dodatku.

Własne rozwiązanie daje możliwość zaprojektowania brakujących zachowań, ale ich nie zapewnia automatycznie. Każdą funkcję trzeba opisać, wdrożyć i odebrać. Dotyczy to również monitoringu, błędów i utrzymania zgodności po zmianach po stronie KSeF. Posiadanie kodu nie gwarantuje, że aktualizacja zewnętrznego API nie wymusi kolejnych prac.

Gotowy produkt oceń na dokumentach i procesach firmy. Jeśli spełnia wymagania, tworzenie równoległego rozwiązania może nie być potrzebne. Gdy brakuje ważnej funkcji, sprawdź możliwość konfiguracji lub rozszerzenia przed decyzją o pełnym wdrożeniu własnym. Właściwy wybór wynika z pokrycia potrzeb i kosztu utrzymania, a nie wyłącznie z liczby faktur czy etykiety mały sklep.

Przygotuj reprezentatywne przypadki razem z księgowością. Obejmij dokumenty rzeczywiście występujące w firmie oraz przewidywane wyjątki. Nie używaj w prezentacji prawdziwych danych klientów, jeśli wystarczą dane testowe. Dostawca powinien wykazać działanie wymaganej funkcji, a nie tylko wskazać podobnie brzmiącą pozycję w ofercie.

Tabela działa zarówno dla wtyczki, jak i rozwiązania własnego. Brak demonstracji nie dowodzi, że funkcja nie istnieje, ale pozostawia ją nieodebraną. Zapisz różnice między zakresem standardowym a dodatkowo płatnym. Dzięki temu wycena obejmuje faktyczne potrzeby, a nie ogólną obietnicę integracji wszystkiego.

W odbiorze rozdziel przygotowanie danych, wysłanie, uzyskanie statusu i obsługę wyniku. Samo powodzenie żądania HTTP nie jest uniwersalnym dowodem przyjęcia faktury. Integracja powinna śledzić stan konkretnego dokumentu zgodnie z procesem KSeF. Oficjalna dokumentacja API KSeF 2.0 opisuje między innymi sesje, uprawnienia i środowiska, które trzeba uwzględnić przy projektowaniu połączenia.

Ustal, gdzie użytkownik widzi odrzucenie i co robi dalej. Alert może być funkcją gotowego konektora albo rozwiązania własnego. Ważniejsze od etykiety produktu jest to, czy informacja trafia do właściwej osoby oraz czy istnieje sposób sprawdzenia nierozwiązanych przypadków. Sam czerwony status w panelu nie pomaga, jeśli nikt do niego nie zagląda.

Osobno sprawdź ponowienie operacji po przerwie w komunikacji. Nie zakładaj, że sam numer dokumentu zawsze zapobiegnie powieleniu albo spowoduje automatyczne odrzucenie dubletu. Proces musi kontrolować powiązanie zamówienia, dokumentu i wyniku wcześniejszej próby. Sytuacje awaryjne rozwija poradnik problemów KSeF w sklepie.

Kolejność wdrożenia jest podobna niezależnie od produktu. Najpierw potwierdź źródło faktury i wymagania, potem uzgodnij dostępy oraz mapowanie danych. Nie pobieraj dodatkowych pól od każdego klienta bez ustalenia, czy są potrzebne w jego przypadku. Dane do wysyłki paczki i dane dokumentu mogą pełnić różne funkcje.

Uprawnienia dobierz do wykonywanych operacji i rozdziel środowiska. Dostęp testowy nie powinien być mylony z produkcyjnym. Nie zapisuj sekretów w repozytorium, raporcie ani korespondencji z listą uwag. Ustal sposób ich przechowywania, wymiany i odebrania po zakończeniu współpracy.

Testy przeprowadź na właściwym środowisku testowym, z dokumentami próbnymi i bez prawdziwych wysyłek do klientów. Obejmij brak danych, odrzucenie, nieaktualne uprawnienie, przerwę w łączności i ponowienie. W dokumentacji API sprawdź także wymagane przez proces tryby offline oraz limity. Nie twórz własnej interpretacji trybu awaryjnego bez uzgodnienia z księgowością. Wynik odbioru powinien pokazywać, co system zrobił i kto ma zareagować na wyjątek.

Porównaj trzy grupy kosztów: zakup lub abonament rozwiązania, wdrożenie w firmie i dalsze utrzymanie. W gotowym produkcie sprawdź limity, dodatki, aktualizacje oraz zakres wsparcia. W rozwiązaniu własnym uwzględnij dokumentację, monitoring, testy i zmiany wymagane po aktualizacji systemów zewnętrznych. Nie zakładaj z góry, że jedna droga zawsze będzie tańsza.

Wdrożenie KSeF w KC Mobile zaczyna się od 2 999 zł netto. To próg usługi, a nie cena każdej możliwej integracji czy nieograniczonego utrzymania. Zakres dokumentów, mapowania, statusów i systemów trzeba potwierdzić w ofercie. Integracja sklepu z ERP jest odrębnym zakresem, wycenianym od 7 900 zł netto; tych kwot nie należy automatycznie sumować dla każdego sklepu.

Do rozmowy o wycenie przygotuj używane programy, opis dokumentów i wymagane wyjątki. Wskaż, co działa dziś oraz co pozostaje ręczne. Jeśli zmiana dotyczy całego sklepu internetowego, oddziel funkcje sprzedaży od wystawiania faktur. Taki podział ułatwia ocenę, za co rzeczywiście płacisz.

Odbiór zakończ wspólnym sprawdzeniem wykonawcy i osoby odpowiedzialnej za dokumenty. Przedstaw listę scenariuszy, znane ograniczenia oraz sposób obsługi błędów. Użytkownik powinien umieć znaleźć dokument oczekujący, odrzucony i przyjęty, a także ustalić, kiedy potrzebna jest pomoc techniczna lub księgowa.

Zapisz, kto kontroluje kolejkę, kto poprawia dane i kto zatwierdza ponowienie. Określ również odpowiedzialność dostawcy gotowego produktu oraz wykonawcy konfiguracji. Umowa z jedną stroną nie musi obejmować awarii drugiego systemu. Przy własnym kodzie zapewnij dostęp do dokumentacji i uzgodniony sposób utrzymania, aby obsługa nie zależała od pamięci jednej osoby.

Po wdrożeniu można ustalić mały pakiet godzinowy na kontrole, aktualizacje i drobne poprawki. SLA powinno opisywać zakres, dostępność i czasy reakcji uzgodnione indywidualnie. Nie utożsamiaj reakcji z gwarancją naprawy każdego problemu w stałym terminie. Prześlij opis procesu fakturowania do KC Mobile, aby porównać gotowy konektor z pracami rzeczywiście potrzebnymi w Twojej firmie.