Ograničenja i zakonski rokovi
Ograničenja brzine zahtjeva, ograničenja prijenosnih sustava, ponovni pokušaji i zakonski rokovi.
- U sandboxu
Jednostavnim riječima
Neki nacionalni sustavi ograničavaju koliko se brzo računi smiju slati, a neki zakoni propisuju rok nakon datuma računa. Ova stranica navodi ograničenja koja brojimo i zakonske rokove koje pratimo, kako bi tvrtka mogla planirati veličinu serije računa i posljednji dan za slanje računa. Datumi i ograničenja potječu iz službenih izvora i treba ih ponovno provjeriti prije nego što se itko na njih osloni.
Tempo određuju četiri stvari: veličina zahtjeva, koliko često klijent smije pozivati API, ograničenje slanja svakog klijenta prema prijenosnom sustavu i zakonski rok na kanalima koji ga imaju.
Veličina zahtjeva
Tijelo veće od 5 MB (5.000.000 bajtova) daje odgovor 413, s tijelom problema (payload-too-large). To vrijedi za POST /invoices, POST /invoices/xml, POST /validate i POST /credentials.
Brzina zahtjeva
Svaki klijent ima proračun za svaki opseg ključa. Računa se za klijenta, a ne za ključ, pa više ključeva ne donosi više zahtjeva.
| Opseg | Poziva u sekundi | Poziva u minuti |
|---|---|---|
submit | 20 | 600 |
read | 50 | 3.000 |
admin | 20 | 600 |
Uz to, popis za obradu smije se čitati 30 puta u minuti, a dokazi za obradu 10 puta u minuti. Iznad ograničenja odgovor je 429 sa zaglavljem Retry-After u sekundama. Pričekajte toliko i pošaljite isti poziv ponovno. Probna provjera koja zatekne sve validatore zauzete odgovara 503 (busy) s Retry-After na isti način.
Ograničeno je i traženje kupca u mreži Peppol: 30 traženja u minuti i 300 na sat za svakog klijenta. Odgovor koji je već pohranjen ne košta ništa.
Ograničenja prijenosnih sustava
Usluga broji pozive svakog klijenta prema prijenosnom sustavu u odnosu na objavljeno ograničenje tog sustava. Klijent je client na računu. Račun bez polja client broji se pod local. Brojači se čuvaju u bazi podataka, pa ih ponovno pokretanje ne poništava.
| Kanal | Poziv | Ograničenje |
|---|---|---|
PL-KSEF | Slanje računa | 10 u sekundi, 30 u minuti, 180 na sat |
PL-KSEF | Čitanje statusa | 30 u sekundi, 120 u minuti, 1.200 na sat |
RO-EFACTURA | Bilo koji poziv | 1.000 u minuti |
DE-XRECHNUNG, PEPPOL, FR-PA | Nije objavljeno, ne primjenjuje se |
Kad klijent prijeđe ograničenje, njegov račun ostaje u redu čekanja i slanje se ponovno pokušava sekundu kasnije. Ništa se ne odbija i ništa se ne prikazuje kao pogreška.
Izvori, pročitani 2. lis. 2026.: ograničenja API-ja KSeF i ANAF-ov postupak za OAuth. KSeF svaki par konteksta i IP adrese broji zasebno. ANAF za svoj API navodi 1.000 zahtjeva u minuti i iznad toga odgovara 429, ali ne kaže po čemu se broji.
Slanja u Poljsku se zbrajaju: uz 180 na sat, slanje 1.000 računa za jednog klijenta traje oko pet i pol sati. Poljski način rada offline24 daje rok za slanje do kraja sljedećeg radnog dana. Skupne sesije (batch) planirane su, ali nisu izrađene.
Ponovni pokušaji pri pogrešci prijenosnog sustava
Slanje se ponavlja samo nakon privremene pogreške prijenosnog sustava. Nakon odbijanja ne ponavlja se: odbijeni račun ide na popis za obradu.
| Neuspjeh | Čekanje do sljedećeg pokušaja |
|---|---|
| 1. | 30 sekundi |
| 2. | 2 minute |
| 3. | 10 minuta |
| 4. | 30 minuta |
| 5. | 1 sat |
| 6. | Nema sljedećeg pokušaja. Račun prelazi u stanje dead_letter i ide na popis za obradu. |
Zadatak koji se prekine usred slanja prije ponovnog slanja pita kanal slanja ima li on već taj račun. Ponovni pokušaji webhookova slijede vlastiti raspored (pogledajte webhookove).
Zakonski rokovi
Dva kanala imaju rok koji se računa od datuma na računu. Usluga ga izračunava za svaki račun pri prijemu.
| Kanal | Rok | Izvor |
|---|---|---|
RO-EFACTURA | Kraj petog radnog dana nakon datuma izdavanja. | OUG 89/2025 i obavijest ANAF-a. |
PL-KSEF | Kraj sljedećeg radnog dana nakon datuma izdavanja, što je rok za offline24. Usluga ga primjenjuje na svaki poljski račun. | Zakon o PDV-u, čl. 106nda, kako je izmijenjen Dz.U. 2025 poz. 1203. |
Ostali kanali nemaju rok. Za račun koji je još queued usluga bilježi upozorenje kad prođe polovina vremena od početka dana izdavanja do roka i ponovno kad prođu četiri petine.
Upozorenje
Dva ograničenja izračuna roka
- Broji od ponedjeljka do petka. Nema kalendar državnih praznika, pa se praznik računa kao radni dan i stvarni rok može pasti kasnije od onoga koji usluga koristi.
- Dane broji u UTC-u. Nadležna tijela broje po lokalnom vremenu, pa se granica dana razlikuje za sat ili dva.
Upozorenja se bilježe u usluzi i ne šalju se (pogledajte praćenje i upozorenja). Rokovi se prikazuju i za svaki račun kao deadline_at, za Rumunjsku i Poljsku, kad račun sadrži datum izdavanja (pogledajte čitanje računa). Oba roka posljednji su put provjerena prema ovim izvorima 27. ruj. 2026.; provjeravaju se ponovno prije objave dokumentacije.