Vai al contenuto principale

Guida · 2026-08-29

Esporta Markdown

Guida alla convalida delle regole di e-fatturazione

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.