Peppol voor ontwikkelaars: aan de slag met elektronische bestellingen

Peppol is een internationaal open B2B-netwerk waarmee organisaties gestructureerde bedrijfsdocumenten 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 verbeteren. Deze gids geeft een overzicht van de belangrijkste concepten en technische richtlijnen voor ontwikkelaars om aan de slag te gaan met elektronische bestellingen met behulp van 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 vierhoekmodel, wat betekent dat elke organisatie via de door haar gekozen Peppol Access Point-provider verbinding maakt met het netwerk, waardoor het niet meer nodig is om serviceproviders af te stemmen op zakenpartners.

De belangrijkste kenmerken van Peppol zijn:

Om elektronische bestellingen in Peppol te implementeren, moet u de Business Interoperability Specifications (BIS), de berichtensyntaxis en de vereisten voor gegevensuitwisseling begrijpen.

Hier volgt een overzicht van de zes belangrijkste stappen en de technische overwegingen daarbij.

Ontwikkelaars die Peppol-facturen implementeren, moeten begrijpen hoe ze cbc-elementen correct moeten invullen volgens de Peppol BIS-richtlijnen om te zorgen dat documenten aan de regels voldoen en succesvol worden verzonden.

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 vertegenwoordigen basisbouwstenen die hergebruikt kunnen worden in zakelijke documenten zoals facturen, bestellingen en verzendberichten.

Peppol ondersteunt drie primaire specificaties, ook wel profielen genoemd, voor orderprocessen. Elk BIS is ontworpen voor specifieke gebruikssituaties en zakenpartners moeten overeenkomen welk profiel ze gaan gebruiken.

BIS Order Only: Voor eenvoudige bestellingen zonder reactie van de leverancier.
BIS Ordering: Bevat reacties op bestellingen om acceptatie, afwijzing of gedeeltelijke acceptatie te bevestigen.
BIS Despatch Advice: Informeert de koper over de verzendgegevens.

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

Om Peppol effectief te implementeren, moeten ontwikkelaars grondig begrijpen hoe ze cbc-elementen moeten invullen in overeenstemming met de Peppol BIS-richtlijnen, zodat zowel de naleving als een vlotte verzending worden gegarandeerd. Het is essentieel om de vereiste syntaxis voor alle documentelementen na te leven, aangezien afwijkingen van de validatieregels van Peppol kunnen leiden tot fouten die het bestelproces verstoren.

Hier volgen enkele voorbeelden van kernelementen voor orderdocumenten:

Gegevensweergave: 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) specificeren welke cbc-elementen verplicht, optioneel of voorwaardelijk vereist zijn.

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

Voor meer informatie over specifieke cbc-elementen die worden gebruikt bij Peppol UBL-bestellingen, raadpleeg de officiële Peppol BIS Ordering .

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

Meer informatie over toegang tot Peppol-bestellingen via Order API.

Validatie zorgt ervoor dat de regels van Peppol en de BIS-vereisten worden nageleefd. Implementeer robuuste validatiecontroles om fouten vóór verzending op te sporen. Controleer bijvoorbeeld verplichte velden zoals cbc:ID en cbc:DocumentCurrencyCode. Valideer gegevensformaten, waaronder datums, valuta's en identificatiegegevens.

Formaatvalidaties zijn ingebouwd en geautomatiseerd voor gebruikers van Qvalia's Peppol Access Point.

Test de integratie in een sandbox-omgeving van uw Access Point-provider 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 verzendadviesberichten.

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 belangrijke metadata over de bestelling.

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

Elke orderregel specificeert de artikelen, hoeveelheden en prijzen.

Met de BIS Despatch Advice kunnen leveranciers kopers informeren over 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 sommige sectoren of regio's specifieke aanpassingen vereisen.
Automatiseer validatie: Implementeer geautomatiseerde controles voor syntaxis en inhoudscontrole vóór verzending.
Beveilig gegevens: Zorg ervoor dat alle verzonden gegevens voldoen aan de AVG en andere privacyregels.

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