# Guida alla convalida delle regole di e-fatturazione

- 2026-08-29

Risolvi avvisi e timeout del validatore. Non trattare il risultato delle regole come approvazione legale o conferma di consegna.

## Cosa controlla la convalida del profilo

Un validatore controlla un file XML rispetto allo schema e alle regole Schematron del profilo e della versione scelti, per esempio KoSIT XRechnung o Peppol BIS Billing.

Un risultato positivo significa solo che il file ha rispettato quelle regole leggibili da software. Non prova che i dati fattura siano corretti, che il trattamento fiscale sia lecito o che un acquirente o portale accetti la consegna.

## Gestione delle interruzioni temporanee

- Le regole scelte o il servizio di convalida si stanno avviando o sono fermi per manutenzione.
- Un ritardo di rete o di avvio causa un timeout tra l’app e il servizio di convalida.
- Un carico temporaneo del servizio restituisce 504 Gateway Timeout.

## Criteri di resilienza per gli sviluppatori

Se il servizio di convalida del profilo non è raggiungibile, Invoice Converter restituisce una risposta 503 con il codice AUTHORITATIVE_VALIDATION_UNAVAILABLE.

Metti questo stato in una coda di nuovi tentativi. Non inviare un file di produzione mentre la convalida necessaria è in attesa e conferma separatamente il canale del destinatario.

## Risoluzione degli errori di convalida

- Controlla che BuyerReference o Leitweg-ID corrisponda alle istruzioni dell’acquirente.
- Verifica che i codici valuta siano conformi allo standard ISO 4217.
- Confronta ogni subtotale fiscale con gli importi delle righe e gli sconti o maggiorazioni a livello di documento.
- Esamina il report XML restituito nel corpo della risposta per individuare gli ID esatti delle regole Schematron come `BR-DE-15`.