wFirma a KSeF - jak wysyłać e-faktury krok po kroku

wFirma a KSeF - co musisz wiedzieć na start

wFirma obsługuje wysyłkę faktur do Krajowego Systemu e-Faktur, więc nie potrzebujesz osobnego programu tylko do KSeF. System pozwala uwierzytelnić się w KSeF, wystawić e-fakturę zgodną ze strukturą FA i wysłać ją bez opuszczania panelu. To wygodne, bo cały tor od dokumentu do potwierdzenia z systemu zamyka się w jednym miejscu.

Sama wysyłka działa dopiero wtedy, gdy spełnisz trzy warunki: nadasz uprawnienia w KSeF, połączysz wFirma z systemem przez token lub uwierzytelnianie kwalifikowane i zadbasz o komplet danych na fakturze. Najwięcej problemów na starcie wynika z trzeciego punktu - faktura z błędnym NIP albo niepełnym adresem nabywcy zostanie odrzucona, niezależnie od poprawnej konfiguracji. Dlatego w tej instrukcji tyle samo miejsca poświęcamy ustawieniom, co jakości danych.

Zanim przejdziemy dalej, jedno zastrzeżenie: to praktyczny przewodnik konfiguracyjny, a nie porada podatkowa ani prawna. Zakres uprawnień, terminy i szczegóły rozliczeń potwierdź u swojego księgowego lub doradcy podatkowego oraz w aktualnych materiałach Ministerstwa Finansów, bo przepisy bywają zmieniane.

Uprawnienia i uwierzytelnianie w KSeF

Pierwszy element to uprawnienia po stronie KSeF. System rozróżnia, kto i w czyim imieniu może wystawiać faktury, więc bez nadanego uprawnienia wFirma nie zautoryzuje sesji. Sposób zależy od formy prowadzenia firmy.

• Jednoosobowa działalność - właściciel jest uprawniony samoistnie i uwierzytelnia się profilem zaufanym, podpisem kwalifikowanym albo wygenerowanym tokenem. Więcej o samym mechanizmie potwierdzania tożsamości piszemy w tekście o tym, czym jest numer KSeF i uwierzytelnianie.
• Spółka lub większa firma - uprawnienia nadaje się wskazanym osobom albo systemowi wystawiającemu (uprawnienie typu samofakturowanie lub wystawianie). To wygodne, gdy faktury generuje program, a nie konkretny człowiek.

W praktyce do automatycznej wysyłki z wFirma najczęściej korzysta się z tokena. Token to ciąg autoryzujący, który pozwala systemowi działać w Twoim imieniu bez logowania osoby przy każdej fakturze. Traktuj go jak hasło: nie udostępniaj, a w razie podejrzenia wycieku unieważnij i wygeneruj nowy.

Konfiguracja KSeF w wFirma krok po kroku

Po stronie wFirma konfiguracja sprowadza się do kilku kroków. Układ ekranów bywa aktualizowany, więc nazwy sekcji potraktuj orientacyjnie i kieruj się bieżącą pomocą wFirma.

1. Sprawdź dane firmy. Upewnij się, że NIP, nazwa i adres sprzedawcy w ustawieniach konta są poprawne i zgodne z rejestrami. To dane, które trafią do każdej e-faktury.
2. Wejdź w ustawienia KSeF. W panelu wFirma znajdziesz sekcję dotyczącą Krajowego Systemu e-Faktur, gdzie podaje się dane uwierzytelniające.
3. Podłącz uwierzytelnianie. Wklej token wygenerowany w KSeF dla swojego podmiotu albo skonfiguruj uwierzytelnianie podpisem kwalifikowanym, zależnie od wybranej metody.
4. Wybierz tryb wysyłki. Zdecyduj, czy faktury mają lecieć do KSeF automatycznie po wystawieniu, czy ręcznie, pojedynczo lub partiami. Dla sklepu z dużą liczbą zamówień sensowna jest wysyłka automatyczna.
5. Wykonaj test. Wystaw kilka faktur na różnych przypadkach (B2B z NIP, sprzedaż krajowa, korekta) i sprawdź, czy przechodzą walidację. Testy najlepiej zrobić wcześnie, a nie tuż przed terminem obowiązkowym. Pełną listę kroków przygotowania znajdziesz w checkliście wdrożenia KSeF w sklepie.

Po skonfigurowaniu połączenia wystawienie faktury w wFirma uruchamia wysyłkę do KSeF zgodnie z wybranym trybem. Jeśli wszystko jest poprawne, dokument otrzymuje numer KSeF i potwierdzenie przyjęcia.

