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

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.

Ejemplo 1

Un secadero de Guijuelo vende jamón ibérico a una charcutería de Hamburgo

ZUGFeRDFactur-XEN 16931Entrega intracomunitariaIVA 0 %

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.

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

    Go
    pdf, err := os.ReadFile("factura.pdf")
    if err != nil {
    	log.Fatal(err)
    }
  2. 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.

    Go
    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",
    	},
    }
  3. 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.

    Go
    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),
    	}},
    }
  4. 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 %.

    Go
    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"),
    }}
  5. 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.

    Go
    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)
    }
  6. 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.

    Go
    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()))

Lo que imprime el programa

go run .
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: 0
El programa completo
main.go
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:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/es-1-jamon
go run .

Este ejemplo en GitHub

Ejemplo 2

Una almazara de Jaén factura el aceite nuevo a Róterdam por Peppol

Peppol BIS Billing 3.0UBLEntrega intracomunitariaIVA 0 %

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.

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

    Go
    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},
    }
  2. 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.

    Go
    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),
    	}},
    }
  3. 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 %.

    Go
    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"),
    }}
  4. 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.

    Go
    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)
    }
  5. 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.

    Go
    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)
    }
  6. 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.

    Go
    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()))

Lo que imprime el programa

go run .
PEPPOL · 9920:ESF23619471 → 0106:24381567
Base: 17152.00 € · IVA: 0.00 € · VATEX-EU-IC
Errores: 0 · avisos: 0
El programa completo
main.go
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:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/es-2-almazara
go run .

Este ejemplo en GitHub

Ejemplo 3

Una guitarrería de Granada factura tres guitarras a una escuela de Madrid

UBLEN 16931Factura nacionalIVA 21 %Descuento

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.

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

    Go
    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},
    }
  2. 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.

    Go
    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),
    	}},
    }
  3. 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 %.

    Go
    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"),
    }}
  4. 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.

    Go
    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"),
    }}
  5. 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.

    Go
    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)
    }
  6. 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.

    Go
    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()))

Lo que imprime el programa

go run .
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: 0
El programa completo
main.go
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:

Shell
git clone https://github.com/ritoon/zerechnung
cd zerechnung/site/examples/es-3-guitarreria
go run .

Este ejemplo en GitHub

Más ejemplos, para cada función del paquete: Ejemplos completos en el README · Referencia de la API