Übersicht über die Procurement Service Bus (PSB) API von eConnect: Architektur, Funktionen und Dokumenttypen.
Der Procurement Service Bus (PSB) ist das zentrale API-Gateway von eConnect, über das Sie E-Rechnungen, Bestellungen und andere E-Dokumente versenden, empfangen und verarbeiten. Der PSB verbindet Ihre Software mit dem Peppol-Netzwerk und anderen E-Rechnungsnetzwerken über eine moderne REST API mit OAuth2-Sicherheit.
Ob Sie ein Softwareanbieter sind, der E-Rechnungen integrieren möchte, oder eine Organisation, die Dokumentenflüsse automatisieren will: der PSB bietet die Infrastruktur, um dies zuverlässig und skalierbar zu tun.
Der PSB ist mehr als ein Versandkanal. Er ist eine vollwertige Plattform für die Verarbeitung von E-Dokumenten, mit Funktionalität, die den gesamten Purchase-to-Pay-Prozess abdeckt.
E-Rechnungen bilden den Kern. Über die API versenden Sie Ausgangsrechnungen an Empfänger im Peppol-Netzwerk und empfangen Eingangsrechnungen von Lieferanten. Der PSB leitet Dokumente automatisch an den richtigen Access Point weiter und bestätigt die Zustellung mit Echtzeit-Statusaktualisierungen.
E-Ordering geht über die Rechnungsstellung hinaus. Der PSB unterstützt das Senden und Empfangen von Bestellungen, Bestellbestätigungen, Bestelländerungen und Stornierungen. Standardmäßig werden nur Peppol-Bestellungen unterstützt (Order Only und Advanced Ordering); DICO-Nachrichten (einschließlich Wartungsnachricht) sind wo zutreffend verfügbar, und Coupa-Bestellungen (cXML) auf Anfrage. Order-Flip (eine Bestellung mit einer Aktion in eine Rechnung umwandeln) ist keine PSB-Funktion; dies ist ausschließlich auf der Collabrr-Plattform verfügbar.
Self-Billing ermöglicht es, im Namen eines Lieferanten Rechnungen zu erstellen und zu versenden. Dies ist relevant für Organisationen, die Eingangsrechnungen selbst auf Basis empfangener Waren oder Dienstleistungen erstellen.
Validierung bietet einen eigenständigen Endpoint, mit dem Sie XML-Dokumente auf Korrektheit prüfen können, ohne sie zu versenden. Die Validate API erkennt das Dokumentformat automatisch, prüft gegen die aktuellsten Artefakte und liefert detailliertes, mehrsprachiges Feedback pro Validierungsregel.
Transformation konvertiert Dokumente von einem E-Rechnungsformat in ein anderes. Sie liefern im Format Ihrer Software an, und der PSB sorgt automatisch für die richtige Konvertierung zum Empfänger. Der PSB unterstützt mehr als 20 Standards, darunter UBL 2.1, NLCIUS, Peppol BIS Billing V3, PINT, CII, XRechnung, Factur-X/ZUGFeRD, FatturaPA, ebInterface, Svefaktura, e-FFF, OIOUBL, Finvoice, ISDOC sowie branchenspezifische Formate wie DICO, SETU und SEEF. Das Format wird beim Upload automatisch erkannt; Sie müssen nicht angeben, welches Format Sie einliefern.
Validated Party Data (VPD) ist eine GraphQL API, mit der Sie Parteidaten abfragen und verifizieren können. Prüfen Sie, ob eine Handelsregisternummer, OIN oder Umsatzsteuer-Identifikationsnummer tatsächlich zu einer bestimmten Organisation gehört, bevor Sie eine Rechnung versenden. In Control ist dieselbe Funktionalität unter dem kundenseitigen Namen Purple Pages bekannt.
Intelligent Document Recognition (IDR) konvertiert PDF-Rechnungen über OCR und KI in strukturiertes XML. Die IDR ist direkt über die PSB API steuerbar, mit konfigurierbaren Qualitätsstufen und Prioritäten.
Der PSB basiert auf dem Actor-Modell in einem Microsoft Azure Service Fabric Cluster. Das klingt technisch, aber die Vorteile sind konkret: Dokumente werden parallel über mehrere Server verarbeitet, ohne aufeinander zu warten. Bei einem Serverausfall wird die Verarbeitung automatisch auf einem anderen Knoten fortgesetzt, ohne Datenverlust.
In der Praxis bedeutet dies eine Verarbeitungszeit von weniger als 100 Millisekunden pro Dokument beim Versand, eine nachgewiesene Kapazität von 200.000 Nachrichten pro Stunde und eine Verfügbarkeit von 99,99 % (über acht Jahre ohne ungeplante Ausfallzeit).
Der PSB arbeitet als Peppol Access Point mit mehreren Access Points in der Standardkonfiguration. Das Volumen wird dynamisch über zuverlässige Queues verteilt. Jeder Mandant ist logisch isoliert: Es ist technisch unmöglich, auf Dokumente eines anderen Mandanten zuzugreifen. Der PSB läuft auf Microsoft Azure (Regionen Niederlande und Irland); die gesamte Datenverarbeitung findet innerhalb der EU/des EWR statt.
Mit einer einzigen API-Integration erhalten Sie Zugang zu mehreren Netzwerken. Der PSB leitet Dokumente automatisch an den richtigen Kanal weiter, basierend auf dem Empfänger.
Der PSB ist auf die europäische ViDA-Richtlinie (VAT in the Digital Age) vorbereitet, die ab dem 1. Juli 2030 Digital Reporting Requirements (DRR) für grenzüberschreitende B2B-Transaktionen vorschreibt. Beim Versand einer Rechnung generiert der PSB automatisch die DRR-Zusammenfassung aus den Rechnungsdaten und übermittelt diese an die zuständige Steuerbehörde. Als Integrator müssen Sie nichts Zusätzliches tun: Sie versenden Ihre Rechnung über die reguläre API und der PSB übernimmt die Berichterstattung.
Der PSB implementiert dafür das Peppol 5-Corner-Modell, bei dem der Access Point die CTC-Berichterstattung (Continuous Transaction Controls) im Namen des Absenders übernimmt. Statusnachrichten, Evidence Files und CTC-Berichterstattungsnachrichten sind im Dokumentpreis enthalten, ohne zusätzliche Kosten pro Nachricht.
Der PSB arbeitet ereignisgesteuert. Anstatt regelmäßig nach neuen Dokumenten zu pollen, können Sie Webhooks einrichten, die Ihre Anwendung sofort benachrichtigen, wenn relevante Ereignisse eintreten: eine Rechnung empfangen, eine Rechnung erfolgreich zugestellt, ein Fehler beim Versand, eine Invoice Response vom Empfänger.
Hooks unterstützen mehrere Aktionstypen: HTTPS-Webhooks, E-Mail-Benachrichtigungen, SFTP-Push und sogar Batch-Verarbeitung, bei der Dokumente periodisch als ZIP-Archiv bereitgestellt werden. Jeder Hook-Typ ist mit HMAC SHA256-Signaturen gesichert.
Der PSB verwendet OAuth 2.0 zur Authentifizierung und unterstützt sowohl Client Credentials als auch Resource Owner Password Credentials Flows. Die gesamte Kommunikation läuft über TLS 1.2 oder höher. Binäre Uploads werden automatisch auf Viren und Malware gescannt, und XML-Dokumente werden gegen Standard-Regelsets validiert.
Jeder Mandant arbeitet in einer logisch isolierten Umgebung. Der PSB verarbeitet Dokumente für mehr als 20.000 Organisationen.
Die PSB REST API (v1) ist in die folgenden Endpoint-Gruppen gegliedert:
Die vollständige Endpoint-Dokumentation mit Request- und Response-Formaten ist als interaktive Swagger UI verfügbar. Die zugehörige swagger.json können Sie herunterladen, um Client-Code zu generieren.
Bereit loszulegen? Die folgenden Artikel helfen Ihnen auf dem Weg, von der Beantragung eines Testkontos bis zum ersten API-Aufruf.
Die PSB bietet Endpoints für E-Rechnungen (Versand und Empfang), E-Ordering, Self-Billing, Validierung, Transformation, Parteidaten (VPD) und PDF-Erkennung (IDR). Mit einer einzigen API-Integration erhalten Sie Zugang zu Peppol und anderen Procurement-Netzwerken.
Die PSB verarbeitet Dokumente in weniger als 100 Millisekunden beim Versand, mit einer nachgewiesenen Kapazität von 200.000 Nachrichten pro Stunde. Die Verfügbarkeit beträgt 99,99 %, mit über acht Jahren ohne ungeplante Ausfallzeit.
Die PSB verwendet OAuth 2.0 zur Authentifizierung und unterstützt sowohl Client Credentials als auch Resource Owner Password Credentials Flows. Die gesamte Kommunikation läuft über TLS 1.2 oder höher.
Sie liefern im Format Ihrer Software ein. Der PSB erkennt das Dokumentformat automatisch und transformiert es in das vom Empfänger erwartete Format. Mehr als 20 Standards werden unterstützt, darunter UBL, NLCIUS, BIS Billing V3, PINT, CII, XRechnung, Factur-X, FatturaPA sowie branchenspezifische Formate wie DICO und SETU. Sie müssen sich keine Gedanken über das Format des Empfängers machen.
Der PSB ist ViDA-ready. Beim Versand einer Rechnung generiert der PSB automatisch die DRR-Zusammenfassung (Digital Reporting Requirement) aus den Rechnungsdaten und übermittelt diese an die zuständige Steuerbehörde. Als Integrator müssen Sie nichts Zusätzliches tun. Statusnachrichten, Evidence Files und CTC-Berichterstattungsnachrichten sind im Dokumentpreis enthalten.
Interaktive API-Dokumentation ansehen