Zum Inhalt springen

Installation & Updates

Anforderungen

Komponente Anforderung
Magento / Adobe Commerce 2.4.4 oder neuer
PHP 8.1 oder neuer
PHP-Erweiterung ext-zip (für den ZIP-Download mehrerer Rechnungen)

Die Bibliothek horstoeko/zugferd wird als Composer-Abhängigkeit automatisch mitinstalliert.

Kompatibilität

Die Erweiterung erkennt die folgenden Module automatisch, sofern sie installiert sind. Keines davon ist Voraussetzung für den Betrieb.

Modul Zusammenspiel
Standard-PDF (Magento) XML-Einbettung in das Rechnungs-PDF (ZUGFeRD-Hybrid)
Mageplaza PDF Invoice XML-Einbettung
Fooman PDF Core XML-Einbettung
Xtento PDF Customizer XML-Einbettung, nur bis Version 2.17
Magetrend PDF Templates XML-Einbettung
Aheadworks Gift Card Eingelöste Gutscheine als Vorauszahlung (BT-113)
Amasty Order Attributes Bestellattribute als Quelle für Referenzen (BT-10, BT-11, BT-13)
Electronic Invoicing Attributes (GEISSWEB) Checkout-Felder für Käuferreferenz und Leitweg-ID

Xtento PDF Customizer ab Version 2.18 wird nicht unterstützt. Das Modul bringt dort eigene E-Rechnungs-Funktionen mit, die sich mit der Einbettung dieser Erweiterung überschneiden. Bleiben Sie bei Version 2.17 oder älter, wenn Sie die Einbettung über diese Erweiterung nutzen möchten.

Installation

Die vollständige Installationsanleitung steht unter Meine herunterladbaren Produkte in Ihrem Kundenkonto. Sie ist auf Ihre Lizenz zugeschnitten und enthält die Adresse unseres Composer-Repositorys, den Paketnamen und die passenden Zugangsdaten.

Composer fragt bei der Installation nach Benutzername und Passwort. Verwenden Sie die Zugangsdaten, die bei genau dieser Lizenz stehen — Zugangsdaten aus einer anderen Bestellung geben keinen Zugriff auf dieses Paket. Betreiben Sie mehrere unserer Erweiterungen in einem Shop, fassen Sie Ihre Lizenzen zu einem Composer-Projekt zusammen: Dann gilt ein Zugangsdaten-Paar für alle Pakete.

Installation über den Adobe Commerce Marketplace

Wenn Sie die Erweiterung über den Magento Marketplace (jetzt Adobe Commerce Marketplace) erworben haben, finden Sie die allgemeine Installationsanleitung in der Adobe-Dokumentation.

Updates

Je nach ursprünglicher Installationsart gibt es zwei Update-Wege.

Update per Composer

  1. Versetzen Sie den Shop in den Wartungsmodus: bin/magento maintenance:enable

  2. Führen Sie composer update geissweb/module-electronicinvoicing aus.

  3. Schließen Sie das Update ab:

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

Klassisches Update im app-Verzeichnis

Dies gilt, wenn Sie die Erweiterung durch Kopieren des ZIP-Inhalts in das app-Verzeichnis installiert haben. Sie benötigen SSH-/SFTP-Zugang.

  1. Versetzen Sie den Shop in den Wartungsmodus: bin/magento maintenance:enable

  2. Entfernen Sie den bestehenden Inhalt aus app/code/Geissweb/ElectronicInvoicing/.

  3. Laden Sie die Verzeichnisse aus der ZIP-Datei nach app/code/Geissweb/ElectronicInvoicing/.

  4. Schließen Sie das Update ab:

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