KSeF (Krajowy System e-Faktur) to już realność — a dla firm korzystających z Subiekta to wdrożenie często łapie się na kilku pułapkach. Tu zbiór najczęstszych, z praktyki wdrożeniowej.

O możliwościach łączenia systemów piszemy na stronie o automatyzacji procesów.

Pułapka 1 — nazwy produktów

Wielu klientów trzyma w Subiekcie nazwy skrócone („A-123”, „Koszulka premium 2024”) — do wewnętrznego użytku. Gdy te same nazwy idą do KSeF, kontrahent dostaje fakturę z niejasnym asortymentem, a i walidacja KSeF bywa wybredna (długość, znaki specjalne).

Problem w tym, że standardowy moduł KSeF nie obejmuje podmiany nazw przy generowaniu e-faktury. Albo wszystko zmieniasz w kartotece (łamie wewnętrzną logikę), albo ręcznie korygujesz każdą fakturę (przy 200 fakturach miesięcznie — nierealne).

Rozwiązanie praktyczne

Autorski dodatek przez Sferę, który podmienia nazwy „w locie” tylko przy wysyłce do KSeF. Normalna sprzedaż i raporty widzą nadal wewnętrzne nazwy. Napisaliśmy taki dodatek dla jednego z naszych klientów — odezwij się, jeśli masz ten sam problem.

Pułapka 2 — formaty dat i kwot

KSeF wymaga konkretnego formatu dat (YYYY-MM-DD) i kwot (kropka jako separator dziesiętny, bez spacji). W Subiekcie wyświetla się PL-format — ale przy wysyłce konwersja musi być idealna.

Najczęstsze błędy:

  • Data wystawienia z „2026-14-04” (miesiąc poza zakresem) — Subiekt pokazuje polski format, operator wpisuje w pomyłce
  • Kwoty z przecinkiem i spacjami („1 234,56”) — blokuje walidacja
  • Brak NIP-u kontrahenta albo NIP z myślnikami zamiast ciągiem cyfr

Pułapka 3 — certyfikaty i tokeny

KSeF wymaga podpisu elektronicznego lub tokena autoryzacyjnego. Tu firmy mają problem z:

  • Wygasającymi certyfikatami kwalifikowanymi — najlepiej mieć monitoring wygaśnięcia
  • Tokenami, do których nikt nie pamięta hasła
  • Uprawnieniami w KSeF — kto może wystawiać, kto tylko odbierać

Porządek w uprawnieniach

Najlepszy moment, żeby uporządkować uprawnienia w KSeF — rejestr kto co może, gdzie jest certyfikat, kiedy wygasa. Zrób to raz, oszczędzisz sobie paniki w kluczowym momencie.

Pułapka 4 — integracja ze sklepem internetowym

Jeśli sklep (WooCommerce, PrestaShop) automatycznie wystawia faktury w Subiekcie, dochodzi dodatkowa warstwa. Sklep wysyła dane zamówienia → Subiekt tworzy fakturę → Subiekt wysyła do KSeF. Każde z tych połączeń może zawieść.

  • Zamówienie ze sklepu ma puste pole NIP — zasady wystawiania faktur do KSeF dla różnych typów nabywców warto skonsultować z księgowym
  • Promocje ze sklepu generują zaokrąglenia, które rozjeżdżają sumy w KSeF
  • Błąd wysyłki do KSeF = zamówienie „wisi” — trzeba wiedzieć gdzie jest kolejka retry

Pułapka 5 — tryb testowy vs produkcyjny

KSeF ma osobne środowiska — testowe (sandbox) i produkcyjne. Faktury wysłane do sandbox NIE liczą się jako wystawione. Firmy czasem testują godzinami w sandbox, potem okazuje się, że musiały wystawić tych samych 50 faktur w produkcji.

Regułka: testuj w sandbox na fikcyjnych danych, potem przełącz konfigurację na produkcję. Nie mieszaj.

Co zrobić zanim zaczniesz

  • Audyt kartoteki produktów — sprawdź, czy nazwy są OK dla KSeF, czy trzeba dodatku do podmiany
  • Audyt NIP-ów kontrahentów — usunąć myślniki, wypełnić brakujące
  • Rejestr certyfikatów — kto ma, kiedy wygasa, kto zastępuje
  • Plan testów w sandbox — 10 typowych scenariuszy przed przejściem na produkcję
  • Plan „co gdy KSeF padnie” — ręczne faktury, komunikacja z klientem

KSeF nie jest strasznie trudny — ale jest formalny i mało wybaczający. Lepiej poświęcić tydzień na solidne przygotowanie, niż miesiąc na naprawianie pomyłek po fakcie.