Guida · Aggiornato a maggio 2026
Esporta MarkdownGestione a livello di codice degli errori di schema delle fatture elettroniche
Analizza gli array di errori di convalida, risolvi i problemi strutturali XML, gestisci le discrepanze degli spazi dei nomi `UBL`/`CII` e automatizza le correzioni a livello di codice.
Analisi del payload di convalida
Quando una fattura non supera la convalida dello schema, l'API restituisce un payload JSON strutturato contenente un elenco dettagliato di errori anziché un file XML convertito. La gestione a livello di codice consente al tuo sistema di correggere automaticamente problemi semplici o di indirizzare errori complessi a revisori umani.
La risposta di errore contiene un codice di stato VALIDATION_FAILED insieme a un array di oggetti di errore. Ciascun oggetto fornisce un percorso specifico al campo che ha originato l'errore, il valore che ha causato l'errore e una descrizione leggibile dall'utente della regola di conformità violata (ad esempio, BR-CO-13).
Automazione delle risoluzioni comuni
Usa questi punti come controlli pratici per questa sezione.
- In caso di
BuyerReferencemancante, interroga il database dei clienti per ottenere ilLeitweg-IDpredefinito e riprova. - Per discrepanze di arrotondamento (ad esempio, differenze di
PayableAmount), applica automaticamente una piccola rettifica di arrotondamento fino a 0,02 unità di valuta. - Per codici unità non validi (come l'uso di PCE anziché dello standard
C62), mappa i valori a livello di codice prima dell'invio.
Riprova vs. escalation manuale
Usa questi punti come controlli pratici per questa sezione.
- Riprova automatica: sicura per errori di connessione temporanei, limiti di frequenza o rapide correzioni dello schema.
- Revisione manuale: richiesta quando i totali sono significativamente diversi, mancano le coordinate bancarie o le categorie fiscali sono ambigue.