Lopster Peppol Access Point

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

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.

Vorlagenpaket

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.

→ Paket herunterladen

1. Konfiguration importieren

Paketimport

1. Navigieren Sie zu Integration → DataFlow → Designer.

2. Wählen Sie eine bestehende Gruppe aus oder erstellen Sie eine neue.

3. Rechtsklick auf die Gruppe → Import Package.

4. Wählen Sie das heruntergeladene DataFlow-Paket: TEMPLATE_PEPPOL_AP_profile_package.dataflow.

Gruppenauswahl

1. Wählen Sie die passenden Gruppen für die Profile aus.

   

2. Klicken Sie auf Import und bestätigen Sie mit Import Package.

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.