KSeF: „przekroczono limit żądań” – co to znaczy i co z tym zrobić
„Przekroczono limit 20 żądań na godzinę. Spróbuj ponownie po 1563 sekundach.” Ten komunikat zna wiele biur rachunkowych od lutego 2026 r. To nie awaria, tylko limity API KSeF 2.0 – i da się pracować tak, żeby ich nie dotykać.
Skąd biorą się limity
API KSeF 2.0 ma limity liczby żądań w oknach sekundowych, minutowych i godzinowych, osobno dla grup operacji. Dla pobierania pojedynczych faktur (grupa invoiceDownload) dokumentacja MF podaje 8 żądań/s, 16/min i 64/h. Inne limity mają zapytania o listę faktur (metadane), sesje i eksport. Aktualne wartości są w dokumentacji API KSeF 2.0 i MF je zmienia, więc nie warto ich wpisywać na sztywno.
Limity liczone są w kontekście (NIP) i dla podmiotu uwierzytelnionego. Biuro, które jednym certyfikatem pobiera faktury kilkudziesięciu klientów, szybciej trafia na ograniczenia niż pojedyncza firma.
Dlaczego program przekracza limit
- Pobieranie faktura po fakturze. 200 faktur kosztowych klienta = 200 żądań pobrania. Przy 64/h to ponad 3 godziny.
- Odświeżanie na żądanie. Kilka osób w biurze klika „pobierz z KSeF” dla tego samego klienta.
- Ponawianie bez czekania. Program po błędzie 429 próbuje od razu – i okno blokady się przedłuża.
Jak pobierać bez blokad
- Raz dziennie, poza godzinami pracy. Jedno zapytanie o metadane za wczoraj, potem pobranie tylko nowych faktur.
- Eksport paczkowy przy większych ilościach. API KSeF 2.0 udostępnia asynchroniczny eksport faktur – jedno zlecenie, archiwum do pobrania. To właściwa ścieżka np. przy pobraniu całego miesiąca dla klienta biura.
- Szanuj nagłówek Retry-After. Czas z komunikatu jest wiążący.
- Nie pobieraj tego, co już masz. Zapisuj numery KSeF pobranych faktur i porównuj z metadanymi.
Gdy korzystasz z gotowego programu
Jeśli komunikat pojawia się w programie księgowym (GOFIN, Optima, Rewizor, wFirma itp.), zgłoś to producentowi z treścią błędu i godziną. Doraźnie: pobieraj rzadziej i większymi zakresami dat, a nie klientem po kliencie co kilka minut.
KSeF Płatności pobiera faktury kosztowe raz dziennie rano, z kolejką i respektowaniem limitów – nie musisz pilnować, kiedy można ponowić. Przy okazji dostajesz zestawienie w Excelu i kontrolę rachunków na białej liście.
Zobacz plany
Najczęstsze pytania
Czy błąd limitu oznacza, że coś jest nie tak z moim kontem KSeF?
Nie. To ochrona API Ministerstwa Finansów przed przeciążeniem. Po upływie czasu podanego w komunikacie można ponowić pobieranie.
Jaki jest limit pobierania pojedynczych faktur?
Według dokumentacji API KSeF 2.0 dla grupy invoiceDownload: 8 żądań na sekundę, 16 na minutę i 64 na godzinę. Aktualne wartości publikuje MF w dokumentacji API.
Czy ponawianie co chwilę pomaga?
Nie. Odpowiedź HTTP 429 zawiera czas, po którym można spróbować ponownie. Wcześniejsze próby niczego nie przyspieszają.
Jak pobrać dużo faktur bez limitu na każdą fakturę?
Użyć eksportu paczkowego (asynchroniczny eksport faktur do archiwum) zamiast pobierania faktura po fakturze.