Validatore di fatture UBL/Peppol

Controlla la struttura prima che lo faccia la rete al posto tuo

Il modo costoso per scoprire che un file di fattura è rotto è inviarlo: viaggia fino al tuo cliente o a un access point, viene rifiutato ore o giorni dopo, e il conto alla rovescia del pagamento riparte da capo. Il modo economico è passare prima trenta secondi qui. Questo validatore risponde alle domande dirette e utili: il file è XML ben formato, è davvero una fattura UBL Invoice, e sono presenti i campi di cui ha bisogno qualsiasi fattura leggibile — numero, date, entrambe le parti, righe e totali. I file vengono controllati nella memoria del server e scartati immediatamente, il che è il modo appropriato di trattare un documento che porta nomi, importi e dati bancari. Si rivela particolarmente utile in due situazioni: una piccola impresa che genera le sue prime fatture UBL da un modello o da un modulo ERP poco familiare, e uno sviluppatore che testa una pipeline di esportazione e vuole un parere esterno rapido sull'output prima di indirizzarlo verso la rete reale.

Cos'è un controllo strutturale — e cos'è Schematron

Qui l'onestà conta. La validazione ufficiale Peppol BIS Billing 3.0 è un insieme di regole Schematron: centinaia di regole di business che controllano cose come la coerenza dei codici categoria IVA e la corrispondenza tra i totali fiscali e la somma delle righe. Questo strumento non esegue quelle regole. Leggi i due esiti di conseguenza: un esito negativo qui è definitivo — un file che non viene analizzato correttamente, o a cui mancano campi obbligatori, fallirà ovunque, quindi correggilo prima di inviarlo. Un esito positivo qui significa che la struttura è utilizzabile, non che ogni regola di business sia soddisfatta; la rete può comunque rifiutarlo per una violazione a livello di regola. Prima la struttura, poi Schematron, è l'ordine naturale del controllo. Il confine è deliberato, non una scorciatoia: i set di regole ufficiali sono versionati e mantenuti centralmente, ed eseguirli correttamente è compito dell'infrastruttura Peppol stessa — imitarla male ti servirebbe peggio che dichiarare chiaramente il limite.

I fallimenti che vediamo davvero

La maggior parte dei file respinti rientra in una manciata di schemi ricorrenti. Il file è una nota di credito invece che una fattura — un tipo di documento UBL diverso che questo validatore non copre ancora. È un PDF Factur-X invece di XML puro — la fattura è incorporata dentro un PDF e va prima estratta con l'Estrattore XML Factur-X/ZUGFeRD di questo sito. È stato troncato o ricodificato da qualche parte durante un tragitto via email, quindi l'XML non viene più analizzato correttamente. Oppure un'esportazione ERP ha lasciato vuoti campi obbligatori di una parte o di un totale perché un record anagrafico era incompleto. Il validatore indica cosa manca, il che di solito punta direttamente a quale di questi casi sia avvenuto. Una variante più sottile vale la pena conoscerla: un file che si apre bene in un editor di testo può comunque non essere analizzato correttamente perché un gateway email o un passaggio di copia-incolla ne ha cambiato la codifica dei caratteri — invisibile all'occhio, fatale per l'XML. Ri-esporta dal sistema di origine invece di riparare a mano.

Lo stesso analizzatore del renderer PDF — e quando chiamare il tuo fornitore

Questo validatore condivide il proprio analizzatore, riga per riga, con lo strumento Fattura UBL/Peppol in PDF di questo sito. Questo ti offre un piccolo flusso di lavoro affidabile: valida il file, poi renderizzalo e leggi la fattura come farebbe una persona — un IBAN sbagliato o un totale assurdo è spesso più facile da individuare su una pagina che nell'XML. E sappi dove si trova il confine: se un file passa qui, si renderizza in modo sensato, ed è comunque rifiutato dalla rete Peppol, il problema si trova a livello di regola di business o di trasmissione. Quella conversazione spetta al tuo access point o al fornitore del software, che può vedere il report di validazione ufficiale — porta con te il loro messaggio di errore, perché indica esattamente quale regola è scattata.

Cosa verifica effettivamente questo strumento

Questo strumento conferma che il file è XML ben formato, ha una radice UBL Invoice e contiene i campi necessari a una fattura leggibile: numero di fattura, date, dati di fornitore e cliente, righe di dettaglio e totali. È un controllo strutturale di base, non la validazione ufficiale Schematron di Peppol BIS Billing 3.0 — non rileva ogni violazione delle regole di business (ad es. totali IVA che non quadrano), ma solo se la struttura è utilizzabile.