ZeRechnung
Idioma: Español
Esta traducción aún no ha sido revisada por un hablante nativo. Proponer una corrección

Paquete Go de código abierto · licencia MIT

Facturas electrónicas en Go, a partir de los PDF que ya generas

Sigue generando tus facturas en PDF como hasta ahora. ZeRechnung añade la factura XML y los metadatos que exige el estándar, y el PDF se convierte en una factura electrónica Factur-X o ZUGFeRD conforme. También lee y valida las facturas que recibes.

go get github.com/ritoon/zerechnung

Versión 0: la API aún puede cambiar antes de la v1.

El gopher de Go, con gafas y un barco de papel en la cabeza, lee un libro de facturas en un escritorio con una máquina de escribir, entre pilas de facturas.

Qué hace

Un solo paquete para toda la vida de una factura electrónica, tanto al emitirla como al recibirla.

Crear

Convierte el PDF que genera tu aplicación en una factura Factur-X o ZUGFeRD. Los totales y el desglose del IVA se calculan con decimales exactos, y una factura no válida se rechaza antes de escribir nada.

Leer

Lee PDF híbridos y XML sin más, en CII o UBL, de todas las versiones de ZUGFeRD desde la 1.0. Los datos para los que el modelo no tiene campo se conservan y se vuelven a escribir en su sitio.

Validar

Comprueba los esquemas, las reglas EN 16931, las de los perfiles y las reglas nacionales de Francia, Alemania, los Países Bajos e Italia, además de Peppol. Cada hallazgo indica el identificador oficial de la regla y el XPath del elemento.

Convertir

Convierte entre CII, UBL, FatturaPA y Facturae, y reescribe un PDF como PDF/A-3 cuando no hace falta un motor PDF. Si hace falta, obtienes los motivos, página por página.

Por qué ZeRechnung

  • Go puro, solo la biblioteca estándar

    Sin CGO, sin Java, sin binarios externos, sin llamadas de red. Basta con un go get para instalarlo.

  • Comparado con los validadores de referencia

    Cada pull request compara los resultados con KoSIT, Mustang y veraPDF, factura por factura. Una nueva diferencia hace fallar la compilación.

  • Rápido

    Leer y validar por completo una factura típica lleva unos 25 µs, la quinta parte que con el siguiente paquete Go más rápido.

  • Tu PDF se queda como está

    El XML se añade con una actualización incremental. Los bytes originales no cambian, así que una firma existente sigue siendo válida.

Formatos y países

Un único modelo de factura, invoice.Invoice, para todas las sintaxis: pasar de una a otra se reduce a una lectura y una escritura.

FormatoPaísesLecturaEscrituraValidación
Factur-X 1.0x / ZUGFeRD 2.xCII · perfiles de MINIMUM a EXTENDED, y 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ía través de CII (CIUS-IT)
Facturae 3.2.x3.2 · 3.2.1 · 3.2.2ESsísíesquema XSD; EN 16931 a través de UBL o CII
ZUGFeRD 1.0CIIDEsícomo Factur-Xcomprobaciones mínimas

¿Qué fiabilidad tiene?

Cada pull request ejecuta los validadores de referencia sobre los corpus de prueba oficiales y compara sus resultados con los de ZeRechnung, factura por factura.

128 / 128

KoSIT

facturas XRechnung con exactamente los mismos errores que el validador KoSIT.

241 / 282

Mustang

facturas con los mismos errores que Mustang. Cada diferencia viene de las propias referencias y está explicada.

283 / 290

NPa

archivos NLCIUS con las mismas reglas que los validadores neerlandeses de la NPa. Las demás diferencias están justificadas.

609 / 614

veraPDF

archivos PDF/A no válidos del corpus de veraPDF detectados por una regla de la cláusula correcta.

Método y limitaciones, en la wiki

Empezar

  1. Instala el paquete. Necesita Go 1.24 o posterior.

    Shell
    go get github.com/ritoon/zerechnung
  2. Convierte tu PDF en una factura 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. Valida una factura recibida, con las reglas nacionales del país del vendedor.

    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. O usa la línea de comandos. validate termina con el código 1 si hay errores, así que encaja tal cual en un pipeline de CI.

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

Código abierto y abierto a contribuciones

ZeRechnung es software libre con licencia MIT. Los informes de errores, las diferencias con un validador de referencia y las reglas que faltan son bienvenidos.

Abrir una issue

Las traducciones están abiertas a todos. ¿Has visto un error en tu idioma? Editar esta traducción