ZUGFeRD E-Rechnung für Magento 2

Changelog

[1.3.7] - 2026-08-03

Added

• SEPA direct debit for XRechnung (BG-19) via the new DirectDebitDataProviderInterface extension point.

Fixed

• Tax representative data (BT-62 to BT-70) was silently dropped for the XRechnung 2.2 and 2.3 profiles.

[1.3.6] - 2026-08-03

Added

• Amasty_Orderattr integration: custom Amasty order attributes are now selectable as source for Buyer Reference (BT-10), Project Reference (BT-11) and Purchase Order Reference (BT-13).

Changed

• Buyer Information configuration restructured for clarity: values read from the customer account are now grouped under "Buyer Identification", values read from the order under "Order & Document References".
• Include Invoice Comments (BT-22) moved to the Invoice Settings group.
• Seller field label unified with its buyer counterpart: "Legal Registration ICD Code" is now "Legal Registration Scheme (ICD)".
• Buyer Legal Registration Scheme (BT-47-1) is now always visible instead of only appearing after a registration attribute was selected.
• Seller Order Reference (BT-14) is now always the order number (increment_id); the configuration field has been removed, as BT-14 is by definition the seller's own sales order reference.
• Minimum horstoeko/zugferd version raised to 1.0.101, which is the first release containing all code list classes used by this module.
• Updated German translations

Fixed

• Buyer legal registration (BT-47) was written with the Leitweg-ID scheme (0204) when no registration scheme was configured. The identifier is now written without a scheme qualifier in that case.

[1.3.5] - 2026-07-06

Added

• Fooman_PdfCustomiser integration
• Xtento_PdfCustomizer integration (version 2.17 and below)

[1.3.4] - 2026-06-10

Fixed

• Issue with giftcards not getting the correct tax code in XML

[1.3.3] - 2026-06-01

Added

• Mageplaza_PdfInvoice integration: embed the electronic invoice XML into Mageplaza-generated invoice PDFs for both the e-mail attachment and print/download paths

[1.3.2] - 2026-04-14

Fixed

• Buyer reference field (Attributes module) not taken into account when generating the invoice XML

[1.3.1] - 2026-03-17

Added

Introduce display options for configurable products in the e-invoice to provide more information about the product variant - Append selected options: Appends variant options to the name, e.g. "Product (Color: Red, Size: M)" - Use selected options as item description: Writes variant options into BT-154 (Item description) - Use child product name: Uses the simple product name instead of the configurable parent name

Changed

• Reenable Xrechnung 2.2 und 2.3 profiles for generation to support older versions

[1.3.0] - 2026-01-28

Added

• XRechnung 3.0 Support
• Buyer Reference (BT-10) configurable attribute select
• BR-DE-15 compliance: buyer reference falls back to order increment_id when no attribute is configured
• Seller Order Reference (BT-14), and Project Reference (BT-11) attribute configuration options
• Buyer Registration attribute and scheme (BT-47) with ISO 6523 ICD code selector
• Invoice comments inclusion in XML (BT-22)
• Configurable XML storage path via system configuration
• Console command geissweb:einvoice:verify-amounts for round-trip validation against database
• Multipurpose voucher detection and VAT categorization for gift card items
• Magetrend PDF integration
• Dedicated seller fields for Leitweg-ID, GLN, and DUNS numbers (BT-29)
• XRechnung Tax Representative validation improvements
• Aheadworks_Giftcard integration for handling gift cards as prepaid amounts (BT-113)

[1.2.0] - 2025-10-20

With this version we have full support for the EN 16931 COMFORT (and lower) profile. X-Rechnung and PEPPOL support is on the roadmap.

Added

• Possibility to select any customer attribute to use as customer number (BT-46)
• Possibility to add tax representative data for B2B transactions with tax representatives
• Possibility to add Trading names, GLN, DUNS, Leitweg-ID (seller), legal registration numbers and electronic addresses
• Simple tax case detection and automatic VAT categorization
• Due days configuration to handle invoices which are paid (online) or due (for offline methods)

Fixed

• Email attachments for Magento 2.4.8
• Discount handling reliability
• Amounts not matching Magento values

[1.1.1] - 2025-07-24

Fixed

• Tests now also work with PHPUnit 10
• Smaller bugfixes like deprecation notice with PHP8.4
• Removed unneeded logging
• Add missing Magento dependencies to composer.json

[1.1.0] - 2025-07-21

Added

• Intelligent VAT category mapping system (VatCategoryMapper) for automatic tax categorization
• Payment terms and means configuration for each payment method
• Enhanced ZUGFeRD/XRechnung xml format compliance
• Console command geissweb:einvoice:generate-xml for batch XML generation of invoices and credit memos
• Console command geissweb:einvoice:validate-xml for XSD validation of generated XML files

[1.0.0] - 2023-11-01

Added

• Initial release of the Geissweb_ElectronicInvoicing module
• Support for generating electronic invoice XML files compliant with ZUGFeRD, XRechnung, and Factur-X standards
• Support for attaching XML files to invoice emails
• Support for embedding XML files in PDF invoices
• Support for downloading XML files from the admin panel and frontend
• Basic configuration system for electronic invoicing settings
• Integration with horstoeko/zugferd package for XML generation and validation