Problemen oplossen
Fouten die u kunt tegenkomen, wat ze werkelijk betekenen en de kortste weg om ze op te lossen.
“De ontvanger is niet geregistreerd op Peppol”
De opzoeking in de directory vond de opgegeven deelnemersidentificatie niet, of de fiche van de ontvanger bestaat wel maar sluit het documenttype uit dat u wilt verzenden (factuur of creditnota).
Wat u kunt proberen:
- Controleer het identificatieschema. De meeste EU-klanten worden geïdentificeerd met hun btw-nummer (bv. schema 9925 voor België, 9930 voor Duitsland). Stripe bewaart btw-nummers soms zonder schemaprefix, dus mogelijk moet u het schema op het verzendscherm overschrijven.
- Vraag de klant of die überhaupt op Peppol zit. Veel bedrijven zijn dat niet. Is dat zo, dan kunt u niet via Peppol leveren: stuur hen dan de door Stripe gehoste factuurlink.
- Ga na of de klant het documenttype aanvaardt dat u verzendt. Sommige ontvangers zijn geregistreerd voor facturen, maar niet voor creditnota's.
“Validatie mislukt”
De gegenereerde UBL voldeed niet aan de schematronregels van Peppol BIS Billing 3.0. De foutmelding noemt de specifieke regel die is mislukt.
Veelvoorkomende oorzaken:
- Ontbrekend btw- of registratienummer van de koper op de Stripe-klant — voeg het toe op de klantfiche in Stripe en vernieuw het verzendscherm.
- Inconsistente valuta of btw-verwerking op de factuur zelf. Peppol BIS verwacht één documentvaluta en een btw-totaal dat tot op de cent overeenkomt met de regeltotalen.
- Kortingsregels die rekenkundig inconsistente btw-tarieven opleveren. Controleer de Stripe-factuur en reik ze indien nodig opnieuw uit.
Bij een mislukte validatie wordt geen credit verbruikt: corrigeer de onderliggende gegevens en start de verzending opnieuw.
“Btw-verschil resteert voor 0% btw”
Deze weigering komt van het Peppol-toegangspunt, dat uw btw-totalen toetst aan uw geregistreerde btw-status. Het toegangspunt gaat ervan uit dat u op deze factuur geen btw mag aanrekenen, waardoor het aangegeven btw-bedrag niet in de categorie met het normale tarief past en als restant in de categorie 0% opduikt.
De twee situaties die dit veroorzaken:
- U rekent btw aan terwijl u als btw-vrijgesteld geregistreerd staat. Valt uw onderneming onder een vrijstellingsregeling voor kleine ondernemingen (bv. de Belgische regeling artikel 56bis), dan moet u aan 0% factureren. Pas de Stripe-factuur aan en reik ze opnieuw uit.
- U bent btw-plichtig, maar Peppost weet dat niet. Peppost gaat standaard uit van “Btw-plichtig” zodra er een btw-nummer voor uw account is ingesteld, dus dit zou het gangbare geval moeten zijn. Mail de ondersteuning als uw account verkeerd is geconfigureerd (we markeren vrijstellingsaccounts per account met vatStatus 3).
“Het toegangspunt van de ontvanger meldde een fout”
Het document is afgeleverd bij het toegangspunt van de ontvanger, maar dat gaf een fout verderop terug (bijvoorbeeld: het boekhoudsysteem van de ontvanger weigerde de inhoud van het document).
Dit geldt als een geslaagde verzending op het netwerk: de credit wordt niet terugbetaald. Neem contact op met uw klant om te achterhalen wat hun systeem nodig heeft, corrigeer het document in Stripe, reik indien nodig een creditnota uit en verzend een gecorrigeerde factuur.
“De Stripe-pdf kon niet worden opgehaald”
Peppost vraagt de gerenderde factuur-pdf op bij Stripe en sluit die in het Peppol-document in. Heeft Stripe de pdf nog niet gegenereerd — meestal omdat de factuur enkele seconden geleden is gefinaliseerd — dan kan het ophalen mislukken met een 404.
Wacht 30 seconden en probeer opnieuw. Stripe heeft de pdf normaal zeer snel klaar. Blijft de fout na een paar minuten terugkomen, neem dan contact op met de ondersteuning.
“De Stripe-verbinding is verlopen”
Uw Stripe Connect-token is ingetrokken, ofwel expliciet vanuit het Stripe-dashboard, ofwel doordat het onderliggende Stripe-account is afgesloten.
Open Instellingen in Peppost en klik op Stripe opnieuw verbinden. U doorloopt hetzelfde OAuth-traject als bij de configuratie. Bestaande creditsaldo's en geschiedenis blijven behouden.
Een creditaankoop is niet op mijn saldo bijgeschreven
Peppost rondt aankopen af via een Stripe-webhook. In zeldzame gevallen loopt de webhook enkele seconden achter. Vernieuw de pagina Credits; is het saldo na vijf minuten nog niet bijgewerkt:
- Controleer of de betaling als geslaagd wordt weergegeven in uw Stripe-bon per e-mail.
- Mail support@peppo.st met de ID van de Stripe Checkout-sessie (zichtbaar op de bon). We stemmen handmatig af binnen één werkdag.
Nog steeds vast?
Mail support@peppo.st met:
- De Peppost-verzend-ID (of de Stripe-factuur-ID).
- De foutmelding die u zag, letterlijk.
- Wat u al hebt geprobeerd.
We streven ernaar binnen één werkdag te antwoorden. Voor vragen over tarieven of het product, zie de FAQ.