Pobieranie e-faktur za podany okres — szybsze nadrabianie zaległości, ale uważaj na limity KSeF
Nowa opcja w programie pobierającym e-faktury — wybierz dowolny zakres dat i pobierz tylko faktury z tego okresu. Pozwala szybciej nadrobić zaległości gdy nie pobierałeś faktur dłużej niż 3 miesiące, bez czekania standardowych 15 minut między automatycznymi pobraniami. Pamiętaj jednak o limitach KSeF (per klient/NIP) — zbyt częste zapytania dla pojedynczego klienta (powyżej 16/min lub 20/godzinę) wyzwalają blokadę po stronie serwera Ministerstwa Finansów dla tego klienta.
Opublikowano
W programie do pobierania e-faktur z KSeF dodaliśmy opcję pobierania za dowolny wskazany okres. Funkcja jest szczególnie przydatna gdy masz do nadrobienia większą zaległość — np. wracasz do programu po dłuższej przerwie, albo musisz pobrać faktury z konkretnego kwartału do uzgodnień z biurem rachunkowym.
Pobieranie za podany okres — jak to działa
Zamiast standardowego pobierania „od ostatniego pobrania do dzisiaj" (które ma wbudowane opóźnienie 15 minut między kolejnymi automatycznymi cyklami, by oszczędnie obchodzić się z limitami KSeF), nowa opcja pozwala wskazać datę od – datę do i pobrać tylko faktury z tego zakresu.
Co istotne — to pobranie nie jest objęte standardowym opóźnieniem 15 minut. Oznacza to, że jeśli masz do pobrania więcej niż 3 miesiące e-faktur, możesz uruchomić kolejne pobrania jeden po drugim (np. miesiąc po miesiącu albo kwartał po kwartale) bez czekania kilkudziesięciu minut między nimi.
Typowe scenariusze:
- Powrót po dłuższej przerwie — pobierasz np. styczeń-marzec jednym poleceniem, potem kwiecień-czerwiec, potem lipiec, bez 15-minutowych pauz
- Uzgodnienia kwartalne — pobierasz tylko trzy konkretne miesiące do rozliczenia VAT-7K
- Pobranie historyczne na nowym komputerze / po reinstalacji — pobranie pełnej historii faktur z poprzednich okresów rozliczeniowych
- Audyt / kontrola — pobranie pełnego zakresu dla danego klienta-firmy
⚠ Limity KSeF — uważaj na blokadę po stronie Ministerstwa Finansów
Brak wbudowanego opóźnienia oznacza, że odpowiedzialność za rozsądne tempo pobierania spoczywa na Tobie. Serwer KSeF Ministerstwa Finansów ma własne, sztywne limity, których przekroczenie powoduje automatyczną blokadę na pewien czas.
Kluczowa informacja — limity są liczone per (kontekst, IP), gdzie kontekstem jest NIP klienta (firmy, której faktury pobierasz). Oznacza to, że każdy klient ma swój własny licznik limitów, niezależnie. Biuro rachunkowe pobierające faktury dla 10 firm z jednego komputera ma 10 osobnych pul limitów — pobranie dla klienta A nie wlicza się do limitu klienta B.
Aktualne limity per klient (NIP) — dokumentacja techniczna KSeF:
| Operacja | req/s | req/min | req/h |
|---|---|---|---|
| Zapytanie o listę faktur (metadata) | 8 | 16 | 20 |
| Eksport (przygotowanie paczki) | 8 | 16 | 20 |
| Pobranie konkretnej faktury (po nr KSeF) | 8 | 16 | 64 |
| Sprawdzanie statusu eksportu | 10 | 60 | 600 |
Najbardziej rygorystyczne są limity godzinowe: tylko 20 zapytań o listę / 20 eksportów na godzinę dla jednego klienta. Wykonanie więcej operacji w ciągu jednej godziny dla tego samego klienta — niezależnie od tego ile czasu minęło między pojedynczymi zapytaniami — wywołuje blokadę tego konkretnego kontekstu.
Jak rozpoznać blokadę:
- Serwer KSeF zwraca HTTP 429 „Too Many Requests"
- W nagłówku
Retry-Afterznajduje się liczba sekund, po których można ponowić zapytanie (czas blokady jest dynamiczny — im więcej i częściej przekraczasz, tym dłuższa blokada) - Program TaxMachine wyświetli komunikat o blokadzie i sugerowanym czasie oczekiwania
Praktyczne rekomendacje:
- Pobieraj kwartałami, nie miesiącami — jedno zapytanie o trzy miesiące zużywa tyle samo limitu co o jeden, a daje 3× więcej danych
- Nie ponawiaj pobrań tego samego okresu — każde to nowe zapytanie liczone do limitu (dla tego samego klienta)
- Po komunikacie o blokadzie odczekaj sugerowany czas — kolejne próby w trakcie blokady przedłużają ją
- Biuro rachunkowe — limity są per klient (NIP), nie wspólne — możesz spokojnie pobierać równolegle dla kilku klientów. Blokada jednego klienta nie blokuje pozostałych. Uważaj jednak by nie nadużywać dla pojedynczego klienta (np. 20+ zapytań w godzinę o listę faktur firmy X)
Pełna dokumentacja limitów: github.com/CIRFMF/ksef-api/blob/main/limity/limity-api.md.
Dla kogo standardowe pobieranie nadal lepsze
Jeśli regularnie korzystasz z programu i pobierasz e-faktury codziennie lub kilka razy w tygodniu, standardowe pobieranie „od ostatniego pobrania" nadal jest najbezpieczniejsze:
- Automatyczne 15-minutowe opóźnienia są dobrane tak, by nigdy nie przekroczyć limitów KSeF nawet przy dużych firmach
- Nie musisz pamiętać o tempie pobierania
- Działa w tle, bez Twojej uwagi
Nowa opcja pobierania za okres to narzędzie do zaległości, nie zastąpienie codziennego workflow.
Jeżeli zauważysz problem albo zostaniesz zablokowany przez KSeF — zgłoś przez formularz zgłoszeniowy z dokładną godziną pobrania. Pomoże nam to ocenić, czy potrzeba dodatkowych zabezpieczeń.
Aktualna wersja programu TaxMachine to: 3.52.1.5815.