ZeRechnung
Lingua: Italiano
Questa traduzione non è ancora stata rivista da un madrelingua. Proponi una correzione

Pacchetto Go open source · licenza MIT

Fatture elettroniche in Go, a partire dai PDF che già producete

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.

Il gopher di Go, con gli occhiali e una barchetta di carta in testa, legge un registro di fatture a una scrivania con una macchina da scrivere, tra pile di fatture.

Che cosa fa

Un solo pacchetto per tutto il ciclo di vita di una fattura elettronica, sia in emissione sia in ricezione.

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é.

Leggere

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.

Validare

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.

Convertire

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.

Perché ZeRechnung

  • Go puro, solo libreria standard

    Niente CGO, niente Java, nessun binario esterno, nessuna chiamata di rete. Basta un go get per installarlo.

  • Confrontato con i validatori di riferimento

    Ogni pull request confronta i risultati con KoSIT, Mustang e veraPDF, fattura per fattura. Una nuova differenza fa fallire la build.

  • Veloce

    Leggere e validare completamente una fattura tipica richiede circa 25 µs, un quinto del tempo del pacchetto Go più veloce dopo di lui.

  • Il vostro PDF resta com'è

    L'XML viene aggiunto con un aggiornamento incrementale. I byte originali restano intatti, quindi una firma esistente rimane valida.

Formati e paesi

Un unico modello di fattura, invoice.Invoice, per tutte le sintassi: passare dall'una all'altra si riduce a una lettura e una scrittura.

FormatoPaesiLetturaScritturaValidazione
Factur-X 1.0x / ZUGFeRD 2.xCII · profili da MINIMUM a EXTENDED, ed EXTENDED-CTC-FRFRDEsìsìsì
XRechnung 3.0CII · UBLDEsìsìsì
Peppol BIS Billing 3.0CII · UBLEUsìsìsì
NLCIUSCII · UBLNLsìsìsì
CIUS-ITCII · UBLITsìsìsì
UBL 2.1Invoice · CreditNote · EN 16931EUsìsìsì
FatturaPA 1.2FPA12 · FPR12ITsìsìtramite CII (CIUS-IT)
Facturae 3.2.x3.2 · 3.2.1 · 3.2.2ESsìsìschema XSD; EN 16931 tramite UBL o CII
ZUGFeRD 1.0CIIDEsìcome Factur-Xcontrolli minimi

Quanto è affidabile?

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.

Metodo e limiti, sul wiki

Per iniziare

  1. Installate il pacchetto. Richiede Go 1.24 o successivo.

    Shell
    go get github.com/ritoon/zerechnung
  2. Trasformate il vostro PDF in una fattura Factur-X.

    Go
    pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
    	Calculate: true,                // totals and VAT breakdown
    	Validate:  &validate.Options{}, // refuse an invalid invoice
    })
  3. Validate una fattura ricevuta, con le regole nazionali del paese del venditore.

    Go
    report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
    if err != nil {
    	log.Fatal(err)
    }
    for _, f := range report.Errors() {
    	fmt.Println(f)
    }
  4. 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.

    Shell
    go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
    zerechnung validate -auto invoice.pdf

Open source, e aperto ai contributi

ZeRechnung è software libero con licenza MIT. Segnalazioni di bug, differenze rispetto a un validatore di riferimento e regole mancanti sono benvenute.

Apri una issue

Le traduzioni sono aperte a tutti. Avete trovato un errore nella vostra lingua? Modifica questa traduzione