Lobster Peppol Access Point

Referenzdokumentation für den Lobster Peppol-Zugangspunkt Service. Dieser Service ermöglicht den bidirektionalen Austausch von E-Rechnungen über unseren zertifizierten Peppol-Zugangspunkt.

Unterstützte Formate und Standards

Die gesamte Verarbeitung basiert auf dem UBL-Framework (Universal Business Language). Peppol BIS Billing 3.0 ist der Standard-Dokumententyp.

Neben BIS Billing werden folgende nationale Peppol-Formate (CIUS) unterstützt:

• NLCIUS (Niederlande)

• Weitere länderspezifische CIUS-Implementierungen

Nationale Formate

Wenden Sie sich an das Lobster Sales-Team oder Ihren Customer Success Manager, um die verfügbaren nationalen Formate für Ihre Zielländer zu besprechen.

Ausgang: Rechnungsversand über Peppol

Übermitteln Sie E-Rechnungen zur Validierung und zum Versand über das Peppol-Netzwerk. Rechnungen können im Format Peppol BIS Billing 3.0 (Standard) oder in einem nationalen Format eingereicht werden, sofern dieses für bestimmte Länder oder Geschäftspartner erforderlich ist.

Authentifizierung

Der Service verwendet HTTP Basic Authentication. Die Zugangsdaten erhalten Sie von Ihrem technischen Ansprechpartner oder dem Lobster Customer Success Team.

Validierung versus Verarbeitung

• Nur Validierung (validateonly=true) — Die Rechnung wird gegen das zutreffende Schema validiert, aber nicht an das Peppol-Netzwerk übermittelt.

• Vollständige Verarbeitung (validateonly=false, Standard) — Die Rechnung wird validiert und, sofern gültig, an das Peppol-Netzwerk weitergeleitet.

Zustellbestätigungen und Benachrichtigungen

Nach der Übermittlung einer E-Rechnung bestätigt eine Message Delivery Notification (MDN) die erfolgreiche Zustellung an den empfangenden Access Point.

Ist der Empfänger nicht über Peppol erreichbar, löst das System automatisch eine Fallback-Zustellung per E-Mail an die im UBL-Dokument hinterlegte Adresse aus.

Der Rechnungssteller kann diese Benachrichtigungen – Zustellbestätigung, Fallback-Zustellung oder Fehlermeldung – über einen der folgenden Kanäle empfangen:

• Eine oder mehrere konfigurierte E-Mail-Adressen

• Einen HTTP-Callback-Endpunkt

Callback-Payloads enthalten folgende Informationen:

• Transaktions-ID

• Zustellstatus (delivered, fallback_email_sent, failed)

• Fehlermeldungen (sofern zutreffend)

Ist bereits ein HTTP-Endpunkt für den Empfang eingehender Rechnungen konfiguriert, kann dieser auch für Status-Callbacks wiederverwendet werden.

Hinweis

Die Callback-Konfiguration wird vom Lobster Onboarding-Team durchgeführt. Stimmen Sie alle technischen Details mit Ihrem Customer Success Manager oder Ihrem technischen Ansprechpartner ab.

Eingang: Rechnungsempfang über Peppol

