peppol.sh

Einführung

peppol.sh ist eine Peppol-E-Rechnungs-API, die Unternehmen dabei hilft, konforme E-Rechnungen zu versenden, ohne das Peppol-Netzwerk selbst verwalten zu müssen. Anstatt sich mit UBL-Schemata, SMP-Abfragen oder der Einrichtung von Access Points herumzuschlagen, können Entwickler einen einfachen API-Aufruf mit JSON-Daten durchführen und peppol.sh die Konvertierung und Zustellung überlassen.

---

Was ist peppol.sh?

peppol.sh ist eine Peppol-E-Rechnungs-API und ein API-first-E-Rechnungsservice für das Peppol-Netzwerk. Es löst ein echtes Problem: Die Peppol-E-Rechnungsstellung erfordert Validierung, Registrierung und Kommunikation mit zertifizierten Access Points. peppol.sh bündelt diesen gesamten Prozess in einem einzigen REST-API-Aufruf.

Der Service akzeptiert JSON-Payloads, konvertiert sie in Peppol-BIS-3.0-UBL, validiert Dokumente gegen EN 16931 und stellt sie über das Peppol-Netzwerk zu. Außerdem enthält er ab der Anmeldung eine Sandbox-Umgebung, sodass Nutzer sofort Peppol-Rechnungen senden und die Integration testen können, bevor sie live gehen. Das macht peppol.sh zu mehr als einem einfachen Konvertierungstool: Es ist eine vollständige Peppol-E-Rechnungs-API für moderne Softwareteams.

Warum ist das wichtig? Die europäischen E-Rechnungspflichten werden ausgeweitet. ViDA wird bis 2030 eine strukturierte E-Rechnungsstellung in der gesamten EU verlangen, und mehrere Mitgliedstaaten setzen dies bereits heute durch. Für Softwareteams bedeutet das, dass sie einen zuverlässigen Weg brauchen, um E-Rechnungs-Konformität zu erreichen, ohne selbst Peppol-Experten zu werden. peppol.sh schließt diese Lücke.

Hauptfunktionen von peppol.sh

Die Hauptstärke dieser Peppol-E-Rechnungs-API ist, dass jeder Prozess automatisiert ist.

Dokumentversand mit einem einzigen Aufruf

Senden Sie einen JSON-Payload an den /v1/documents-Endpunkt, und das Dokument wird zur Zustellung eingereiht. Keine mehrstufigen Abläufe, keine manuelle Peppol-Konfiguration. Das ist der Kern der Peppol-E-Rechnungs-API-Erfahrung.

JSON-zu-UBL-Konvertierung

peppol.sh konvertiert JSON automatisch in gültiges Peppol-BIS-3.0-UBL. Dadurch entfällt die Notwendigkeit, UBL-Syntax zu erlernen oder komplexe Transformationsvorlagen zu pflegen.

Integrierte E-Rechnungs-Konformität

Der Service übernimmt die EN-16931-Validierung und arbeitet als zertifizierter Peppol-Access-Point. Das erleichtert die Erfüllung der E-Rechnungs-Konformitätsanforderungen in der EU.

Sandbox ab dem ersten Tag

Jedes Konto startet im Sandbox-Modus. Entwickler können Peppol-Rechnungen mit einem ps_test_-Schlüssel senden, und Sandbox-Zustellungen werden per E-Mail versendet. Keine Benutzeroberfläche, keine Genehmigung, keine Kreditkarte.

Zustellungsverfolgung und Webhooks

Jedes Dokument hat einen Statusendpunkt, und Webhooks informieren über Zustellungsereignisse. Teams können prüfen, ob jede Rechnung den Empfänger tatsächlich erreicht.

Teilnehmersuche

Ein Lookup-Endpunkt ermöglicht es Ihnen, vor dem Versand zu prüfen, ob ein Unternehmen bei Peppol registriert ist. Das hilft, fehlgeschlagene Zustellungen zu vermeiden.

Stripe-App für automatischen Versand

Für Stripe-Nutzer: Die offizielle App lauscht auf invoice.finalized-Events und sendet die Rechnung automatisch über das Peppol-Netzwerk. Für diesen Weg sind keine Codeänderungen erforderlich.

KI-Agent-bereit

peppol.sh enthält eine SKILL.md-Datei und einen MCP-Server, sodass KI-Agenten Konten erstellen, Rechnungen senden und die Zustellung eigenständig verfolgen können. Das passt zum API-first-Design.

Anwendungsfälle für peppol.sh

SaaS und E-Commerce-Checkout

Nach der Zahlung durch einen Kunden kann das System über peppol.sh Peppol-Rechnungen an dessen Unternehmen senden. Das ist nützlich für SaaS-Produkte, E-Commerce-Shops und Dienstleistungsunternehmen.

Integration in Buchhaltungs- und ERP-Systeme

Buchhaltungsplattformen können den Peppol-Versand in ihr Produkt integrieren. Jeder Mandant erhält eine Unternehmensidentität, aber es gibt keine Gebühren pro Mandant oder Mindestmonatsbeträge.

Automatisierte Abrechnungsworkflows

