Übersicht der Verbindungsmethoden für Entwickler: REST API, SFTP und HTTPS. Mit direkten Links zur PSB-Dokumentation.
Ist Ihre Software nicht in der Liste der fertigen Verbindungen aufgeführt, oder entwickeln Sie selbst eine Anwendung, die Rechnungen über Peppol versenden und empfangen soll? Dann können Sie direkt mit dem eConnect Procurement Service Bus (PSB) integrieren. Der PSB ist das technische System hinter allen eConnect-Verbindungen, erreichbar über psb.econnect.eu. Die eConnect-Plattform (platform.econnect.eu) ist die Kundenoberfläche, in der Sie unter anderem Verbindungsschlüssel erstellen und Ihre Einstellungen verwalten. Der PSB bietet drei Verbindungsmethoden: eine moderne REST API, SFTP und HTTPS.
Welche Methode am besten passt, hängt von Ihrer Architektur, Ihren Sicherheitsanforderungen und dem erwarteten Volumen ab. Für jede Methode finden Sie die technische Dokumentation auf dem PSB-Entwicklerportal.
Die am häufigsten verwendete Methode für neue Integrationen. Die PSB REST API bietet Endpunkte zum Versenden, Empfangen und Verwalten von Rechnungen, Bestellungen und Antworten. Die Authentifizierung erfolgt über OAuth2, mit zwei verfügbaren Flows: Resource Owner Password Credentials und Client Credentials. Tokens werden über POST /connect/token auf identity.econnect.eu angefordert. Optional kann ein Subscription-Key-Header für organisationsspezifischen Zugang mitgegeben werden.
Geeignet für: SaaS-Anwendungen, Webanwendungen, Microservices und moderne Architekturen.
Dokumentation: PSB API & Swagger UI: interaktive API-Dokumentation, OpenAPI-Spezifikation und Swagger Editor.
Dateiaustausch über eine gesicherte SFTP-Verbindung. Die PSB unterstützt zwei Flows: From SFTP (periodisches Abholen von Dateien von Ihrem SFTP-Server) und To SFTP (Dokumente bei Empfang auf Ihren Server pushen). Beide Flows werden über SFTP-Hooks in der PSB konfiguriert.
Geeignet für: Enterprise-Umgebungen mit Batch-Verarbeitung, ERP-Systeme wie SAP und Unit4 ERP CR.
Dokumentation: PSB API & Hooks: suchen Sie nach SFTP-Hooks in den Hook-Endpunkten.
Eine direkte HTTPS-Verbindung für den Rechnungsaustausch. Die PSB empfängt Dokumente über HTTPS POST und liefert sie über Webhooks oder HTTPS Inbound aus. Unterstützt IP-Whitelisting und OAuth2.
Geeignet für: Enterprise-Verbindungen mit spezifischen Sicherheitsanforderungen.
Dokumentation: PSB API & Webhooks: HTTPS Inbound/Outbound und Webhook-Konfiguration.
Technisch: Der PSB kommuniziert intern über das Peppol AS4-Protokoll mit anderen Access Points. Dies ist keine Verbindungsmethode, die Sie als Kunde wählen; sie wird automatisch verwendet, wenn Sie Rechnungen über Peppol versenden.
Für jede Integration mit der PSB benötigen Sie:
Der schnellste Weg zum Start führt über die REST API: öffnen Sie psb.econnect.eu, erkunden Sie die Swagger UI und machen Sie Ihren ersten API-Aufruf. Weitere Erläuterungen finden Sie im Abschnitt API & Integration dieser Dokumentation.
Für SFTP- oder HTTPS-Verbindungen kontaktieren Sie die Vertriebsabteilung von eConnect für ein Intake-Gespräch. Dabei werden die technischen Details, das erwartete Volumen und die Sicherheitsanforderungen besprochen. Die technischen Spezifikationen finden Sie in der PSB API-Dokumentation.
Tipp: Entwickeln Sie eine Integration für ein Softwarepaket, das von mehreren Kunden genutzt wird? Dann kontaktieren Sie das Partnerteam von eConnect. Als Partner können Sie die Verbindung einmalig entwickeln und für alle Ihre Kunden verfügbar machen.
Die REST API ist die am häufigsten verwendete Methode für neue Integrationen und eignet sich für SaaS-Anwendungen und moderne Architekturen. SFTP ist ideal für Enterprise-Umgebungen mit Batch-Verarbeitung. HTTPS eignet sich für Verbindungen mit spezifischen Sicherheitsanforderungen und IP-Whitelisting.
Sie benötigen ein eConnect-Konto mit mindestens einem Professional-Abonnement für SFTP und HTTPS. Für die REST API benötigen Sie OAuth2-Credentials (client_id und client_secret). Enterprise-Protokolle erfordern einen Subscription Key über die Vertriebsabteilung.
Ja, kontaktieren Sie das Partnerteam von eConnect. Als Partner können Sie die Verbindung einmalig entwickeln und für alle Ihre Kunden verfügbar machen. Die PSB bietet dafür die technische Infrastruktur.
Bereit zum Starten? Öffnen Sie die PSB API-Dokumentation oder lesen Sie die PSB-Übersicht für mehr Kontext.
API-Dokumentation ansehen