Validazione XRechnung: i 10 errori più comuni e come correggerli
Validazione XRechnung: i 10 errori più comuni e come correggerli
Chiunque crei e validi una XRechnung per la prima volta incontrerà quasi certamente messaggi di errore criptici. Codici come BR-DE-15, BR-CO-17 o BR-S-08 non sono esattamente autoesplicativi. Eppure la maggior parte di questi errori ha cause semplici che possono essere corrette rapidamente. In questo articolo spieghiamo i dieci errori di validazione più comuni in modo chiaro e mostriamo come risolverli.
Perché la validazione è essenziale
XRechnung si basa sullo standard europeo EN 16931. Questo standard definisce non solo il formato ma anche regole commerciali vincolanti. Ogni regola ha un codice univoco che inizia con BR (Business Rule). Le regole aggiuntive specifiche per la Germania hanno il prefisso BR-DE. Una fattura è considerata conforme solo quando tutte le regole sono soddisfatte. I sistemi riceventi — specialmente quelli utilizzati dalle agenzie governative — rifiutano automaticamente le fatture non conformi.
I 10 errori più comuni
1. BR-DE-15: riferimento acquirente mancante (Leitweg-ID)
Questo è l'errore più frequentemente riscontrato. XRechnung richiede un riferimento acquirente nel campo BuyerReference. Per le fatture alle autorità appaltanti del settore pubblico, questa è la Leitweg-ID. Nelle transazioni B2B, può essere utilizzato qualsiasi valore di riferimento concordato, ma il campo non deve mai essere vuoto.
Soluzione: inserisci la Leitweg-ID del destinatario o un numero di riferimento concordato.
2. BR-CO-17: calcolo IVA errato
BR-CO-17 verifica se l'importo dell'imposta per categoria fiscale (BT-117) è stato calcolato correttamente: importo imposta = base imponibile (BT-116) x aliquota fiscale (BT-119) / 100, arrotondato a due decimali. Anche minime differenze di arrotondamento attiveranno questo errore.
Soluzione: calcola l'IVA separatamente per ogni categoria fiscale dalla base imponibile e dall'aliquota fiscale, e arrotonda a due decimali solo alla fine. Evita arrotondamenti intermedi a livello di singola voce.
3. BR-DE-05: nome del contatto del venditore mancante
L'estensione tedesca XRechnung richiede che sia fornito un nome di contatto nella sezione "Contatto del venditore" (BG-6) — specificamente, un punto di contatto del venditore (BT-41). BR-DE-02 rende l'intero gruppo di contatto obbligatorio, e BR-DE-05 richiede specificamente il nome del contatto.
Soluzione: compila cac:Contact/cbc:Name con il nome di una persona di contatto o di un dipartimento.
4. BR-DE-06: numero di telefono del contatto del venditore mancante
La regola BR-DE-06 richiede che sia fornito un numero di telefono del venditore nella sezione contatto (BT-42, numero di telefono del contatto del venditore).
Soluzione: compila l'elemento cac:Contact/cbc:Telephone.
5. BR-DE-07: indirizzo email del contatto del venditore mancante
La regola BR-DE-07 richiede che il venditore fornisca un indirizzo email nella sezione contatto (BT-43, indirizzo email del contatto del venditore).
Soluzione: compila l'elemento cac:Contact/cbc:ElectronicMail per il venditore.
6. BR-S-08: discrepanza base imponibile
Questo errore indica che il totale netto di una categoria fiscale non corrisponde alla somma delle voci associate.
Soluzione: assicurati che la somma di tutti gli importi netti delle voci corrisponda esattamente al valore nel riepilogo fiscale (Tax Subtotal).
7. BR-DE-16: identificazione fiscale del venditore mancante
BR-DE-16 richiede che sia fornito almeno uno dei seguenti elementi: la partita IVA (BT-31, identificativo IVA del venditore), il numero di registrazione fiscale (BT-32, identificativo di registrazione fiscale del venditore) o un rappresentante fiscale (BG-11, rappresentante fiscale del venditore).
Soluzione: inserisci la tua partita IVA nel formato DE123456789 in BT-31 o il tuo numero di registrazione fiscale in BT-32. Almeno uno dei due è obbligatorio.
8. BR-CL-01: codice tipo fattura non valido
Il tipo di fattura deve corrispondere a un codice UNTDID 1001 valido. Per una fattura standard, il codice è 380; per una nota di credito è 381. Altri codici comuni includono 389 (fattura autofatturata) e 384 (fattura corretta).
Soluzione: utilizza il codice corretto dall'elenco codici UNTDID 1001.
9. BR-CO-10: totali incoerenti
BR-CO-10 verifica se la somma degli importi netti delle voci (BT-106) corrisponde al totale degli importi netti delle singole voci (BT-131). Insieme alle regole correlate, assicura che l'importo totale esclusa IVA (BT-109) = totale voci (BT-106) - sconti (BT-107) + maggiorazioni (BT-108).
Soluzione: rivedi i tuoi calcoli dei totali: la somma di tutti gli importi netti delle voci deve corrispondere esattamente a BT-106, e BT-106 meno gli sconti più le maggiorazioni deve corrispondere all'importo netto totale (BT-109).
10. BR-DE-01: istruzioni di pagamento mancanti
La XRechnung tedesca richiede che il gruppo "Istruzioni di pagamento" (BG-16) sia completato. Questo include almeno la specifica di un codice del mezzo di pagamento (BT-81), come il bonifico bancario (codice 30 o 58). A seconda del metodo di pagamento, devono essere forniti dettagli aggiuntivi come l'IBAN (BG-17).
Soluzione: aggiungi le istruzioni di pagamento in BG-16 con il codice del mezzo di pagamento appropriato e i dettagli associati (ad es. IBAN per i bonifici bancari). Facoltativamente, puoi anche includere i termini di pagamento come testo libero in PaymentTerms/Note (BT-20).
Come evitare errori fin dall'inizio
Il modo più semplice per evitare errori di validazione è utilizzare uno strumento che verifica le regole automaticamente. Con il validatore XRechnung gratuito di invapi, puoi validare i tuoi file XML direttamente nel browser rispetto a tutte le regole EN 16931 e XRechnung. I messaggi di errore sono presentati in un formato chiaro con indicazioni specifiche su come correggerli.
In alternativa, puoi integrare l'API invapi direttamente nel tuo flusso di lavoro di fatturazione per creare, convertire e validare automaticamente le fatture prima dell'invio.
Conclusione
Gli errori di validazione XRechnung possono sembrare intimidatori a prima vista, ma possono quasi sempre essere ricondotti a campi obbligatori mancanti o problemi di arrotondamento. Conoscere gli errori più comuni e utilizzare un buon strumento di validazione fa risparmiare tempo e garantisce la conformità. Prova il validatore invapi gratuito e invia la tua prossima XRechnung senza errori.