Shoper KSeF: Kompletna lista kontrolna obowiązkowych ustawień na 2026
Przygotowanie i konfiguracja wstępna w panelu Shoper
Zanim cokolwiek połączysz, musisz uporządkować swój dom. W przypadku Shoper i KSeF, ten "dom" to panel administracyjny Twojego sklepu. Błędy w danych podstawowych są najprostszą drogą do odrzucenia faktury przez system. Zacznij od tego.
Ustawienia systemowe
- Zaloguj się i znajdź odpowiednią sekcję. Przejdź do 'Ustawienia' > 'Fakturowanie' lub bezpośrednio do 'KSeF', jeśli taki moduł już się pojawił. To punkt startowy dla całej konfiguracji.
- Zweryfikuj dane sprzedawcy. Nazwa firmy, adres siedziby i NIP muszą być identyczne z tymi wpisanymi w CEIDG (dla jednoosobowych działalności) lub KRS. KSeF będzie to sprawdzał automatycznie. Literówka w nazwie ulicy? Faktura nie przejdzie.
- Przygotuj certyfikat kwalifikowany. To klucz do systemu. W ustawieniach KSeF w Shoper musisz wybrać i aktywować metodę autoryzacji. Najczęściej będzie to podpis kwalifikowany lub Zaufany Profil. Bez tego nie ma mowy o bezpiecznym połączeniu API.
Integracja z systemem KSeF i wybór metody połączenia
Tu zaczyna się techniczna część. Jak Twój Shoper ma "rozmawiać" z KSeF? Nie wszystkie wersje platformy mają gotową, natywną integrację. Sprawdź to od razu.
Łączność techniczna
- Sprawdź możliwości swojej platformy. Czy Twoja wersja Shoper ma wbudowany moduł KSeF? Jeśli nie, konieczny będzie dodatek zewnętrzny. Działaj na faktach, a nie na przypuszczeniach – skontaktuj się z supportem Shoper lub sprawdź dokumentację.
- Skonfiguruj połączenie API. To serce integracji. Będziesz potrzebował danych autoryzacyjnych: Tokenu i Identifera. Pobierzesz je z Portalu Podatkowego po zalogowaniu się certyfikatem. Wprowadź je dokładnie w odpowiednie pola w panelu Shoper.
- Rozważ gotowe, sprawdzone rozwiązanie. Konfiguracja API bywa złożona. Dla pewności i oszczędności czasu, warto skorzystać z usług specjalistów. Na przykład, invoicelink.pl oferuje kompletną integrację Shoper z KSeF, która działa od razu, bez zagłębiania się w techniczne szczegóły połączenia API. To dobra alternatywa dla samodzielnego majsterkowania.
Konfiguracja szablonów faktur i danych obowiązkowych
Stary szablon faktury PDF nie wystarczy. KSeF wymaga strukturyzowanych danych w formacie XML. Twoim zadaniem jest tak skonfigurować Shoper, by zbierał i wysyłał wszystkie potrzebne informacje.
Dostosowanie dokumentów
- Dostosuj szablony pod kątem pól KSeF. Chodzi o takie dane jak kody GTU (Grupa Towarów i Usług), MPK (miejsce powstawania kosztów) czy precyzyjne określenie formy zapłaty. Upewnij się, że te pola są aktywne i mapowane w systemie.
- Zautomatyzuj przypisywanie kodów GTU. Ręczne wpisywanie kodu do każdego produktu to droga przez mękę. Skonfiguruj reguły, aby kod GTU był automatycznie przypisywany na podstawie kategorii produktu w sklepie. To oszczędza godziny pracy przy każdej fakturze.
- Ustaw domyślne metody i terminy płatności. Czy oferujesz przelewy, płatności online? Dla każdej metody ustaw domyślny termin zapłaty (np., "7 dni" dla przelewu, "natychmiast" dla płatności online typu Stripe i KSeF). Te informacje muszą być jednoznacznie przeniesione do faktury w KSeF.
Proces testowy i walidacja przed przejściem na produkcję
Nigdy, przenigdy nie przełączaj od razu na tryb produkcyjny. Środowisko testowe KSeF (tzw. sandbox) istnieje po to, by sprawdzić wszystko bez konsekwencji. Korzystaj z niego bez ograniczeń.
Faza testów
- Wystaw próbną fakturę w sandboxie. Stwórz testowe zamówienie w Shoper i wygeneruj dla niego fakturę. Cały proces powinien pójść przez środowisko testowe KSeF. To sprawdzi poprawność całego łańcucha: od kliknięcia w panelu po otrzymanie odpowiedzi z systemu.
- Sprawdź zapis identyfikatorów. Po udanym wysłaniu, w zamówieniu w Shoper powinien pojawić się unikalny numer KSeF (UUID) oraz kod URF. Jeśli ich nie ma, integracja nie zapisuje danych zwrotnych – a to obowiązkowy element.
- Przetestuj różne scenariusze. Nie tylko prostą fakturę VAT. Sprawdź fakturę korygującą, proformę, fakturę dla klienta zagranicznego (B2B i B2C). Jak zachowa się system przy zwrocie towaru? Im więcej przypadków przetestujesz teraz, tym mniej niespodzianek spotka Cię później.
Wdrożenie na produkcję i monitorowanie pierwszej faktury
Testy poszły dobrze? Czas na prawdziwy strzał. Przełączenie na produkcję to formalność, ale pierwsza faktura wymaga Twojej pełnej uwagi.
Ostatnie kroki
- Przełącz tryb z sandboxa na produkcję. W ustawieniach integracji KSeF w Shoper zmień endpoint z testowego na produkcyjny. Upewnij się, że certyfikat i dane logowania też są te produkcyjne. To kluczowy moment.
- Wystaw i natychmiast sprawdź pierwszą fakturę. Wybierz prawdziwe, nieduże zamówienie. Zaraz po wystawieniu, zaloguj się na Portal Podatkowy i znajdź fakturę po numerze. Sprawdź też, czy w panelu Shoper zapisał się poprawny numer KSeF. Od tego zależy dalsza księgowość.
- Potwierdź odbiór przez klienta. Pamiętaj, że od 2026 roku to Twój obowiązek. Upewnij się, że klient otrzymał fakturę, np. w formie linku do Portalu Podatkowego. To finalny krok całego procesu wystawiania.
Utrzymanie, archiwizacja i wsparcie po wdrożeniu
Wdrożenie to nie koniec, a nowy początek. System KSeF będzie działał przez lata. Musisz mieć plan na jego codzienną obsługę i ewentualne problemy.
Działania cykliczne
- Regularnie przeglądaj logi integracji. W panelu Shoper znajdziesz sekcję z logami połączeń z KSeF. Zaglądaj tam co jakiś czas, szukając błędów komunikacji, przekroczeń czasu czy błędów autoryzacji. Lepiej wykryć trend awarii wcześniej.
- Wprowadź procedurę archiwizacji. Faktury w KSeF muszą być przechowywane przez 10 lat, a ich kopie w formie JPK także. Zdefiniuj, jak i gdzie będziesz je archiwizował. Czy Shoper robi to automatycznie? Sprawdź. To wymóg prawny, nie techniczny.
- Miej plan awaryjny na wsparcie. Co zrobisz, gdy integracja się zawiesi? Kto pomoże, gdy KSeF zwróci błąd, którego nie rozumiesz? Warto mieć kontakt do specjalistów. Na przykład, invoicelink.pl oferuje nie tylko integrację, ale też stałe wsparcie techniczne dla KSeF, co daje spokój na wypadek niespodziewanych problemów po wdrożeniu. To ważne zabezpieczenie dla ciągłości działania sklepu.
Najczesciej zadawane pytania
Czym jest KSeF i dlaczego jest ważny dla użytkowników Shoper?
KSeF, czyli Krajowy System e-Faktur, to centralny system informatyczny Ministerstwa Finansów do obligatoryjnego przesyłania i przechowywania faktur w formie elektronicznej. Dla użytkowników Shoper jest to kluczowa zmiana, ponieważ od 1 lipca 2026 roku (zgodnie z obecnym harmonogramem) wystawianie faktur w formie papierowej lub elektronicznej (np. PDF) na potrzeby transakcji B2B w Polsce będzie zabronione. Wszystkie takie faktury będą musiały być wystawiane i przesyłane wyłącznie przez KSeF. Integracja Shoper z KSeF jest więc niezbędna do kontynuacji legalnej działalności.
Jakie obowiązkowe ustawienia w Shoper muszę skonfigurować przed wdrożeniem KSeF?
Lista obowiązkowych ustawień w Shoper na potrzeby KSeF obejmuje m.in.: 1. **Konfiguracja danych firmy**: Upewnienie się, że dane sprzedawcy (NIP, nazwa, adres) w panelu Shoper są kompletne i poprawne, ponieważ będą automatycznie umieszczane na fakturze. 2. **Integracja z KSeF**: Aktywacja i konfiguracja dedykowanego modułu/rozszerzenia Shoper do komunikacji z KSeF. 3. **Autoryzacja w KSeF**: Uzyskanie i wprowadzenie do systemu niezbędnych poświadczeń (np. tokenów autoryzacyjnych, kwalifikowanego podpisu elektronicznego lub podpisu zaufanego) do bezpiecznego połączenia z systemem. 4. **Mapowanie pól produktów**: Sprawdzenie i ewentualne dostosowanie, jak dane produktów (stawki VAT, jednostki miary, kody PKWiU/GTU) są przekazywane do faktury. 5. **Ustawienia numeracji faktur**: Skonfigurowanie formatu numeracji faktur zgodnego z wymogami KSeF (musi być unikalny, ciągły i nadawany w ramach jednej serii). 6. **Konfiguracja metod płatności i dostawy**: Upewnienie się, że te elementy są prawidłowo opisane, aby informacje trafiały poprawnie na fakturę.
Kiedy obowiązek korzystania z KSeF stanie się obowiązkowy dla sklepów internetowych Shoper?
Zgodnie z obecnie obowiązującymi przepisami, **obowiązkowe korzystanie z KSeF dla transakcji B2B ma rozpocząć się od 1 lipca 2026 roku**. Oznacza to, że od tej daty wszyscy przedsiębiorcy (w tym prowadzący sklepy na platformie Shoper) będą zobowiązani wystawiać faktury dla innych firm wyłącznie przez Krajowy System e-Faktur. Warto na bieżąco śledzić komunikaty MF i Shoper, ponieważ terminy mogą ulec zmianie.
Czy Shoper przygotowuje gotowe rozwiązanie do integracji z KSeF?
Tak, Shoper aktywnie pracuje nad dostarczeniem swoim użytkownikom kompleksowego, wbudowanego rozwiązania (modułu lub rozszerzenia) do integracji z Krajowym Systemem e-Faktur. Rozwiązanie to ma umożliwić automatyczne wystawianie faktur KSeF bezpośrednio z poziomu panelu administracyjnego sklepu, na podstawie złożonych zamówień. Kluczowe jest jednak, aby samodzielnie przygotować i skonfigurować wymagane ustawienia (jak dane firmy, poświadczenia) oraz przetestować proces przed obowiązkowym terminem.
Jakie są najważniejsze kroki przygotowawcze do KSeF, które mogę podjąć już teraz?
Nawet przed udostępnieniem finalnego modułu przez Shoper, warto podjąć następujące kroki przygotowawcze: 1. **Weryfikacja danych firmy w Shoper**: Sprawdź i zaktualizuj dane kontrahenta w panelu. 2. **Zabezpieczenie poświadczeń do KSeF**: Zastanów się i przygotuj metodę autoryzacji (kwalifikowany podpis elektroniczny, podpis zaufany). 3. **Przegląd struktury produktów**: Sprawdź, czy produkty mają prawidłowo przypisane stawki VAT i opisy. 4. **Śledzenie informacji**: Regularnie sprawdzaj oficjalne kanały komunikacji Shoper (blog, newsletter, pomoc) oraz stronę Ministerstwa Finansów w celu uzyskania aktualnych wytycznych. 5. **Planowanie testów**: Gdy Shoper udostępni rozwiązanie, zaplanuj przetestowanie wystawiania faktur w środowisku testowym KSeF, aby uniknąć problemów w "dniu zero".