Guida · Aggiornato a maggio 2026
Esporta MarkdownMessaggi di errore API e automazione
Common integration error codes explained for non-technical users.
A chi serve questo articolo
Usa questo articolo quando un cliente vede un errore da integrazione, automazione o flusso batch e deve capire quale azione fare.
Messaggi comuni
| Messaggio o codice | Cosa significa | Cosa fare |
|---|---|---|
| AUTHENTICATION_REQUIRED | La richiesta non includeva un accesso utilizzabile o un bearer token valido. | Accedi di nuovo o aggiungi il token API mancante. |
| INVALID_API_KEY | La chiave API è errata, scaduta, revocata o proviene dall’ambiente sbagliato. | Crea o copia la chiave corretta. |
| RATE_LIMITED | Too many requests were sent in a short period. | Attendi la finestra di retry, poi continua più lentamente. |
| PAYLOAD_TOO_LARGE | Il file caricato supera il limite di dimensione. | Comprimi il PDF o dividi il lavoro in fatture più piccole. |
| INVALID_UPLOAD | Il file caricato non poteva essere letto come input fattura valido. | Controlla che il file non sia vuoto, danneggiato, protetto da password o nel formato sbagliato. |
| VALIDATION_FAILED | I dati della fattura contengono problemi bloccanti. | Controlla i campi restituiti e correggi i dati della fattura prima di riprovare. |
| OUTPUT_PROFILE_REQUIRED | Il formato di output richiesto richiede un profilo di conformità più chiaro. | Scegli il profilo previsto, ad esempio XRechnung, EN 16931, ZUGFeRD o Factur-X. |
| OUTPUT_PROFILE_CONFLICT | Il formato scelto e il profilo si contraddicono. | Scegli un obiettivo di output coerente e riprova. |
Indicazioni per riprovare
Riprova gli errori temporanei come timeout, servizi non disponibili e alcuni errori di caricamento.
Non riprovare alla cieca errori di validazione, autenticazione, limite richieste, dimensione file o profilo. Prima serve una correzione.