Limiti e termini di legge
Frequenza delle richieste, limiti delle infrastrutture, nuovi tentativi e termini di legge.
- Nella sandbox
In parole semplici
Alcuni sistemi nazionali limitano la velocità con cui si possono inviare le fatture, e alcune leggi fissano una scadenza a partire dalla data della fattura. Questa pagina elenca i limiti che conteggiamo e i termini di legge che sorvegliamo, così un’azienda può pianificare la dimensione di un lotto e il giorno entro cui una fattura va trasmessa. Date e limiti provengono da fonti ufficiali e vanno ricontrollati prima di farvi affidamento.
Quattro fattori determinano il ritmo: la dimensione di una richiesta, la frequenza con cui un cliente può chiamare l’API, il limite di ciascun cliente sugli invii a un’infrastruttura e il termine di legge sui canali che ne hanno uno.
Dimensione della richiesta
Per un corpo oltre 5 MB (5.000.000 byte) la risposta è 413, con un corpo problem (payload-too-large). Vale per POST /invoices, POST /invoices/xml, POST /validate e POST /credentials.
Frequenza delle richieste
Ogni cliente ha un budget per ciascuno scope di chiave. Viene conteggiato per il cliente, non per la chiave, quindi più chiavi non danno più richieste.
| Scope | Chiamate al secondo | Chiamate al minuto |
|---|---|---|
submit | 20 | 600 |
read | 50 | 3.000 |
admin | 20 | 600 |
Inoltre, l’elenco degli scarti può essere letto 30 volte al minuto e le evidenze degli scarti 10 volte al minuto. Oltre un limite la risposta è 429 con un’intestazione Retry-After in secondi. Attendere quel tempo e inviare di nuovo la stessa chiamata. Una simulazione che trova tutti i validatori occupati risponde 503 (busy) con Retry-After allo stesso modo.
Anche la ricerca Peppol di un acquirente è limitata: 30 ricerche al minuto e 300 all’ora per ciascun cliente. Una risposta già conservata non costa nulla.
Limiti delle infrastrutture
Il servizio conta le chiamate di ciascun cliente a un’infrastruttura rispetto al limite pubblicato dall’infrastruttura. Un cliente è il client indicato nella fattura. Una fattura senza client viene conteggiata sotto local. I contatori sono conservati nel database, quindi un riavvio non li azzera.
| Canale | Chiamata | Limite |
|---|---|---|
PL-KSEF | Invio di una fattura | 10 al secondo, 30 al minuto, 180 all’ora |
PL-KSEF | Lettura di uno stato | 30 al secondo, 120 al minuto, 1.200 all’ora |
RO-EFACTURA | Qualsiasi chiamata | 1.000 al minuto |
DE-XRECHNUNG, PEPPOL, FR-PA | Nessuno pubblicato, nessuno applicato |
Quando un cliente supera un limite, la sua fattura resta in coda e viene ritentata un secondo dopo. Nulla viene scartato e nulla compare come errore.
Fonti, consultate il 2 ott. 2026: i limiti dell’API KSeF e la procedura OAuth di ANAF. KSeF conta separatamente ogni coppia di contesto e indirizzo IP. ANAF indica 1.000 richieste al minuto per la sua API e risponde 429 oltre questa soglia, senza specificare su quale base si conta.
Gli invii polacchi si sommano: a 180 all’ora, 1.000 fatture di un solo cliente richiedono circa cinque ore e mezza. La modalità offline24 della Polonia concede tempo fino alla fine del giorno lavorativo successivo per l’invio. Le sessioni batch sono pianificate e non realizzate.
Nuovi tentativi per un errore dell’infrastruttura
Si ritenta solo dopo un errore temporaneo di un’infrastruttura. Dopo uno scarto no: la fattura va nell’elenco degli scarti.
| Errore | Attesa prima del tentativo successivo |
|---|---|
| 1° | 30 secondi |
| 2° | 2 minuti |
| 3° | 10 minuti |
| 4° | 30 minuti |
| 5° | 1 ora |
| 6° | Nessuna. La fattura diventa dead_letter e va nell’elenco degli scarti. |
Un job che si interrompe a metà di un invio chiede al canale se ha già la fattura prima di inviarla di nuovo. I nuovi tentativi dei webhook seguono un calendario proprio (vedere webhook).
Termini di legge
Due canali hanno una scadenza a partire dalla data della fattura. Il servizio la calcola per ogni fattura alla presa in carico.
| Canale | Scadenza | Fonte |
|---|---|---|
RO-EFACTURA | La fine del quinto giorno lavorativo dopo la data di emissione. | OUG 89/2025 e un comunicato di ANAF. |
PL-KSEF | La fine del giorno lavorativo successivo alla data di emissione, che è la scadenza della modalità offline24. Il servizio la applica a ogni fattura polacca. | La legge sull’IVA, art. 106nda, come modificata da Dz.U. 2025 poz. 1203. |
Gli altri canali non hanno un termine. Per una fattura ancora queued, il servizio registra un avviso quando è trascorsa metà del tempo tra l’inizio del giorno di emissione e la scadenza, e di nuovo ai quattro quinti.
Avvertenza
Due limiti del calcolo dei termini
- Conta dal lunedì al venerdì. Non ha un calendario delle festività nazionali, quindi un giorno festivo conta come giorno lavorativo e la scadenza reale può cadere più tardi di quella usata dal servizio.
- Conta i giorni in UTC. Le autorità contano in ora locale, quindi il confine del giorno differisce di una o due ore.
Gli avvisi vengono registrati nel servizio e non inviati (vedere monitoraggio e avvisi). Le scadenze sono mostrate anche per ogni fattura come deadline_at, per Romania e Polonia, quando la fattura riporta una data di emissione (vedere leggere una fattura). Le due scadenze sono state verificate l’ultima volta su queste fonti il 27 set. 2026; vengono verificate di nuovo prima della pubblicazione della documentazione.