{
"status": {
"code": 429,
"description": "Too Many Requests",
"details": ["Przekroczono limit 20 żądań na minutę. Spróbuj ponownie po 30 sekundach."]
}
}Jak liczone są limity
- Osobno dla każdej pary: firma (kontekst) + adres IP. Biuro rachunkowe i sam klient pobierający faktury tego samego NIP-u z innego adresu mają osobne limity.
- Okno przesuwne: liczą się zapytania z ostatniej sekundy, minuty i godziny — limit nie „zeruje się” o pełnej godzinie.
- Blokada jest dynamiczna: czas w Retry-After rośnie przy powtarzających się przekroczeniach.
- W nocy (20:00–6:00) limity pobierania są wyższe niż w dzień.
Najważniejsze limity (stan z dokumentacji MF z 14.09.2026)
| Operacja | na sekundę | na minutę | na godzinę |
|---|---|---|---|
| Lista faktur (metadane) | 8 | 16 | 20 |
| Eksport paczki faktur | 8 | 16 | 20 |
| Pobranie jednej faktury po numerze KSeF | 8 | 16 | 64 |
| Otwarcie sesji interaktywnej | 10 | 30 | 120 |
| Wysłanie faktury (sesja interaktywna) | 10 | 30 | 180 |
| Otwarcie sesji wsadowej | 10 | 20 | 60 |
| Pozostałe zapytania | 10 | 30 | 120 |
Wniosek praktyczny: lista faktur i eksport to tylko 20 zapytań na godzinę. Program, który przy każdym otwarciu okna odpytuje KSeF dzień po dniu, szybko trafi na 429. Lepiej pobierać cały miesiąc jednym eksportem.
Co zrobić
- Odczekaj czas z komunikatu (zwykle od kilkudziesięciu sekund do kilku minut). Nie klikaj „wyślij” wielokrotnie.
- Przy dużej liczbie faktur użyj sesji wsadowej — jedna paczka zamiast setek pojedynczych wysyłek.
- Jeśli 429 pojawia się codziennie, zgłoś to dostawcy programu: ma za częste odpytywanie KSeF. Przy stałych wysokich wolumenach MF proponuje kontakt z działem wsparcia KSeF.
MF rejestruje przekroczenia i może blokować konteksty lub adresy IP, które próbują obchodzić limity (np. wieloma adresami IP naraz). Nie omijaj limitów — dostosuj tempo.