Jak sprawdzić fakturę w KSeF — 3 sposoby

Krajowy System e-Faktur (KSeF) gromadzi wszystkie faktury ustrukturyzowane w jednym miejscu. Każda faktura wystawiona przez Twojego kontrahenta trafia do KSeF automatycznie — ale system nie wysyła żadnego powiadomienia, że nowa faktura czeka. Musisz sam ją znaleźć.

W tym artykule pokażę 3 konkretne sposoby na sprawdzenie faktur przychodzących w KSeF — od ręcznego logowania, przez integrację API, po automatyczne powiadomienia email.

Po co w ogóle sprawdzać faktury w KSeF?

KSeF to centralny rejestr faktur ustrukturyzowanych prowadzony przez Ministerstwo Finansów. Od momentu wejścia obowiązku e-faktur, każda faktura wystawiona przez polskiego podatnika VAT trafia do KSeF w formie pliku XML.

Problem polega na tym, że KSeF działa jak skrzynka pocztowa bez powiadomień. Faktury przychodzące pojawiają się w systemie, ale nikt Cię o tym nie informuje. To oznacza, że:

• Możesz przegapić termin płatności — faktura leży w KSeF, a Ty nawet nie wiesz, że istnieje
• Odliczenie VAT się opóźni — nie zaksięgujesz faktury, bo nie wiesz o niej
• Kontrahent może naliczyć odsetki — bo z jego perspektywy faktura została doręczona w momencie nadania numeru KSeF
• Księgowa nie zamknie miesiąca — bo brakuje faktur kosztowych

Dlatego regularne sprawdzanie faktur w KSeF jest kluczowe. Pytanie brzmi: jak to robić efektywnie?

Sposób 1: Aplikacja Podatnika (ręcznie)

Ministerstwo Finansów udostępnia darmową Aplikację Podatnika KSeF dostępną pod adresem ap.ksef.mf.gov.pl. To oficjalne narzędzie do przeglądania faktur.

Krok po kroku:

1. Wejdź na ap.ksef.mf.gov.pl — to oficjalna strona Aplikacji Podatnika
2. Zaloguj się — możesz użyć Profilu Zaufanego, e-dowodu lub pieczęci kwalifikowanej. Szczegóły logowania opisaliśmy w artykule Jak zalogować się do KSeF
3. Przejdź do sekcji "Faktury" — wybierz zakładkę z fakturami przychodzącymi (faktury, w których Twój NIP jest nabywcą)
4. Ustaw filtry — możesz filtrować po dacie wystawienia, NIP sprzedawcy, numerze KSeF
5. Przeglądaj i pobieraj — każdą fakturę możesz otworzyć, zobaczyć w formie czytelnej lub pobrać XML

Zalety:

• Darmowe, oficjalne narzędzie MF
• Nie wymaga żadnej konfiguracji technicznej
• Widok czytelny (nie surowy XML)

Wady:

• Trzeba pamiętać, żeby się zalogować i sprawdzić
• Każde logowanie wymaga autoryzacji (Profil Zaufany = kilka kliknięć)
• Łatwo zapomnieć — szczególnie gdy faktur jest mało
• Brak powiadomień — musisz sam inicjować sprawdzenie

Więcej o Aplikacji Podatnika pisaliśmy w osobnym artykule: Aplikacja Podatnika KSeF — co umożliwia i jak z niej korzystać.

Sposób 2: API KSeF (dla programistów)

KSeF udostępnia REST API, które pozwala programistycznie odpytywać system o nowe faktury. To rozwiązanie dla firm, które mają własny dział IT lub korzystają z programów księgowych z integracją KSeF.

Jak to działa:

1. Wygeneruj token uwierzytelniający — w Aplikacji Podatnika. Jak to zrobić krok po kroku opisaliśmy w artykule Token KSeF — jak wygenerować
2. Otwórz sesję API — wysyłasz token do endpointu autoryzacyjnego i otrzymujesz sesyjny access token
3. Odpytaj o faktury — endpoint POST /api/v2/invoices/query z filtrem subjectType=subject2 (faktury przychodzące)
4. Pobierz XML faktury — endpoint GET /api/invoices/ksef/{nrKSeF}

Szczegółową dokumentację API, endpointy i przykłady kodu znajdziesz w artykule KSeF API — dokumentacja, integracja, przykłady.

Zalety:

• Pełna automatyzacja — skrypt może odpytywać co X minut
• Integracja z dowolnym systemem (ERP, CRM, księgowość)
• Możliwość budowania własnej logiki (filtrowanie, alerty)

Wady:

• Wymaga umiejętności programistycznych
• Trzeba utrzymywać infrastrukturę (serwer, crony, monitoring)
• Obsługa sesji, tokenów, rate limitów
• Czas wdrożenia: dni lub tygodnie

Sposób 3: Automatyczne powiadomienia (FakturyKSeF)

Jeśli nie chcesz ręcznie logować się do Aplikacji Podatnika ani budować własnej integracji z API, możesz skorzystać z FakturyKSeF — serwisu, który monitoruje KSeF i wysyła email o każdej nowej fakturze przychodzące.

Jak to działa:

1. Rejestrujesz się na app.fakturyksef.com
2. Dodajesz firmę — NIP + token uwierzytelniający KSeF
3. Podajesz email, na który mają przychodzić powiadomienia
4. Gotowe — FakturyKSeF odpytuje KSeF co 15 minut i wysyła email z danymi nowej faktury (sprzedawca, kwota netto/brutto, numer KSeF)

Zalety:

• Zero wysiłku — nie musisz pamiętać o sprawdzaniu
• Email przychodzi w ciągu 15 minut od wystawienia faktury
• Nie wymaga umiejętności technicznych
• Konfiguracja w 2 minuty

Wady:

• Wymaga podania tokena KSeF (ale token daje dostęp tylko do odczytu faktur)
• Usługa płatna (19 zł/msc za firmę)

Porównanie 3 sposobów

Który sposób wybrać?

To zależy od Twojej sytuacji:

• Dostajesz 1-2 faktury miesięcznie — Aplikacja Podatnika wystarczy. Zaloguj się raz w miesiącu i sprawdź.
• Masz dział IT i chcesz pełną integrację — API KSeF da Ci największą elastyczność. Zbudujesz dokładnie to, czego potrzebujesz.
• Chcesz wiedzieć od razu, bez ręcznego sprawdzania — FakturyKSeF to najprostsze rozwiązanie. Konfiguracja w 2 minuty, email przychodzi sam.

W praktyce wielu przedsiębiorców i księgowych zaczyna od Aplikacji Podatnika, ale szybko odkrywa, że regularne logowanie jest uciążliwe. Automatyczne powiadomienia eliminują ten problem.

Najczęstsze pytania

Czy KSeF wysyła powiadomienia o nowych fakturach?

Nie. KSeF nie ma wbudowanych powiadomień email, SMS ani push. Musisz sam sprawdzać faktury lub skorzystać z zewnętrznego narzędzia.

Jak szybko faktura pojawia się w KSeF?

Faktura pojawia się w KSeF natychmiast po jej wystawieniu przez sprzedawcę i nadaniu numeru KSeF. Nie ma opóźnień — jedynym opóźnieniem jest to, kiedy Ty o niej się dowiesz.

Czy muszę mieć token KSeF, żeby sprawdzić faktury?

Przez Aplikację Podatnika — nie, wystarczy Profil Zaufany. Przez API lub FakturyKSeF — tak, potrzebujesz tokena uwierzytelniającego.