# Guida alla convalida ufficiale delle fatture elettroniche

Risolvi gli avvisi di convalida ufficiale, gestisci i timeout di connessione, interpreta i report del convalidatore KoSIT e garantisci la conformità `EN16931`.

## Comprendere la convalida ufficiale

Mentre i convalidatori locali verificano la struttura di base, la conformità ufficiale della fattura elettronica richiede il superamento della convalida ufficiale. Ciò comporta l'esecuzione delle regole Schematron ufficiali del convalidatore KoSIT per gli standard tedeschi, o delle specifiche Peppol BIS Billing 3.0.

Il superamento di questo passaggio fornisce la prova legale che il file XML `UBL` o `CII` generato è conforme agli standard europei.

## Gestione delle interruzioni temporanee

- Servizio web KoSIT o Peppol in avvio o offline per manutenzione.
- La latenza di rete causa timeout di connessione tra il gateway e i server ufficiali.
- Periodi di traffico intenso che causano risposte temporanee `504 Gateway Timeout`.

## Criteri di resilienza per gli sviluppatori

Se il servizio di convalida ufficiale non è raggiungibile, Invoice Converter restituisce un errore `VALIDATION_SERVICE_UNAVAILABLE`.

In ambienti di produzione, dovresti intercettare questo stato e inserire la fattura in una coda di riprova (retry queue). Non saltare mai la convalida per gli acquirenti del settore pubblico (come quelli che richiedono un `Leitweg-ID`), poiché rifiuteranno le fatture non convalidate.

## Risoluzione degli errori di convalida

- Verifica che la `BuyerReference` o il `Leitweg-ID` corrispondano al formato ufficiale del registro.
- Verifica che i codici valuta siano conformi allo standard ISO 4217.
- Assicurati che i subtotali delle imposte corrispondano esattamente alla somma dei valori fiscali delle singole voci.
- Esamina il report XML restituito nel corpo della risposta per individuare gli ID esatti delle regole Schematron come `BR-DE-15`.