W skrócie
KSeF API ma limity częstotliwości zapytań. MRKsef sprawdza KSeF co kilka minut – to optymalny balans między szybkością powiadomień a efektywnością (bateria, sieć, limity API). W aplikacji zawsze widzisz, kiedy dane były ostatnio odświeżone.
Jak działa sprawdzanie KSeF?
KSeF nie posiada mechanizmu „push” – system nie informuje aktywnie o nowych dokumentach. Jedynym sposobem na sprawdzenie, czy pojawiła się nowa faktura, jest odpytanie KSeF API, czyli wysłanie zapytania: „Czy od ostatniego sprawdzenia pojawiły się nowe dokumenty?”.
MRKsef robi to automatycznie, w regularnych odstępach czasu. Gdy API zwraca informację o nowym dokumencie, aplikacja wysyła powiadomienie push na Twojego iPhone'a.
To podejście nazywa się „polling” (cykliczne odpytywanie) i jest standardem w integracji z systemami, które nie oferują powiadomień w czasie rzeczywistym.
Dlaczego nie można odpytywać KSeF co sekundę?
Istnieją trzy główne powody, dla których odpytywanie KSeF co sekundę byłoby problematyczne.
Limity API (rate limiting)
KSeF API – jak każde API rządowe – ma ograniczenia dotyczące liczby zapytań w danym okresie. Zbyt częste odpytywanie może skutkować tymczasowym zablokowaniem dostępu (tzw. throttling). Aplikacja, która respektuje te limity, zapewnia stabilne i niezawodne działanie.
Efektywność baterii i sieci
Każde zapytanie do API zużywa baterię telefonu i dane mobilne. Odpytywanie co sekundę szybko wyczerpałoby baterię i mogłoby generować znaczne koszty transferu danych. MRKsef sprawdza KSeF w inteligentnych odstępach, które minimalizują wpływ na baterię.
Odpowiedzialność wobec systemu
KSeF obsługuje miliony podatników. Gdyby każda aplikacja odpytywała system co sekundę, infrastruktura mogłaby tego nie wytrzymać. Odpowiedzialne korzystanie z API to wspólna korzyść – system działa stabilnie dla wszystkich.
Jak MRKsef radzi sobie z ograniczeniami?
MRKsef został zaprojektowany tak, aby oferować najlepszy możliwy balans między szybkością powiadomień a efektywnością. Oto kluczowe elementy tego podejścia.
Inteligentne interwały sprawdzania
MRKsef odpytuje KSeF w regularnych odstępach co kilka minut. Ten interwał jest dobrany tak, aby respektować limity API, nie obciążać baterii i jednocześnie zapewnić szybkie wykrycie nowych dokumentów.
Widoczny status synchronizacji
W aplikacji zawsze widzisz, kiedy ostatni raz MRKsef sprawdził KSeF i czy synchronizacja przebiegła prawidłowo. Nie musisz zgadywać – status jest widoczny na głównym ekranie.
Automatyczne ponawianie
Jeśli zapytanie do KSeF API nie powiedzie się (np. z powodu tymczasowej niedostępności systemu), MRKsef automatycznie ponowi próbę przy kolejnym cyklu. Nie musisz ręcznie interweniować.
Oszczędność baterii
Dzięki odpowiedzialnemu podejściu do częstotliwości odpytywania MRKsef zużywa minimalną ilość baterii. Możesz monitorować KSeF przez cały dzień bez zauważalnego wpływu na czas pracy telefonu.
Kilka minut a kilka dni – perspektywa ma znaczenie
Łatwo skupić się na pytaniu „dlaczego nie w ciągu sekundy?”, ale warto spojrzeć na to z perspektywy alternatywy. Bez MRKsef masz dwie opcje:
- Ręczne logowanie do portalu KSeF – co realistycznie robisz raz dziennie lub raz w tygodniu.
- Czekanie na informację od księgowego – co może zająć kilka dni, a nawet tygodni.
W porównaniu z tymi scenariuszami powiadomienie w ciągu kilku minut to ogromna zmiana jakościowa. Dostajesz informację tego samego dnia, w ciągu kilku minut od pojawienia się dokumentu – bez jakiegokolwiek wysiłku ze swojej strony.
Dla większości przedsiębiorców i księgowych różnica między 1 minutą a 5 minutami nie ma praktycznego znaczenia. Faktura kosztowa nie wymaga reakcji w ciągu sekund – ważne jest, że wiesz o niej tego samego dnia, a nie po tygodniu.
Transparentność – nasz sposób na budowanie zaufania
Moglibyśmy napisać na stronie „powiadomienia w czasie rzeczywistym”, ale to nie byłaby prawda. Wolimy być transparentni: MRKsef sprawdza KSeF co kilka minut, a nie w czasie rzeczywistym.
Dlatego w aplikacji zawsze pokazujemy status synchronizacji – datę i godzinę ostatniego sprawdzenia. Dzięki temu:
- Wiesz, jak aktualne są Twoje dane.
- Widzisz, czy synchronizacja działa prawidłowo.
- Nie musisz zgadywać, czy MRKsef „pracuje” w tle.
Czy w przyszłości będzie szybciej?
Jeśli Ministerstwo Finansów wprowadzi w przyszłości mechanizm webhook – czyli możliwość, by KSeF sam informował aplikacje o nowych dokumentach – MRKsef będzie mógł działać jeszcze szybciej.
Na razie (styczeń 2026) KSeF API nie oferuje takiej funkcji. Odpytywanie w regularnych odstępach to jedyny dostępny mechanizm, a MRKsef korzysta z niego w sposób optymalny.
Przeczytaj także
Najczęściej zadawane pytania
Odpowiedzi na pytania o szybkość powiadomień i limity KSeF API.
Jak szybko MRKsef wysyła powiadomienie o nowej fakturze?+
Dlaczego MRKsef nie sprawdza KSeF co sekundę?+
Czy opóźnienie powiadomienia ma znaczenie w praktyce?+
Skąd wiem, kiedy MRKsef ostatnio sprawdzał KSeF?+
Co się stanie, jeśli KSeF API będzie niedostępne?+
Źródła i przydatne linki
Kilka minut zamiast kilku dni
MRKsef sprawdza KSeF regularnie i wysyła powiadomienie push, gdy pojawi się nowy dokument. Pobierz aplikację i zacznij monitorować faktury na iPhone.
Pobierz MRKsef na iPhone