Prima di inviare un'e-fattura, è importante assicurarsi che il file XML sia tecnicamente corretto. L'eConnect Validator controlla la fattura su schemi XML, regole Schematron e validazioni specifiche per paese. Lo strumento è disponibile gratuitamente come validatore online.

L'eConnect Validator esegue diversi controlli sul file dell'e-fattura:

Validazione dello schema XML. La struttura di base del file è corretta? Tutti gli elementi XML obbligatori sono presenti e correttamente annidati?

Validazione Schematron. La fattura è conforme alle business rules del profilo selezionato? Si pensi a regole per i calcoli IVA, campi obbligatori e codelist.

Controllo del profilo. Il sistema riconosce automaticamente quale profilo segue la fattura (BIS Billing V3, NLCIUS, PINT, XRechnung) e applica le relative regole di validazione.

Regole specifiche per paese. Per ogni paese vigono regole di validazione aggiuntive. Per i Paesi Bassi si tratta delle regole NL-R, per la Germania delle regole DE-R, per la Danimarca delle regole DK-R e così via. Il validatore le applica automaticamente in base al codice paese nella fattura.

Il validatore supporta tutti i formati comuni di e-fattura:

Il validatore online è disponibile su /it/validator. Non è necessario creare un account.

1. Apra il Document Validator.
2. Carichi il file XML o incolli il contenuto XML.
3. Il validatore riconosce automaticamente il formato e applica le regole corrette.
4. Consulti il risultato: per ogni regola è visibile se il controllo è superato, genera un avviso o contiene un errore.

In caso di errori, il validatore fornisce il codice errore esatto, una descrizione del problema e la posizione nel file XML (XPath). In questo modo sa esattamente cosa modificare.

Il validatore fornisce tre tipi di messaggi:

• Errore (error): la fattura non è conforme alla specifica e verrà rifiutata sulla rete Peppol. Questo deve essere risolto prima dell'invio.
• Avviso (warning): la fattura non viene rifiutata, ma c'è un punto di attenzione. Gli avvisi potrebbero diventare obbligatori in una futura release.
• Informativo: un'osservazione senza conseguenze per l'invio.

I codici errore più comuni iniziano con un prefisso che indica il dominio: PEPPOL- per regole Peppol generali, NL-R- per regole olandesi, BR- per regole base della EN 16931. La descrizione dell'errore indica sempre quale sia il comportamento atteso.

Durante l'invio di una nota di credito si verificano regolarmente alcuni errori di validazione specifici. L'errore appare a livello Peppol (per gli invii via API, ad esempio, come [API400.AT04] Invalid payload). Per regola, la causa e la soluzione:

BR-IC-11 e BR-IC-12 sono regole base EN 16931 che si applicano solo quando la nota di credito contiene una categoria IVA intracomunitaria; per le cessioni nazionali non si verificano.

Una fattura può contenere un periodo a due livelli: un periodo di fattura a livello documento (BG-14) e un periodo di riga per riga fattura (BG-26, per servizi ricorrenti o abbonamenti a livello di riga). Quando entrambi vengono utilizzati, Peppol richiede che ogni periodo di riga rientri nel periodo di fattura complessivo. I seguenti errori compaiono se questa condizione non è soddisfatta:

Il controllo sottostante di R110 verifica che la data di inizio del periodo di riga sia uguale o successiva alla data di inizio del periodo di fattura. Se l'errore persiste pur sembrando corretto il periodo di riga, verificare se il problema è a livello documento: o il periodo di fattura (BT-73) è impostato troppo tardi, oppure il periodo di riga è involontariamente più ampio del previsto. Entrambi i periodi devono contenersi a vicenda: il periodo di fattura è il limite esterno, ogni periodo di riga deve rientrarvi.

BR-30 (EN 16931) è una regola diversa da R110/R111: R110/R111 verificano se il periodo di riga rientra nel periodo di fattura, mentre BR-30 verifica solo l'ordine di due date di periodo di riga presenti (BT-135 maggiore o uguale a BT-134).

Regole di periodo aggiuntive che possono presentarsi nello stesso contesto:

• BR-CO-19 / BR-CO-20: se viene utilizzato un periodo di fattura (BG-14) o un periodo di riga (BG-26), deve essere compilata almeno la data di inizio o quella di fine (una delle due è sufficiente, sono ammesse anche entrambe).
• PEPPOL-EN16931-F001: tutte le date devono essere nel formato YYYY-MM-DD.

Queste regole si applicano sia alle fatture (ubl:Invoice) sia alle note di credito (ubl:CreditNote).

Oltre al validatore manuale, la piattaforma eConnect esegue automaticamente la validazione anche al momento dell'invio. Se una fattura non soddisfa i requisiti, l'invio viene bloccato e viene mostrato un messaggio di errore con la regola di validazione interessata.

Per gli utenti API: la PSB valida ogni fattura al momento dell'invio e restituisce i risultati della validazione nella risposta API. In questo modo è possibile integrare la validazione anche nel proprio processo software.

Le regole di validazione vengono aggiornate con ogni nuova release della specifica Peppol BIS Billing. eConnect aggiorna gli artefatti Schematron e le codelist non appena una nuova versione diventa obbligatoria. Il validatore online valida sempre rispetto alla release corrente.

Suggerimento: dopo un aggiornamento della specifica, verifichi che le Sue fatture siano ancora valide. Nuove regole possono imporre requisiti più stringenti su campi che in precedenza erano opzionali.

Desidera consultare file di esempio per verificare la composizione del Suo XML? Scarichi i file di esempio.

• Scaricare file di esempio e template NLCIUS
• Qual è la differenza tra XML, UBL, BIS Billing V3 e NLCIUS?
• Registrarsi su Peppol per l'invio e la ricezione