# Gestione a livello di codice degli errori di schema delle fatture elettroniche

- 2026-08-29

Analizza gli errori di convalida, individua problemi strutturali XML e di namespace e applica solo correzioni supportate dalla fonte.

## Analisi del payload di convalida

Quando una fattura non supera la convalida dello schema, l’API restituisce errori JSON strutturati invece dell’XML convertito. Associa i codici noti ai campi, ma cambia un valore solo se una fonte o i dati anagrafici approvati lo confermano. Invia le modifiche ambigue o importanti a una persona.

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

- Per una `BuyerReference` mancante, usa il valore di questo ordine dai dati cliente o ordine approvati. Se manca, chiedilo all’acquirente; non inserire una `Leitweg-ID` predefinita.
- Per discrepanze di arrotondamento (ad esempio, differenze di `PayableAmount`), esamina il documento di origine e correggi gli importi di riga o i valori IVA sottostanti; accetta solo valori che corrispondono alla fattura.
- In caso di codice unità mancante, Invoice Converter imposta la riga sul valore predefinito `C62` e la contrassegna per la revisione; prima di accettare, verifica che l'unità contrassegnata corrisponda alla fattura di origine.

## Riprova vs. escalation manuale

- Riprova automaticamente solo dopo un errore temporaneo di connessione o limite, oppure dopo una correzione deterministica confermata dai dati sorgente.
- Revisione manuale: richiesta quando i totali sono significativamente diversi, mancano le coordinate bancarie o le categorie fiscali sono ambigue.