Dostosowanie limitów API KSeF 2.0 do indywidualnych potrzeb - komunikat dla integratorów

• Z uwagi na szczególne  potrzeby, integratorzy mogą składać wnioski o zmianę limitów żądań API KSeF 2.0.
• Zmodyfikowane, indywidualne limity żądań API KSeF 2.0 obejmą środowisko przedprodukcyjne (Demo) oraz środowisko produkcyjne. 

W czerwcu 2025 r. opublikowaliśmy pełną dokumentację API KSeF 2.0, umożliwiającą dostawcom systemów finansowo-księgowych rozpoczęcie prac integracyjnych z KSeF 2.0 w środowisku testowym.

Dostosowanie limitów API KSeF 2.0 do indywidualnych potrzeb

Ze względu na skalę działania i publiczny charakter systemu KSeF, w API KSeF 2.0 wprowadziliśmy limity – mechanizmy ograniczające liczbę żądań API dla poszczególnych integracji.

Celem limitów jest:

• ochrona stabilności systemu,
• ochrona przed cyberzagrożeniami,
• gwarancja stabilnych warunków dostępu dla wszystkich użytkowników.

Limity określają maksymalną liczbę zapytań, które można wykonać w określonym czasie i wspierają sposób integracji, zgodny z założeniami architektury systemu. Domyślne limity żądań API zostały określone na podstawie przewidywanych scenariuszy wykorzystania systemu i modeli obciążenia systemu.

Z uwagi na zróżnicowane potrzeby poszczególnych integracji, limity mogą być w uzasadnionych przypadkach dostosowane do indywidualnych potrzeb integratorów.

Jak zawnioskować o dostosowanie limitów API KSeF 2.0 do indywidualnych potrzeb

Zwiększenie limitów na środowisku przedprodukcyjnym (Demo) oraz produkcyjnym jest możliwe na podstawie wniosku uzasadnionego rzeczywistą potrzebą operacyjną.

Wniosek należy złożyć za pośrednictwem formularza kontaktowego, dołączając załącznik zawierający szczegółowy opis potrzeb wymagających większej intensywności operacji.

Formularz zgłoszenia należy wypełnić zgodnie z parametrami:

• Pełniona rola – Integrator.
• Rodzaj zgłoszenia – Techniczne.
• Typ zgłoszenia - Prośba o informację.
• Aplikacja, której dotyczy zgłoszenie – API KSeF.
• Środowisko, którego dotyczy zgłoszenie – Produkcyjne KSeF 2.0 / Przedprodukcyjne (Demo) KSeF 2.0.
• Podkategoria zgłoszenia - Indywidualne limity żądań API .

Indywidualne limity przyznane poszczególnym integratorom zostaną zmienione jednocześnie na środowisku przedprodukcyjnym (Demo) i środowisku produkcyjnym.

Limity

Pełna informacja o domyślnych limitach API KSeF 2.0 znajduje się w dokumentacji -  Limity żądań API. Wykaz limitów API możliwych do zmiany znajduje się w załączniku do wniosku.

Metoda sprawdzenia obowiązujących limitów

API Systemu KSeF 2.0 udostępnia usługi pozwalające na sprawdzenie aktualnych wartości limitów dla bieżącego kontekstu lub podmiotu na danym środowisku.

W przypadku pytań w zakresie limitów prosimy o kontakt za pośrednictwem formularza zgłoszeniowego.