Installer PeppolKit dans Shopware 6
Voici comment installer l'application PeppolKit dans Shopware 6. Dès que l'application est activée, votre boutique est connectée : chaque commande reçoit une facture quand le paiement passe à Paid.
Commencer gratuitement Comment ça marche
Ce qu'il vous faut
- Shopware 6. Testé avec Shopware 6.7 (6.7.16) sur un serveur propre ; Shopware Cloud n'a pas été testé.
- Une boutique joignable depuis Internet. PeppolKit est une application, pas un plugin : aucun code ne tourne dans votre boutique, et PeppolKit vient lire la commande dans votre boutique.
- Un administrateur autorisé à installer des extensions.
- Une entreprise établie aux Pays-Bas ou en Belgique, avec votre numéro de TVA et votre numéro d'entreprise ou KvK.
Les captures d'écran viennent d'une administration en anglais. Si la vôtre est en français ou en néerlandais, les textes de PeppolKit sont traduits.
Installer
- Téléchargez le zip sur peppolkit.com/downloads/shopware/PeppolKit.zip. L'application n'est pas encore dans le Shopware Store.
- Envoyez-le sous Extensions → My extensions avec le bouton Upload extension.
- Installez et activez. Cliquez sur Install à côté de PeppolKit, puis sur Accept and install : l'application ne demande que des droits de lecture, sur les commandes et les données qui s'y rapportent. Activez ensuite l'interrupteur de PeppolKit.

PeppolKit dans My extensions, installée et activée.
Connecter
- Ouvrez PeppolKit. Cliquez sur les trois points à côté de PeppolKit et choisissez Open extension. Votre boutique est déjà connectée ; il n'y a pas de compte à créer. Le compte est gratuit jusqu'à 20 factures par mois et ne demande aucune donnée de paiement.

La page PeppolKit dans l'administration de Shopware. - Complétez les coordonnées de votre entreprise. Cliquez sur Open the PeppolKit dashboard. Le tableau de bord s'ouvre dans un nouvel onglet et vous êtes connecté d'office. Sous Réglages, saisissez le nom de l'entreprise, l'adresse, le numéro de TVA et le numéro d'entreprise ou KvK, puis enregistrez. Tant que ces données manquent, PeppolKit ne crée pas de factures. Le bouton fonctionne 30 minutes ; rechargez la page pour en obtenir un nouveau.
Quand une facture ou une note de crédit est-elle créée ?
- Facture : dès que le paiement d'une commande passe à Paid, même si vous changez ce statut vous-même dans l'administration. Shopware le transmet par sa file de messages ; la facture suit en général dans la minute.
- Montants : une promotion ou un code de réduction apparaît comme remise sur les lignes de produits, les frais de port forment une ligne à part. Les prix TTC comme HT fonctionnent, donc aussi les groupes de clients en prix nets.
- Note de crédit : si vous passez le paiement à Refunded, PeppolKit crée une note de crédit pour toute la commande. Avec Refunded (partially), Shopware ne garde pas de montant et aucune note de crédit n'est créée.
Numéro de TVA des clients professionnels
Shopware demande leur numéro de TVA aux clients professionnels dès que les clients peuvent choisir entre particulier et entreprise. Activez-le sous Settings → Log-in & sign-up, avec Show selection between company and private customer. PeppolKit lit le numéro, le vérifie via VIES et applique l'autoliquidation sur la facture pour un numéro valide d'un autre pays de l'UE.
Activer Peppol
Dans le tableau de bord, Réglages → Peppol indique comment votre boutique envoie. Boutique belge ? Confirmez-y 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, voir Créer un compte Peppyrus.
Commandes antérieures et premier test
Le bouton Invoice the paid orders of the last 60 days crée les factures des commandes déjà payées avant la connexion. Une commande ne reçoit jamais deux factures. Vous voulez d'abord tester ? Passez une commande d'essai, marquez-la comme payée et regardez dans le tableau de bord sous Factures : la facture s'y trouve en PDF et en fichier UBL.
Questions fréquentes
Aucune facture n'arrive. Que faire ?
Vérifiez que le paiement de la commande est à Paid et que les coordonnées de votre entreprise sont enregistrées dans le tableau de bord. Si la facture n'arrive toujours pas, vérifiez que la file de messages de Shopware tourne (l'admin worker ou bin/console messenger:consume) et que votre boutique est joignable depuis Internet. D'autres causes sont décrites dans Résoudre un problème de facture.
Est-ce que cela fonctionne avec Shopware Cloud ?
Cela n'a pas été testé. PeppolKit est conçu comme une application, la forme que Shopware Cloud utilise aussi, mais n'a été testé que sur un Shopware 6.7 auto-hébergé.
Comment retirer l'application ?
Désinstallez l'application sous Extensions → My extensions (les trois points → Uninstall). Votre boutique est alors déconnectée de PeppolKit. Vos factures restent 30 jours dans votre tableau de bord PeppolKit.
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.
Laissez Peppol à PeppolKit.
Installez PeppolKit et vos clients professionnels reçoivent leur facture via Peppol, sans que vous ayez à gérer quoi que ce soit avec le réseau.
Choisir votre plateforme Commencez gratuitement avec 20 factures par mois.Explication à titre d'orientation, pas un conseil fiscal.