Skip to main content

Proposals & Invoices · Article 5.7

Peppol — ID's, netwerkroutering, foutstatus

Peppol is het universele e-factureringsnetwerk van de EU. Stuur een Peppol UBL-factuur via Clozo en het wordt gerouteerd via uw Access Point, de Peppol-directory, het Access Point van de klant en in hun boekhoudkundige systeem — meestal binnen 1–10 minuten.

Peppol is een van die afkortingen die intimiderend lijken maar eigenlijk een van de eenvoudigere e-factureringskanalen is. Het is een vier-hoekig netwerk: u, uw Access Point (AP), het AP van de ontvanger en de ontvanger. De Peppol-directory vertelt uw AP waar te leveren; het formaat is gestandaardiseerd; de certificaten worden centraal beheerd. Zodra beide partijen zijn geregistreerd, is het verzenden van een factuur één API-aanroep.

Step by step

  1. Registreer uw Peppol-ID

    (eenmalig): /settings/payments → Peppol-sectie → Registreren. Goedkeuren van het toestemmingsscherm. Wacht op de badge "Geregistreerd" (~5 minuten instelling, ~1–4 uur voor directory-verspreiding).

  2. Voeg het Peppol-ID van de klant toe

    : /clients/{id} → Peppol-sectie → voer het volledige deelnemers-ID in (bijv. iso6523-actorid-upis::0007:1234567890).

  3. Genereer en verzend

    : vanuit de Documenten-dropdown naast een factuur, kies "Verzenden via Peppol". De indiening wordt uitgevoerd; de tijdlijn registreert de poging.

  4. Bewaak de levering

    : binnen 1–10 minuten wordt de tijdlijn bijgewerkt met "Afgeleverd bij ontvanger-AP" (succes) of een foutcode.

  5. Opnieuw proberen indien nodig

    : klik vanuit de tijdlijngebeurtenis op Peppol-levering opnieuw proberen als het is mislukt. Nuttig voor voorbijgaande problemen (netwerkstoringen, AP-time-out). Voor "Ontvanger niet gevonden": herstel eerst het ID.

een actie "Verzenden via Peppol" op elke factuur in het Documenten-gebied. Tijdlijngebeurtenissen voor indiening, leveringsbevestiging en eventuele fouten. De offerte-banner toont "Factuur afgeleverd via Peppol op [datum]" zodra het is geslaagd.

Why this works this way

Peppol-deelnemers-ID's (het "ID op de hoek van het netwerk"). Elke partij in Peppol heeft een uniek ID in een specifiek schema. Voor de meeste EU-landen wordt het schema iso6523-actorid-upis gebruikt met een subschema dat de autoriteit van het land identificeert:

- 0007 — Zweden (Organisationsnummer) - 0088 — Noorwegen (Foretaksregister) - 0192 — Noorwegen (Mva-register) - 0009 — Frankrijk (SIRET) - 0204 — Italië (IPA) - 0184 — Denemarken (CVR) - 9925 — België BTW - 9930 — Duitsland BTW - 9931 — Frankrijk BTW - 9932 — Spanje BTW - 9933 — Italië BTW - 9934 — Nederland BTW - 0007:1234567890 is dan een volledig deelnemers-ID voor een Zweedse onderneming met organisatienummer 1234567890.

Clozo registreert uw Peppol-ID met uw BTW-nummer onder het juiste schema voor uw land (automatisch geselecteerd op basis van uw profiellandcode). Registratie is een eenmalig proces dat ongeveer 5 minuten duurt en binnen 1–4 uur door de Peppol-directory wordt verspreid.

Het vier-hoekige model.

`` [U] [Ontvanger] ↓ ↑ [Uw AP] [AP van ontvanger] ↓ ↑ └──── Peppol-netwerk ──────┘ (SMP-directory + certificaten) ``

Uw AP is de gateway waardoorheen uw facturen vertrekken. De Peppol SMP (Service Metadata Publisher) koppelt deelnemers-ID's aan AP-eindpunten — uw AP bevraagt dit om te weten waar te leveren. Het AP van de klant is de gateway waardoorheen facturen binnenkomen; van daaruit wordt het in hun boekhoud-/ERP-systeem gepusht via welke lokale integratie ze ook hebben geconfigureerd (gewoonlijk plug-ins voor SAP, Microsoft Dynamics, NetSuite, Visma, Exact, enz.).

Clozo gebruikt een vooraf geïntegreerde AP-provider; u hoeft er geen te kiezen. Uw facturen vertrekken automatisch via dat AP; de kant van de ontvanger is voor hen om te configureren.

Het formaat: UBL EN 16931. EN 16931 is de Europese Norm voor het semantische gegevensmodel van een e-factuur. UBL is een van de twee syntaxisbindingen (de andere is UN/CEFACT CII; beide dragen hetzelfde EN 16931-model). Peppol gebruikt het Peppol BIS Billing 3.0-profiel, dat in wezen EN 16931 is met een paar Peppol-specifieke beperkingen. Clozo geeft BIS Billing 3.0-conforme XML uit.

De routeringsstroom:

1. U klikt op "Downloaden als Peppol UBL" of automatisch leveren via de Verzenden-actie. 2. Clozo verpakt de factuur als Peppol BIS Billing 3.0 UBL. 3. Het AP van Clozo bevraagt de Peppol SMP naar het AP-eindpunt van de ontvanger. 4. Het AP dient de factuur in via AS4 (een industriestandaard berichtenprotocol). 5. Het AP van de ontvanger ontvangt, valideert en pusht naar zijn boekhoudkundige systeem. 6. Het AP van de ontvanger retourneert een leveringsbevestiging aan uw AP binnen ~1–10 minuten. 7. Clozo registreert de bevestiging op de offerte-tijdlijn.

Veelvoorkomende foutstatussen:

- Ontvanger niet gevonden: het opgegeven deelnemers-ID staat niet in de SMP-directory. De klant heeft u het verkeerde ID gegeven, of hun AP is niet geregistreerd. Verifieer met hun boekhouder. - Schema ongeldig: het UBL-document doorstaat de Peppol BIS Billing 3.0-validatie niet. Bijna altijd een Clozo-zijdig probleem — neem contact op met ondersteuning. - Afgewezen door ontvanger-AP: het AP van de ontvanger handhaaft lokale regels boven en buiten Peppol BIS (bijv. een specifiek formaat voor PO-nummer vereisen). De foutmelding zal de regel identificeren. - Leveringstijdlimiet: zeldzaam; het AP van de ontvanger heeft niet binnen 24 uur gereageerd. Clozo kan op verzoek opnieuw proberen.

Troubleshooting

Keep reading