KSeF Błąd 429 – Too Many Requests [2026]
Zespół NaprawKSeF·7 min czytania
Błąd 429 Too Many Requests oznacza, że wysyłasz za dużo żądań do API KSeF w krótkim czasie. System stosuje rate limiting, aby zapobiec przeciążeniu.
Limity API KSeF
- 100 żądań/minutę – dla pojedynczej sesji
- 1000 żądań/godzinę – dla jednego NIP
- 10 równoległych połączeń – maksymalnie na raz
Uwaga: Limity mogą się zmieniać. Zawsze sprawdzaj nagłówki odpowiedzi.
Jak uniknąć błędu 429?
1
Implementuj retry z backoff
Przy błędzie 429 czekaj przed ponowną próbą. Zwiększaj czas oczekiwania wykładniczo.
2
Batch processing
Zamiast wysyłać faktury pojedynczo, grupuj je w pakiety.
3
Sprawdź nagłówek Retry-After
Odpowiedź 429 zawiera nagłówek informujący ile czekać.
Strategia retry
// Przykład w JavaScript
async function sendWithRetry(invoice, maxRetries = 3) {
for (let i = 0; i < maxRetries; i++) {
try {
return await sendToKsef(invoice);
} catch (e) {
if (e.status === 429) {
const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s
await sleep(waitTime);
} else throw e;
}
}
}