Installer PeppolKit dans Magento 2

Voici comment installer le module PeppolKit dans Magento 2 ou Mage-OS et connecter votre boutique. Ensuite, chaque commande payée reçoit une facture et chaque avoir Magento devient une note de crédit PeppolKit.

Commencer gratuitement Comment ça marche

Ce qu'il vous faut

• Magento Open Source 2.4.7, 2.4.8 ou 2.4.9, ou Mage-OS. Testé sur les trois sous PHP 8.3.
• Un accès au serveur (SSH) pour placer le module, et un cron Magento qui fonctionne. Le module met les commandes payées en file d'attente ; le cron les envoie chaque minute.
• Une entreprise établie en Belgique ou aux Pays-Bas, avec votre numéro de TVA et votre numéro d'entreprise ou KvK.

Les boutons sont cités ci-dessous en français ; si votre administration est en anglais, Connecter PeppolKit s'appelle Connect PeppolKit.

Installer

1. Téléchargez le zip sur peppolkit.com/downloads/peppolkit-magento.zip. Le module a été soumis à l'Adobe Commerce Marketplace et n'y figure pas encore.
2. Décompressez-le dans le dossier app/code/Kadeworks/PeppolKit de votre installation Magento. Le fichier registration.php se trouve alors directement dans ce dossier.
3. Activez le module. Exécutez à la racine de Magento :

   bin/magento module:enable Kadeworks_PeppolKit
   bin/magento setup:upgrade
   bin/magento cache:flush

   Si votre boutique tourne en mode production, exécutez aussi :

   bin/magento setup:di:compile
   bin/magento setup:static-content:deploy

Connecter et régler

1. Connectez votre boutique. Dans l'administration Magento, allez dans Sales → PeppolKit. Vérifiez Votre adresse e-mail et cliquez sur Connecter PeppolKit. Le compte est gratuit jusqu'à 20 factures par mois et ne demande aucune donnée de paiement. Vous voyez « PeppolKit est connecté. Complétez ci-dessous les données de votre entreprise. » et le statut Connecté.
2. Complétez les données de l'entreprise sous Données de l’entreprise sur vos factures : nom, rue et numéro, code postal, ville, pays (Belgique ou Pays-Bas), numéro de TVA et numéro d'entreprise ou KvK. L'IBAN, l'adresse de réponse et le préfixe du numéro de facture sont facultatifs.
3. Choisissez vos options : Envoyer la facture par e-mail au client, Envoyer les factures aux clients professionnels via Peppol, l'OSS et le seuil de 10 000 €, ainsi que la Langue de la facture. Cliquez sur Enregistrer.

Si Magento envoie aussi sa propre facture par e-mail, votre client en reçoit deux. Désactivez cet e-mail sous Stores → Configuration → Sales → Sales Emails → Invoice.

Une installation Magento a une seule connexion : toutes les vues de boutique facturent au nom de la même entreprise. PeppolKit reconnaît votre boutique à l'adresse de la vue de boutique par défaut.

Quand une facture ou une note de crédit est-elle créée ?

• Facture : dès qu'une commande est entièrement payée dans Magento : tout ce qui peut être facturé l'est, et chaque facture Magento est payée. Avec un moyen de paiement qui débite tout de suite, c'est juste après la commande ; avec un virement, c'est quand vous créez la facture Magento. La facture PeppolKit suit dans la minute ou les deux minutes.
• Montants : la facture reprend ce que votre client a payé : les articles, les remises, la livraison et la TVA calculée par Magento, au centime près. Cela fonctionne avec des prix catalogue TVA comprise ou hors TVA.
• Note de crédit : dès que vous créez un avoir (credit memo) dans Magento pour une commande qui a une facture PeppolKit. La note de crédit renvoie à la facture d'origine et part chez votre client de la même manière.
• Sur la commande, l'administration affiche le bloc PeppolKit avec la facture et les notes de crédit, les liens PDF et UBL, le statut Peppol et le bouton Renvoyer l’e-mail.

Numéro de TVA des clients professionnels

PeppolKit lit le numéro de TVA dans l'adresse de facturation de la commande, sinon dans le compte client. Activez le champ sous Stores → Configuration → Customers → Customer Configuration → Name and Address Options → Show VAT Number on Storefront. PeppolKit vérifie le numéro via VIES et applique l'autoliquidation sur la facture pour un numéro valide d'un autre pays de l'UE. Le montant payé par votre client vient toutefois de Magento : activez-y aussi le groupe de clients automatique pour les clients professionnels de l'UE (Create New Account Options → Enable Automatic Assignment to Customer Group), avec un groupe sans TVA. Sinon, PeppolKit signale sur la commande que de la TVA a été facturée.

Activer Peppol

Sur la page PeppolKit, la rubrique Peppol indique comment votre boutique envoie, avec un bouton vers le tableau de bord. Boutique belge ? Cliquez sur Connecter Peppol dans le tableau de bord et confirmez une seule fois l'identité de votre entreprise, en 5 minutes environ ; Peppol est alors inclus dans chaque formule. Boutique néerlandaise ? Connectez votre propre compte Peppyrus gratuit.

Commandes antérieures et premier test

Le bouton Créer les factures des commandes payées des 60 derniers jours met en file d'attente les commandes payées sans facture, jusqu'à 250 à la fois. Elles sont traitées comme des nouvelles : si l'envoi par e-mail est activé, les clients reçoivent leur facture.

Testez en créant une facture Magento sur une commande (Invoice → Submit Invoice). En quelques minutes, le bloc PeppolKit de la commande affiche le numéro de facture. Si cela dure plus longtemps, cliquez sur Créer la facture maintenant ; si la facture arrive alors, c'est que le cron de Magento ne tourne pas.

Questions fréquentes

PeppolKit par plateforme : Shopify, WooCommerce, PrestaShop, Magento, Drupal Commerce, OpenCart, Shopware, Joomla, bol.com, Lightspeed, CCV Shop, Wix et Stripe. Voyez comment cela fonctionne pour votre boutique.

Explication à titre d'orientation, pas un conseil fiscal.