PeppolKit installeren in Shopware 6
Zo installeer je de PeppolKit-app in Shopware 6. Zodra de app aan staat, is je winkel gekoppeld: elke bestelling krijgt een factuur wanneer de betaling op Paid komt te staan.
Wat je nodig hebt
- Shopware 6. Getest met Shopware 6.7 (6.7.16) op een eigen server; Shopware Cloud is niet getest.
- Een winkel die vanaf internet bereikbaar is. PeppolKit is een app, geen plugin: in je winkel draait geen code, en PeppolKit haalt de bestelling zelf op bij je winkel.
- 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/shopware/PeppolKit.zip. De app staat nog niet in de Shopware Store.
- Upload hem onder Extensions → My extensions met de knop Upload extension.
- Installeer en zet aan. Klik bij PeppolKit op Install en daarna op Accept and install: de app vraagt alleen leesrechten, op bestellingen en de gegevens die daarbij horen. Zet daarna de schakelaar voor PeppolKit aan.

PeppolKit in My extensions, geïnstalleerd en aangezet.
Koppelen
- Open PeppolKit. Klik bij PeppolKit op de drie puntjes en kies Open extension. Je winkel is al gekoppeld; een apart account maken hoeft niet. Het account is gratis tot 20 facturen per maand en vraagt geen betaalgegevens.

De PeppolKit-pagina in het Shopware-beheer. - 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. De knop werkt 30 minuten; laad de pagina opnieuw voor een nieuwe.
Wanneer ontstaat een factuur of creditnota?
- Factuur: zodra de betaling van een bestelling de status Paid krijgt, ook als je die status zelf in het beheer zet. Shopware geeft dat door via zijn berichtenwachtrij; de factuur volgt meestal binnen een minuut.
- Bedragen: een actie of kortingscode staat als korting op de productregels, verzendkosten zijn een eigen regel. Prijzen met en zonder btw werken allebei, dus ook klantgroepen met nettoprijzen.
- Creditnota: zet je de betaling op Refunded, dan maakt PeppolKit een creditnota voor de hele bestelling. Bij Refunded (partially) bewaart Shopware geen bedrag en komt er geen creditnota.
Btw-nummer van zakelijke klanten
Shopware vraagt zakelijke klanten om hun btw-nummer zodra klanten kunnen kiezen tussen particulier en bedrijf. Dat zet je aan onder Settings → Log-in & sign-up, met Show selection between company and private customer. 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 betaling van de bestelling op Paid staat en of je bedrijfsgegevens in het dashboard zijn opgeslagen. Komt de factuur dan nog niet, controleer of de berichtenwachtrij van Shopware draait (de admin-worker of bin/console messenger:consume) en of je winkel vanaf internet bereikbaar is. Meer oorzaken staan in Factuurprobleem oplossen.
Werkt het met Shopware Cloud?
Dat is niet getest. PeppolKit is gebouwd als app, de vorm die ook Shopware Cloud gebruikt, maar is alleen getest op een zelf gehoste Shopware 6.7.
Hoe haal ik de app weer weg?
Verwijder de app onder Extensions → My extensions (de drie puntjes → Uninstall). Daarmee is je winkel losgekoppeld van PeppolKit. 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.