Installation & Updates

Installation

You can find a detailed installation guide under Downloads and license keys in your customer account.

Magento Marketplace Installation

If you obtained the module via the Magento Marketplace (now the Adobe Commerce Marketplace), follow the installation guide here.

Updates

Depending on how you installed the module, there are two possible update paths.

Composer Update

Enable maintenance mode:
```
bin/magento maintenance:enable
```
Run the Composer update:
```
composer update geissweb-euvat
```
Install the required database changes and compile the code:
```
bin/magento setup:upgrade
bin/magento setup:di:compile
```
Update the static content (use your shop languages and themes if applicable):
```
bin/magento setup:static-content:deploy
```
(Optional) Reindex to apply the latest changes:
```
bin/magento indexer:reindex
```
(Optional) Flush the cache:
```
bin/magento cache:flush
```
Disable maintenance mode:
```
bin/magento maintenance:disable
```
Finally, run a few tests (e.g. a test order) to make sure the module works correctly.

Classic update in the app directory

Create a backup

Create a complete backup (database and shop files).
Enable maintenance mode (optional)
```
bin/magento maintenance:enable
```
Remove or back up the old module version
- Go to app/code/Geissweb/Euvat
- Back up the folder (e.g. by renaming it) so that you can roll back if needed.
Upload the new module files

Upload the new .zip file to app/code and unpack it. The structure should then contain app/code/Geissweb/Euvat.
Run the database upgrade
```
bin/magento setup:upgrade
```
Flush the cache
```
bin/magento cache:flush
```
Disable maintenance mode (if enabled)
```
bin/magento maintenance:disable
```

Important update notes for specific versions

Here you will find all the important information for updating EU VAT Enhanced for Magento 2.

Update to version 1.20.0

This version now takes into account both the VAT ID of the billing address and that of the shipping address to determine whether and which tax rate is applied. This makes it possible to cover all common VAT scenarios, for example intra-Community triangular transactions. Please test your tax calculations to make sure they meet your requirements.

Update to version 1.17.0

Version 1.17.0 requires at least Magento 2.3 and PHP 7.1. Since both versions are already EOL (End of Life), we strongly recommend updating to Magento 2.4.4.

Update to version 1.14.0

This version enables the validation of British (UK) VAT IDs via the HMRC service. This required a refactoring in order to create a uniform validation across the different interfaces.

In addition, an adminhtml grid was added that lets you revalidate or delete validation results. New ACL permissions ensure that only authorized admin accounts have access to viewing, validating and deleting. Accounts without full admin rights must be granted these new permissions in order to use the validation.

Update to versions > 1.7

Version 1.7 introduced a new field for the domestic country as well as the shop operator's VAT ID. Please make sure that these details are configured correctly, as they can determine whether an order is taxed.

If no domestic country is set in the settings, the information is taken automatically from the shop's address configuration.