SendPol Stripe App
Installatiehandleiding
Verstuur Stripe facturen direct naar het Peppol netwerk met de SendPol Stripe App. Kies tussen handmatige of volledig automatische verwerking via webhooks.
Inhoudsopgave
Wat is de SendPol Stripe App?
De SendPol Stripe App maakt het mogelijk om facturen vanuit Stripe direct te versturen via het Peppol netwerk voor e-invoicing compliance. Je kunt kiezen tussen handmatige verwerking via de Stripe App, of volledig automatische verwerking via webhooks.
Functionaliteiten
- Handmatig of automatisch: Kies de methode die bij jouw workflow past
- Status tracking: Bekijk de verwerkingsstatus van verzonden facturen (Created, Ready to send, Sent via Peppol)
- UBL download: Download de gegenereerde UBL factuur
- Naadloze integratie: Werkt direct vanuit het Stripe Dashboard
Zie SendPol in actie
Bekijk hoe eenvoudig de integratie is
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 webshopsVereisten
- Een SendPol account met actief abonnement
- Een Stripe account met facturen
- Een webshop aangemaakt in SendPol met API key
Methode 1: Handmatige verwerking
Via de SendPol Stripe App
Met de SendPol Stripe App kun je facturen handmatig versturen naar Peppol. Dit is ideaal als je controle wilt houden over welke facturen worden verstuurd.
1Vind en installeer de SendPol-app
Open in je Stripe Dashboard de App Marketplace en zoek op "peppol". Open de listing "SendPol – Peppol e-Invoicing Integration" en klik op "Install app".
2Kopieer je API-sleutel uit SendPol
Log in op SendPol en ga naar Mijn Account → Webshops. Open de webshop die je wilt koppelen en kopieer de API-sleutel — die plak je in de volgende stap in Stripe.
3Verbind SendPol in Stripe
Terug in Stripe open je het SendPol-paneel, plak je je API-sleutel en klik je op "Connect". SendPol bevestigt de verbinding met een "Connected"-badge.
4Controleer je instellingen en testmodus
In het SendPol-instellingenpaneel schakel je de testmodus in of uit. In testmodus worden facturen wel verwerkt maar niet via Peppol afgeleverd — schakel hem uit (en voltooi de KYC) om live te gaan. Hier kun je ook je sleutel bijwerken of de verbinding verbreken.
5Verstuur een factuur via Peppol
Open een willekeurige Stripe-factuur. Het SendPol-paneel toont of ze klaar is om te versturen; klik op "Send via Peppol" om ze naar het netwerk te sturen.
6Bevestig de levering en download de UBL
Zodra de factuur is afgeleverd, toont het paneel "Sent via Peppol" met het synchronisatietijdstip. Je kunt de gegenereerde UBL downloaden of het document in SendPol openen.
Methode 2: Automatische verwerking
Via Stripe Webhooks
Met webhooks worden facturen automatisch naar Peppol verstuurd zodra ze in Stripe worden aangemaakt of betaald. Dit is de meest efficiënte methode voor bedrijven met veel facturen.
Voordelen
- Volledig automatisch - geen handmatige actie nodig
- Werkt ook wanneer je niet ingelogd bent in Stripe
- Ideaal voor hoge volumes
- Eenmalige configuratie
Genereer je Webhook URL
Selecteer je webshop om de unieke webhook URL te genereren. Deze URL gebruik je in Stripe om automatische verwerking in te stellen.
Log in om je webhook URL te genereren
Inloggen1. Ga naar Stripe Webhooks
Log in op je Stripe Dashboard en ga naar Developers → Webhooks. Klik op 'Add endpoint' om een nieuwe webhook toe te voegen.
2. Maak een nieuwe webhook
Klik op 'Add endpoint' om een nieuwe webhook endpoint aan te maken.
3. Selecteer events
Selecteer de events waarvoor je webhooks wilt ontvangen. Voor automatische factuurverwerking selecteer je 'invoice.paid' of 'invoice.finalized'.
4. Kies webhook type
Selecteer het type webhook. Kies voor een standaard webhook endpoint.
5. Voer de SendPol URL in
Plak de webhook URL die je hierboven hebt gegenereerd. Deze URL bevat je API key en zorgt ervoor dat facturen automatisch naar SendPol worden doorgestuurd.
OIN-nummer toevoegen voor een klant
Voor Nederlandse (semi-)overheidsklanten kun je een OIN-nummer meegeven via de metadata van de klant in Stripe. SendPol leest dit veld uit en gebruikt het OIN als Peppol-identificatie (schema 0190) voor die klant.
- Ga in Stripe naar Klanten en selecteer de betreffende klant.
- Klik naast Metadata op het potlood-icoon om te bewerken.
- Voeg een sleutel oin toe met als waarde het 20-cijferige OIN-nummer.
- Sla op. SendPol gebruikt dit OIN automatisch bij de volgende facturen naar Peppol.
Ondernemingsnummer (KvK/KBO) toevoegen voor een klant
Voor zakelijke klanten kun je het nationale ondernemingsnummer meegeven via de metadata van de klant in Stripe — KvK (NL, 8 cijfers), KBO (BE, 10 cijfers), SIREN (FR, 9 cijfers), matricule (LU) of Handelsregisternummer (DE). SendPol zet dit als registratienummer (BT-30) op de e-factuur en gebruikt het als extra zoeksleutel om de klant op Peppol te vinden wanneer het BTW-nummer niets oplevert. Het staat los van het BTW-nummer.
- Ga in Stripe naar Klanten en selecteer de betreffende klant.
- Klik naast Metadata op het potlood-icoon om te bewerken.
- Voeg een sleutel company_registration_number toe met als waarde het ondernemingsnummer van de klant (het nummer dat hoort bij het land van de klant).
- Sla op. SendPol gebruikt dit nummer automatisch bij de volgende facturen.
Problemen oplossen
API key wordt niet geaccepteerd
Controleer of je de juiste API key hebt gekopieerd uit je SendPol account. Zorg ervoor dat er geen extra spaties zijn.
Factuur kan niet worden verstuurd
Controleer of de factuur alle verplichte velden bevat, waaronder een geldig BTW-nummer van de ontvanger.
Status blijft op 'Ready to send via Peppol (check your settings)'
Dit kan te maken hebben met de testmodus die mogelijk nog aanstaat, of de KYC procedure die nog niet voltooid is.
API key werkt maar facturen worden niet verstuurd
Je webshop staat mogelijk op inactief. Controleer de status van je webshop in je SendPol account.
Webhook ontvangt geen events
Controleer in Stripe Dashboard → Developers → Webhooks of de webhook correct is geconfigureerd en of er geen errors zijn. Zorg dat de webhook URL exact overeenkomt met de gegenereerde URL.
Veelgestelde vragen
Klaar om te beginnen?
Installeer de SendPol Stripe App en begin direct met het versturen van facturen via Peppol - handmatig of volledig automatisch.