Für den Empfang eingehender Rechnungen konfigurieren Sie einen HTTP-Endpunkt (zum Beispiel https://ihredomain.de/invoice/receive). Rechnungen werden in ihrem Originalformat an diesen Endpunkt zugestellt – so wie sie aus dem Peppol-Netzwerk empfangen wurden. Es findet keine Formatkonvertierung statt.

Zugestellte Inhalte:

• UBL-XML-Dokumente mit Content-Type: application/xml

• Peppol BIS Billing 3.0 (häufigstes Format)

• Nationale Formate, wenn vom Geschäftspartner verwendet (zum Beispiel NLCIUS von niederländischen Lieferanten)

• Unverändert — Rechnungen werden im empfangenen Zustand zugestellt, um die Originalstruktur und die regulatorische Konformität zu wahren

Bestätigen Sie den erfolgreichen Empfang mit 200 OK.

Endpunkt- und Authentifizierungskonfiguration

Ihre Endpunkt-URL und die zugehörigen Zugangsdaten müssen im Lobster E-Invoicing Portal hinterlegt werden. Übermitteln Sie diese Angaben an Ihren technischen Ansprechpartner oder das Lobster Customer Success Team.

Installation

Für Kunden der Lobster Data Platform steht ein Paket mit vorkonfigurierten Vorlagenprofilen und Partnerkanälen zur Verfügung, das die Integration mit dem Peppol Access Point Service beschleunigt.

1. Klicken Sie Start → Mit Vorlage starten.

2. Klicken Sie in der Kachel des Templates Peppol Access Point API auf Installieren.

   Sie wechseln nun automatisch zu Integration → DataFlow → Designer.

   Der Dialog Paket importieren wird geladen. Er ist in vier Tabs untergegliedert:

   • Inhaltsverzeichnis — Listet alle enthaltenen Profile und DataFlows mit Typ, Name, Status und Version auf.

   • Konstanten — Zeigt im Paket enthaltene Konstanten an (in diesem Paket: 0).

   • Partner/Kanäle — Zeigt die im Paket enthaltenen Partner und Partnerkanäle mit Importoptionen an.

   • Information — Enthält ergänzende Informationen zum Paket.

Tab: Inhaltsverzeichnis

Der Tab Inhaltsverzeichnis zeigt alle im Paket enthaltenen Komponenten:

Das Paket enthält folgende Komponenten:

Hinweis

Profile mit dem Status Inaktiv sind Vorlagen, die nach dem Import für Ihre individuellen Mappings angepasst und aktiviert werden müssen. Profile mit dem Status Aktiv sind sofort einsatzbereit.

Gruppenauswahl

Wählen Sie die passenden lokalen Gruppen für die Profile aus oder erstellen Sie neue, indem Sie auf jedes Ordnersymbol in der Spalte Gruppe (Lokal) klicken.

Tab: Partner/Kanäle

Der Tab Partner/Kanäle zeigt die im Paket enthaltenen Partner und Partnerkanäle an. In diesem Paket ist ein Partner mit einem Partnerkanal enthalten. Wenn die Option zum Überschreiben nicht aktiviert ist, wird der Partnerkanal durch ein Update nicht verändert, sodass Sie den Connector bedenkenlos aktualisieren können.

Folgende Optionen stehen zur Verfügung:

• Partner importieren — Importiert den im Paket enthaltenen Partner (Lobster Peppol Access Point) mit dem zugehörigen HTTPS-Kanal. Diese Option ist standardmäßig aktiviert.

• Partner/Kanäle überschreiben — Überschreibt bereits vorhandene Partner und Kanäle mit gleichem Namen. Aktivieren Sie diese Option nur, wenn Sie eine bestehende Konfiguration bewusst ersetzen möchten.

Wichtig

Wenn der Partner Lobster Peppol Access Point bereits in Ihrer Umgebung existiert und Sie individuelle Anpassungen vorgenommen haben, lassen Sie die Option Partner/Kanäle überschreiben deaktiviert, um Ihre Konfiguration nicht zu überschreiben.

Import abschließen

Prüfen Sie die angezeigten Komponenten in allen Tabs und klicken Sie auf Importieren, und bestätigen Sie, um den Import zu starten.

2. Zugangsdaten konfigurieren

Zugangsdaten für den Rechnungsversand

• Benutzername und Passwort für die Lobster E-Invoicing HTTPS-Endpunkte.

• Die Zugangsdaten erhalten Sie vom Lobster Customer Success Team.

Zugangsdaten für den Rechnungsempfang

• Stellen Sie Ihre Endpunkt-URL bereit.

• Legen Sie einen Benutzernamen und ein Passwort für die Authentifizierung fest.

Partnerkanal-Konfiguration

Das DataFlow-Paket enthält folgende vorkonfigurierten Komponenten:

• Partner: Lobster Peppol Access Point

• HTTPS-Kanal: peppol_ap

Navigation:Administration → Partner → Partners/Channels → Lobster Peppol Access Point → peppol_ap

Ausgangs-Zugangsdaten konfigurieren

• Bereich: Own ID

• Tragen Sie den Benutzernamen und das Passwort ein, die Sie vom Customer Success Team erhalten haben.

  

Eingangs-Zugangsdaten konfigurieren

• Bereich: Partner ID (Partner towards me)

• Erstellen Sie einen Benutzernamen und ein Passwort.

• Übermitteln Sie diese Zugangsdaten an das Lobster Customer Success Team.

  

Endpunkt-URL mitteilen

URL-Format:<ihr-servername>/dw/request/<endpoint-uri>

Endpunkt-URI ermitteln:

• Profil: TEMPLATE_PEPPOL_AP_receiveUblInvoice_BisBilling3.0

• Phase 1 → URL Address

  

3. Vorlagenprofile für eigene Mappings verwenden

Das Paket enthält Vorlagenprofile für beide Richtungen: Versand und Empfang von UBL-Rechnungen.

Rechnungsversand

Smoke-Test und Mapping-Beispiel:TEMPLATE_PEPPOL_AP_sendUblInvoice_smoketestExample

• Verwendet Ihre Zugangsdaten zur Verbindung mit dem Peppol Access Point Service.

• Enthält ein 1:1-Beispielmapping für Peppol BIS Billing 3.0.

• Für einen Smoke-Test klicken Sie mit der rechten Maustaste auf das Profil und wählen Sie Restart → Start Cron.

Anpassbare Vorlage:TEMPLATE_PEPPOL_AP_sendUblInvoice_BisBilling3.0

• Verwenden Sie diese Vorlage zum Versand von UBL-Rechnungen über den Peppol Access Point Service.

• Ersetzen Sie die Quellstruktur durch Ihr eigenes Rechnungsformat.

• Mappen Sie Ihr Format auf die vorbelegte UBL-Zielstruktur.

Synchrone HTTP-Antwortverarbeitung:TEMPLATE_PEPPOL_AP_receiveHttpResponse

• Verarbeitet die synchrone HTTP-Antwort, die vom Versandprofil zurückgegeben wird.

• Ersetzen Sie die Zielstruktur durch Ihr eigenes Format.

• Verarbeiten Sie die Antwort gemäß Ihren Anforderungen.

Asynchrone Statusbenachrichtigungen:TEMPLATE_PEPPOL_AP_receiveStatus

• Stellt einen Callback-Endpunkt für asynchrone Statusbenachrichtigungen des Peppol Access Point bereit (zum Beispiel Zustellbestätigungen oder Fehlermeldungen).

• Ersetzen Sie die Zielstruktur durch Ihr eigenes Format.

• Verarbeiten Sie die empfangenen Statusbenachrichtigungen gemäß Ihren Anforderungen.

Rechnungsempfang

Vorlage:TEMPLATE_PEPPOL_AP_receiveUblInvoice_BisBilling3.0

• Verwenden Sie diese Vorlage zum Empfang von UBL-Rechnungen über den Peppol Access Point Service.

• Ersetzen Sie die Zielstruktur durch Ihr eigenes Rechnungsformat.

• Verarbeiten Sie die empfangenen Rechnungen gemäß Ihren Anforderungen.

Support

Bei Fragen zur DataFlow-Konfiguration wenden Sie sich an das Lobster Customer Success Team. Stellen Sie sicher, dass alle Zugangsdaten korrekt konfiguriert sind, bevor Sie die Konfiguration produktiv schalten.

Kontakt

Lobster DATA GmbH
https://www.lobster-world.com/
support@lobster.cloud

Server

Produktion

Produktivumgebung für den Rechnungsversand über das Peppol-Netzwerk.

https://connect-data-network.lobster-cloud.com

Staging

Testumgebung für den Rechnungsversand über das Peppol-Netzwerk.

https://connect-test-data-network.lobster-cloud.com

Kunden-Webhook-Endpunkt

Ihr Endpunkt für den Empfang von Rechnungen aus dem Peppol-Netzwerk.

https://{customer-domain}

Servervariablen

customer-domain — Ihre Webhook-Endpunkt-Domain, wie im Lobster E-Invoicing Portal konfiguriert.