Installation & Updates

Installation

Eine detaillierte Installationsanleitung finden Sie unter Downloads und Lizenzschlüssel in Ihrem Kundenkonto.

Magento Marketplace Installation

Wenn Sie das Modul über den Magento Marketplace (jetzt Adobe Commerce Marketplace) bezogen haben, folgen Sie der Installationsanleitung hier.

Updates

Abhängig davon, wie Sie das Modul installiert haben gibt es zwei mögliche Update-Pfade.

Composer Update

Aktivieren Sie den Wartungsmodus:
```
bin/magento maintenance:enable
```
Führen Sie das Composer-Update aus:
```
composer update geissweb-euvat
```
Installieren Sie notwendige Datenbank-Änderungen und kompillieren Sie den Code:
```
bin/magento setup:upgrade
bin/magento setup:di:compile
```
Aktualisieren Sie die statischen Inhalte (nutzen Sie ggf. Ihre Shop-Sprachen und -Themes):
```
bin/magento setup:static-content:deploy
```
(Optional) Indizes neu erstellen, um die neuesten Änderungen zu übernehmen:
```
bin/magento indexer:reindex
```
(Optional) Cache leeren:
```
bin/magento cache:flush
```
Deaktivieren Sie den Wartungsmodus:
```
bin/magento maintenance:disable
```
Führen Sie abschließend einige Tests durch (z. B. Testbestellung), um sicherzustellen, dass das Modul ordnungsgemäß funktioniert.

Klassisches Update im app Verzeichnis

Backup erstellen
Erstelle ein komplettes Backup (Datenbank und Shop-Dateien).
Wartungsmodus aktivieren (optional)
```
bin/magento maintenance:enable
```
Alte Modulversion entfernen oder sichern
- Gehe zu app/code/Geissweb/Euvat
- Sichere den Ordner (z.B. durch Umbenennen), damit du bei Bedarf ein Rollback durchführen kannst.
Neue Moduldateien hochladen
Lade die neue .zip-Datei in app/code hoch und entpacke sie. Die Struktur soll anschließend app/code/Geissweb/Euvat enthalten.
Datenbank-Upgrade ausführen
```
bin/magento setup:upgrade
```
Cache leeren
```
bin/magento cache:flush
```
Wartungsmodus deaktivieren (falls aktiviert)
```
bin/magento maintenance:disable
```

Wichtige Update-Hinweise zu spezifischen Versionen

Hier finden Sie alle wichtigen Informationen für das Update von EU VAT Enhanced für Magento 2.

Update auf Version 1.20.0

Diese Version berücksichtigt jetzt sowohl die USt-IdNr. der Rechnungsadresse als auch der Versandadresse, um zu steuern, ob und welcher Steuersatz angewendet wird. Dadurch lassen sich alle gängigen Umsatzsteuerzenarien abdecken, beispielsweise innergemeinschaftliche Dreiecksgeschäfte. Testen Sie bitte Ihre Steuerberechnungen, um sicherzustellen, dass sie Ihren Anforderungen entsprechen.

Update auf Version 1.17.0

Version 1.17.0 erfordert mindestens Magento 2.3 und PHP 7.1. Da beide Versionen bereits EOL (End of Life) sind, empfehlen wir dringend ein Update auf Magento 2.4.4.

Update auf Version 1.14.0

Diese Version ermöglicht die Validierung britischer USt-IdNrn. (UK) über den HMRC-Dienst. Hierfür war ein Refactoring notwendig, um eine einheitliche Validierung für unterschiedliche Schnittstellen zu schaffen.

Außerdem wurde ein Adminhtml-Grid hinzugefügt, über das Sie Validierungsergebnisse erneut validieren oder löschen können. Neue ACL-Berechtigungen sorgen dafür, dass nur autorisierte Admin-Konten Zugriff auf das Anzeigen, Validieren und Löschen haben. Konten ohne volle Adminrechte müssen diese neuen Berechtigungen erhalten, um die Validierung nutzen zu können.

Update auf Versionen > 1.7

Version 1.7 führte ein neues Feld für das Inland (domestic country) sowie die USt-IdNr. des Shopbetreibers ein. Stellen Sie bitte sicher, dass diese Angaben korrekt konfiguriert sind, da sie bestimmen können, ob eine Bestellung besteuert wird.

Sofern kein Inland in den Einstellungen festgelegt ist, werden die Informationen automatisch aus der Shop-Adresskonfiguration übernommen.