Vai al contenuto principale

Guida · 2026-08-29

Esporta Markdown

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

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.