WordPress & WooCommerce

    Installatiehandleiding

    Volledige technische handleiding voor het installeren en configureren van SendPol voor WordPress en WooCommerce. Integreer je webshop met het Peppol netwerk in enkele stappen.

    Video Handleiding

    Bekijk Hoe Je SendPol Instelt voor WordPress/WooCommerce

    Leer hoe je de SendPol plugin voor WordPress/WooCommerce installeert en configureert in slechts enkele minuten.

    Wat is SendPol?

    SendPol voor WooCommerce is een WordPress plugin die automatisch je WooCommerce winkel integreert met het Peppol netwerk. Het transformeert je orderverwerking door voltooide bestellingen automatisch om te zetten in UBL (Universal Business Language) facturen en deze via Peppol te verzenden zonder handmatige tussenkomst.

    Belangrijkste functies

    • Volledige WooCommerce integratie: Automatisch herkennen en omzetten van bestellingen naar facturen
    • UBL (Universal Business Language) facturen: Compatibel met overheden en zakelijke klanten
    • Automatisch verzenden via Peppol: Gestandaardiseerd & juridisch geldig
    • B2B klaar: Perfect voor bedrijven die aan andere bedrijven of overheidsinstanties verkopen
    • EU-conforme: Klaar voor Peppol e-facturering vereisten (verplicht vanaf 2026 in veel EU-landen)

    Waarom kiezen voor SendPol?

    Vanaf 2026 wordt Peppol e-facturering verplicht in steeds meer Europese landen, vooral voor bedrijven en overheidscontracten. Met SendPol ben je klaar voor compliance zonder complexe setups of hoge ontwikkelingskosten.

    Testmodus

    Begin met de testmodus

    Standaard staat elke nieuwe webshop in testmodus. Documenten worden gevalideerd en zichtbaar in je SendPol dashboard, maar nog niet doorgestuurd naar het Peppol netwerk. Zo kun je je workflow rustig testen voordat er ook maar één factuur live gaat.

    Wanneer je klaar bent voor productie, schakel testmodus uit via je webshop-instellingen in MyAccount.

    Naar mijn webshops

    Installatie

    Systeemvereisten

    • WordPress 5.9 of hoger
    • WooCommerce plugin geïnstalleerd en geactiveerd
    • PHP 7.4 of hoger
    • SendPol account (registreer op www.sendpol.com)

    Methode 1: Installatie via WordPress Plugin Store (Aanbevolen)

    De SendPol plugin is beschikbaar in de officiële WordPress plugin store

    1

    Ga naar je WordPress admin dashboard

    2

    Navigeer naar Plugins > Nieuwe toevoegen

    3

    Zoek naar 'SendPol voor WooCommerce'

    4

    Klik op 'Nu installeren' bij de SendPol plugin

    5

    Klik op 'Activeren' na installatie

    6

    Je zou 'SendPol' moeten zien in je WordPress admin menu

    Methode 2: Handmatige installatie

    Alternatief: Upload het plugin bestand handmatig

    1

    Download de SendPol voor WooCommerce plugin

    2

    Ga naar je WordPress admin dashboard

    3

    Navigeer naar Plugins > Nieuwe toevoegen > Plugin uploaden

    4

    Selecteer het plugin ZIP-bestand en klik op 'Nu installeren'

    5

    Klik op 'Plugin activeren' na installatie

    6

    Je zou 'SendPol' moeten zien in je WordPress admin menu

    Eerste configuratie

    API-gegevens verkrijgen

    1

    Registreer bij SendPol

    Bezoek www.sendpol.com en maak een account aan of log in op je bestaande account.

    2

    Zoek je API Key in het SendPol Dashboard

    API Base URL: https://api.sendpol.com

    Om je API Key te vinden:

    • Ga naar www.sendpol.com en log in met je account
    • Aan de linkerkant van het dashboard, kies je "Webshops"
    • Klik op het sleuteltje (🔑) om je API key te zien
    • Kopieer deze key en bewaar deze veilig
    SendPol Dashboard - Webshops beheer met API key

    Eerste configuratie

    Bij eerste gebruik zie je een onboarding scherm

    SendPol Plugin Configuratie
    1

    Klik op "SendPol" in je WordPress admin menu

    2

    Voer de API Base URL in: https://api.sendpol.com

    3

    Voer je SendPol API key in

    4

    Klik op "Activate SendPol" - de plugin test automatisch je verbinding

    Configuratie

    Plugin gebruiken

    Automatische factuurverwerking

    Eenmaal geconfigureerd, werkt de plugin automatisch

    1

    Bestelling voltooid

    Wanneer een WooCommerce bestelling wordt gemarkeerd als "Voltooid" of "Verwerking", genereert de plugin automatisch een UBL factuur en verstuurt deze via Peppol naar de klant.

    2

    Bestellingsvalidatie

    De plugin valideert bestellingen voor verzending, controleert op vereiste klantinformatie, verifieert BTW-nummers indien opgegeven, en zorgt ervoor dat alle benodigde gegevens aanwezig zijn.

    3

    Status tracking

    Monitor factuurstatus in het SendPol dashboard, bekijk leveringsbevestigingen en volg eventuele verwerkingsfouten.

    Handmatige acties

    Facturen opnieuw verzenden

    • Vanaf bestelling bewerkpagina: Ga naar WooCommerce > Bestellingen, bewerk de specifieke bestelling, zoek het "SendPol - Order Status" metabox en klik op "Opnieuw verzenden".
    • Vanaf SendPol Dashboard: Navigeer naar SendPol > Document Statussen, vind het relevante document en gebruik beschikbare acties om opnieuw te verwerken.

    Bulk acties

    Verwerk meerdere bestellingen tegelijk: Ga naar WooCommerce > Bestellingen, selecteer meerdere bestellingen, kies SendPol bulk acties uit de dropdown en pas de actie toe.

    Creditnota's & terugbetalingen

    SendPol ondersteunt volledige en gedeeltelijke terugbetalingen via creditnota's.

    • Zowel volledige als gedeeltelijke terugbetalingen genereren automatisch een creditnota.
    • Creditnota's worden net als facturen naar het Peppol-netwerk gestuurd.
    • Handmatige verzending van een creditnota is beschikbaar via het order actie-menu ("SendPol: Creditnota verzenden").
    • Per-refund tracking: elke terugbetaling wordt apart bijgehouden.
    • Creditnota's bij geannuleerde orders kunnen geautomatiseerd worden (zie instelling "Automatische creditnota bij annulering").

    Automatisch retry-systeem

    Wanneer een factuur niet kan worden verstuurd, plant de plugin automatisch nieuwe pogingen.

    • Het retry-systeem gebruikt exponential backoff: pogingen worden op steeds langere tussenpozen uitgevoerd.
    • Er wordt een maximum aantal pogingen gerespecteerd.
    • De retry-status is per order zichtbaar in de SendPol order metabox.
    • Oude retry-records worden automatisch opgekuist.
    • Handmatig opnieuw proberen is altijd mogelijk via de orderpagina.

    Dashboard overzicht

    SendPol Dashboard

    Het SendPol dashboard biedt een realtime overzicht van je Peppol integratie met recente verzendingen, documentstatussen, verbindingsstatus en logs.

    Statistieken (Stats tab)

    Het stats-tabblad van het plugin dashboard toont:

    • Documenten verstuurd deze maand en totaal (sinds installatie)
    • Totaal aantal API-calls
    • SendPol abonnementsniveau en API-gebruikslimiet
    • Peppol verbindingsstatus
    • Documenten geüpload naar Peppol
    • Documenten klaar voor upload
    • Documenten mislukt: validatiefout
    • Documenten mislukt: ontvanger niet op Peppol
    • Documenten mislukt: ontvanger is geen bedrijf

    Tabblad "Recente documenten"

    • In het tabblad met recente documenten kan je filteren op status, documenttype, documentnummer en datumbereik.
    • Per document zie je: documentnummer, type (factuur/creditnota), klantnaam, totaalbedrag, aanmaakdatum en een status badge.
    • Acties per document: Verzenden naar SendPol, Verzenden via Peppol, Opnieuw proberen en Reset — plus Upgrade abonnement / KYC voltooien wanneer een document geblokkeerd is.
    • UBL/XML download knop per document.

    Bestellingen beheren

    SendPol kolom in de bestellingenlijst

    De WooCommerce bestellingenlijst krijgt een extra "SendPol" kolom met:

    • Kleurgecodeerde status badge
    • Remote document ID
    • Snel visueel overzicht zonder elke order te moeten openen
    • Werkt zowel met de klassieke bestellingen-weergave als met HPOS (High-Performance Order Storage).

    Order metabox "SendPol – Order Status"

    In de bewerkpagina van een order toont de "SendPol – Order Status" metabox:

    • Huidige status met badge
    • Remote document ID
    • Laatste sync-tijdstip
    • Laatste poging-tijdstip
    • Validatiefouten (indien aanwezig)
    • Handmatige btw-invoer (een btw-nummer kan rechtstreeks op de order toegevoegd of bewerkt worden)
    • Actieknoppen: Opnieuw verzenden, Verwijderen en opnieuw verzenden, Creditnota verzenden, Status verversen, Debug payload

    Bulk acties

    In de bestellingenlijst zijn twee bulk acties beschikbaar:

    • SendPol: Opnieuw verzenden — verstuurt de geselecteerde orders opnieuw naar SendPol.
    • SendPol: Verwijderen en opnieuw verzenden — verwijdert eerst het bestaande remote document en stuurt daarna opnieuw (handig bij vastgelopen documenten).

    Debug payload

    Via de order metabox toont de "Debug payload" knop de volledige JSON payload die naar de SendPol API zou worden verstuurd. Handig om problemen met de inhoud van een factuur te onderzoeken.

    Compatibiliteit

    WooCommerce Blocks-ondersteuning

    Het btw-veld werkt zowel in de klassieke WooCommerce checkout als in de nieuwe WooCommerce Blocks checkout. Er is geen extra configuratie nodig.

    HPOS-ondersteuning

    De plugin ondersteunt WooCommerce High-Performance Order Storage (HPOS) volledig. Alle functies (orderkolom, metabox, bulk acties) werken met HPOS ingeschakeld.

    Ontwikkelaars & filters

    Voor ontwikkelaars stelt de plugin enkele tools en hooks beschikbaar.

    Btw-detectie test

    In de geavanceerde instellingen kan je een specifieke order-ID invoeren om de btw-detectie te testen. De tool toont welke meta key werd gebruikt om het btw-nummer te vinden, alle btw-gerelateerde meta keys die in de order aanwezig zijn, en of er een btw-nummer gedetecteerd werd.

    PHP filters

    De plugin biedt onder andere de volgende filters:

    • sendpol_wc_api_base_urlprogrammatisch de API base URL overschrijven.
    • sendpol_wc_external_invoiceeen eigen externe UBL-factuur aanleveren per order (geef een UBL-XML-string terug, of null om SendPol zelf te laten genereren).
    • sendpol_wc_auto_refresh_order_statusauto-refresh van de orderstatus in de metabox uitschakelen.
    • sendpol_wc_show_api_base_urlhet API base URL veld verbergen in de instellingen (bijvoorbeeld voor beheerde installaties).
    // Override the API base URL programmatically
    add_filter('sendpol_wc_api_base_url', function ($url) {
        return 'https://staging.api.sendpol.com';
    });
    
    // Provide a custom external UBL invoice for an order
    add_filter('sendpol_wc_external_invoice', function ($invoice, $order) {
        // Return a UBL XML string, or null to let SendPol generate one
        return null;
    }, 10, 2);
    
    // Disable auto-refresh of order status in the order edit metabox
    add_filter('sendpol_wc_auto_refresh_order_status', '__return_false');
    
    // Hide the API base URL field in settings (e.g. for managed installs)
    add_filter('sendpol_wc_show_api_base_url', '__return_false');

    Problemen oplossen

    FAQ

    Plugin Screenshots

    Configuratie & Onboarding

    Eenvoudige setup met API configuratie en automatische verbinding met Peppol

    SendPol Plugin Configuratie

    Dashboard & Statistieken

    Realtime overzicht van Peppol verbinding en verzonden documenten

    SendPol Plugin Dashboard

    Snelstart

    Kom snel aan de slag met SendPol voor WordPress

    1

    Registreer bij SendPol

    Maak een account aan op sendpol.com en verkrijg je API-sleutel

    2

    Installeer de Plugin

    Download en activeer de SendPol plugin in je WordPress dashboard

    3

    Configureer API

    Voer je API-sleutel in en test de verbinding met het Peppol netwerk

    Hulp nodig?

    Ons ondersteuningsteam staat klaar om je te helpen met je SendPol integratie