Creare
Trasformate il PDF prodotto dalla vostra applicazione in una fattura Factur-X o ZUGFeRD. I totali e il riepilogo IVA sono calcolati con decimali esatti, e una fattura non valida viene rifiutata prima che venga scritto alcunché.
Pacchetto Go open source · licenza MIT
Continuate a generare le vostre fatture in PDF come fate oggi. ZeRechnung aggiunge la fattura XML e i metadati richiesti dallo standard, e il PDF diventa una fattura elettronica Factur-X o ZUGFeRD conforme. Legge e valida anche le fatture che ricevete, e legge e scrive FatturaPA, il formato del Sistema di Interscambio.
go get github.com/ritoon/zerechnung
Versione 0: l'API può ancora cambiare prima della v1.
Un solo pacchetto per tutto il ciclo di vita di una fattura elettronica, sia in emissione sia in ricezione.
Trasformate il PDF prodotto dalla vostra applicazione in una fattura Factur-X o ZUGFeRD. I totali e il riepilogo IVA sono calcolati con decimali esatti, e una fattura non valida viene rifiutata prima che venga scritto alcunché.
Leggete PDF ibridi e XML semplice, in CII o UBL, di tutte le versioni di ZUGFeRD dalla 1.0. I dati per cui il modello non ha un campo vengono conservati e riscritti al loro posto.
Controllate gli schemi, le regole EN 16931, quelle dei profili e le regole nazionali di Francia, Germania, Paesi Bassi e Italia, oltre a Peppol. Ogni segnalazione riporta l'identificativo ufficiale della regola e l'XPath dell'elemento.
Convertite tra CII, UBL, FatturaPA e Facturae, e riscrivete un PDF in PDF/A-3 quando non serve un motore PDF. Altrimenti ottenete i motivi, pagina per pagina.
Niente CGO, niente Java, nessun binario esterno, nessuna chiamata di rete. Basta un go get per installarlo.
Ogni pull request confronta i risultati con KoSIT, Mustang e veraPDF, fattura per fattura. Una nuova differenza fa fallire la build.
Leggere e validare completamente una fattura tipica richiede circa 25 µs, un quinto del tempo del pacchetto Go più veloce dopo di lui.
L'XML viene aggiunto con un aggiornamento incrementale. I byte originali restano intatti, quindi una firma esistente rimane valida.
Programmi completi, passo per passo, con fatture del paese di ciascuna lingua.
I tempi di esecuzione, misurati rispetto alle altre librerie Go e a TypeScript, Python e Rust.
Le regole di fatturazione elettronica di ogni paese europeo, e i punti di controllo coperti da ZeRechnung.
Un unico modello di fattura, invoice.Invoice, per tutte le sintassi: passare dall'una all'altra si riduce a una lettura e una scrittura.
| Formato | Paesi | Lettura | Scrittura | Validazione |
|---|---|---|---|---|
| Factur-X 1.0x / ZUGFeRD 2.xCII · profili da MINIMUM a EXTENDED, ed EXTENDED-CTC-FR | FRDE | sì | sì | sì |
| XRechnung 3.0CII · UBL | DE | sì | sì | sì |
| Peppol BIS Billing 3.0CII · UBL | EU | sì | sì | sì |
| NLCIUSCII · UBL | NL | sì | sì | sì |
| CIUS-ITCII · UBL | IT | sì | sì | sì |
| UBL 2.1Invoice · CreditNote · EN 16931 | EU | sì | sì | sì |
| FatturaPA 1.2FPA12 · FPR12 | IT | sì | sì | tramite CII (CIUS-IT) |
| Facturae 3.2.x3.2 · 3.2.1 · 3.2.2 | ES | sì | sì | schema XSD; EN 16931 tramite UBL o CII |
| ZUGFeRD 1.0CII | DE | sì | come Factur-X | controlli minimi |
Ogni pull request esegue i validatori di riferimento sui corpus di test ufficiali e confronta i loro risultati con quelli di ZeRechnung, fattura per fattura.
128 / 128
KoSIT
fatture XRechnung con esattamente gli stessi errori del validatore KoSIT.
241 / 282
Mustang
fatture con gli stessi errori di Mustang. Ogni differenza deriva dai riferimenti stessi ed è spiegata.
283 / 290
NPa
file NLCIUS con le stesse regole dei validatori olandesi della NPa. Le altre differenze sono motivate.
609 / 614
veraPDF
file PDF/A non validi del corpus veraPDF rilevati da una regola della clausola giusta.
Installate il pacchetto. Richiede Go 1.24 o successivo.
go get github.com/ritoon/zerechnungTrasformate il vostro PDF in una fattura Factur-X.
pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
Calculate: true, // totals and VAT breakdown
Validate: &validate.Options{}, // refuse an invalid invoice
})Validate una fattura ricevuta, con le regole nazionali del paese del venditore.
report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
if err != nil {
log.Fatal(err)
}
for _, f := range report.Errors() {
fmt.Println(f)
}Oppure usate la riga di comando. validate termina con il codice 1 in caso di errori, quindi si inserisce così com'è in una pipeline di CI.
go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
zerechnung validate -auto invoice.pdfZeRechnung è software libero con licenza MIT. Segnalazioni di bug, differenze rispetto a un validatore di riferimento e regole mancanti sono benvenute.
Le traduzioni sono aperte a tutti. Avete trovato un errore nella vostra lingua? Modifica questa traduzione