# Gestione 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

- 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`), 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

- 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.