Dokumentacja

Przewodnik po aplikacji KSeFka

Licencja PRO#

KSeFka dostępna jest w dwóch wersjach: bezpłatnej (FREE) i płatnej (PRO). Każda instalacja zaczyna od 30-dniowego okresu próbnego z pełnym PRO, wspólnego dla aplikacji, CLI i MCP, bez rejestracji.

Porównanie wersji#

FunkcjaFREEPRO
Zarządzanie fakturami✓✓
Synchronizacja z KSeF✓✓
Pulpit i statystyki✓✓
Kontrahenci✓✓
Konta bankowe✓✓
Generowanie PDF (bez logo i kodu QR do zapłaty)✓✓
Szablony faktur✓✓
Wysyłka faktury e-mailem (ręcznie)✓✓
Eksport ZIP dla księgowej✓✓
QR do zapłaty faktury otrzymanej✕✓
Biała lista VAT✕✓
Plik przelewów do banku1 eksport✓
Załączniki1 do faktury otrzymanej✓
Faktury cykliczne✕✓
Faktury pro-forma✕✓
QR do zapłaty na PDF faktury i pro-formy✕✓
Personalizacja✕✓
Automatyczna wysyłka faktury e-mailem✕✓
Integracja z asystentami AI (MCP)✕✓
Wiersz poleceń (CLI)✕✓
Praca w tle po zamknięciu okna✕✓
Integracje (webhook, JSONL)✕✓

Zakup licencji PRO#

Licencję PRO możesz kupić na stronie ksefka.com/pro. Po zakupie otrzymasz token aktywacyjny.

Aktywacja#

  1. Przejdź do Ustawienia → Licencja
  2. Wklej token licencji w pole tekstowe
  3. Kliknij Aktywuj

Po aktywacji zobaczysz:

  • Zieloną etykietę PRO zamiast FREE lub PRO (okres próbny)
  • Adres e-mail powiązany z licencją
  • Datę aktywacji

Status licencji#

Status licencji widoczny jest w Ustawienia → Licencja:

  • PRO (okres próbny) (bursztynowy) — 30 dni pełnego PRO od pierwszego uruchomienia, z liczbą pozostałych dni i datą końca; w ostatnich 7 dniach i po zakończeniu aplikacja pokazuje nad treścią zamykany pasek z przyciskiem zakupu
  • FREE (szary) — wersja bezpłatna; po zakończeniu okresu próbnego sekcja podaje datę jego końca, a dane z tego okresu (pro-formy, załączniki, logo, harmonogramy faktur cyklicznych) zostają w aplikacji i wracają do użytku po aktywacji licencji
  • PRO (zielony) — licencja aktywna, wyświetlany e-mail i data aktywacji

Funkcje PRO#

CLI (narzędzie wiersza poleceń)#

Narzędzie do zarządzania fakturami z terminala. Instalacja dostępna w Ustawienia → CLI.

MCP (Model Context Protocol)#

Integracja z asystentami AI (np. Claude), umożliwiająca zarządzanie fakturami za pomocą poleceń w języku naturalnym.

Faktury cykliczne#

Automatyczne tworzenie faktur na podstawie harmonogramu — np. co miesiąc dla stałych umów. Cykl tworzysz z poziomu wystawionej faktury (Więcej → Utwórz cykliczną). Bez PRO (po okresie próbnym albo unieważnieniu licencji) harmonogramy zostają do wglądu, wstrzymania i usunięcia, ale aplikacja nie wystawia z nich faktur: harmonogram z minionym terminem wstrzymuje, a po aktywacji licencji wznawiasz go ręcznie, bez dopisywania zaległych faktur. Szczegóły: Faktury cykliczne.

Faktury pro-forma#

Wezwanie do zapłaty poza KSeF z własną numeracją PF/<nr>/<rok>, a po otrzymaniu wpłaty — przekształcenie jednym kliknięciem w fakturę VAT lub zaliczkową. Szczegóły: Faktury pro-forma.

Personalizacja (white label)#

Własne logo na fakturze i w pasku bocznym oraz dodatkowy tekst kontaktowy na fakturze. Szczegóły: Personalizacja.

Integracje (webhook, JSONL)#

Powiadamianie zewnętrznych systemów o nowych fakturach otrzymanych z synchronizacji KSeF — przez webhook HTTP lub plik zdarzeń JSONL. Szczegóły: Integracje (webhook, JSONL).

QR do zapłaty faktury otrzymanej#

Kod QR w standardzie ZBP ("zeskanuj i zapłać") w szczegółach nieopłaconej faktury otrzymanej — jeden skan w aplikacji banku wypełnia dane przelewu. Szczegóły: Faktury otrzymane.

QR do zapłaty na PDF faktury i pro-formy#

Ten sam kod ZBP po drugiej stronie transakcji: na PDF wystawionej faktury i pro-formy, w sekcji płatności. Twój kontrahent skanuje go w aplikacji swojego banku zamiast przepisywać numer konta i kwotę. Opcja jest domyślnie wyłączona — włączasz ją per firma w sekcji Personalizacja.

Biała lista VAT#

Po każdej synchronizacji KSeFka sprawdza w Wykazie podatników VAT rachunki z nowych, nieopłaconych faktur otrzymanych płatnych przelewem. Wynik z numerem potwierdzenia MF zostaje przy fakturze, a rachunek spoza listy jest oznaczony przed przelewem. Sprawdzanie działa w środowisku produkcyjnym KSeF. Szczegóły: Biała lista VAT.

Plik przelewów do banku#

Plik do importu w bankowości internetowej z zaznaczonych faktur otrzymanych: przelewy krajowe (Elixir-0), z podzieloną płatnością (MPP) i SEPA w euro. Pierwszy eksport jest darmowy, każdy kolejny wymaga PRO.

Załączniki#

Bez PRO do każdej faktury otrzymanej dodasz jeden załącznik, np. skan. Kolejne załączniki do faktury otrzymanej i wszystkie załączniki do faktury wystawionej (umowa, protokół, korespondencja) wymagają PRO. Szczegóły: Załączniki.

Automatyczna wysyłka faktury e-mailem#

Gdy KSeF przyjmie wystawioną fakturę, KSeFka sama wysyła jej PDF na adres e-mail kontrahenta. Ręczna wysyłka przyciskiem Wyślij na email działa także bez PRO. Szczegóły: Wysyłka faktur e-mailem.

Praca w tle po zamknięciu okna#

Proces pracy w tle pobiera faktury z KSeF i wysyła faktury z kolejki także po zamknięciu okna, do wylogowania z systemu. Praca w tle przy otwartym oknie działa bez PRO. Szczegóły: Synchronizacja z KSeF.

Kupno PRO z poziomu aplikacji#

Na Pulpicie widoczny jest przycisk Kup wersję PRO, który otwiera stronę zakupu w przeglądarce. Przycisk pojawia się tylko w wersji FREE.