WAPRO Fakturka — konfiguracja i fakturowanie w KSeF

Konfiguracja KSeF w WAPRO Fakturka zaczyna się od połączenia programu z systemem i przygotowania dostępu firmy.
Potem trzeba ustawić wysyłkę i odbiór faktur oraz sprawdzić, czy dokumenty przechodzą poprawnie. Sposób obsługi może zależeć od używanej wersji programu. Obowiązek wystawiania faktur w KSeF obejmuje duże firmy od 1 lutego 2026 r., pozostałych podatników od 1 kwietnia, a najmniejszych od 1 stycznia 2027 r.¹.

Konfiguracja KSeF w WAPRO Fakturka krok po kroku

Najpierw ustal, kto będzie działać w KSeF w imieniu firmy. Przygotuj uprawnienia tej osoby i metodę uwierzytelniania, a w WAPRO Fakturka wybierz właściwą firmę.
W jednym zawiadomieniu ZAW-FA można wskazać tylko jedną osobę fizyczną. Ta osoba może później elektronicznie nadać uprawnienia kolejnym osobom².

Uwierzytelnianie potwierdza tożsamość osoby lub podmiotu, który łączy się z KSeF. Uprawnienia KSeF określają z kolei, jakie czynności wolno wykonać w imieniu firmy.
Samo potwierdzenie tożsamości nie daje więc dostępu do każdej czynności. Przed autoryzacją w programie przypisz osobie właściwy zakres uprawnień³.

Jak ustawić uwierzytelnianie i uprawnienia KSeF w WAPRO Fakturka?

Przygotowanie dostępu wymaga powiązania osoby uprawnionej z danymi firmy i metodą autoryzacji. Certyfikat KSeF używany do uwierzytelniania jest ważny nie dłużej niż dwa lata od wytworzenia lub wskazanej daty początkowej⁴. Przed rozpoczęciem pracy wykonaj następujące czynności:

• Dane firmy: Dane firmy w programie muszą wskazywać podmiot, którego dokumenty trafią do KSeF.
• Uprawnienia: Osobie obsługującej faktury nadaj odpowiedni zakres dostępu w systemie KSeF 2.0, w tym przez Aplikację Podatnika MF lub bezpośrednio w Wapro Fakturka⁵.
• Certyfikat KSeF: Przygotuj certyfikat, jeżeli wybrana metoda integracji używa go do uwierzytelniania.
• Autoryzacja: Powiąż metodę uwierzytelniania z właściwą firmą w ustawieniach używanej wersji programu.

Po tych czynnościach dostęp użytkownika WAPRO Fakturka jest powiązany z firmą, której faktury ma obsługiwać w KSeF³.

Wysyłka faktury i sprawdzanie połączenia z KSeF

Zapisanie faktury w WAPRO Fakturka nie oznacza jeszcze, że trafiła ona do KSeF. Po wysyłce odczytaj status dokumentu i komunikat zwrotny.
Numer KSeF potwierdza przyjęcie konkretnej faktury przez system. Ma 35 znaków⁶.

Odbiór faktur sprawdzaj osobno, bo dotyczy dokumentów wystawionych firmie przez kontrahentów. Dane odebranej faktury porównaj z tym, co widnieje w KSeF.
Zestaw dziesięciocyfrowy NIP nabywcy z polem NIP w elemencie Podmiot2 odebranego dokumentu⁷.

Jak sprawdzić, czy WAPRO Fakturka łączy się z KSeF?

O wyniku wysyłki mówi status konkretnej faktury, nie sam fakt nawiązania połączenia. Kod 200 w statusie przetwarzania potwierdza przyjęcie dokumentu; sam kod HTTP 200 tego nie zastępuje⁸.
Przy wysyłaniu faktury wykonaj poniższe czynności:

• Faktura: Wybierz fakturę przeznaczoną do przekazania do KSeF.
• Ręczna wysyłka do KSeF: Uruchom ją, jeśli używana wersja programu udostępnia tę czynność.
• Status wysyłki: Odczytaj komunikat zwrotny i sprawdź, czy KSeF przyjął dokument.
• Numer KSeF: Sprawdź, czy program przypisał go do przyjętej faktury.

Przyjęcie faktury i nadanie jej numeru KSeF potwierdzają wynik wysyłki. Zgodnie z art. 106na ust. 3 ustawy o VAT fakturę uznaje się za otrzymaną przez KSeF w dniu nadania jej numeru identyfikującego⁹.

Błędy konfiguracji KSeF w WAPRO Fakturka: jak je rozpoznać i usunąć?

