Peppol voor ontwikkelaars: aan de slag met elektronische bestellingen

Peppol is een internationaal, open B2B-netwerk waarmee organisaties gestructureerde zakelijke documenten, zoals bestellingen en facturen, efficiënt kunnen uitwisselen.

Inzicht in de technische specificaties en het implementatieproces van Peppol is van cruciaal belang voor ontwikkelaars om robuuste systemen te bouwen die de efficiëntie van organisaties vergroten. Deze handleiding geeft een overzicht van de belangrijkste concepten en technische richtlijnen waarmee ontwikkelaars aan de slag kunnen met elektronische bestellingen via Peppol.

Peppol (Pan-European Public Procurement Online) is een raamwerk dat de elektronische uitwisseling van documenten tussen bedrijven en overheidsinstanties standaardiseert. Het is geen ERP-systeem, portaal of inkoopplatform, maar een protocol dat interoperabiliteit tussen verschillende systemen mogelijk maakt.

Peppol maakt gebruik van het vierhoeksmodel, wat inhoudt dat elke organisatie via de door haar gekozen Peppol Access Point-provider verbinding maakt met het netwerk, waardoor het niet meer nodig is om dienstverleners op elkaar af te stemmen met zakelijke partners.

De belangrijkste kenmerken van Peppol zijn:

Om elektronische bestellingen via Peppol te kunnen implementeren, is het noodzakelijk om inzicht te hebben in de Business Interoperability Specifications (BIS), de syntaxis van de berichten en de vereisten voor gegevensuitwisseling.

Hieronder volgt een overzicht van de zes belangrijkste stappen en de bijbehorende technische overwegingen.

Ontwikkelaars die Peppol-facturen implementeren, moeten weten hoe ze cbc-elementen correct moeten invullen volgens de Peppol BIS-richtlijnen, om ervoor te zorgen dat de documenten aan de voorschriften voldoen en de verzending succesvol verloopt.

In de context van Peppol en de UBL-syntaxis (Universal Business Language) voor facturen staat cbc voor Common Basic . Deze vooraf gedefinieerde gegevenselementen binnen het UBL-schema vormen de basisbouwstenen van bedrijfsdocumenten zoals facturen, bestellingen en verzendberichten.

Peppol ondersteunt drie hoofdspecificaties, ook wel profielen genoemd, voor bestelprocessen. Elk BIS is ontworpen voor specifieke toepassingen, en zakenpartners moeten overeenkomen welke ze gaan gebruiken.

BIS Order Only: Voor eenvoudige bestellingen zonder reactie van de leverancier.
BIS Ordering: Inclusief reacties op bestellingen ter bevestiging van acceptatie, afwijzing of gedeeltelijke acceptatie.
BIS Despatch Advice: Informeert de koper over de verzendgegevens.

De Peppol-ordertransactie (T01) volgt de UBL-standaard (Universal Business Language) standaard.

Om Peppol effectief te implementeren, moeten ontwikkelaars grondig begrijpen hoe ze cbc-elementen moeten invullen volgens de Peppol BIS-richtlijnen, zodat zowel naleving als een soepele verzending gewaarborgd zijn. Het is essentieel dat de vereiste syntaxis voor alle documentelementen wordt nageleefd, aangezien afwijkingen van de validatieregels van Peppol kunnen leiden tot fouten die het bestelproces verstoren.

Hier volgen enkele voorbeelden van essentiële onderdelen van besteldocumenten:

Weergave van gegevens: cbc-elementen vertegenwoordigen doorgaans afzonderlijke gegevensvelden, waardoor ze eenvoudig te gebruiken en te valideren zijn.
Attributen: Sommige cbc-elementen bevatten attributen zoals currencyID (voor bedragen) of unitCode (voor hoeveelheden).
Verplicht/optioneel: De Peppol BIS-richtlijnen (Business Interoperability Specification) geven aan welke cbc-elementen verplicht, optioneel of voorwaardelijk verplicht zijn.

Terwijl cbc basiscomponenten vertegenwoordigt, wordt cac (Common Aggregate Components) gebruikt voor complexe gegevensstructuren waarin verwante cbc- en andere cac-elementen worden gegroepeerd. Zo groepeert cac:Party bijvoorbeeld alle informatie over een bedrijfsentiteit, zoals de naam, het adres en de identificatiegegevens.

Raadpleeg de officiële Peppol BIS Ordering voor meer informatie over specifieke CBC-elementen die bij Peppol UBL-bestellingen worden gebruikt.

Peppol-transacties worden verzonden via gecertificeerde Peppol-toegangspunten, ook wel Peppol-serviceproviders genoemd. Als ontwikkelaar moet je applicatie verbinding maken met de API van een provider om documenten te verzenden en te ontvangen. Toegangspunten zorgen voor de technische afhandeling van het doorsturen van berichten van en naar handelspartners.

Lees meer over het opvragen van Peppol-bestellingen via de Order API.

Validatie garandeert dat aan de regels van Peppol en de BIS-vereisten wordt voldaan. Voer grondige validatiecontroles uit om fouten vóór de verzending op te sporen. Controleer bijvoorbeeld verplichte velden zoals cbc:ID en cbc:DocumentCurrencyCode. Controleer de geldigheid van gegevensformaten, waaronder datums, valuta’s en identificatiecodes.

Voor gebruikers van het Peppol Access Point van Qvalia zijn formaatcontroles standaard ingebouwd en geautomatiseerd.

Test de integratie in een door uw Access Point-provider aangeboden testomgeving voordat u uw oplossing implementeert. Zo kunt u verschillende scenario’s simuleren, zoals het plaatsen van bestellingen, het ontvangen van reacties en het beheren van verzendbevestigingen.

Peppol-bestellingen zijn gebaseerd op XML-gebaseerde UBL-schema’s. Hieronder volgt een kort overzicht van de belangrijkste elementen in de bestelstructuur:

De koptekst bevat essentiële metagegevens over de bestelling.

De koper en verkoper worden gedefinieerd met behulp van de segmenten `cac:BuyerCustomerParty` en `cac:SellerSupplierParty`.

Op elke orderregel staan de artikelen, hoeveelheden en prijzen vermeld.

Met de BIS Despatch Advice kunnen leveranciers afnemers op de hoogte brengen van de verzendgegevens.

Het bericht kan het volgende bevatten:

Volg de Peppol BIS-richtlijnen: Houd u altijd aan de officiële Peppol BIS-documentatie om naleving te garanderen.
Ga om met lokale variaties: Hoewel Peppol een wereldwijde standaard is, kunnen bepaalde sectoren of regio’s specifieke aanpassingen vereisen.
Automatiseer de validatie: Implementeer geautomatiseerde controles op de naleving van syntaxis en inhoud vóór verzending.
Beveilig gegevens: Zorg ervoor dat alle verzonden gegevens voldoen aan de AVG en andere privacyregelgeving.

Peppol biedt een robuust raamwerk voor elektronische bestellingen, waardoor bedrijven hun processen kunnen stroomlijnen en de nauwkeurigheid van gegevens kunnen verbeteren. Voor ontwikkelaars is het van cruciaal belang om de technische specificaties van Peppol BIS, UBL-schema's en Access Point-integratie te begrijpen om schaalbare en efficiënte oplossingen te kunnen creëren.