KSeF API limity zapytań i wydajność

Strona opisuje zagadnienie „KSeF API limity zapytań i wydajność” w ramach Krajowego Systemu e-Faktur (KSeF) w oparciu o oficjalne informacje Ministerstwa Finansów.

Co musisz wiedzieć

Krajowy System e-Faktur (KSeF) jest centralnym systemem administracji skarbowej do wystawiania i otrzymywania faktur ustrukturyzowanych w formacie XML.

Na tej stronie znajdziesz uporządkowane informacje dotyczące tematu: KSeF API limity zapytań i wydajność. Opis koncentruje się na aktualnych przepisach oraz komunikatach Ministerstwa Finansów.

Najczęstsze problemy i rozwiązania

Otrzymuję błąd 429 – przekroczony limit zapytań

Błąd HTTP 429 oznacza przekroczenie limitu rate limiting. Poczekaj kilka sekund przed kolejnym żądaniem. Rozważ optymalizację zapytań lub wniosek o zwiększenie limitów dla środowiska produkcyjnego.

Jak uniknąć przekroczenia limitów przy masowej wysyłce?

Rozłóż wysyłkę w czasie, stosując opóźnienia między zapytaniami. Używaj trybu wsadowego do wysyłki wielu faktur jednocześnie. Monitoruj odpowiedzi API pod kątem limitów.

Czy mogę wnioskować o wyższe limity?

Tak, na środowisku produkcyjnym podmioty wymagające większej intensywności operacji mogą wnioskować o podwyższenie limitów przez formularz kontaktowy Ministerstwa Finansów.

FAQ

Jakie są limity zapytań w API KSeF?

API KSeF stosuje mechanizm rate limiting z różnymi limitami dla różnych operacji. Przykładowo: pobieranie listy metadanych faktur to 8 żądań na sekundę, eksport paczki faktur to 4 żądania na sekundę. Szczegółowe limity znajdziesz w dokumentacji API.

Co się stanie, gdy przekroczę limit zapytań?

Przekroczenie limitu skutkuje odpowiedzią HTTP 429 z informacją o bloku. System stosuje mechanizm sliding window, więc kolejne żądania są możliwe po upływie odpowiedniego czasu od wysłania poprzedniego zapytania.

Czy mogę zwiększyć limity zapytań do API KSeF?

Tak, na środowisku produkcyjnym podmioty wymagające większej intensywności operacji mogą wnioskować o podwyższenie limitów przez formularz kontaktowy Ministerstwa Finansów. Wniosek musi zawierać szczegółowy opis zastosowania.

Jak sprawdzić aktualne limity dla mojego konta?

KSeF 2.0 udostępnia specjalne endpointy do sprawdzenia bieżących limitów: GET /limits/context dla wartości limitów sesji oraz GET /limits/subject dla limitów certyfikatów i żądań certyfikacyjnych.