Finanzteams und Entwickler können vollständig API-gesteuerte Abrechnungsabläufe aufbauen. Von der Anmeldung über KYC bis zum Live-Versand kann jeder Schritt automatisiert werden.

KI-Agenten und interne Tools

Da die gesamte API bootstrap-fähig ist, können KI-Agenten oder interne Skripte Workspaces erstellen, Rechnungen senden und den Status prüfen, ohne ein Dashboard zu öffnen.

So verwenden Sie peppol.sh

Die Nutzung dieser Peppol-E-Rechnungs-API basiert auf einigen einfachen Schritten.

1. Erstellen Sie ein Konto mit einer einzigen curl-Anfrage an /v1/signup und erhalten Sie sofort einen Sandbox-API-Schlüssel.
2. Verwenden Sie den ps_test_-Schlüssel, um Peppol-Rechnungen im Sandbox-Modus zu senden, und bestätigen Sie, dass die Antwort eine Dokumenten-ID enthält.
3. Schließen Sie KYC ab, indem Sie Dokumente über /v1/kyc/documents und /v1/kyc/submit hochladen und einreichen.
4. Erstellen Sie einen Live-API-Schlüssel und beginnen Sie, Rechnungen über den zertifizierten Peppol-Access-Point zu senden.

Es ist kein Browser erforderlich. Der gesamte Ablauf kann über das Terminal oder einen automatisierten Agenten durchgeführt werden.

Zielgruppe für peppol.sh

• Entwickler, die eine Peppol-E-Rechnungs-API möchten, ohne Infrastruktur verwalten zu müssen
• SaaS- und E-Commerce-Unternehmen
• Buchhaltungs- und ERP-Plattformen
• Abrechnungsanbieter und Fintech-Unternehmen
• KI-Agent-Entwickler und Automatisierungsteams
• Unternehmen, die sich auf EU-E-Rechnungspflichten vorbereiten

Ist peppol.sh kostenlos?

peppol.sh bietet eine kostenlose Sandbox-Umgebung und transparente Preise pro Dokument für den Live-Versand.

Diese Preisstruktur macht die Peppol-E-Rechnungs-API sowohl für kleine Teams als auch für große Plattformen zugänglich. Bei der Anmeldung ist keine Kreditkarte erforderlich, und Guthaben verfällt nie.

Vor- und Nachteile von peppol.sh

Häufig gestellte Fragen zu peppol.sh

Wie lange dauert es, bis man eine Peppol-E-Rechnungs-API nutzen kann?

Die Anmeldung erfolgt sofort über die API. Testrechnungen können innerhalb einer Minute im Sandbox-Modus gesendet werden. Für den Live-Betrieb sind eine KYC-Genehmigung und eine Workspace-Verifizierung erforderlich, aber für die Anmeldung gibt es weder ein Dashboard noch einen Genehmigungsschritt.

Funktioniert peppol.sh in jedem EU-Land?

peppol.sh ist auf das Peppol-Netzwerk und Peppol BIS 3.0 ausgerichtet, das in Europa weit verbreitet ist. Käufer und Lieferanten müssen bei Peppol registriert sein, um Rechnungen über das Netzwerk zu senden und zu empfangen. Ein Lookup-Endpunkt hilft dabei, die Registrierung anhand des Namens oder der Steuernummer zu prüfen.

Was ist der Unterschied zwischen Sandbox- und Live-Schlüsseln?

Sandbox-Schlüssel beginnen mit ps_test_ und stellen Testrechnungen per E-Mail zu. Live-Schlüssel beginnen mit ps_live_ und stellen Rechnungen über das echte Peppol-Netzwerk zu. Die Workspace-Verifizierung wird einmalig durchgeführt, und Live-Schlüssel werden nach der Genehmigung erstellt.

Kann ich PDF-Rechnungen über peppol.sh senden?

Ja. Die Peppol-E-Rechnungs-API unterstützt JSON- und PDF-Upload als zwei Möglichkeiten, konforme Dokumente zu senden. JSON wird in UBL konvertiert, und PDFs werden laut Produktdokumentation als Dokumente eingereicht.

Gibt es einen kostenlosen Plan zum Testen?

Ja. Jedes Konto startet im Sandbox-Modus und bleibt für Tests dauerhaft kostenlos. Nutzer können vor der Erstellung eines Live-Workspace Testdokumente in der Sandbox senden.

Berechnet peppol.sh Gebühren pro Mandant?

Nein. Es gibt keine Gebühren pro Mandant und keinen Mindestmonatsbetrag. Die Preisgestaltung basiert auf der Anzahl der gesendeten Rechnungen, ab 0,10 € pro Rechnung.

peppol.sh-Tags

Peppol-E-Rechnungs-API, Peppol-Rechnungen senden, JSON zu UBL, Peppol BIS 3.0, E-Rechnungs-Konformität, Peppol-Access-Point, E-Rechnungs-API, Sandbox-Tests, Stripe-E-Rechnung, EU-E-Rechnungspflichten, automatisierte E-Rechnungsstellung, API-first-E-Rechnungsstellung