PeppolKit installeren in Joomla
Zo installeer je de PeppolKit-plugin in Joomla en koppel je je winkel in HikaShop of VirtueMart. Daarna krijgt elke bestelling een factuur zodra hij een betaalde status krijgt, en een creditnota als je hem op Refunded zet.
Wat je nodig hebt
- Joomla 4.2 of nieuwer met HikaShop of VirtueMart, en PHP 8.1 of nieuwer. Getest met Joomla 5.4, HikaShop Starter en VirtueMart 4.8.
- Een beheerder die extensies mag installeren.
- Een bedrijf dat in Nederland of België gevestigd is, met je btw-nummer en je KvK- of ondernemingsnummer.
De schermafbeeldingen komen uit een Engelstalig beheer. Staat je beheer in het Nederlands of Frans, dan zijn de teksten van PeppolKit vertaald.
Installeren
- Download de zip op peppolkit.com/downloads/joomla/plg_system_peppolkit.zip. De plugin staat nog niet in de Joomla Extensions Directory.
- Upload hem in je Joomla-beheer onder System → Install → Extensions, op het tabblad Upload Package File. De plugin zet zichzelf aan.

Sleep de zip in het vak of kies hem met de groene knop. - Open de plugin. Ga naar System → Manage → Plugins en zoek op peppolkit. In een Engelstalig beheer heet hij System - PeppolKit, in een Nederlandstalig beheer Systeem - PeppolKit.

De plugin in de lijst, met de zoekterm peppolkit.
Koppelen
- Koppel je winkel. Controleer je e-mailadres, ga akkoord met de voorwaarden en klik op Connect to PeppolKit. Het account is gratis tot 20 facturen per maand en vraagt geen betaalgegevens.

Koppelen met alleen je e-mailadres. - Vul je bedrijfsgegevens in. Klik op Open the PeppolKit dashboard. Het dashboard opent in een nieuw tabblad en je bent meteen ingelogd. Vul onder Instellingen je bedrijfsnaam, adres, btw-nummer en KvK- of ondernemingsnummer in en sla op. Zolang die gegevens ontbreken, maakt PeppolKit geen facturen.
Instellen
Op dezelfde pagina kies je bij welke bestelstatussen PeppolKit iets doet. Je ziet de statussen van je eigen winkel: die van HikaShop of die van VirtueMart. Sla op met Save.
- Invoice at status: een bestelling krijgt een factuur de eerste keer dat hij een van deze statussen krijgt. Standaard zijn dat Confirmed en Shipped, plus Delivered in HikaShop of Completed in VirtueMart.
- Credit note at status: een gefactureerde bestelling die een van deze statussen krijgt, krijgt een creditnota. Standaard is dat Refunded.


Wanneer ontstaat een factuur of creditnota?
- Factuur: de eerste keer dat een bestelling een van de gekozen statussen krijgt. Bij bankoverschrijving staat een bestelling eerst op Created (HikaShop) of Pending (VirtueMart): de factuur volgt zodra jij of de betaalplugin hem op Confirmed zet.
- Bedragen: een coupon staat als korting op de productregels. Verzendkosten zijn een eigen regel, en een betaaltoeslag in VirtueMart ook.
- Creditnota: een gedeeltelijke terugbetaling met een bedrag kennen HikaShop en VirtueMart niet. Zet je een bestelling op Refunded, dan maakt PeppolKit een creditnota voor de hele bestelling.
Btw-nummer van zakelijke klanten
HikaShop heeft een btw-nummerveld bij het adres, maar dat staat standaard uit. Publiceer het onder HikaShop → Display → Custom fields (VAT number). VirtueMart heeft geen eigen btw-nummerveld: maak onder Configuration → Shopper Fields een veld met de naam vat_number. PeppolKit leest het nummer, controleert het bij VIES en verlegt de btw op de factuur bij een geldig nummer uit een ander EU-land.
Peppol activeren
In het dashboard staat onder Instellingen → Peppol hoe je winkel verstuurt. Belgische webshop? Bevestig daar eenmalig de identiteit van je bedrijf, in ongeveer 5 minuten; Peppol is dan inbegrepen in elk plan. Nederlandse webshop? Koppel je eigen gratis Peppyrus-account, zie Peppyrus-account maken.
Eerdere bestellingen en je eerste test
De knop Invoice the paid orders of the last 60 days maakt facturen voor bestellingen die al betaald waren voordat je koppelde. Een bestelling krijgt nooit twee facturen. Wil je eerst testen? Plaats een proefbestelling, zet hem op betaald en kijk in het dashboard onder Facturen: daar staat de factuur als pdf en als UBL-bestand.
Veelgestelde vragen
Er komt geen factuur. Wat nu?
Kijk of de status van de bestelling een van de statussen is die je bij Invoice at status hebt aangevinkt en of je bedrijfsgegevens in het dashboard zijn opgeslagen. Op de pagina van de plugin staat hoeveel bestellingen nog verstuurd moeten worden, met het laatste antwoord van PeppolKit. Meer oorzaken staan in Factuurprobleem oplossen.
Werkt het met VirtueMart?
Ja, sinds versie 1.1 van de plugin. Heb je een oudere versie, installeer dan de nieuwe zip over de oude heen: je koppeling blijft staan.
Hoe haal ik de plugin weer weg?
Klik op de pagina van de plugin op Disconnect, of verwijder de plugin onder System → Manage → Extensions: daarmee wordt je winkel ook ontkoppeld. Je facturen blijven 30 dagen in je PeppolKit-dashboard staan.
PeppolKit per platform: Shopify, WooCommerce, PrestaShop, Magento, Drupal Commerce, OpenCart, Shopware, Joomla, bol.com, Lightspeed, CCV Shop, Wix en Stripe. Zo werkt het voor jouw webshop.
Laat Peppol aan PeppolKit over.
Installeer PeppolKit en je zakelijke klanten krijgen hun factuur via Peppol, zonder dat jij iets met het netwerk hoeft te regelen.
Kies je platform Begin gratis met 20 facturen per maand.Uitleg ter oriëntatie, geen fiscaal advies.