PeppolKit installeren in OpenCart
Zo installeer je de PeppolKit-extensie in OpenCart 4 of 3 en koppel je je winkel. 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
- OpenCart 4 of OpenCart 3. Getest met 4.1.0.4, 4.0.2.3 en 3.0.5.1.
- 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 voor OpenCart 4 of OpenCart 3. Laat de bestandsnaam peppolkit.ocmod.zip zoals hij is: OpenCart weigert een andere naam.
- Upload hem onder Extensions → Installer met de blauwe uploadknop. In OpenCart 4 staat PeppolKit daarna in de lijst: klik daar op de groene knop Install. In OpenCart 3 is de extensie na het uploaden meteen geplaatst.

De Extension Installer van OpenCart 4, met PeppolKit onderaan de lijst. - Installeer de module. Ga naar Extensions → Extensions, kies bovenaan het type Modules en klik bij PeppolKit op de groene knop Install. Klik daarna op het blauwe potlood om de module te openen.

PeppolKit in de lijst met modules: het potlood opent de instellingen.
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
Na het koppelen kies je op dezelfde pagina bij welke statussen PeppolKit iets doet. Sla op met de blauwe knop rechtsboven.
- Invoice at status: een bestelling krijgt een factuur de eerste keer dat hij een van deze statussen krijgt. Standaard zijn dat Processing, Shipped, Complete en Processed.
- Credit note at status: een gefactureerde bestelling die een van deze statussen krijgt, krijgt een creditnota. Standaard zijn dat Refunded, Reversed en Chargeback.

Wanneer ontstaat een factuur of creditnota?
- Factuur: de eerste keer dat een bestelling een van de gekozen statussen krijgt, ook als je de status zelf in het beheer zet. Bij bankoverschrijving of rembours staat een bestelling eerst op Pending: de factuur volgt zodra de status verandert.
- Bedragen: de factuur toont de producten, kortingen, verzendkosten en btw van de bestelling, in de valuta waarin je klant bestelde.
- Creditnota: OpenCart kent geen gedeeltelijke terugbetaling. Zet je een bestelling op een status als Refunded, dan maakt PeppolKit een creditnota voor het hele bedrag.
Btw-nummer van zakelijke klanten
OpenCart heeft geen eigen veld voor het btw-nummer. Maak er een onder Customers → Custom Fields: type Text, locatie Address, met Btw-nummer in de naam (VAT of TVA mag ook). PeppolKit leest dat veld, controleert het nummer 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, of de schakelaar Status van de module aan staat en of je bedrijfsgegevens in het dashboard zijn opgeslagen. Meer oorzaken staan in Factuurprobleem oplossen.
Hoe werk ik de extensie bij in OpenCart 4?
OpenCart 4 weigert een zip van een extensie die er al staat. Ga naar Extensions → Installer, klik bij PeppolKit eerst op Uninstall en dan op Delete, upload de nieuwe zip en installeer hem. Je instellingen en de koppeling blijven staan.
Hoe haal ik de extensie weer weg?
Klik in de module op Disconnect, of klik onder Extensions → Extensions → Modules bij PeppolKit op Uninstall: 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.