Limieten en wettelijke termijnen
Aanvraagsnelheid, limieten van de netwerken, herhaalpogingen en wettelijke termijnen.
- In de sandbox
In gewone woorden
Sommige nationale systemen beperken hoe snel facturen mogen worden verzonden, en sommige wetten leggen een deadline op die na de factuurdatum valt. Deze pagina vermeldt de limieten die we tellen en de wettelijke termijnen die we bewaken, zodat een bedrijf de grootte van een batch en de uiterste verzenddatum van een factuur kan plannen. Datums en limieten komen uit officiële bronnen en moeten opnieuw worden gecontroleerd voordat iemand erop vertrouwt.
Vier dingen bepalen het tempo: de grootte van een verzoek, hoe vaak een eindklant de API mag aanroepen, de limiet per eindklant op verzendingen naar een netwerk, en de wettelijke termijn bij de verzendkanalen die er een hebben.
Grootte van een verzoek
Een body groter dan 5 MB (5.000.000 bytes) geeft 413, met een problem-body (payload-too-large). Dat geldt voor POST /invoices, POST /invoices/xml, POST /validate en POST /credentials.
Aanvraagsnelheid
Elke eindklant heeft een budget per scope van een sleutel. Het wordt voor de eindklant geteld, niet voor de sleutel, dus meer sleutels leveren niet meer aanvragen op.
| Scope | Aanroepen per seconde | Aanroepen per minuut |
|---|---|---|
submit | 20 | 600 |
read | 50 | 3.000 |
admin | 20 | 600 |
Daarnaast mag de opvolgingslijst 30 keer per minuut worden gelezen en het bewijsmateriaal van de opvolging 10 keer per minuut. Boven een limiet is het antwoord 429 met een header Retry-After in seconden. Wacht zo lang en stuur dezelfde aanroep opnieuw. Een proefrun die alle validators bezet vindt, geeft op dezelfde manier 503 (busy) met Retry-After.
Ook het opzoeken van een koper in Peppol is beperkt: 30 opzoekingen per minuut en 300 per uur voor elke eindklant. Een antwoord dat al is bewaard, kost niets.
Limieten van de netwerken
De dienst telt de aanroepen van elke eindklant naar een netwerk en toetst ze aan de gepubliceerde limiet van dat netwerk. Een eindklant is de client op de factuur. Een factuur zonder client telt mee onder local. De tellers staan in de database, dus een herstart zet ze niet terug op nul.
| Verzendkanaal | Aanroep | Limiet |
|---|---|---|
PL-KSEF | Een factuur verzenden | 10 per seconde, 30 per minuut, 180 per uur |
PL-KSEF | Een status lezen | 30 per seconde, 120 per minuut, 1.200 per uur |
RO-EFACTURA | Elke aanroep | 1.000 per minuut |
DE-XRECHNUNG, PEPPOL, FR-PA | Niet gepubliceerd, niet toegepast |
Als een eindklant boven een limiet zit, blijft zijn factuur in de wachtrij en wordt ze een seconde later opnieuw geprobeerd. Er wordt niets afgewezen en er verschijnt niets als fout.
Bronnen, gelezen op 2 okt. 2026: de API-limieten van KSeF en de OAuth-procedure van ANAF. KSeF telt elk paar van context en IP-adres afzonderlijk. ANAF geeft voor zijn API 1.000 verzoeken per minuut op en antwoordt daarboven met 429, zonder te vermelden per wat die limiet geldt.
Poolse verzendingen tellen op: bij 180 per uur duren 1.000 facturen voor één eindklant ongeveer vijfenhalf uur. De Poolse offline24-modus geeft tijd tot het einde van de volgende werkdag om te verzenden. Batchsessies zijn gepland en niet gebouwd.
Herhaalpogingen bij een netwerkfout
Alleen een tijdelijke fout van een netwerk wordt opnieuw geprobeerd. Een afwijzing niet: die gaat naar de opvolgingslijst.
| Mislukking | Wachttijd tot de volgende poging |
|---|---|
| 1e | 30 seconden |
| 2e | 2 minuten |
| 3e | 10 minuten |
| 4e | 30 minuten |
| 5e | 1 uur |
| 6e | Geen. De factuur wordt dead_letter en gaat naar de opvolgingslijst. |
Een job die halverwege een verzending uitvalt, vraagt het verzendkanaal of het de factuur al heeft, voordat hij opnieuw verzendt. Herhaalpogingen van webhooks volgen hun eigen schema (zie webhooks).
Wettelijke termijnen
Twee verzendkanalen hebben een deadline die afhangt van de datum op de factuur. De dienst berekent die voor elke factuur bij de inname.
| Verzendkanaal | Deadline | Bron |
|---|---|---|
RO-EFACTURA | Het einde van de vijfde werkdag na de factuurdatum. | OUG 89/2025 en een mededeling van ANAF. |
PL-KSEF | Het einde van de volgende werkdag na de factuurdatum, de deadline van offline24. De dienst past die toe op elke Poolse factuur. | De btw-wet, art. 106nda, zoals gewijzigd door Dz.U. 2025 poz. 1203. |
De andere verzendkanalen hebben geen termijn. Voor een factuur die nog queued is, legt de dienst een waarschuwing vast wanneer de helft van de tijd tussen het begin van de factuurdatum en de deadline verstreken is, en opnieuw bij vier vijfde.
Waarschuwing
Twee beperkingen van de termijnberekening
- Ze telt van maandag tot vrijdag. Ze heeft geen kalender met nationale feestdagen, dus een feestdag telt als werkdag en de echte deadline kan later vallen dan de deadline die de dienst gebruikt.
- Ze telt dagen in UTC. De overheden tellen in lokale tijd, dus de daggrens verschilt een à twee uur.
Waarschuwingen worden in de dienst vastgelegd en niet verzonden (zie monitoring en waarschuwingen). De deadlines worden ook per factuur getoond als deadline_at, voor Roemenië en Polen, als de factuur een uitgiftedatum heeft (zie een factuur lezen). De twee deadlines zijn het laatst aan deze bronnen getoetst op 27 sept. 2026; ze worden opnieuw gecontroleerd voordat de documentatie wordt gepubliceerd.