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 resta non raggiungibile, la External API chiude il task con una risposta 409, il codice ARTIFACT_GENERATION_RERUN_REQUIRED e details.code AUTHORITATIVE_VALIDATION_UNAVAILABLE; invia di nuovo il documento come nuova conversione.

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.