PeppolKit installeren in Drupal Commerce
Zo installeer je de PeppolKit-module in Drupal Commerce en koppel je je winkel. Daarna krijgt elke betaalde bestelling een factuur en wordt elke terugbetaling in Commerce een creditnota van PeppolKit.
Wat je nodig hebt
- Drupal 10.3 of 11 met Drupal Commerce 2.40 of 3 (de modules Order en Payment) en PHP 8.1 of nieuwer. Getest met Drupal 11 en Commerce 3.
- Toegang tot de bestanden van je site om de module te plaatsen, en een werkende cron: wat niet meteen verstuurd kan worden, gaat bij de volgende cron-run.
- 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/peppolkit-drupal.zip. De module staat nog niet op drupal.org.
- Pak hem uit in de map modules/custom van je Drupal-installatie. Je krijgt de map modules/custom/peppolkit.
- Zet de module aan onder Extend: zoek op peppolkit, vink PeppolKit aan en klik onderaan op Install. Met drush kan het ook: drush en peppolkit.
De module PeppolKit op de pagina Extend.
Koppelen
- Koppel je winkel. Ga naar Commerce → Configuration → PeppolKit. 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.
Na het koppelen: het dashboard openen, eerdere bestellingen factureren of ontkoppelen.
Wanneer ontstaat een factuur of creditnota?
- Factuur: zodra een bestelling volledig betaald is. De factuur van PeppolKit volgt meteen daarna.
- Bedragen: de factuur toont de bestelling zoals Commerce hem heeft berekend: de regels, kortingen, verzendkosten en de btw. Dat werkt met prijzen inclusief en exclusief btw.
- Creditnota: zodra je een betaling geheel of gedeeltelijk terugbetaalt in Commerce. De creditnota verwijst naar de oorspronkelijke factuur en gaat op dezelfde manier naar je klant.
Btw-nummer van zakelijke klanten
Commerce Tax heeft een btw-nummerveld op het klantprofiel, maar toont het pas in de kassa als je het aanzet: Configuration → People → Profile types → Customer → Manage form display. PeppolKit leest het 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 eerst of de bestelling in Commerce volledig betaald is en of je bedrijfsgegevens in het dashboard zijn opgeslagen. Kon de module PeppolKit even niet bereiken, dan probeert hij het opnieuw bij de volgende cron-run. Meer oorzaken staan in Factuurprobleem oplossen.
Waar bewaart de module de sleutel van de koppeling?
In de state van Drupal, niet in de configuratie. De sleutel komt dus nooit in een configuratie-export of in je repository.
Hoe haal ik de module weer weg?
Klik op de PeppolKit-pagina op Disconnect, of verwijder de module onder Extend → 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.