Abbiamo reso open source peppol-validator — un npm gratuito per validare fatture UBL e Peppol
peppol-validator è un pacchetto npm gratuito con licenza MIT che valida documenti UBL 2.1 / Peppol BIS / EN 16931 rispetto a XSD e Schematron — senza Java, con i tuoi set di regole.
Abbiamo appena pubblicato il nostro primo pacchetto open source: peppol-validator, una piccola libreria npm che valida documenti UBL 2.1 e Peppol BIS — fatture, note di credito, ordini, avvisi di spedizione, cataloghi, application response — sia rispetto alla struttura XSD sia alle regole di business Schematron. È con licenza MIT e gratuita.
Perché rendere open source il validatore
Un documento non è "valido" solo perché è XML ben formato. Deve superare rigorosi controlli strutturali (XSD) e di regole di business (Schematron) per EN 16931, Peppol BIS o XRechnung — e mettere in piedi correttamente quella pipeline è macchinoso. La validazione, però, è una commodity: verifica i documenti, non li genera. Così abbiamo estratto quel livello dalla nostra piattaforma e lo abbiamo rilasciato a sé stante.
Cosa fa
La validazione XSD funziona subito — gli schemi OASIS UBL 2.1 sono inclusi, la radice del documento viene rilevata automaticamente (Invoice, CreditNote, Order, Catalogue, ApplicationResponse e altro) e viene selezionato lo schema corrispondente. Schematron gira su SaxonJS, quindi non c'è alcun Java o JVM da installare.
- Validazione XSD pronta all'uso (schemi OASIS UBL 2.1 inclusi).
- Validazione Schematron tramite SaxonJS — JavaScript puro, niente JVM.
- Rileva automaticamente il tipo di documento; un'unica API per le fatture e l'intera famiglia di documenti di approvvigionamento.
- Parsing rafforzato: entità esterne, caricamento DTD e accesso di rete disabilitati; dimensione dell'input limitata.
Porta i tuoi set di regole
Una scelta di progettazione deliberata: i set di regole Schematron Peppol, EN 16931 e XRechnung non vengono ridistribuiti all'interno del pacchetto — appartengono ai rispettivi enti. peppol-validator include invece un compilatore che trasforma localmente i file .sch ufficiali che scarichi in artefatti SEF eseguibili, così rimani sempre entro i termini accettati al momento del download. Vengono forniti solo l'XSD OASIS UBL e lo scheletro ISO Schematron con licenza MIT.
Per iniziare
Installalo con "npm install peppol-validator". Chiama validateXsd(xml) per un controllo strutturale istantaneo, oppure validate(xml, { sef }) per eseguire XSD più un set di regole Schematron compilato in un'unica chiamata. Ottieni un report chiaro con gli ID delle regole fallite e i messaggi.
Vedi peppol-validator su npmCome si collega a MyInvoice
peppol-validator è il livello di validazione aperto di MyInvoice. Il validatore verifica i documenti; la piattaforma MyInvoice va oltre — converte i dati che già possiedi (CSV, Excel, UBL, EDIFACT o XML legacy) in un documento EN 16931 conforme nel profilo che ti serve, lo convalida allo stesso modo e si collega al tuo ERP. Se devi solo verificare file, il pacchetto npm è sufficiente; se devi generare fatture conformi, è proprio a questo che serve MyInvoice.