FAQ & Support

For KSeF Katalog

Last updated: 2026-02-28

Contact Us

If you have any questions, feedback, or need help with KSeF Katalog, please reach out to us:

Email: contact@thehardway.pl

Developer: Damian Wisniewski

We aim to respond to all inquiries within 48 hours.

Ogólne

Czym jest KSeF Katalog?

KSeF Katalog to aplikacja macOS umożliwiająca pobieranie, przeglądanie i organizowanie faktur ustrukturyzowanych z Krajowego Systemu e-Faktur (KSeF). Aplikacja pozwala katalogować faktury, tagować je, przeglądać pozycje faktur, generować podglądy PDF oraz analizować statystyki.

Czy Aplikacja jest powiązana z Ministerstwem Finansów?

Nie. KSeF Katalog to niezależna aplikacja. Nie jest tworzona, wspierana ani powiązana z Ministerstwem Finansów ani żadną instytucją rządową. Aplikacja korzysta z publicznego API KSeF udostępnionego przez Ministerstwo Finansów.

Czy Aplikacja stanowi poradę podatkową?

Nie. Statystyki, podsumowania i wyliczenia prezentowane w Aplikacji mają charakter wyłącznie informacyjny. Nie mogą być podstawą do rozliczeń podatkowych. W sprawach podatkowych skonsultuj się z doradcą podatkowym.

Połączenie z KSeF

Jak uzyskać token autoryzacyjny KSeF?

Token autoryzacyjny KSeF można wygenerować na stronie Ministerstwa Finansów:

  1. Wejdź na stronę https://ksef.mf.gov.pl
  2. Zaloguj się za pomocą Profilu Zaufanego, e-Dowodu lub podpisu kwalifikowanego
  3. Przejdź do sekcji zarządzania tokenami
  4. Wygeneruj nowy token z uprawnieniami do odczytu faktur
  5. Skopiuj wygenerowany token i wklej go w ustawieniach KSeF Katalog

Token powinien mieć uprawnienia do pobierania faktur (odczyt). Nie jest wymagane uprawnienie do wystawiania faktur.

Jak skonfigurować połączenie w Aplikacji?

  1. Otwórz KSeF Katalog
  2. Przejdź do Ustawienia (Cmd+,)
  3. W sekcji Konto KSeF wpisz NIP podmiotu
  4. Wklej token autoryzacyjny KSeF
  5. Wybierz środowisko: Produkcja (prawdziwe faktury) lub Test (środowisko testowe)
  6. Kliknij Zapisz

Jakie środowisko wybrać?

  • Produkcja — do pracy z prawdziwymi fakturami z systemu KSeF
  • Test — do przetestowania Aplikacji na środowisku testowym KSeF (faktury testowe)

Synchronizacja faktur

Jak działa synchronizacja?

Po skonfigurowaniu połączenia z KSeF, kliknij przycisk synchronizacji na pasku narzędzi. Aplikacja pobierze faktury z systemu KSeF i zapisze je lokalnie na Twoim komputerze.

Synchronizacja pobiera:

  • Faktury przychodzące (otrzymane)
  • Faktury wychodzące (wystawione)
  • Pełne dane XML każdej faktury

Czy synchronizacja jest automatyczna?

Nie. Synchronizacja uruchamiana jest ręcznie przez użytkownika. Aplikacja nie pobiera faktur w tle.

Gdzie są przechowywane pobrane faktury?

Wszystkie faktury są przechowywane wyłącznie lokalnie na Twoim komputerze — w bazie danych SwiftData oraz jako pliki XML w katalogu Application Support. Żadne dane nie są wysyłane na zewnętrzne serwery.

Dane demonstracyjne

Co to są dane demonstracyjne?

Dane demonstracyjne to przykładowe, fikcyjne faktury wyświetlane w Aplikacji przed połączeniem z kontem KSeF. Pozwalają zapoznać się z interfejsem i funkcjami Aplikacji bez konieczności posiadania konta KSeF.

Jak usunąć dane demonstracyjne?

Przejdź do Ustawienia (Cmd+,) i skorzystaj z opcji usunięcia danych demonstracyjnych. Dane demonstracyjne nie wpływają na prawdziwe faktury pobrane z KSeF.

Wersja Pro

Jakie funkcje oferuje wersja Pro?

Wersja Pro odblokowuje:

FunkcjaDarmowaPro
Pobieranie i przeglądanie faktur✓✓
Katalogi i tagi (do 3)✓✓
Katalogi i tagi (bez limitu)—✓
Panel statystyk—✓
Generowanie podglądu PDF—✓
Kategorie pozycji faktur—✓
Eksport do CSV—✓

Czy to jednorazowy zakup czy subskrypcja?

KSeF Katalog Pro to jednorazowy zakup (nie subskrypcja). Płacisz raz i masz dostęp do funkcji Pro na zawsze, bez dodatkowych opłat.

Jak przywrócić zakup na innym urządzeniu?

Jeśli kupiłeś wersję Pro i chcesz ją przywrócić na innym komputerze Mac (z tego samego Apple ID):

  1. Otwórz KSeF Katalog
  2. Gdy pojawi się ekran uaktualnienia, kliknij Przywróć zakupy
  3. Zakup zostanie automatycznie przywrócony

Eksport danych

Jak wyeksportować dane do CSV?

Funkcja eksportu jest dostępna w wersji Pro. Aby wyeksportować dane:

  1. Przejdź do menu Plik
  2. Wybierz jedną z opcji eksportu:
    • Eksport listy faktur
    • Eksport pozycji faktur
    • Eksport statystyk tagów
  3. Wybierz lokalizację zapisu pliku CSV

Czy pliki CSV są kompatybilne z Apple Numbers i Excel?

Tak. Pliki CSV generowane przez Aplikację używają kodowania UTF-8 i są w pełni kompatybilne z Apple Numbers, Microsoft Excel oraz innymi arkuszami kalkulacyjnymi.

Prywatność i bezpieczeństwo

Czy moje dane są bezpieczne?

Tak. Wszystkie dane są przechowywane wyłącznie na Twoim komputerze. Token autoryzacyjny KSeF i NIP są przechowywane w macOS Keychain (szyfrowane przez system). Aplikacja nie wysyła żadnych danych na serwery Wydawcy i nie korzysta z usług analitycznych.

Więcej informacji: Polityka prywatności

Czy Aplikacja zbiera dane analityczne?

Nie. Aplikacja nie zbiera żadnych danych analitycznych, nie stosuje śledzenia użytkowników i nie korzysta z żadnych usług telemetrycznych.

Problemy techniczne

Aplikacja nie może połączyć się z KSeF

Sprawdź:

  1. Czy NIP i token autoryzacyjny są poprawne
  2. Czy wybrałeś właściwe środowisko (Produkcja/Test)
  3. Czy Twoje połączenie internetowe działa
  4. Czy system KSeF jest dostępny — sprawdź status na stronie https://ksef.mf.gov.pl

Gdzie zgłosić problem?

Jeśli napotkasz problem z Aplikacją, skontaktuj się z nami:

Back to KSeF Katalog