Installer PeppolKit dans Joomla
Voici comment installer le plugin PeppolKit dans Joomla et connecter votre boutique HikaShop ou VirtueMart. Ensuite, chaque commande reçoit une facture dès qu'elle atteint un statut payé, et une note de crédit si vous la passez à Refunded.
Commencer gratuitement Comment ça marche
Ce qu'il vous faut
- Joomla 4.2 ou plus récent avec HikaShop ou VirtueMart, et PHP 8.1 ou plus récent. Testé avec Joomla 5.4, HikaShop Starter et VirtueMart 4.8.
- 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/joomla/plg_system_peppolkit.zip. Le plugin n'est pas encore dans le Joomla Extensions Directory.
- Envoyez-le dans l'administration de Joomla sous System → Install → Extensions, dans l'onglet Upload Package File. Le plugin s'active de lui-même.
Glissez le zip dans le cadre ou choisissez-le avec le bouton vert. - Ouvrez le plugin. Allez dans System → Manage → Plugins et cherchez peppolkit. Dans une administration en anglais, il s'appelle System - PeppolKit, en français Système - PeppolKit.
Le plugin dans la liste, avec la recherche peppolkit.
Connecter
- Connectez votre boutique. Vérifiez votre adresse e-mail, acceptez les conditions et cliquez sur Connect to PeppolKit. Le compte est gratuit jusqu'à 20 factures par mois et ne demande aucune donnée de paiement.
La connexion ne demande que votre adresse e-mail. - 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.
Régler
Sur la même page, vous choisissez à quels statuts de commande PeppolKit agit. Vous voyez les statuts de votre boutique : ceux de HikaShop ou ceux de VirtueMart. Enregistrez avec Save.
- Invoice at status : une commande reçoit sa facture la première fois qu'elle atteint l'un de ces statuts. Par défaut : Confirmed et Shipped, plus Delivered dans HikaShop ou Completed dans VirtueMart.
- Credit note at status : une commande facturée qui atteint l'un de ces statuts reçoit une note de crédit. Par défaut : Refunded.
Quand une facture ou une note de crédit est-elle créée ?
- Facture : la première fois qu'une commande atteint l'un des statuts choisis. Avec un virement, la commande est d'abord en Created (HikaShop) ou Pending (VirtueMart) : la facture suit dès que vous ou le plugin de paiement la passez à Confirmed.
- Montants : un coupon apparaît comme remise sur les lignes de produits. Les frais de port forment une ligne à part, tout comme des frais de paiement dans VirtueMart.
- Note de crédit : HikaShop et VirtueMart ne connaissent pas le remboursement partiel avec un montant. Si vous passez une commande à Refunded, PeppolKit crée une note de crédit pour toute la commande.
Numéro de TVA des clients professionnels
HikaShop a un champ de numéro de TVA dans l'adresse, mais il est désactivé par défaut. Publiez-le sous HikaShop → Display → Custom fields (VAT number). VirtueMart n'a pas de champ de numéro de TVA : créez sous Configuration → Shopper Fields un champ nommé vat_number. 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 statut de la commande est l'un de ceux cochés sous Invoice at status et que les coordonnées de votre entreprise sont enregistrées dans le tableau de bord. La page du plugin indique combien de commandes attendent encore d'être envoyées, avec la dernière réponse de PeppolKit. D'autres causes sont décrites dans Résoudre un problème de facture.
Est-ce que cela fonctionne avec VirtueMart ?
Oui, depuis la version 1.1 du plugin. Si vous avez une version plus ancienne, installez le nouveau zip par-dessus l'ancien : votre connexion reste en place.
Comment retirer le plugin ?
Cliquez sur Disconnect sur la page du plugin, ou désinstallez le plugin sous System → Manage → Extensions : votre boutique est alors aussi déconnectée. 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.