Dokument

Wsparcie i FAQ

Ostatnia aktualizacja: 2026-09-09

Dokument wiążący prawnie: thehardway.pl/apps/ksef-katalog/support. Ta wersja jest mirrorem na stronie marketingowej i może zawierać drobne opóźnienie w aktualizacji względem wersji wiążącej.

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	—	✓
Lokalny serwer MCP (macOS)	—	✓

Pro Lifetime czy subskrypcja Pro — co wybrać?

Od wersji 2.0 oferujemy dwie alternatywne ścieżki dostępu do tych samych funkcji Pro:

Cecha	Pro Lifetime (jednorazowo)	Pro Subskrypcja
Cena	jednorazowo	9,99 zł / miesiąc
Czas trwania	bezterminowy	dopóki opłacasz
Auto-odnowienie	nie dotyczy	tak (anulowane w dowolnym momencie)
Idealne dla	użytkowników, którzy planują długoterminowe korzystanie	użytkowników szukających niskiego progu wejścia

Funkcjonalnie obie opcje odblokowują identyczny zestaw funkcji.

Mam już Pro Lifetime — czy mogę kupić subskrypcję?

Nie. Aplikacja blokuje zakup subskrypcji jeśli wykryje aktywne Pro Lifetime, aby uchronić Cię przed podwójną płatnością. Twoje Pro Lifetime daje dostęp do wszystkich funkcji v2.0 oraz przyszłych aktualizacji bez dodatkowych opłat.

Mam aktywną subskrypcję — czy mogę kupić Pro Lifetime?

Tak. Po zakupie Pro Lifetime zaleca się anulowanie subskrypcji w panelu Apple ID, aby uniknąć dalszych obciążeń. Aplikacja pokazuje banner z linkiem do zarządzania subskrypcją w odpowiednim momencie.

Jak anulować subskrypcję Pro?

macOS: otwórz apps.apple.com/account/subscriptions, wybierz „KSeF Katalog Pro”, kliknij Anuluj subskrypcję
iPadOS: Ustawienia → [Twoje imię] → Subskrypcje → KSeF Katalog Pro → Anuluj subskrypcję

Po anulowaniu zachowujesz dostęp do funkcji Pro do końca opłaconego okresu.

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

Dotyczy zarówno Pro Lifetime, jak i subskrypcji Pro.

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.

Lokalny serwer MCP (Pro, macOS)

Co to jest serwer MCP?

Lokalny serwer Model Context Protocol pozwala klientom AI (np. Claude Desktop, Cursor, mcp-inspector) odpytywać Twoje faktury bezpośrednio na Macu. Możesz na przykład poprosić AI: „Pokaż faktury z marca 2026 od Allegro” lub „Oznacz wszystkie faktury z Q1 jako rozliczone”.

Czy to jest bezpieczne?

Tak. Serwer:

Działa wyłącznie lokalnie (127.0.0.1) — nikt z sieci LAN ani internetu nie może się połączyć
Nie wymaga osobnego tokena MCP; ochroną przed dostępem z sieci jest nasłuchiwanie wyłącznie na interfejsie loopback
Gdy jest włączony, może się z nim połączyć każdy proces na tym Macu; zalecany tryb początkowy to Read-only
Domyślnie jest wyłączony — sam decydujesz czy włączyć i w jakim trybie
Każda zmiana wykonana przez AI jest logowana w Historii zmian z możliwością cofnięcia

Tryby Off / Read-only / Read+Write — czym się różnią?

Off — serwer nie nasłuchuje, klient AI nie ma dostępu do danych
Read-only — AI może czytać dane (lista faktur, statystyki), ale nie może niczego zmieniać
Read+Write — AI może dodatkowo zmieniać atrybuty wzbogacające: przypisać fakturę do katalogu, dodać/usunąć tag, zmienić kategorię pozycji. Nie może modyfikować numeru, kwot, dat ani kontrahentów — KSeF jest jedynym źródłem prawdy.

Jak skonfigurować Claude Desktop?

Pełna instrukcja: ksef-katalog.pl/mcp

Skrót:

Włącz serwer MCP w Ustawieniach (Pro, macOS)
Wybierz tryb (rekomendowany na start: Read-only)
Upewnij się, że masz Node.js 18 lub nowszy (node --version)
Skopiuj konfigurację Claude Desktop z mostkiem mcp-remote
Wklej ją do claude_desktop_config.json
Zamknij Claude Desktop przez Cmd + Q i uruchom go ponownie

Czy moje faktury opuszczają Mac?

Sama aplikacja KSeF Katalog nie wysyła faktur poza urządzenie. Jednak klient MCP jest osobnym programem — jeśli używasz np. Claude Desktop, klient ten może przekazywać kontekst rozmowy (w tym treść faktur) do Anthropic w celu generowania odpowiedzi AI. Decyzja o wyborze klienta i akceptacji jego polityki prywatności należy do Ciebie.

Szczegóły: Polityka prywatności § 4a

Skróty / Siri / Spotlight

Jakie funkcje są dostępne przez Skróty?

5 darmowych intencji App Intents:

Otwórz fakturę — deep-link do widoku szczegółów
Wyszukaj faktury — full-text search po numerze, kontrahencie, numerze KSeF
Faktury z okresu — lista z zakresu dat (z opcjonalnymi filtrami)
Suma miesięczna — agregowana kwota brutto
Podsumowanie VAT — total, count, średnia VAT z okresu

Wszystkie 5 jest dostępnych dla każdego użytkownika (Free i Pro). Działają identycznie na macOS i iPadOS.

Pełna instrukcja i przykładowe Skróty: ksef-katalog.pl/shortcuts

Historia zmian i synchronizacji

Co zawiera Historia zmian?

Wszystkie operacje na atrybutach wzbogacających: przypisania do katalogów, tagi, kategorie pozycji. Każdy wpis pokazuje kto i kiedy wykonał zmianę (Ty / klient MCP / Skróty), z możliwością cofnięcia pojedynczej operacji lub zaznaczenia wielu i cofnięcia hurtem.

Ustawienia → Historia zmian

Co zawiera Historia synchronizacji?

Lista wszystkich operacji synchronizacji z KSeF — kiedy ściągałeś faktury, ile (przychodzących/wychodzących), jak długo trwało, czy się powiodło. Funkcja informacyjna dla księgowości i compliance — pozwala udokumentować kiedy ściągnięto fakturę z państwowego rejestru.

Ustawienia → Historia synchronizacji

Historia synchronizacji nie ma funkcji „cofnięcia” (nie można cofnąć ściągnięcia z państwowego rejestru) — jest wyłącznie informacyjna.

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 z wyjątkiem lokalnego serwera MCP (macOS-only) 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