Aller au contenu

Installation et mises à jour

Prérequis

Composant Prérequis
Magento / Adobe Commerce 2.4.4 ou plus récent
PHP 8.1 ou plus récent
Extension PHP ext-zip (pour le téléchargement ZIP de plusieurs factures)

La bibliothèque horstoeko/zugferd est automatiquement installée en tant que dépendance Composer.

Compatibilité

L'extension détecte automatiquement les modules suivants s'ils sont installés. Aucun d'entre eux n'est requis pour le fonctionnement.

Module Interaction
PDF standard (Magento) Intégration du XML dans le PDF de facture (hybride ZUGFeRD)
Mageplaza PDF Invoice Intégration du XML
Fooman PDF Core Intégration du XML
Xtento PDF Customizer Intégration du XML, uniquement jusqu'à la version 2.17
Magetrend PDF Templates Intégration du XML
Aheadworks Gift Card Bons utilisés comme acompte (BT-113)
Amasty Order Attributes Attributs de commande comme source de références (BT-10, BT-11, BT-13)
Electronic Invoicing Attributes (GEISSWEB) Champs de commande pour la référence acheteur et la Leitweg-ID

Xtento PDF Customizer à partir de la version 2.18 n'est pas pris en charge. À partir de cette version, le module intègre ses propres fonctions de facturation électronique, qui se chevauchent avec l'intégration réalisée par cette extension. Restez en version 2.17 ou antérieure si vous souhaitez utiliser l'intégration fournie ici.

Installation

Le guide d'installation complet se trouve sous Mes produits téléchargeables dans votre compte client. Il est adapté à votre licence et contient l'adresse de notre dépôt Composer, le nom du paquet et les identifiants correspondants.

Lors de l'installation, Composer demande un nom d'utilisateur et un mot de passe. Utilisez les identifiants indiqués pour cette licence précise — les identifiants d'une autre commande ne donnent pas accès à ce paquet. Si vous utilisez plusieurs de nos extensions dans une même boutique, regroupez vos licences dans un projet Composer : un seul jeu d'identifiants couvre alors tous les paquets.

Installation via l'Adobe Commerce Marketplace

Si vous avez acquis l'extension via le Magento Marketplace (désormais Adobe Commerce Marketplace), vous trouverez le guide d'installation général dans la documentation Adobe.

Mises à jour

Selon le mode d'installation initial, il existe deux voies de mise à jour.

Mise à jour via Composer

  1. Mettez la boutique en mode maintenance : bin/magento maintenance:enable

  2. Exécutez composer update geissweb/module-electronicinvoicing.

  3. Finalisez la mise à jour :

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

Mise à jour classique dans le répertoire app

Ceci s'applique si vous avez installé l'extension en copiant le contenu du ZIP dans le répertoire app. Vous avez besoin d'un accès SSH/SFTP.

  1. Mettez la boutique en mode maintenance : bin/magento maintenance:enable

  2. Supprimez le contenu existant de app/code/Geissweb/ElectronicInvoicing/.

  3. Chargez les répertoires du fichier ZIP dans app/code/Geissweb/ElectronicInvoicing/.

  4. Finalisez la mise à jour :

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