Ejemplos
Ejemplos, paso a paso
Cada ejemplo es un programa Go completo que se ejecuta tal cual. Crea una factura electrónica real, la comprueba con las reglas del país y después la vuelve a leer. Las pruebas del repositorio ejecutan cada programa y comprueban que imprime lo que muestra esta página.
Las empresas, las personas y los identificadores de estos ejemplos son ficticios. Los identificadores tienen dígitos de control válidos, para que las reglas nacionales los acepten.
Ejemplo 1
Un secadero de Guijuelo vende jamón ibérico a una charcutería de Hamburgo
Jamones Hermanas Prieto cura jamones y paletas de bellota en sus bodegas de Guijuelo (Salamanca), al aire frío de la sierra. Desde hace unos años sirve a Feinkost Möller & Kaya, una charcutería fina de Hamburgo que corta el jamón a cuchillo delante de sus clientes. El programa de facturación del secadero ya genera la factura en PDF; ZeRechnung le añade el XML y los metadatos de ZUGFeRD, el nombre alemán de Factur-X, para que la contabilidad de Hamburgo la lea sin teclear nada.
Es una entrega intracomunitaria de bienes: la factura no lleva IVA español (categoría K) y el comprador declara el IVA de la adquisición en Alemania. ZeRechnung no tiene reglas nacionales para España: la factura se valida con la norma europea EN 16931 y con lo que Alemania exige a una factura electrónica.
-
Leer el PDF de la factura
Se parte del PDF que el programa de facturación ya produce. Lo ideal es un PDF/A-3, pero sirve cualquier PDF: ZeRechnung no toca sus bytes y añade el XML como adjunto mediante una actualización incremental.
Gopdf, err := os.ReadFile("factura.pdf") if err != nil { log.Fatal(err) } -
Describir al vendedor y al comprador
En una entrega intracomunitaria, la factura debe llevar el NIF-IVA de las dos partes (regla BR-IC-02): el del secadero, con el prefijo ES, y el número alemán de IVA de la charcutería (USt-IdNr.). ZeRechnung comprueba que estén, pero no consulta el sistema VIES: esa verificación sigue siendo cosa del vendedor.
Gosecadero := invoice.Party{ Name: "Jamones Hermanas Prieto, S.L.", VATID: "ESB37412855", Address: invoice.Address{ Line1: "Calle de la Dehesa, 14", PostCode: "37770", City: "Guijuelo", CountrySubdivision: "Salamanca", CountryCode: "ES", }, Contact: &invoice.Contact{ PersonName: "Rocío Prieto", Phone: "+34 923 000 000", Email: "pedidos@hermanasprieto.example", }, } charcuteria := invoice.Party{ Name: "Feinkost Möller & Kaya GmbH", VATID: "DE318472657", Address: invoice.Address{ Line1: "Isestraße 41", PostCode: "20144", City: "Hamburg", CountryCode: "DE", }, } -
Añadir las menciones obligatorias
Una factura exenta debe citar la norma que la exime: el artículo 25 de la Ley del IVA va en el motivo de exención (BT-120), con su código VATEX-EU-IC (BT-121). La fecha de entrega (BT-72) y el país de destino de la mercancía (BT-80) también son obligatorios con la categoría K. El plazo de pago respeta los 60 días de la ley de morosidad.
God := invoice.MustDecimal inv := &invoice.Invoice{ Profile: invoice.ProfileEN16931, Number: "HP-2026-0412", TypeCode: invoice.TypeCommercialInvoice, IssueDate: invoice.NewDate(2026, time.November, 20), Currency: "EUR", PurchaseOrderReference: "B-2026-118", Seller: secadero, Buyer: charcuteria, DeliveryDate: invoice.NewDate(2026, time.November, 17), ShipTo: &invoice.Party{ Name: "Feinkost Möller & Kaya, tienda de Eppendorf", Address: invoice.Address{ Line1: "Isestraße 41", PostCode: "20144", City: "Hamburg", CountryCode: "DE", }, }, Notes: []invoice.Note{ {SubjectCode: "PMD", Content: "Intereses de demora según la Ley 3/2004 de morosidad."}, }, VATBreakdown: []invoice.VATBreakdown{{ CategoryCode: invoice.VATIntraCommunity, Rate: d("0"), ExemptionReason: "Entrega intracomunitaria exenta, art. 25 Ley 37/1992.", ExemptionReasonCode: invoice.VATEXIntraCommunity, }}, PaymentMeans: []invoice.PaymentMeans{{ TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "ES9121000418450200051332", }}, PaymentTerms: []invoice.PaymentTerms{{ Description: "Transferencia a 30 días de la fecha de entrega.", DueDate: invoice.NewDate(2026, time.December, 17), }}, } -
Detallar los productos
El jamón se vende al peso: la cantidad va en kilos (código UN/ECE KGM), los soportes por piezas (H87) y el transporte como una unidad (C62). Todas las líneas llevan la categoría K y un tipo del 0 %.
Goinv.Lines = []invoice.Line{{ ID: "1", Item: invoice.Item{Name: "Jamón de bellota 100 % ibérico, DOP Guijuelo, 5 piezas"}, Quantity: d("41.6"), UnitCode: "KGM", NetPrice: d("62.00"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "2", Item: invoice.Item{Name: "Paleta de bellota 100 % ibérica, DOP Guijuelo, 6 piezas"}, Quantity: d("27.3"), UnitCode: "KGM", NetPrice: d("38.50"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "3", Item: invoice.Item{Name: "Lomo de bellota ibérico, pieza entera"}, Quantity: d("9.8"), UnitCode: "KGM", NetPrice: d("54.00"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "4", Item: invoice.Item{Name: "Chorizo ibérico de bellota, vela"}, Quantity: d("10"), UnitCode: "KGM", NetPrice: d("21.50"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "5", Item: invoice.Item{Name: "Soporte jamonero de madera de haya"}, Quantity: d("2"), UnitCode: "H87", NetPrice: d("45.00"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "6", Item: invoice.Item{Name: "Transporte a temperatura controlada, Guijuelo-Hamburgo"}, Quantity: d("1"), UnitCode: "C62", NetPrice: d("180.00"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }} -
Crear la factura ZUGFeRD
Calculate calcula los importes de las líneas, los totales y el desglose del IVA, con decimales exactos. Con Auto, la validación añadiría las reglas del país del vendedor, pero para España no hay ninguna. Por eso se piden, además de las reglas por defecto, las de GermanyProfile: la Hacienda alemana solo admite como factura electrónica los perfiles completos, a partir de BASIC. Si la factura no es válida, Create devuelve los errores y no escribe nada.
Goopts := &validate.Options{Rules: validate.Default | validate.GermanyProfile} out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{ Calculate: true, Validate: opts, }) if err != nil { log.Fatal(err) } if err := os.WriteFile("HP-2026-0412.pdf", out, 0o644); err != nil { log.Fatal(err) } -
Releer y comprobar el resultado
El PDF generado se lee como cualquier factura recibida. Check revisa el contenedor PDF, los metadatos XMP y el XML con las mismas reglas. Con las reglas alemanas, el XML debe ir adjunto como Alternative: en Alemania, lo que cuenta legalmente es el XML, no el PDF.
Goback, att, err := zerechnung.Read(out) if err != nil { log.Fatal(err) } fmt.Println(att.Filename, "·", att.Relationship, "·", att.Metadata.ConformanceLevel) for _, vat := range back.VATBreakdown { fmt.Printf("IVA %s %s %% sobre %s € (%s)\n", vat.CategoryCode, vat.Rate, vat.TaxableAmount, vat.ExemptionReasonCode) } due := back.PaymentTerms[0].DueDate fmt.Println("Total:", back.Totals.GrandTotal, "€ · a pagar antes del", due) report, _, err := zerechnung.Check(out, opts) if err != nil { log.Fatal(err) } fmt.Println("Errores:", len(report.Errors()))
Lo que imprime el programa
factur-x.xml · Alternative · EN 16931
IVA K 0 % sobre 4644.45 € (VATEX-EU-IC)
Total: 4644.45 € · a pagar antes del 2026-12-17
Errores: 0El programa completo
package main
import (
"fmt"
"log"
"os"
"time"
"github.com/ritoon/zerechnung"
"github.com/ritoon/zerechnung/invoice"
"github.com/ritoon/zerechnung/validate"
)
func main() {
// Leer el PDF de la factura
pdf, err := os.ReadFile("factura.pdf")
if err != nil {
log.Fatal(err)
}
// Describir al vendedor y al comprador
secadero := invoice.Party{
Name: "Jamones Hermanas Prieto, S.L.",
VATID: "ESB37412855",
Address: invoice.Address{
Line1: "Calle de la Dehesa, 14", PostCode: "37770", City: "Guijuelo",
CountrySubdivision: "Salamanca", CountryCode: "ES",
},
Contact: &invoice.Contact{
PersonName: "Rocío Prieto",
Phone: "+34 923 000 000",
Email: "pedidos@hermanasprieto.example",
},
}
charcuteria := invoice.Party{
Name: "Feinkost Möller & Kaya GmbH",
VATID: "DE318472657",
Address: invoice.Address{
Line1: "Isestraße 41", PostCode: "20144", City: "Hamburg", CountryCode: "DE",
},
}
// Añadir las menciones obligatorias
d := invoice.MustDecimal
inv := &invoice.Invoice{
Profile: invoice.ProfileEN16931,
Number: "HP-2026-0412",
TypeCode: invoice.TypeCommercialInvoice,
IssueDate: invoice.NewDate(2026, time.November, 20),
Currency: "EUR",
PurchaseOrderReference: "B-2026-118",
Seller: secadero,
Buyer: charcuteria,
DeliveryDate: invoice.NewDate(2026, time.November, 17),
ShipTo: &invoice.Party{
Name: "Feinkost Möller & Kaya, tienda de Eppendorf",
Address: invoice.Address{
Line1: "Isestraße 41", PostCode: "20144", City: "Hamburg", CountryCode: "DE",
},
},
Notes: []invoice.Note{
{SubjectCode: "PMD", Content: "Intereses de demora según la Ley 3/2004 de morosidad."},
},
VATBreakdown: []invoice.VATBreakdown{{
CategoryCode: invoice.VATIntraCommunity,
Rate: d("0"),
ExemptionReason: "Entrega intracomunitaria exenta, art. 25 Ley 37/1992.",
ExemptionReasonCode: invoice.VATEXIntraCommunity,
}},
PaymentMeans: []invoice.PaymentMeans{{
TypeCode: invoice.PaymentSEPACreditTransfer,
PayeeIBAN: "ES9121000418450200051332",
}},
PaymentTerms: []invoice.PaymentTerms{{
Description: "Transferencia a 30 días de la fecha de entrega.",
DueDate: invoice.NewDate(2026, time.December, 17),
}},
}
// Detallar los productos
inv.Lines = []invoice.Line{{
ID: "1", Item: invoice.Item{Name: "Jamón de bellota 100 % ibérico, DOP Guijuelo, 5 piezas"},
Quantity: d("41.6"), UnitCode: "KGM", NetPrice: d("62.00"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "2", Item: invoice.Item{Name: "Paleta de bellota 100 % ibérica, DOP Guijuelo, 6 piezas"},
Quantity: d("27.3"), UnitCode: "KGM", NetPrice: d("38.50"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "3", Item: invoice.Item{Name: "Lomo de bellota ibérico, pieza entera"},
Quantity: d("9.8"), UnitCode: "KGM", NetPrice: d("54.00"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "4", Item: invoice.Item{Name: "Chorizo ibérico de bellota, vela"},
Quantity: d("10"), UnitCode: "KGM", NetPrice: d("21.50"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "5", Item: invoice.Item{Name: "Soporte jamonero de madera de haya"},
Quantity: d("2"), UnitCode: "H87", NetPrice: d("45.00"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "6", Item: invoice.Item{Name: "Transporte a temperatura controlada, Guijuelo-Hamburgo"},
Quantity: d("1"), UnitCode: "C62", NetPrice: d("180.00"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}}
// Crear la factura ZUGFeRD
opts := &validate.Options{Rules: validate.Default | validate.GermanyProfile}
out, err := zerechnung.Create(pdf, inv, &zerechnung.CreateOptions{
Calculate: true,
Validate: opts,
})
if err != nil {
log.Fatal(err)
}
if err := os.WriteFile("HP-2026-0412.pdf", out, 0o644); err != nil {
log.Fatal(err)
}
// Releer y comprobar el resultado
back, att, err := zerechnung.Read(out)
if err != nil {
log.Fatal(err)
}
fmt.Println(att.Filename, "·", att.Relationship, "·", att.Metadata.ConformanceLevel)
for _, vat := range back.VATBreakdown {
fmt.Printf("IVA %s %s %% sobre %s € (%s)\n",
vat.CategoryCode, vat.Rate, vat.TaxableAmount, vat.ExemptionReasonCode)
}
due := back.PaymentTerms[0].DueDate
fmt.Println("Total:", back.Totals.GrandTotal, "€ · a pagar antes del", due)
report, _, err := zerechnung.Check(out, opts)
if err != nil {
log.Fatal(err)
}
fmt.Println("Errores:", len(report.Errors()))
}Ejecútalo desde un clon del repositorio:
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/es-1-jamon
go run .Ejemplo 2
Una almazara de Jaén factura el aceite nuevo a Róterdam por Peppol
La almazara cooperativa Cerro del Lobo, en Mancha Real (Jaén), moltura las aceitunas de variedad picual que le traen sus socios. En noviembre sale el primer aceite de la campaña, el de cosecha temprana, y una parte viaja a Róterdam: el mayorista Groothandel Bakker & El Amrani lo reparte entre tiendas y restaurantes de los Países Bajos.
El mayorista recibe sus facturas por la red Peppol, como muchas empresas neerlandesas. La factura se escribe en Peppol BIS Billing 3.0, la especificación de esa red, en sintaxis UBL, y se valida con sus reglas. Como entrega intracomunitaria, va sin IVA español.
-
Identificar a las partes en la red Peppol
En Peppol, cada parte tiene una dirección electrónica (BT-34, BT-49) con su esquema. La almazara usa su NIF-IVA (esquema 9920, el de la Agencia Tributaria); el mayorista, su número de la Cámara de Comercio neerlandesa, el KvK-nummer (esquema 0106). Las reglas Peppol comprueban el formato de estos identificadores según su esquema.
Goalmazara := invoice.Party{ Name: "Almazara Cerro del Lobo, S. Coop. And.", VATID: "ESF23619471", Address: invoice.Address{ Line1: "Camino de la Estación, s/n", PostCode: "23100", City: "Mancha Real", CountrySubdivision: "Jaén", CountryCode: "ES", }, Contact: &invoice.Contact{ PersonName: "Antonio Expósito", Email: "ventas@cerrodellobo.example", }, ElectronicAddress: invoice.Identifier{ID: "ESF23619471", Scheme: invoice.SchemeESVAT}, } mayorista := invoice.Party{ Name: "Groothandel Bakker & El Amrani B.V.", VATID: "NL853164721B01", LegalRegistration: invoice.Identifier{ID: "24381567", Scheme: invoice.SchemeKvK}, Address: invoice.Address{ Line1: "Maashaven Oostzijde 12", PostCode: "3072 HE", City: "Rotterdam", CountryCode: "NL", }, ElectronicAddress: invoice.Identifier{ID: "24381567", Scheme: invoice.SchemeKvK}, } -
Preparar la cabecera Peppol
Peppol pide el proceso de negocio (BT-23) y una referencia del comprador o de su pedido (BT-10 o BT-13), y solo admite una nota en la cabecera. El perfil ProfilePeppol escribe el identificador de la especificación (BT-24). La exención del artículo 25 de la Ley del IVA va en el desglose, con el almacén de destino y la fecha de entrega.
God := invoice.MustDecimal inv := &invoice.Invoice{ Profile: invoice.ProfilePeppol, BusinessProcess: invoice.ProcessPeppolBilling, Number: "CL-2026-0871", TypeCode: invoice.TypeCommercialInvoice, IssueDate: invoice.NewDate(2026, time.November, 19), Currency: "EUR", BuyerReference: "INKOOP-OLIE", PurchaseOrderReference: "PO-77310", Seller: almazara, Buyer: mayorista, DeliveryDate: invoice.NewDate(2026, time.November, 17), ShipTo: &invoice.Party{ Name: "Bakker & El Amrani, almacén de Waalhaven", Address: invoice.Address{ Line1: "Waalhaven Zuidzijde 40", PostCode: "3089 JH", City: "Rotterdam", CountryCode: "NL", }, }, Notes: []invoice.Note{ {Content: "Aceite de la campaña 2026/2027, extraído en frío el día de la recogida."}, }, VATBreakdown: []invoice.VATBreakdown{{ CategoryCode: invoice.VATIntraCommunity, Rate: d("0"), ExemptionReason: "Entrega intracomunitaria exenta, art. 25 Ley 37/1992.", ExemptionReasonCode: invoice.VATEXIntraCommunity, }}, PaymentMeans: []invoice.PaymentMeans{{ TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "ES9121000418450200051332", PayeeAccountName: "Almazara Cerro del Lobo", }}, PaymentTerms: []invoice.PaymentTerms{{ Description: "Transferencia a 30 días.", DueDate: invoice.NewDate(2026, time.December, 19), }}, } -
Listar los aceites
AOVE es el aceite de oliva virgen extra. El de los bag-in-box se factura por litros (código UN/ECE LTR), las botellas y las latas por piezas (H87). Cada línea lleva la categoría K y un tipo del 0 %.
Goinv.Lines = []invoice.Line{{ ID: "1", Item: invoice.Item{Name: "AOVE picual de cosecha temprana, bag-in-box de 5 l"}, Quantity: d("600"), UnitCode: "LTR", NetPrice: d("9.30"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "2", Item: invoice.Item{Name: "AOVE DOP Sierra Mágina, botella de 500 ml"}, Quantity: d("960"), UnitCode: "H87", NetPrice: d("6.20"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "3", Item: invoice.Item{Name: "AOVE picual, lata de 2,5 l"}, Quantity: d("200"), UnitCode: "H87", NetPrice: d("24.90"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }, { ID: "4", Item: invoice.Item{Name: "Transporte en camión, 4 palés, Mancha Real-Róterdam"}, Quantity: d("1"), UnitCode: "C62", NetPrice: d("640.00"), VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"), }} -
Calcular y escribir el UBL
Calculate calcula los importes de las líneas, los totales y el desglose del IVA. ubl.Marshal escribe la factura en UBL 2.1, la sintaxis que circula por Peppol.
Goinv.Calculate() xml, err := ubl.Marshal(inv, &ubl.MarshalOptions{Indent: true}) if err != nil { log.Fatal(err) } if err := os.WriteFile("CL-2026-0871.xml", xml, 0o644); err != nil { log.Fatal(err) } -
Validar con las reglas Peppol
Las reglas Peppol se aplicarían solas, porque la factura se declara Peppol en BT-24; aquí se piden de forma explícita. Se suman al esquema UBL y a las reglas EN 16931. Una factura con errores no debe salir: el programa se detiene y los muestra.
Goreport := validate.XML(xml, &validate.Options{Rules: validate.Default | validate.Peppol}) if !report.Valid() { for _, f := range report.Errors() { fmt.Println(f) } os.Exit(1) } -
Releer la factura
El mayorista leerá el UBL con ubl.Parse, o con su propio programa. Se recupera el mismo modelo de factura, con sus direcciones Peppol y sus totales.
Goback, err := ubl.Parse(xml) if err != nil { log.Fatal(err) } from, to := back.Seller.ElectronicAddress, back.Buyer.ElectronicAddress fmt.Println(report.Profile, "·", from.Scheme+":"+from.ID, "→", to.Scheme+":"+to.ID) fmt.Println("Base:", back.Totals.TaxBasisTotal, "€ · IVA:", back.Totals.TaxTotal, "€ ·", back.VATBreakdown[0].ExemptionReasonCode) fmt.Println("Errores:", len(report.Errors()), "· avisos:", len(report.Warnings()))
Lo que imprime el programa
PEPPOL · 9920:ESF23619471 → 0106:24381567
Base: 17152.00 € · IVA: 0.00 € · VATEX-EU-IC
Errores: 0 · avisos: 0El programa completo
package main
import (
"fmt"
"log"
"os"
"time"
"github.com/ritoon/zerechnung/invoice"
"github.com/ritoon/zerechnung/ubl"
"github.com/ritoon/zerechnung/validate"
)
func main() {
// Identificar a las partes en la red Peppol
almazara := invoice.Party{
Name: "Almazara Cerro del Lobo, S. Coop. And.",
VATID: "ESF23619471",
Address: invoice.Address{
Line1: "Camino de la Estación, s/n", PostCode: "23100", City: "Mancha Real",
CountrySubdivision: "Jaén", CountryCode: "ES",
},
Contact: &invoice.Contact{
PersonName: "Antonio Expósito", Email: "ventas@cerrodellobo.example",
},
ElectronicAddress: invoice.Identifier{ID: "ESF23619471", Scheme: invoice.SchemeESVAT},
}
mayorista := invoice.Party{
Name: "Groothandel Bakker & El Amrani B.V.",
VATID: "NL853164721B01",
LegalRegistration: invoice.Identifier{ID: "24381567", Scheme: invoice.SchemeKvK},
Address: invoice.Address{
Line1: "Maashaven Oostzijde 12", PostCode: "3072 HE", City: "Rotterdam",
CountryCode: "NL",
},
ElectronicAddress: invoice.Identifier{ID: "24381567", Scheme: invoice.SchemeKvK},
}
// Preparar la cabecera Peppol
d := invoice.MustDecimal
inv := &invoice.Invoice{
Profile: invoice.ProfilePeppol,
BusinessProcess: invoice.ProcessPeppolBilling,
Number: "CL-2026-0871",
TypeCode: invoice.TypeCommercialInvoice,
IssueDate: invoice.NewDate(2026, time.November, 19),
Currency: "EUR",
BuyerReference: "INKOOP-OLIE",
PurchaseOrderReference: "PO-77310",
Seller: almazara,
Buyer: mayorista,
DeliveryDate: invoice.NewDate(2026, time.November, 17),
ShipTo: &invoice.Party{
Name: "Bakker & El Amrani, almacén de Waalhaven",
Address: invoice.Address{
Line1: "Waalhaven Zuidzijde 40", PostCode: "3089 JH", City: "Rotterdam",
CountryCode: "NL",
},
},
Notes: []invoice.Note{
{Content: "Aceite de la campaña 2026/2027, extraído en frío el día de la recogida."},
},
VATBreakdown: []invoice.VATBreakdown{{
CategoryCode: invoice.VATIntraCommunity,
Rate: d("0"),
ExemptionReason: "Entrega intracomunitaria exenta, art. 25 Ley 37/1992.",
ExemptionReasonCode: invoice.VATEXIntraCommunity,
}},
PaymentMeans: []invoice.PaymentMeans{{
TypeCode: invoice.PaymentSEPACreditTransfer,
PayeeIBAN: "ES9121000418450200051332",
PayeeAccountName: "Almazara Cerro del Lobo",
}},
PaymentTerms: []invoice.PaymentTerms{{
Description: "Transferencia a 30 días.",
DueDate: invoice.NewDate(2026, time.December, 19),
}},
}
// Listar los aceites
inv.Lines = []invoice.Line{{
ID: "1", Item: invoice.Item{Name: "AOVE picual de cosecha temprana, bag-in-box de 5 l"},
Quantity: d("600"), UnitCode: "LTR", NetPrice: d("9.30"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "2", Item: invoice.Item{Name: "AOVE DOP Sierra Mágina, botella de 500 ml"},
Quantity: d("960"), UnitCode: "H87", NetPrice: d("6.20"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "3", Item: invoice.Item{Name: "AOVE picual, lata de 2,5 l"},
Quantity: d("200"), UnitCode: "H87", NetPrice: d("24.90"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}, {
ID: "4", Item: invoice.Item{Name: "Transporte en camión, 4 palés, Mancha Real-Róterdam"},
Quantity: d("1"), UnitCode: "C62", NetPrice: d("640.00"),
VATCategoryCode: invoice.VATIntraCommunity, VATRate: d("0"),
}}
// Calcular y escribir el UBL
inv.Calculate()
xml, err := ubl.Marshal(inv, &ubl.MarshalOptions{Indent: true})
if err != nil {
log.Fatal(err)
}
if err := os.WriteFile("CL-2026-0871.xml", xml, 0o644); err != nil {
log.Fatal(err)
}
// Validar con las reglas Peppol
report := validate.XML(xml, &validate.Options{Rules: validate.Default | validate.Peppol})
if !report.Valid() {
for _, f := range report.Errors() {
fmt.Println(f)
}
os.Exit(1)
}
// Releer la factura
back, err := ubl.Parse(xml)
if err != nil {
log.Fatal(err)
}
from, to := back.Seller.ElectronicAddress, back.Buyer.ElectronicAddress
fmt.Println(report.Profile, "·", from.Scheme+":"+from.ID, "→", to.Scheme+":"+to.ID)
fmt.Println("Base:", back.Totals.TaxBasisTotal, "€ · IVA:", back.Totals.TaxTotal, "€ ·",
back.VATBreakdown[0].ExemptionReasonCode)
fmt.Println("Errores:", len(report.Errors()), "· avisos:", len(report.Warnings()))
}Ejecútalo desde un clon del repositorio:
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/es-2-almazara
go run .Ejemplo 3
Una guitarrería de Granada factura tres guitarras a una escuela de Madrid
En la Cuesta de Gomérez, la calle que sube a la Alhambra, Guitarras Fajardo Morente construye guitarras a mano desde hace tres generaciones; hoy dirige el taller Inmaculada Fajardo. La escuela de guitarra flamenca La Bulería, en Lavapiés, le ha encargado tres guitarras para sus profesores: dos blancas de ciprés y una negra de palosanto.
Con la Ley Crea y Crece, la factura electrónica será obligatoria entre empresas: desde octubre de 2027 para las que facturan más de 8 millones de euros, un año después para las demás. Valdrá el modelo de la norma europea EN 16931 en cuatro sintaxis, entre ellas UBL, la de la solución gratuita de la Agencia Tributaria. ZeRechnung escribe y valida esa factura; no genera los registros de VERI*FACTU ni envía nada a la AEAT.
-
Describir el taller y la escuela
Las dos partes se identifican por su NIF, con el prefijo ES (BT-31, BT-48). Los datos de inscripción en el Registro Mercantil, que una sociedad debe hacer constar en sus facturas, van en la información legal del vendedor (BT-33). La dirección electrónica (BT-34, BT-49) repite el NIF con el esquema 9920, el de la Agencia Tributaria.
Gotaller := invoice.Party{ Name: "Guitarras Fajardo Morente, S.L.", VATID: "ESB18726042", Description: "Inscrita en el R. M. de Granada, tomo 1532, folio 45, hoja GR-48213.", Address: invoice.Address{ Line1: "Cuesta de Gomérez, 18", PostCode: "18009", City: "Granada", CountryCode: "ES", }, ElectronicAddress: invoice.Identifier{ID: "ESB18726042", Scheme: invoice.SchemeESVAT}, } escuela := invoice.Party{ Name: "Escuela de Guitarra Flamenca La Bulería, S.L.", VATID: "ESB87531299", Address: invoice.Address{ Line1: "Calle del Ave María, 30", PostCode: "28012", City: "Madrid", CountryCode: "ES", }, ElectronicAddress: invoice.Identifier{ID: "ESB87531299", Scheme: invoice.SchemeESVAT}, } -
Añadir las menciones de la factura
La factura lleva su serie y su número, la fecha de expedición y la fecha de la operación, aquí la de entrega (BT-72), y remite al encargo de la escuela (BT-13). El plazo de pago queda dentro de los 60 días de la ley de morosidad, con transferencia a la cuenta del taller.
God := invoice.MustDecimal inv := &invoice.Invoice{ Profile: invoice.ProfileEN16931, Number: "A-2026-0147", TypeCode: invoice.TypeCommercialInvoice, IssueDate: invoice.NewDate(2026, time.November, 20), Currency: "EUR", BuyerReference: "PROFESORADO", PurchaseOrderReference: "ENC-2026-031", Seller: taller, Buyer: escuela, DeliveryDate: invoice.NewDate(2026, time.November, 18), PaymentMeans: []invoice.PaymentMeans{{ TypeCode: invoice.PaymentSEPACreditTransfer, PayeeIBAN: "ES9121000418450200051332", }}, PaymentTerms: []invoice.PaymentTerms{{ Description: "Transferencia a 30 días.", DueDate: invoice.NewDate(2026, time.December, 20), }}, } -
Describir cada guitarra
Una guitarra hecha a mano se define por sus maderas. Los atributos del artículo (BG-32) las recogen como pares de nombre y valor, que el programa del comprador lee sin tener que interpretar el nombre del artículo. Todo lleva el tipo general del IVA, el 21 %.
Goinv.Lines = []invoice.Line{{ ID: "1", Item: invoice.Item{ Name: "Guitarra flamenca blanca, modelo Albaicín", Attributes: []invoice.ItemAttribute{ {Name: "Tapa", Value: "abeto alemán"}, {Name: "Aros y fondo", Value: "ciprés"}, {Name: "Diapasón", Value: "ébano"}, }, }, Quantity: d("2"), UnitCode: "H87", NetPrice: d("3200.00"), VATCategoryCode: invoice.VATStandard, VATRate: d("21"), }, { ID: "2", Item: invoice.Item{ Name: "Guitarra flamenca negra, modelo Sacromonte", Attributes: []invoice.ItemAttribute{ {Name: "Tapa", Value: "cedro rojo"}, {Name: "Aros y fondo", Value: "palosanto de la India"}, {Name: "Diapasón", Value: "ébano"}, }, }, Quantity: d("1"), UnitCode: "H87", NetPrice: d("3900.00"), VATCategoryCode: invoice.VATStandard, VATRate: d("21"), }, { ID: "3", Item: invoice.Item{Name: "Estuche rígido de fibra"}, Quantity: d("3"), UnitCode: "H87", NetPrice: d("180.00"), VATCategoryCode: invoice.VATStandard, VATRate: d("21"), }, { ID: "4", Item: invoice.Item{Name: "Ajuste de altura de cuerdas y cejuela, por profesor"}, Quantity: d("3"), UnitCode: "HUR", NetPrice: d("45.00"), VATCategoryCode: invoice.VATStandard, VATRate: d("21"), }} -
Aplicar el descuento
Por encargar tres guitarras, la escuela tiene un 5 % de descuento sobre su precio. Es un descuento a nivel de documento (BG-20), con su base, su porcentaje, su motivo y su código (95, descuento), y lleva el IVA de lo que descuenta. Calculate deduce el importe.
Goinv.AllowancesCharges = []invoice.AllowanceCharge{{ BaseAmount: d("10300.00"), Percentage: d("5"), Reason: "Descuento por encargo de tres guitarras", ReasonCode: "95", VATCategoryCode: invoice.VATStandard, VATRate: d("21"), }} -
Calcular y escribir el UBL
Calculate calcula los importes de las líneas, el descuento, los totales y el desglose del IVA, con decimales exactos. ubl.Marshal escribe la factura en UBL 2.1.
Goinv.Calculate() xml, err := ubl.Marshal(inv, &ubl.MarshalOptions{Indent: true}) if err != nil { log.Fatal(err) } if err := os.WriteFile("A-2026-0147.xml", xml, 0o644); err != nil { log.Fatal(err) } -
Validar y releer la factura
ZeRechnung no tiene una CIUS española: se aplican el esquema UBL 2.1 y las reglas de la norma EN 16931, las opciones por defecto. Si hay un error, el programa lo muestra y se detiene. La escuela leerá la factura con ubl.Parse, o con su programa de contabilidad.
Goreport := validate.XML(xml, &validate.Options{Rules: validate.Default}) if !report.Valid() { for _, f := range report.Errors() { fmt.Println(f) } os.Exit(1) } back, err := ubl.Parse(xml) if err != nil { log.Fatal(err) } negra, t := back.Lines[1].Item, back.Totals fmt.Println(negra.Name+":", negra.Attributes[1].Name, "de", negra.Attributes[1].Value) fmt.Println("Descuento:", t.AllowanceTotal, "€ · base imponible:", t.TaxBasisTotal, "€") fmt.Println("IVA", back.VATBreakdown[0].Rate, "%:", t.TaxTotal, "€ · total:", t.GrandTotal, "€") fmt.Println("Errores:", len(report.Errors()))
Lo que imprime el programa
Guitarra flamenca negra, modelo Sacromonte: Aros y fondo de palosanto de la India
Descuento: 515.00 € · base imponible: 10460.00 €
IVA 21 %: 2196.60 € · total: 12656.60 €
Errores: 0El programa completo
package main
import (
"fmt"
"log"
"os"
"time"
"github.com/ritoon/zerechnung/invoice"
"github.com/ritoon/zerechnung/ubl"
"github.com/ritoon/zerechnung/validate"
)
func main() {
// Describir el taller y la escuela
taller := invoice.Party{
Name: "Guitarras Fajardo Morente, S.L.",
VATID: "ESB18726042",
Description: "Inscrita en el R. M. de Granada, tomo 1532, folio 45, hoja GR-48213.",
Address: invoice.Address{
Line1: "Cuesta de Gomérez, 18", PostCode: "18009", City: "Granada", CountryCode: "ES",
},
ElectronicAddress: invoice.Identifier{ID: "ESB18726042", Scheme: invoice.SchemeESVAT},
}
escuela := invoice.Party{
Name: "Escuela de Guitarra Flamenca La Bulería, S.L.",
VATID: "ESB87531299",
Address: invoice.Address{
Line1: "Calle del Ave María, 30", PostCode: "28012", City: "Madrid", CountryCode: "ES",
},
ElectronicAddress: invoice.Identifier{ID: "ESB87531299", Scheme: invoice.SchemeESVAT},
}
// Añadir las menciones de la factura
d := invoice.MustDecimal
inv := &invoice.Invoice{
Profile: invoice.ProfileEN16931,
Number: "A-2026-0147",
TypeCode: invoice.TypeCommercialInvoice,
IssueDate: invoice.NewDate(2026, time.November, 20),
Currency: "EUR",
BuyerReference: "PROFESORADO",
PurchaseOrderReference: "ENC-2026-031",
Seller: taller,
Buyer: escuela,
DeliveryDate: invoice.NewDate(2026, time.November, 18),
PaymentMeans: []invoice.PaymentMeans{{
TypeCode: invoice.PaymentSEPACreditTransfer,
PayeeIBAN: "ES9121000418450200051332",
}},
PaymentTerms: []invoice.PaymentTerms{{
Description: "Transferencia a 30 días.",
DueDate: invoice.NewDate(2026, time.December, 20),
}},
}
// Describir cada guitarra
inv.Lines = []invoice.Line{{
ID: "1", Item: invoice.Item{
Name: "Guitarra flamenca blanca, modelo Albaicín",
Attributes: []invoice.ItemAttribute{
{Name: "Tapa", Value: "abeto alemán"},
{Name: "Aros y fondo", Value: "ciprés"},
{Name: "Diapasón", Value: "ébano"},
},
},
Quantity: d("2"), UnitCode: "H87", NetPrice: d("3200.00"),
VATCategoryCode: invoice.VATStandard, VATRate: d("21"),
}, {
ID: "2", Item: invoice.Item{
Name: "Guitarra flamenca negra, modelo Sacromonte",
Attributes: []invoice.ItemAttribute{
{Name: "Tapa", Value: "cedro rojo"},
{Name: "Aros y fondo", Value: "palosanto de la India"},
{Name: "Diapasón", Value: "ébano"},
},
},
Quantity: d("1"), UnitCode: "H87", NetPrice: d("3900.00"),
VATCategoryCode: invoice.VATStandard, VATRate: d("21"),
}, {
ID: "3", Item: invoice.Item{Name: "Estuche rígido de fibra"},
Quantity: d("3"), UnitCode: "H87", NetPrice: d("180.00"),
VATCategoryCode: invoice.VATStandard, VATRate: d("21"),
}, {
ID: "4", Item: invoice.Item{Name: "Ajuste de altura de cuerdas y cejuela, por profesor"},
Quantity: d("3"), UnitCode: "HUR", NetPrice: d("45.00"),
VATCategoryCode: invoice.VATStandard, VATRate: d("21"),
}}
// Aplicar el descuento
inv.AllowancesCharges = []invoice.AllowanceCharge{{
BaseAmount: d("10300.00"), Percentage: d("5"),
Reason: "Descuento por encargo de tres guitarras", ReasonCode: "95",
VATCategoryCode: invoice.VATStandard, VATRate: d("21"),
}}
// Calcular y escribir el UBL
inv.Calculate()
xml, err := ubl.Marshal(inv, &ubl.MarshalOptions{Indent: true})
if err != nil {
log.Fatal(err)
}
if err := os.WriteFile("A-2026-0147.xml", xml, 0o644); err != nil {
log.Fatal(err)
}
// Validar y releer la factura
report := validate.XML(xml, &validate.Options{Rules: validate.Default})
if !report.Valid() {
for _, f := range report.Errors() {
fmt.Println(f)
}
os.Exit(1)
}
back, err := ubl.Parse(xml)
if err != nil {
log.Fatal(err)
}
negra, t := back.Lines[1].Item, back.Totals
fmt.Println(negra.Name+":", negra.Attributes[1].Name, "de", negra.Attributes[1].Value)
fmt.Println("Descuento:", t.AllowanceTotal, "€ · base imponible:", t.TaxBasisTotal, "€")
fmt.Println("IVA", back.VATBreakdown[0].Rate, "%:", t.TaxTotal, "€ · total:", t.GrandTotal, "€")
fmt.Println("Errores:", len(report.Errors()))
}Ejecútalo desde un clon del repositorio:
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/es-3-guitarreria
go run .Más ejemplos, para cada función del paquete: Ejemplos completos en el README · Referencia de la API