Peppol-foutcodes oplossen met D Soft

Ontwikkelaars die onze Peppol-oplossing koppelen, krijgen heel wat feedback via statusmeldingen en error codes. Hieronder vind je een overzicht van veelvoorkomende foutmeldingen, hoe je ze herkent en welke stappen je kan nemen. Alle voorbeelden zijn gebaseerd op de processen die we beschrijven op onze Peppol-pagina.

Algemene debugging-aanpak

1. Controleer het document formaat: validaties gebeuren tegen EN 16931/Peppol BIS. Een ontbrekende IBAN of verkeerde btw-code veroorzaakt al snel een fout.

2. Verifieer je SMP-gegevens: het register bepaalt welke documenttypes je kan ontvangen. Zijn nieuwe processen nog niet geregistreerd, dan krijg je een reject. Gebruik deze link om je documenten te valideren: https://ecosio.com/en/peppol-e-invoice-xml-document-validator/ (kies voor Openpeppol UBL Invoice/Creditnote)

3. Gebruik DocTrails monitoring: onze oplossing toont statusmeldingen zodat developers exact zien bij welke corner in het 4-corner model de fout optrad.

Veelgezochte foutcodes

Ontbrekende verplichte velden

Deze fout treedt op wanneer een verplicht veld (bv. `cbc:ID` of `cbc:EndpointID`) ontbreekt. De validator van het Access Point stopt de verzending.

Oplossing: controleer de mapping in je ERP of integratieconnector. Vul het veld in en verstuur opnieuw.

Ongeldig KBO-nummer

Wanneer het KBO-nummer niet voldoet aan de vereiste structuur (10 cijfers) of niet overeenkomt met wat in het SMP staat, krijg je deze melding.

Oplossing: valideer het KBO-nummer via de ERP-masterdata. Indien het nummer recent wijzigde, vraag onze consultants om het SMP bij te werken.

Foute codelijst waarde

Peppol gebruikt vaste codelijsten voor btw-codes, landcodes en documenttypes. Een onbekende waarde leidt tot een reject.

Oplossing: vervang de waarde door een toegestane code (bv. `S` voor standaardbtw). Raadpleeg de documentatie op onze Peppol-pagina of in DocTrails.

Foutieve Peppol-ID

Als je deelnemer niet gevonden wordt in de SMP of je JWT-token gekoppeld aan onze API is verlopen, krijg je deze melding.

Oplossing: controleer of de Peppol-ID (=KBO-nummer) correct is en of de deelnemersregistratie actief is.

Ontvanger niet bereikbaar

Deze status komt terug wanneer het Access Point van de ontvanger unreachable is of wanneer het documenttype niet toegestaan is voor die partij.

Oplossing: verifieer met de klant of hij het documenttype ondersteunt. Eventueel registreert onze SMP-dienst het snel voor je.

Business rule geblokkeerd

DocTrails kan aangepaste regels bevatten (bv. verplichte PO-vermelding). Als een rule faalt, verschijnt deze fout.

Oplossing: kijk in DocTrails welke regel is afgegaan. Voeg de ontbrekende info toe of pas de rule aan via het beheerportaal.

Best practices voor developers

• Automatische retries: stuur documenten opnieuw wanneer het een tijdelijke netwerkfout betreft, maar beperk het aantal retries tot drie.

• Logging + correlation IDs: gebruik dezelfde ID als in DocTrails zodat support het bericht snel terugvindt.

• Testomgeving: maak gebruik van onze Acceptatieomgeving om nieuwe mappings te valideren voor je live gaat.

• Gebruik onze checklist: combineer dit artikel met de Peppol Readiness Checklist 2026 om te bepalen of je setup klaar is.

Heb je een fout die hier niet tussen staat? Mail naar peppol@dsoft.be.