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

- Aggiornato a maggio 2026

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

- In caso di `BuyerReference` mancante, interroga il database dei clienti per ottenere il `Leitweg-ID` predefinito e riprova.
- 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 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.