Validare una fattura

L'eConnect Validator gratuito: verifichi se il Suo XML è conforme a UBL, BIS Billing e NLCIUS.

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.

Cosa controlla il validatore?

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.

Formati supportati

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

FormatoDescrizionePeppol BIS Billing V3Lo standard Peppol per fatture e note di creditoNLCIUS / SI-UBL 2.0L'implementazione olandese della EN 16931PINT (tutte le varianti)Peppol International Invoice (UE, A-NZ, Giappone, Singapore, Malesia, EAU)XRechnungImplementazione tedescaCII (Cross-Industry Invoice)Sintassi XML alternativa, incluso Factur-X
Come utilizzare il validatore?

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.

Interpretare gli errori

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.

Errori di validazione comuni per le note di credito

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:

Codice erroreCausaSoluzioneBR-IC-02 (EN 16931: BR-IC-2)Riga fattura (BG-25) con categoria IVA Intra-community supply / K (BT-151) senza party-VAT obbligatorio: seller VAT (BT-31) o seller tax representative VAT (BT-63), e buyer VAT (BT-48). Non indica un numero di riga specifico; dati mancanti nei dettagli della parte.Compili seller VAT (o tax rep) e buyer VAT con prefisso paese, senza spazi/punti. Verifichi tutte le righe con categoria K.BR-IC-11In una cessione intracomunitaria (categoria IVA "Intra-community supply"), manca la data di consegna BT-72.Compili la data di consegna effettiva (BT-72, cac:Delivery/cbc:ActualDeliveryDate), oppure indichi un periodo di fatturazione (BG-14). Uno dei due è obbligatorio.BR-IC-12In una cessione intracomunitaria, manca il codice paese BT-80 dell'indirizzo di consegna.Compili il codice paese "deliver to" (BT-80, cac:Delivery/cac:DeliveryLocation/cac:Address/cac:Country/cbc:IdentificationCode) con un codice ISO 3166-1 alpha-2.BR-27Il prezzo unitario dell'articolo (PriceAmount, BT-146) è negativo ("Item net price shall NOT be negative"; tra gli altri, Maventa/Peppol segnala questo come "XML Invalid").Il prezzo unitario deve sempre essere positivo. Non disattivabile -- non è un'impostazione tenant di eConnect, è una regola EN 16931/Peppol. Accrediti tramite una quantità negativa (TypeCode 380) o tramite lo schema CreditNote (381, prezzo e quantità positivi). Corregga l'esportazione nel software di origine; reinviare lo stesso XML non risolve BR-27. Veda anche Varianti di nota di credito e self-billing.NL-R-001Manca il riferimento fattura obbligatorio su una nota di credito di un fornitore NL.Compili cac:BillingReference/cac:InvoiceDocumentReference/cbc:ID con il numero della fattura originale. Obbligatorio per le note di credito. Veda anche Varianti di nota di credito.

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.

Validazione all'invio

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.

Monitorare le nuove release

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.

Domande frequenti
Cosa succede se la mia fattura contiene un errore durante la validazione?

Per ogni errore, il validatore mostra il codice errore esatto, una descrizione del problema e la posizione nel file XML (XPath). Gli errori devono essere risolti prima dell'invio, altrimenti la fattura verrà rifiutata sulla rete Peppol. Gli avvisi sono punti di attenzione ma non bloccano l'invio.

Quali formati può controllare il validatore?

Il validatore supporta Peppol BIS Billing V3, NLCIUS/SI-UBL 2.0, tutte le varianti PINT, XRechnung e CII (Cross-Industry Invoice, incluso Factur-X). Il formato viene rilevato automaticamente al caricamento del file XML.

La mia fattura viene validata automaticamente anche all'invio?

Sì. La piattaforma eConnect esegue automaticamente la validazione al momento dell'invio. Se una fattura non soddisfa i requisiti, l'invio viene bloccato con un messaggio di errore. Gli utenti API ricevono i risultati della validazione nella risposta API.


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

Validi la Sua fattura

Correlati