Statusy faktur i numer KSeF

Wysyłka do KSeF to proces, a nie pojedyncze kliknięcie, dlatego warto rozumieć statusy dokumentów w wFirma. Każda faktura przechodzi przez kilka stanów, zanim uznasz ją za prawnie wprowadzoną do obiegu.

Kluczowy jest numer KSeF. To identyfikator nadawany przez system po przyjęciu poprawnej faktury i dopiero jego otrzymanie potwierdza skuteczne wprowadzenie dokumentu do obiegu. Faktura ze statusem odrzucona nie ma numeru KSeF, więc nie jest uznana za prawnie wystawioną, dopóki nie poprawisz błędu i nie wyślesz jej ponownie.

Najczęstsze przyczyny odrzucenia to błędny lub nieaktywny NIP nabywcy, niekompletny adres oraz niezgodność ze strukturą e-faktury. Przy pojedynczych dokumentach łatwo to wyłapać ręcznie, ale przy kilkudziesięciu fakturach dziennie potrzebujesz mechanizmu, który zatrzyma problematyczne dokumenty i pozwoli je ponowić po naprawie, zamiast gubić je po cichu.

Jak NavyFlame dba o komplet danych przed wysyłką

wFirma odpowiada za wystawienie i wysyłkę e-faktury do KSeF. NavyFlame działa o krok wcześniej: zbiera zamówienia z różnych kanałów i przygotowuje komplet danych, z których powstaje faktura. To istotne, bo jakość danych decyduje o tym, czy KSeF przyjmie dokument, czy go odrzuci.

W sprzedaży wielokanałowej dane przychodzą w różnych formatach. Allegro, własny sklep i kolejny marketplace inaczej opisują nabywcę, pozycje i stawki VAT. NavyFlame pełni rolę huba: pobiera zamówienia, mapuje je do spójnego formatu i zleca automatyczne fakturowanie w wFirma według Twoich reguł. Dzięki temu faktura powstaje z poprawnym NIP, prawidłową stawką VAT i kompletnym adresem, czyli z danymi, na których walidacja KSeF najczęściej się wykłada.

Tor wygląda tak: zamówienie z kanału trafia do NavyFlame, system buduje fakturę z kompletem danych, wFirma ją wystawia i wysyła do KSeF, a numer KSeF potwierdza przyjęcie. Gdy coś się nie powiedzie (na przykład chwilowy błąd po stronie API), dokument trafia do kolejki ponownych prób, a Ty widzisz status w panelu zamiast szukać zgubionej faktury. Jak ułożyć całą konfigurację fakturowania w wFirma od strony sklepu, opisujemy w osobnym przewodniku po wFirma dla e-commerce.

Co ważne, NavyFlame nie zastępuje wFirma ani nie pełni roli systemu wystawiającego faktury wobec KSeF. To wFirma uwierzytelnia się w KSeF i nadaje numer, a integrator pilnuje, żeby do wFirma trafiały dane, które tę wysyłkę przejdą bez odrzuceń.

Najczęstsze problemy z wysyłką do KSeF

Większość kłopotów daje się sprowadzić do kilku powtarzalnych przyczyn. Warto znać je z góry, żeby nie tracić czasu na diagnozę w dniu, w którym faktur jest najwięcej.

• Brak uprawnienia w KSeF - sesja nie autoryzuje się, mimo że token jest wklejony. Sprawdź, czy podmiot lub osoba ma nadane uprawnienie do wystawiania.
• Wygasły lub unieważniony token - po rotacji tokena trzeba zaktualizować go w ustawieniach wFirma, inaczej wysyłka przestaje działać.
• Błędne dane nabywcy - nieaktywny NIP, literówka w nazwie firmy, niepełny adres. To najczęstsza przyczyna odrzuceń przy sprzedaży masowej.
• Niezgodność ze strukturą e-faktury - rzadziej, ale zdarza się przy nietypowych pozycjach lub stawkach. Tu zwykle pomaga aktualizacja systemu fakturowego.

Jeśli wysyłasz dużo faktur dziennie, ręczne kontrolowanie każdego statusu przestaje być realne. Wtedy wartość daje połączenie automatycznego fakturowania z monitoringiem - faktury powstają same, a Ty reagujesz tylko na te, które wymagają poprawy. To pozwala utrzymać porządek nawet przy szczytach sprzedażowych, gdy liczba dokumentów rośnie kilkukrotnie.

Najczesciej zadawane pytania