Peppol für Entwickler: Erste Schritte mit elektronischen Bestellungen

Peppol ist ein internationales, offenes B2B-Netzwerk, das es Unternehmen ermöglicht, strukturierte Geschäftsdokumente wie Bestellungen und Rechnungen effizient auszutauschen.

Das Verständnis der technischen Spezifikationen und des Implementierungsprozesses von Peppol ist für Entwickler von entscheidender Bedeutung, um robuste Systeme zu entwickeln, die die organisatorische Effizienz steigern. Dieser Leitfaden umreißt die wichtigsten Konzepte und technischen Anleitungen für Entwickler, die mit elektronischen Bestellungen mit Peppol beginnen wollen.

Peppol (Pan-European Public Procurement Online) ist ein Rahmenwerk, das den elektronischen Dokumentenaustausch zwischen Unternehmen und öffentlichen Organisationen standardisiert. Es handelt sich nicht um ein ERP-System, ein Portal oder eine Beschaffungsplattform, sondern um ein Protokoll, das die Interoperabilität zwischen verschiedenen Systemen ermöglicht.

Peppol verwendet das Vier-Ecken-Modell, d. h. jede Organisation verbindet sich über den von ihr gewählten Peppol Access Point-Anbieter mit dem Netzwerk, wodurch die Notwendigkeit entfällt, Dienstanbieter mit Geschäftspartnern abzustimmen.

Die wichtigsten Merkmale von Peppol sind:

Die Implementierung elektronischer Bestellungen in Peppol erfordert ein Verständnis der Business Interoperability Specifications (BIS), der Nachrichtensyntax und der Datenaustauschanforderungen.

Im Folgenden finden Sie eine Aufschlüsselung der sechs wichtigsten Schritte und ihrer technischen Aspekte.

Entwickler, die Peppol-Rechnungen implementieren, müssen wissen, wie sie die cbc-Elemente gemäß den Peppol-BIS-Richtlinien richtig ausfüllen, um die Übereinstimmung mit den Dokumenten und eine erfolgreiche Übertragung zu gewährleisten.

Im Zusammenhang mit Peppol und der UBL-Syntax (Universal Business Language) für Rechnungen steht cbc für Common Basic Components. Diese vordefinierten Datenelemente innerhalb des UBL-Schemas stellen grundlegende, wiederverwendbare Bausteine von Geschäftsdokumenten wie Rechnungen, Bestellungen und Versandanzeigen dar.

Peppol unterstützt drei Hauptspezifikationen, auch Profile genannt, für Bestellprozesse. Jedes BIS ist für bestimmte Anwendungsfälle konzipiert, und die Geschäftspartner müssen sich darauf einigen, welches zu verwenden ist.

BIS Order Only: Für einfache Bestellungen ohne Antwort des Lieferanten.
BIS Ordering: Enthält Bestellungsantworten zur Bestätigung der Annahme, Ablehnung oder Teilannahme.
BIS Despatch Advice: Informiert den Käufer über Versanddetails.

Die Peppol Order Transaktion (T01) folgt der UBL (Universelle Geschäftssprache) Standard.

Um Peppol effektiv zu implementieren, müssen die Entwickler genau wissen, wie sie die cbc-Elemente gemäß den Peppol-BIS-Richtlinien ausfüllen, um sowohl die Einhaltung der Vorschriften als auch eine reibungslose Übertragung zu gewährleisten. Die Einhaltung der erforderlichen Syntax für alle Dokumentelemente ist von entscheidender Bedeutung, da Abweichungen von den Peppol-Validierungsregeln zu Fehlern führen können, die den Bestellprozess stören.

Im Folgenden finden Sie einige Beispiele für Kernelemente von Auftragsdokumenten:

Datendarstellung: cbc-Elemente stellen in der Regel einzelne Datenfelder dar, wodurch sie einfach zu verwenden und zu validieren sind.
Attribute: Einige cbc-Elemente enthalten Attribute wie currencyID (für Beträge) oder unitCode (für Mengen).
Obligatorisch/optional: In den Peppol BIS-Richtlinien (Business Interoperability Specification) ist festgelegt, welche cbc-Elemente obligatorisch, optional oder bedingt erforderlich sind.

