Installation & mises à jour

Installation

Vous trouverez un guide d'installation détaillé sous Téléchargements et clés de licence dans votre compte client.

Installation via la Marketplace Magento

Si vous avez obtenu le module via la Marketplace Magento (désormais Adobe Commerce Marketplace), suivez le guide d'installation disponible ici.

Mises à jour

Selon la manière dont vous avez installé le module, il existe deux chemins de mise à jour possibles.

Mise à jour via Composer

Activez le mode maintenance :
```
bin/magento maintenance:enable
```
Exécutez la mise à jour Composer :
```
composer update geissweb-euvat
```
Installez les modifications de base de données nécessaires et compilez le code :
```
bin/magento setup:upgrade
bin/magento setup:di:compile
```
Mettez à jour les contenus statiques (utilisez le cas échéant les langues et thèmes de votre boutique) :
```
bin/magento setup:static-content:deploy
```
(Facultatif) Reconstruisez les index afin d'appliquer les dernières modifications :
```
bin/magento indexer:reindex
```
(Facultatif) Videz le cache :
```
bin/magento cache:flush
```
Désactivez le mode maintenance :
```
bin/magento maintenance:disable
```
Effectuez enfin quelques tests (par exemple une commande de test) pour vous assurer que le module fonctionne correctement.

Mise à jour classique dans le répertoire app

Créer une sauvegarde

Créez une sauvegarde complète (base de données et fichiers de la boutique).
Activer le mode maintenance (facultatif)
```
bin/magento maintenance:enable
```
Supprimer ou sauvegarder l'ancienne version du module
- Rendez-vous dans app/code/Geissweb/Euvat
- Sauvegardez le dossier (par exemple en le renommant) afin de pouvoir effectuer un rollback si nécessaire.
Téléverser les nouveaux fichiers du module

Téléversez le nouveau fichier .zip dans app/code et décompressez-le. La structure doit ensuite contenir app/code/Geissweb/Euvat.
Exécuter la mise à niveau de la base de données
```
bin/magento setup:upgrade
```
Vider le cache
```
bin/magento cache:flush
```
Désactiver le mode maintenance (s'il a été activé)
```
bin/magento maintenance:disable
```

Remarques importantes sur les mises à jour de versions spécifiques

Vous trouverez ici toutes les informations importantes pour la mise à jour d'EU VAT Enhanced pour Magento 2.

Mise à jour vers la version 1.20.0

Cette version prend désormais en compte aussi bien le numéro de TVA de l'adresse de facturation que celui de l'adresse de livraison afin de déterminer si et quel taux de TVA est appliqué. Cela permet de couvrir tous les scénarios de TVA courants, par exemple les opérations triangulaires intracommunautaires. Veuillez tester vos calculs de taxe afin de vous assurer qu'ils correspondent à vos exigences.

Mise à jour vers la version 1.17.0

La version 1.17.0 requiert au minimum Magento 2.3 et PHP 7.1. Ces deux versions étant déjà en fin de vie (EOL, End of Life), nous vous recommandons vivement de migrer vers Magento 2.4.4.

Mise à jour vers la version 1.14.0

Cette version permet la validation des numéros de TVA britanniques (UK) via le service HMRC. Un refactoring a été nécessaire à cet effet afin de mettre en place une validation unifiée pour les différentes interfaces.

Par ailleurs, une grille Adminhtml a été ajoutée ; elle vous permet de revalider ou de supprimer les résultats de validation. De nouvelles autorisations ACL garantissent que seuls les comptes administrateurs autorisés peuvent accéder à l'affichage, à la validation et à la suppression. Les comptes ne disposant pas de droits d'administration complets doivent recevoir ces nouvelles autorisations pour pouvoir utiliser la validation.

Mise à jour vers les versions > 1.7

La version 1.7 a introduit un nouveau champ pour le pays intérieur (domestic country) ainsi que le numéro de TVA de l'exploitant de la boutique. Veuillez vous assurer que ces informations sont correctement configurées, car elles peuvent déterminer si une commande est taxée.

Si aucun pays intérieur n'est défini dans les réglages, les informations sont automatiquement reprises de la configuration d'adresse de la boutique.