· Dokument

Wsparcie i FAQ

Ostatnia aktualizacja: 2026-04-09

Kontakt

Jeśli masz pytania, sugestie albo potrzebujesz pomocy z KSeF Katalog — napisz do nas:

E-mail: contact@thehardway.pl

Twórca: Damian Wiśniewski

Odpowiadamy zazwyczaj w ciągu 48 godzin.

Ogólne

Czym jest KSeF Katalog?

KSeF Katalog to aplikacja na macOS i iPadOS 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:

Wejdź na stronę ksef.mf.gov.pl
Zaloguj się za pomocą Profilu Zaufanego, e-Dowodu lub podpisu kwalifikowanego
Przejdź do sekcji zarządzania tokenami
Wygeneruj nowy token z uprawnieniami do odczytu faktur
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?

Otwórz KSeF Katalog
Przejdź do Ustawienia (Cmd+,)
W sekcji Konto KSeF wpisz NIP podmiotu
Wklej token autoryzacyjny KSeF
Wybierz środowisko: Produkcja (prawdziwe faktury) lub Test (środowisko testowe)
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 urządzeniu.

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 urządzeniu — 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:

Funkcja	Darmowa	Pro
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 urządzeniu — Macu lub iPadzie (z tego samego Apple ID):

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

Eksport danych

Jak wyeksportować dane do CSV?

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

Przejdź do menu Plik
Wybierz jedną z opcji eksportu:
- Eksport listy faktur
- Eksport pozycji faktur
- Eksport statystyk tagów
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 urządzeniu. Token autoryzacyjny KSeF i NIP są przechowywane w systemowym 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.

iPad

Czy KSeF Katalog działa na iPadzie?

Tak. KSeF Katalog jest dostępny na iPadzie z systemem iPadOS 18.0 lub nowszym. Interfejs automatycznie dostosowuje się do rozmiaru ekranu iPada.

Czy funkcje Pro działają tak samo na iPadzie?

Tak. Wszystkie funkcje Pro (statystyki, PDF, eksport CSV, kategorie) są dostępne zarówno na Macu, jak i na iPadzie. Zakup Pro jest współdzielony — kupujesz raz i korzystasz na obu platformach.

Czy dane synchronizują się między Macem a iPadem?

Nie. Dane są przechowywane lokalnie na każdym urządzeniu osobno. Faktury pobrane na Macu nie pojawiają się automatycznie na iPadzie — konieczna jest osobna synchronizacja z KSeF na każdym urządzeniu.

Problemy techniczne

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

Sprawdź:

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

Gdzie zgłosić problem?

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

E-mail: contact@thehardway.pl
Strona: thehardway.pl