Monitor KSeF – Instrukcja użytkownika

1. Czym jest Monitor KSeF?

Monitor KSeF to aplikacja na iPhone'a, która pozwala przeglądać faktury z Krajowego Systemu e‑Faktur (KSeF) prowadzonego przez Ministerstwo Finansów.

Co aplikacja potrafi

• Łączy się bezpośrednio z oficjalnym systemem KSeF Ministerstwa Finansów.
• Pobiera i wyświetla faktury przypisane do Twojego NIP‑u.
• Plus: eksport do PDF oraz pobieranie oryginalnych plików XML.

Czego aplikacja nie robi

• Nie wystawia faktur – służy tylko do ich przeglądania.
• Nie zmienia ani nie usuwa faktur w KSeF.
• Nie wysyła Twoich danych na zewnętrzne serwery – wszystko zostaje na urządzeniu.
• Nie jest oficjalnym produktem Ministerstwa Finansów.

Czego potrzebujesz

• iPhone z iOS 17.0 lub nowszym.
• NIP (10 cyfr).
• Token autoryzacyjny KSeF (sekcja 4).

2. Pierwsze uruchomienie i ustawienie kodu PIN

Przy pierwszym uruchomieniu aplikacja poprosi o utworzenie kodu PIN (4–6 cyfr). PIN chroni dostęp do aplikacji i danych podatkowych.

1. Wpisz PIN (4–6 cyfr).
2. Wpisz ponownie, aby potwierdzić.

Zmiana PIN

1. Konfiguracja → Bezpieczeństwo.
2. Wybierz „Zmień PIN aplikacji".
3. Wpisz aktualny PIN i ustaw nowy.

3. Odblokowywanie aplikacji

Aplikacja wymaga odblokowania przy uruchomieniu oraz po przejściu do tła.

Odblokowanie kodem PIN

1. Wpisz PIN na klawiaturze numerycznej.
2. Aplikacja odblokuje się automatycznie po poprawnym wpisaniu.

Odblokowanie Face ID / Touch ID

Możesz włączyć biometrię w Konfiguracja → Bezpieczeństwo.

Błędny PIN i blokada

4. Konfiguracja połączenia z KSeF

Aby pobierać faktury, podaj NIP i token KSeF.

Co to jest token KSeF?

Token KSeF to klucz potwierdzający, że masz prawo przeglądać faktury przypisane do danego NIP‑u. Token wydaje Ministerstwo Finansów.

Jak uzyskać token KSeF

1. Wejdź na podatki.gov.pl i zaloguj się.
2. Przejdź: KSeF → Zarządzanie tokenami.
3. Wygeneruj token z uprawnieniami tylko do odczytu („Faktura Odczyt / Invoice Read").
4. Skopiuj wygenerowany token (wyświetla się tylko raz).

Wprowadzenie danych w aplikacji

1. Konfiguracja → Dane dostępowe.
2. Wpisz NIP (10 cyfr).
3. Wklej token w odpowiednie pole (możesz użyć ikony oka, aby go zweryfikować).
4. Naciśnij „Zapisz".

Aplikacja łączy się z produkcyjnym serwerem KSeF pod adresem api.ksef.mf.gov.pl.

Ustawienia zapytania

Możesz wybrać role (np. Nabywca, Sprzedawca) oraz typ daty (wystawienia, przyjęcia, trwałego zapisu).

5. Przeglądanie faktur

1. Zakładka Faktury.
2. Ustaw zakres dat (domyślnie bieżący dzień).
3. Naciśnij „Sprawdź faktury".

Aplikacja może automatycznie sprawdzać faktury z bieżącego dnia przy odblokowaniu (raz na dobę).

6. Szczegóły faktury (Monitor KSeF Plus)

Podgląd szczegółów wymaga aktywnej subskrypcji Monitor KSeF Plus.

• Nagłówek: numer, typ dokumentu, daty.
• Strony: sprzedawca i nabywca.
• Kwoty: netto/brutto/VAT.
• Pozycje faktury.
• Podgląd XML (FA(3)).

7. Eksport faktur do PDF i XML (Plus)

Eksport działa przez standardowy arkusz udostępniania iOS (Share Sheet). Pliki tworzone są tymczasowo.

8. Monitor KSeF Plus – subskrypcja

Zakup i przywracanie

• Zakup realizowany jest przez Apple.
• Po reinstalacji: Info → „Przywróć zakupy".
• Zarządzanie: Ustawienia iOS → Subskrypcje.

9. Ustawienia i personalizacja

Konfiguracja zawiera m.in. dane dostępowe, ustawienia zapytania, motyw/ikonę, bezpieczeństwo oraz czyszczenie danych.

10. Bezpieczeństwo Twoich danych

• NIP, token i PIN przechowywane są w zaszyfrowanej pamięci systemowej (Keychain).
• Faktury przetwarzane są tymczasowo w RAM i nie są zapisywane na dysku.
• Brak własnych serwerów; jedyny serwer to API KSeF.
• Połączenia szyfrowane (TLS 1.2+), dodatkowo pinning certyfikatu.
• Maskowanie treści w podglądzie przełącznika aplikacji.
• Logi diagnostyczne redagują dane wrażliwe.

11. Logi komunikacji (diagnostyka)

Logi mogą pomóc w diagnozie problemów z połączeniem. Możesz je wyeksportować w zakładce Info (np. e-mail do wsparcia).

12. Najczęstsze pytania i rozwiązywanie problemów

Nieprawidłowa konfiguracja

• Sprawdź, czy NIP ma 10 cyfr.
• Upewnij się, że token jest kompletny i nie wygasł.

Brak faktur

• Sprawdź zakres dat (domyślnie bieżący dzień).
• Zweryfikuj rolę (Nabywca/Sprzedawca) i typ daty.

Zapomniałem PIN

PIN jest nieodwracalny – wymagana reinstalacja aplikacji i ponowna konfiguracja.

13. Informacje prawne i kontakt

Deweloper: KrzewiLabs

E-mail: kontakt@krzewilabs.pl

Polityka prywatności: polityka-prywatnosci.html

Regulamin aplikacji: regulamin_ios.html

Monitor KSeF nie jest oficjalnym produktem administracji publicznej i nie jest powiązany z MF ani KAS.