PeppolKit installeren in Magento 2

Zo installeer je de PeppolKit-module in Magento 2 of Mage-OS en koppel je je winkel. Daarna krijgt elke betaalde bestelling een factuur en wordt elke credit memo in Magento een creditnota van PeppolKit.

Begin gratis Zo werkt het

Wat je nodig hebt

• Magento Open Source 2.4.7, 2.4.8 of 2.4.9, of Mage-OS. Op alle drie getest met PHP 8.3.
• Toegang tot de server (SSH) om de module te plaatsen, en een werkende Magento-cron. De module zet betaalde bestellingen in een wachtrij; cron verstuurt ze elke minuut.
• Een bedrijf dat in Nederland of België gevestigd is, met je btw-nummer en je KvK- of ondernemingsnummer.

Hieronder staan de knoppen met hun Nederlandse naam; staat je beheer in het Engels, dan is PeppolKit koppelen gewoon Connect PeppolKit.

Installeren

1. Download de zip op peppolkit.com/downloads/peppolkit-magento.zip. De module is ingediend bij de Adobe Commerce Marketplace en staat daar nog niet.
2. Pak hem uit in de map app/code/Kadeworks/PeppolKit van je Magento-installatie. Het bestand registration.php staat dan direct in die map.
3. Zet de module aan. Voer in de hoofdmap van Magento uit:

   bin/magento module:enable Kadeworks_PeppolKit
   bin/magento setup:upgrade
   bin/magento cache:flush

   Draait je winkel in productiemodus, voer dan ook uit:

   bin/magento setup:di:compile
   bin/magento setup:static-content:deploy

Koppelen en instellen

1. Koppel je winkel. Ga in het Magento-beheer naar Sales → PeppolKit. Controleer Je e-mailadres en klik op PeppolKit koppelen. Het account is gratis tot 20 facturen per maand en vraagt geen betaalgegevens. Je ziet "PeppolKit is gekoppeld. Vul hieronder je bedrijfsgegevens in." en de status Gekoppeld.
2. Vul de bedrijfsgegevens in onder Bedrijfsgegevens op je facturen: bedrijfsnaam, straat en huisnummer, postcode, plaats, land (Nederland of België), btw-nummer en KvK- of ondernemingsnummer. IBAN, antwoordadres en voorvoegsel van het factuurnummer zijn optioneel.
3. Kies je opties: Factuur naar de klant mailen, Facturen aan zakelijke klanten via Peppol versturen, OSS en de drempel van € 10.000, plus de Factuurtaal. Klik op Opslaan. Je ziet "Opgeslagen. Betaalde bestellingen krijgen nu automatisch een factuur."

Mailt Magento je klant ook zijn eigen factuur, dan krijgt hij er twee. Zet die mail uit onder Stores → Configuration → Sales → Sales Emails → Invoice.

Eén Magento-installatie heeft één koppeling: alle winkelweergaven factureren vanuit hetzelfde bedrijf. PeppolKit kent je winkel aan het adres van de standaardwinkelweergave.

Wanneer ontstaat een factuur of creditnota?

• Factuur: zodra een bestelling in Magento volledig betaald is: alles wat gefactureerd kan worden is gefactureerd, en elke Magento-factuur staat op betaald. Bij een betaalmethode die direct afschrijft is dat meteen na de bestelling; bij overschrijving is dat wanneer je de Magento-factuur maakt. De PeppolKit-factuur volgt binnen een minuut of twee.
• Bedragen: de factuur toont wat je klant betaalde: de artikelen, kortingen, verzendkosten en de btw die Magento rekende, tot op de cent. Dat werkt met catalogusprijzen inclusief en exclusief btw.
• Creditnota: zodra je in Magento een creditnota (credit memo) maakt voor een bestelling met een PeppolKit-factuur. De creditnota verwijst naar de oorspronkelijke factuur en gaat op dezelfde manier naar je klant.
• Bij de bestelling staat in het beheer het blok PeppolKit met de factuur en creditnota's, de links PDF en UBL, de Peppol-status en de knop Opnieuw e-mail verzenden.

Btw-nummer van zakelijke klanten

PeppolKit leest het btw-nummer uit het factuuradres van de bestelling, en anders uit het klantaccount. Zet het veld aan onder Stores → Configuration → Customers → Customer Configuration → Name and Address Options → Show VAT Number on Storefront. PeppolKit controleert het nummer bij VIES en verlegt de btw op de factuur bij een geldig nummer uit een ander EU-land. Het bedrag dat je klant betaalt komt wel uit Magento: zet daar ook de automatische klantgroep voor zakelijke EU-klanten aan (Create New Account Options → Enable Automatic Assignment to Customer Group), met een klantgroep zonder btw. Anders waarschuwt PeppolKit bij de bestelling dat er btw is gerekend.

Peppol activeren

Op de PeppolKit-pagina staat onder Peppol hoe je winkel verstuurt, met een knop naar het dashboard. Belgische webshop? Klik op Peppol verbinden in het dashboard en bevestig 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 Facturen maken voor betaalde bestellingen van de afgelopen 60 dagen zet betaalde bestellingen zonder factuur in de wachtrij, tot 250 per keer. Die verlopen als nieuwe: staat het mailen aan, dan krijgen klanten hun factuur per e-mail.

Test door bij een bestelling een Magento-factuur te maken (Invoice → Submit Invoice). Binnen een paar minuten staat bij de bestelling het blok PeppolKit met het factuurnummer. Duurt het langer, klik dan op Factuur nu maken; komt er dan wel een factuur, dan draait de cron van Magento niet.

Veelgestelde vragen

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.

Uitleg ter oriëntatie, geen fiscaal advies.