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.
Paquete Go de código abierto · licencia MIT
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.
Un solo paquete para toda la vida de una factura electrónica, tanto al emitirla como al recibirla.
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.
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.
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.
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.
Sin CGO, sin Java, sin binarios externos, sin llamadas de red. Basta con un go get para instalarlo.
Cada pull request compara los resultados con KoSIT, Mustang y veraPDF, factura por factura. Una nueva diferencia hace fallar la compilación.
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.
El XML se añade con una actualización incremental. Los bytes originales no cambian, así que una firma existente sigue siendo válida.
Programas completos, paso a paso, con facturas del país de cada idioma.
Tiempos de ejecución, medidos frente a las demás bibliotecas Go y frente a TypeScript, Python y Rust.
Las reglas de facturación electrónica de cada país europeo y los puntos de control que cubre ZeRechnung.
Un único modelo de factura, invoice.Invoice, para todas las sintaxis: pasar de una a otra se reduce a una lectura y una escritura.
| Formato | Países | Lectura | Escritura | Validación |
|---|---|---|---|---|
| Factur-X 1.0x / ZUGFeRD 2.xCII · perfiles de MINIMUM a EXTENDED, y 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í | a través de CII (CIUS-IT) |
| Facturae 3.2.x3.2 · 3.2.1 · 3.2.2 | ES | sí | sí | esquema XSD; EN 16931 a través de UBL o CII |
| ZUGFeRD 1.0CII | DE | sí | como Factur-X | comprobaciones mínimas |
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.
Instala el paquete. Necesita Go 1.24 o posterior.
go get github.com/ritoon/zerechnungConvierte tu PDF en una factura Factur-X.
pdf, err := zerechnung.Create(host, inv, &zerechnung.CreateOptions{
Calculate: true, // totals and VAT breakdown
Validate: &validate.Options{}, // refuse an invalid invoice
})Valida una factura recibida, con las reglas nacionales del país del vendedor.
report, _, err := zerechnung.Check(pdf, &validate.Options{Auto: true})
if err != nil {
log.Fatal(err)
}
for _, f := range report.Errors() {
fmt.Println(f)
}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.
go install github.com/ritoon/zerechnung/cmd/zerechnung@latest
zerechnung validate -auto invoice.pdfZeRechnung es software libre con licencia MIT. Los informes de errores, las diferencias con un validador de referencia y las reglas que faltan son bienvenidos.
Las traducciones están abiertas a todos. ¿Has visto un error en tu idioma? Editar esta traducción