Gdy WAPRO Fakturka zgłasza błąd, ustal etap, na którym kończy się próba wysyłki: autoryzację, połączenie lub weryfikację dokumentu. Przed zmianą ustawień przeczytaj cały komunikat.
Odpowiedź API z kodem HTTP 401 Unauthorized wskazuje problem z uwierzytelnieniem żądania. Nie należy jej mylić z błędem uprawnień 403¹⁰.

• Błąd autoryzacji oznacza problem z potwierdzeniem dostępu do KSeF. Sprawdź, czy metoda uwierzytelniania dotyczy właściwej firmy.
• Błąd połączenia dotyczy komunikacji programu z systemem. Sprawdź sieć i wybrane środowisko KSeF, a potem ponów próbę.
• Odrzucenie dokumentu następuje po przekazaniu faktury do weryfikacji. Odczytaj przyczynę, popraw wskazane dane i dopiero wtedy wyślij ją ponownie¹¹.

Jeżeli faktura nie została wysłana, w buforze pojawi się status błędny i będą dostępne szczegóły błędu¹².

Dane firmy i ustawienia faktur: przygotowanie dokumentów do KSeF

WAPRO Fakturka potrzebuje poprawnych danych firmy i faktury, by przygotować dokument do wysyłki. Przed przekazaniem go do KSeF skontroluj poniższe elementy¹¹:

• Dane sprzedawcy: Porównaj NIP i nazwę firmy w programie z danymi podmiotu wystawiającego fakturę.
• Dane kontrahenta: Sprawdź identyfikator i nazwę nabywcy wpisane na dokumencie.
• Pozycje faktury: Skontroluj nazwy towarów lub usług, kwoty oraz zastosowane stawki podatku.
• Rodzaj dokumentu: Upewnij się, że ustawienia odpowiadają wystawianej fakturze.

Popraw dane przed wysyłką, aby ograniczyć ryzyko odrzucenia dokumentu przez KSeF¹¹.

Środowisko KSeF w WAPRO Fakturka: wybór i ustawienie

WAPRO Fakturka musi łączyć się z właściwym środowiskiem KSeF. Produkcyjne służy do obsługi rzeczywistych faktur, a testowe do prób działania integracji.
Wybór środowiska zależy od celu pracy, nie od danych kontrahenta. Środowiska produkcyjne i testowe mają odrębne adresy API¹³.

Tabela pokazuje cel użycia każdego środowiska i skutek wysłania do niego dokumentu. KSeF 2.0 ma trzy środowiska: testowe, przedprodukcyjne Demo i produkcyjne. Tylko faktury wystawione w środowisku produkcyjnym wywierają skutki prawne¹⁴.

• Cel pracy: Ustal, czy sprawdzasz integrację, czy przygotowujesz rzeczywistą fakturę.
• Ustawienie połączenia: Wybierz środowisko odpowiadające temu celowi, jeśli używana wersja programu pozwala na taki wybór.
• Kontrola przed wysyłką: Sprawdź wybrane środowisko, zanim przekażesz dokument.

Faktury przeznaczone dla kontrahentów kieruj do środowiska produkcyjnego, a nie testowego.
Art. 106na ust. 1 ustawy o VAT wiąże dzień wystawienia faktury ustrukturyzowanej z jej przesłaniem do KSeF, z zastrzeżeniem trybów szczególnych¹⁵.

Najczęściej zadawane pytania

Czy konfiguracja KSeF wygląda tak samo w każdej wersji WAPRO Fakturka?

Nie zawsze — sposób obsługi może zależeć od używanej wersji programu. Niektóre czynności, takie jak ręczna wysyłka lub wybór środowiska, mogą być dostępne zależnie od wersji.

Od kiedy firmy mają obowiązek wystawiania faktur w KSeF?

Duże firmy obejmuje obowiązek od 1 lutego 2026 r., pozostałych podatników od 1 kwietnia, a najmniejszych od 1 stycznia 2027 r.

Ile osób można wskazać w jednym zawiadomieniu ZAW-FA?

Wskazana osoba może później elektronicznie nadać uprawnienia kolejnym osobom.

Jak długo jest ważny certyfikat KSeF do uwierzytelniania?

Nie dłużej niż dwa lata od wytworzenia lub wskazanej daty początkowej.

Czy kod HTTP 200 sam potwierdza przyjęcie faktury przez KSeF?

Nie. Przyjęcie potwierdza kod 200 w statusie przetwarzania faktury; sam kod HTTP 200 nie wystarcza.