Fakturownia i KSeF - podłączenie operatora
Jak podłączyć operatora do Fakturowni - konto, token API, dział sprzedawcy, tryb wysyłki do KSeF (testowy i produkcyjny), termin płatności, podstawa zwolnienia z VAT i webhook.
Zaktualizowano 2 listopada 2026
Na tej stronie
Faktury wystawia chmura w Fakturowni operatora i - gdy włączysz KSeF - wysyła je do KSeF. Każdy operator ma własne konto Fakturowni i jeden dział, który jest sprzedawcą na fakturach. Kasy w lokalizacjach faktur nie wystawiają: drukują gotowe dokumenty z chmury.
Zanim zaczniesz
Uprawnienia:
- Operator ma konto w Fakturowni z uzupełnionymi danymi firmy (co najmniej jeden dział).
- Wysyłkę do KSeF musi obsługiwać konto Fakturowni operatora - połączenie z KSeF ustawia się w Fakturowni. System wybiera tylko, czy i do którego środowiska KSeF wysyłać faktury.
- Panel jest dostępny z internetu po HTTPS - Fakturownia powiadamia go o zmianach faktur.
Co wystawia system
| Dokument | Kiedy |
|---|---|
| faktura VAT | sprzedaż z dokumentem „Faktura” dla firmy z NIP-em |
| faktura zaliczkowa i końcowa | wpłaty na zamówienie firmy i rozliczenie jego realizacji |
| faktura do paragonu | na żądanie klienta, z karty sprzedaży |
| faktura korygująca | zwrot albo korekta sprzedaży z fakturą |
| nota kaucyjna | kaucje za opakowania zwrotne - poza fakturą i poza KSeF |
Szczegóły pracy z fakturami są w artykule Faktury i KSeF.
Podłącz Fakturownię
- W Fakturowni skopiuj token API: Ustawienia › Ustawienia konta › Integracja › Kod autoryzacyjny API.
- W panelu przejdź do Konfiguracja › Operatorzy i otwórz operatora.
- Na karcie Faktury (Fakturownia) kliknij .
- Wpisz Konto Fakturowni (np.
mojafirmaalbohttps://mojafirma.fakturownia.pl) i Token API. - Kliknij i wybierz Dział sprzedawcy.
- Wybierz Wysyłkę do KSeF: na początek „KSeF - tryb testowy (DEMO)” albo „Bez KSeF”.
- Wpisz Termin płatności przelewu (dni) - domyślnie 7.
- Jeśli operator sprzedaje pozycje zwolnione z VAT, wybierz Podstawę zwolnienia z VAT (pozycje „zw”). Kliknij .
- Kliknij , a potem .
Webhook rejestruje się w Fakturowni sam - nie trzeba nic wklejać ręcznie. Na karcie widzisz potem Webhook / ostatnie sprawdzenie: „Zarejestrowany” i datę. Przycisk zmienia się na - użyj go po zmianie konta albo tokenu.
Token API zapisany raz nie wraca na ekran. Zostaw pole puste, jeśli go nie zmieniasz. Dane Fakturowni zostają w chmurze i nie trafiają na kasy.
Tryb wysyłki do KSeF
| Tryb | Co się dzieje |
|---|---|
| Bez KSeF | faktury powstają tylko w Fakturowni |
| KSeF - tryb testowy (DEMO) | faktury idą do testowego środowiska KSeF - bez skutków podatkowych |
| KSeF - produkcja | każda faktura, dla firmy i dla osoby prywatnej, idzie do KSeF; klient dostaje ją dopiero z numerem KSeF |
Stan integracji na karcie operatora
| Stan | Co znaczy |
|---|---|
| Nie skonfigurowana | brak konta i tokenu - faktur nie da się wystawić |
| Niekompletna - wybierz dział | jest konto, brakuje działu sprzedawcy |
| Skonfigurowana | system wystawia faktury w Fakturowni |
Ostatni błąd połączenia (np. nieważny token) wyświetla się na czerwono pod danymi karty.
Stawki VAT a faktura
Faktura bierze stawkę z pozycji sprzedaży. Stawka o nazwie zw idzie do Fakturowni jako zwolnienie - wtedy potrzebna jest Podstawa zwolnienia z VAT. Jak nazwać stawki, opisuje Stawki VAT.
Częste problemy
Powiązane
- Dodanie operatora Jak dodać operatora - firmę, która sprzedaje i wystawia dokumenty - uzupełnić jej dane, symbol w numeracji dokumentów i właściciela, a potem wyłączyć albo usunąć operatora.
- Faktury i KSeF Skąd biorą się faktury, noty kaucyjne i faktury korygujące, jak czytać stany faktury i KSeF, ponowić wystawienie, pobrać PDF, XML i UPO oraz wysłać fakturę e-mailem.
- Faktura do paragonu Jak na prośbę klienta wystawić fakturę do paragonu albo e-paragonu - dla firmy z paragonu z NIP lub dla osoby prywatnej - i w jakim terminie.