Während cbc für Basiskomponenten steht, wird cac (Common Aggregate Components) für komplexe Datenstrukturen verwendet, die verwandte cbc- und andere cac-Elemente zusammenfassen. Zum Beispiel fasst cac:Party alle Informationen über eine Wirtschaftseinheit zusammen, wie Name, Adresse und Identifikatoren.

Weitere Einzelheiten zu bestimmten cbc-Elementen, die in der Peppol-UBL-Bestellung verwendet werden, finden Sie in der offiziellen Peppol-Dokumentation BIS Ordering .

Peppol-Transaktionen werden über zertifizierte Peppol-Zugangspunkte, auch Peppol-Service-Provider genannt, verteilt. Als Entwickler muss sich Ihre Anwendung mit der API eines Anbieters verbinden, um Dokumente zu übertragen und zu empfangen. Die Zugangspunkte kümmern sich um die technische Komplexität der Weiterleitung von Nachrichten an und von Handelspartnern.

Erfahren Sie mehr über den Zugriff auf Peppol-Bestellungen über die Order API.

Die Validierung gewährleistet die Einhaltung der Peppol-Regeln und der BIS-Anforderungen. Implementieren Sie robuste Validierungsprüfungen, um Fehler vor der Übertragung zu erkennen. Prüfen Sie zum Beispiel Pflichtfelder wie cbc:ID und cbc:DocumentCurrencyCode. Validieren Sie Datenformate, einschließlich Daten, Währungen und Bezeichner.

Die Formatvalidierung ist für Benutzer des Peppol Access Point von Qvalia integriert und automatisiert.

Bevor Sie Ihre Lösung einsetzen, sollten Sie die Integration in einer Sandbox-Umgebung testen, die Ihnen Ihr Access Point-Anbieter zur Verfügung stellt. Auf diese Weise können Sie verschiedene Szenarien simulieren, z. B. die Übermittlung von Bestellungen, den Empfang von Antworten und die Verwaltung von Versandanzeigen.

Peppol-Aufträge basieren auf XML-basierten UBL-Schemata. Im Folgenden finden Sie einen kurzen Überblick über die wichtigsten Elemente der Auftragsstruktur:

Die Kopfzeile enthält wichtige Metadaten über die Bestellung.

Der Käufer und der Verkäufer werden durch die Segmente cac:BuyerCustomerParty und cac:SellerSupplierParty definiert.

In jeder Auftragszeile werden die Artikel, die Mengen und die Preise angegeben.

Die Spezifikation BIS Despatch Advice ermöglicht es den Lieferanten, die Käufer über die Einzelheiten der Lieferung zu informieren.

Die Nachricht kann Folgendes enthalten:

Befolgen Sie die Peppol BIS-Richtlinien: Halten Sie sich immer an die offizielle Peppol BIS-Dokumentation, um die Konformität zu gewährleisten.
Beachten Sie lokale Abweichungen: Peppol ist zwar ein globaler Standard, aber einige Sektoren oder Regionen können spezifische Anpassungen erfordern.
Automatisieren Sie die Validierung: Führen Sie vor der Übermittlung automatische Überprüfungen auf Syntax- und Inhaltskonformität durch.
Daten sichern: Stellen Sie sicher, dass alle übertragenen Daten mit der GDPR und anderen Datenschutzbestimmungen übereinstimmen.

Peppol bietet einen robusten Rahmen für elektronische Bestellungen, der es Unternehmen ermöglicht, Abläufe zu rationalisieren und die Datengenauigkeit zu verbessern. Für Entwickler ist das Verständnis der technischen Spezifikationen von Peppol BIS, der UBL-Schemata und der Access Point-Integration entscheidend, um skalierbare und effiziente Lösungen zu erstellen.