Guida · 2026-05-16
Esporta MarkdownMessaggi di errore API e automazione
Codici di errore di integrazione comuni spiegati per utenti non tecnici.
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 non valida per questo account o endpoint. | Crea o copia la chiave corretta. |
| RATE_LIMITED | Sono state inviate troppe richieste in poco tempo. | 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.
Articoli correlati
Integra la conversione via API: ottieni accesso, carica con chiave di idempotenza, controlla il task e scarica il risultato.
Convertire fatture via e-mail: come funzionaConverti PDF via e-mail: attiva il canale Enterprise, verifica i mittenti, scegli il formato, invia gli allegati e controlla la risposta.
Checklist di integrazione ERP per e-fatturazione e rollout moderniChecklist pratica di integrazione ERP per progetti e-fatturazione: mapping dati, scelta formato, validazione, gestione eccezioni e controlli di go-live.