Limity a zákonné lehoty
Frekvencia požiadaviek, limity sietí, opakované pokusy a zákonné lehoty.
- V sandboxe
Jednoducho povedané
Niektoré systémy krajín obmedzujú, ako rýchlo možno faktúry odosielať, a niektoré zákony určujú lehotu od dátumu faktúry. Táto stránka uvádza limity, ktoré počítame, a zákonné lehoty, ktoré sledujeme, aby si firma mohla naplánovať veľkosť dávky a posledný deň, keď možno faktúru odoslať. Dátumy a limity pochádzajú z oficiálnych zdrojov a predtým, než sa na ne niekto spoľahne, ich treba znova overiť.
Tempo určujú štyri veci: veľkosť požiadavky, ako často môže klient volať API, limit každého klienta na odosielanie do siete a zákonná lehota pri kanáloch, ktoré ju majú.
Veľkosť požiadavky
Na telo väčšie ako 5 MB (5 000 000 bajtov) je odpoveď 413 s telom problému (payload-too-large). Týka sa to POST /invoices, POST /invoices/xml, POST /validate a POST /credentials.
Frekvencia požiadaviek
Každý klient má rozpočet pre každé oprávnenie kľúča. Počíta sa pre klienta, nie pre kľúč, takže viac kľúčov neprinesie viac požiadaviek.
| Oprávnenie | Volaní za sekundu | Volaní za minútu |
|---|---|---|
submit | 20 | 600 |
read | 50 | 3 000 |
admin | 20 | 600 |
Okrem toho možno zoznam na riešenie čítať 30-krát za minútu a dôkazy 10-krát za minútu. Nad limitom je odpoveď 429 s hlavičkou Retry-After v sekundách. Počkajte toľko a pošlite to isté volanie znova. Skúšobný beh, pri ktorom sú všetky validátory zaneprázdnené, odpovie 503 (busy) s Retry-After rovnakým spôsobom.
Obmedzené je aj vyhľadávanie kupujúceho v sieti Peppol: 30 vyhľadávaní za minútu a 300 za hodinu pre každého klienta. Už uchovaná odpoveď nestojí nič.
Limity sietí
Služba počíta volania každého klienta do siete a porovnáva ich so zverejneným limitom siete. Klientom je client uvedený na faktúre. Faktúra bez client sa počíta pod local. Počítadlá sa uchovávajú v databáze, takže ich reštart nevynuluje.
| Kanál | Volanie | Limit |
|---|---|---|
PL-KSEF | Odoslanie faktúry | 10 za sekundu, 30 za minútu, 180 za hodinu |
PL-KSEF | Čítanie stavu | 30 za sekundu, 120 za minútu, 1 200 za hodinu |
RO-EFACTURA | Akékoľvek volanie | 1 000 za minútu |
DE-XRECHNUNG, PEPPOL, FR-PA | Žiadny zverejnený, žiadny sa neuplatňuje |
Keď klient prekročí limit, jeho faktúra zostane vo fronte a o sekundu sa skúsi znova. Nič sa neodmietne a nič sa nezobrazí ako chyba.
Zdroje, prečítané 2. okt. 2026: limity KSeF API a postup OAuth ANAF. KSeF počíta každú dvojicu kontextu a IP adresy samostatne. ANAF uvádza pre svoje API 1 000 požiadaviek za minútu, nad tento počet odpovedá 429 a neuvádza, na čo sa limit vzťahuje.
Pri poľských odoslaniach sa čas sčítava: pri 180 za hodinu trvá odoslanie 1 000 faktúr jedného klienta asi päť a pol hodiny. Poľský režim offline24 dáva na odoslanie čas do konca nasledujúceho pracovného dňa. Dávkové relácie sú plánované a neimplementované.
Opakované pokusy pri chybe siete
Opakuje sa len dočasná chyba zo siete. Odmietnutie nie: ide do zoznamu na riešenie.
| Zlyhanie | Čakanie pred ďalším pokusom |
|---|---|
| 1. | 30 sekúnd |
| 2. | 2 minúty |
| 3. | 10 minút |
| 4. | 30 minút |
| 5. | 1 hodina |
| 6. | Žiadne. Faktúra prejde do stavu dead_letter a ide do zoznamu na riešenie. |
Úloha, ktorá skončí uprostred odosielania, sa pred ďalším odoslaním opýta kanála, či už faktúru má. Opakované pokusy webhookov majú vlastný plán (pozri webhooky).
Zákonné lehoty
Dva kanály majú lehotu od dátumu na faktúre. Služba ju vypočíta pre každú faktúru na vstupe.
| Kanál | Lehota | Zdroj |
|---|---|---|
RO-EFACTURA | Koniec piateho pracovného dňa po dátume vystavenia. | OUG 89/2025 a oznámenie ANAF. |
PL-KSEF | Koniec nasledujúceho pracovného dňa po dátume vystavenia, čo je lehota režimu offline24. Služba ju uplatňuje na každú poľskú faktúru. | Zákon o DPH, čl. 106nda, v znení Dz.U. 2025 poz. 1203. |
Ostatné kanály lehotu nemajú. Pri faktúre, ktorá je stále queued, služba zaznamená upozornenie, keď uplynie polovica času od začiatku dňa vystavenia po lehotu, a znova pri štyroch pätinách.
Varovanie
Dve obmedzenia lehoty
- Počíta pondelok až piatok. Nemá kalendár štátnych sviatkov, takže sviatok sa počíta ako pracovný deň a skutočná lehota môže pripadnúť na neskorší deň, než s akým počíta služba.
- Dni počíta v UTC. Úrady počítajú v miestnom čase, takže hranica dňa sa líši o hodinu alebo dve.
Upozornenia sa zaznamenávajú v službe a neodosielajú sa (pozri monitoring a upozornenia). Lehoty sa zobrazujú aj pre každú faktúru ako deadline_at, pre Rumunsko a Poľsko, keď faktúra nesie dátum vystavenia (pozri čítanie faktúry). Obe lehoty sme naposledy overili podľa týchto zdrojov 27. sept. 2026; pred zverejnením dokumentácie sa overia znova.