Skip to content

Installation & Updates

Requirements

Component Requirement
Magento / Adobe Commerce 2.4.4 or newer
PHP 8.1 or newer
PHP extension ext-zip (for the ZIP download of multiple invoices)

The horstoeko/zugferd library is installed automatically as a Composer dependency.

Compatibility

The extension detects the following modules automatically if they are installed. None of them is required for operation.

Module Interaction
Standard PDF (Magento) XML embedding into the invoice PDF (ZUGFeRD hybrid)
Mageplaza PDF Invoice XML embedding
Fooman PDF Core XML embedding
Xtento PDF Customizer XML embedding, up to version 2.17 only
Magetrend PDF Templates XML embedding
Aheadworks Gift Card Redeemed gift cards as a prepaid amount (BT-113)
Amasty Order Attributes Order attributes as a source for references (BT-10, BT-11, BT-13)
Electronic Invoicing Attributes (GEISSWEB) Checkout fields for buyer reference and Leitweg-ID

Xtento PDF Customizer from version 2.18 onwards is not supported. From that version the module ships its own e-invoicing features, which overlap with the embedding performed by this extension. Stay on version 2.17 or older if you want to use the embedding provided here.

Installation

The complete installation guide is available under My Downloadable Products in your customer account. It is tailored to your licence and contains the address of our Composer repository, the package name and the matching credentials.

During installation Composer asks for a username and password. Use the credentials shown with this very licence — credentials from another order do not give access to this package. If you run several of our extensions in one shop, combine your licences into a Composer project: one set of credentials then covers all packages.

Installation via the Adobe Commerce Marketplace

If you purchased the extension through the Magento Marketplace (now Adobe Commerce Marketplace), you will find the general installation guide in the Adobe documentation.

Updates

Depending on the original installation method, there are two update paths.

Update via Composer

  1. Put the shop into maintenance mode: bin/magento maintenance:enable

  2. Run composer update geissweb/module-electronicinvoicing.

  3. Complete the update:

    bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento maintenance:disable

Classic update in the app directory

This applies if you installed the extension by copying the ZIP contents into the app directory. You need SSH/SFTP access.

  1. Put the shop into maintenance mode: bin/magento maintenance:enable

  2. Remove the existing contents from app/code/Geissweb/ElectronicInvoicing/.

  3. Upload the directories from the ZIP file to app/code/Geissweb/ElectronicInvoicing/.

  4. Complete the update:

    bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento maintenance:disable