Mehrere Zustellkanäle konfigurieren: Peppol, DICO, andere Procurement-Netzwerke, E-Mail-Fallback und Prioritäten.
Eine der leistungsfähigsten Eigenschaften der PSB ist die Multi-Channel-Zustellung: Über eine einzige API-Integration erreichen Sie Empfänger auf Peppol, anderen Procurement-Netzwerken und per E-Mail. Die PSB wählt automatisch den besten Kanal, Sie können die Zustellung aber auch selbst steuern.
Standardmäßig routet die PSB alle Rechnungen über Peppol. Das System prüft, ob der Empfänger auf Peppol registriert ist, und sendet die Rechnung über das Peppol-Netzwerk. Wenn der Empfänger nicht auf Peppol registriert ist, greift der Fallback-Mechanismus.
Durch die Konfiguration mehrerer Hooks mit Send*-Topics können Sie zusätzliche Kanäle aktivieren:
-0003:XC...) als IdentifierDie PSB wählt den Kanal anhand einer Prioritätsreihenfolge:
InvoiceSent hat Vorrang vor einem Wildcard-Hook&&-Klausel gewinnt beispielsweise gegen einen kürzeren Filter ohne diese Klausel1 < 02 < 10 < dico < peppol)Bevor Sie eine Rechnung versenden, können Sie über queryRecipientParty prüfen, welchen Kanal die PSB verwenden wird. Es gibt zwei Endpoints, einen pro Dokumenttyp:
POST /api/v1/{partyId}/salesInvoice/queryRecipientParty
POST /api/v1/{partyId}/purchaseOrder/queryRecipientParty
Der Body akzeptiert ein einfaches Array ["0106:12345678"] oder ein Objekt mit Meta-Attributen { "partyIds": [...], "metaAttributes": {...} }. Optionale Query-Parameter: ?preferredDocumentTypeId, ?includeOptions, ?documentFamily (nur beim purchaseOrder-Variant).
Die Antwort zeigt den ausgewählten Kanal und die verfügbaren Alternativen.
Innerhalb desselben queryRecipientParty-Aufrufs darf pro Scheme/Agency-Code (z. B. 0106, 0190, 0208, 9944) höchstens ein Identifier angegeben werden. Mehrere Identifiers in verschiedenen Schemes innerhalb desselben Aufrufs sind erlaubt.
Bei einem Verstoß antwortet die PSB mit:
EConnect.Psb.Models.EConnectException: 'Duplicate id agencies {code} requested.'
wobei {code} der Agency-Code ohne führende Null ist (Scheme 0208 → 208). Um mehrere Kandidaten innerhalb desselben Schemes zu testen, führen Sie separate API-Aufrufe durch -- einen pro Kandidat.
Für erweiterte Lookups inklusive Access Point-URL und Zertifikat steht der Peppol-Endpoint zur Verfügung:
GET /api/v1/peppol/deliveryOption?partyIds=...&documentFamily=...&isCredit=...&documentTypeIds=...&preferredDocumentTypeId=...
Die Antwort enthält partyId, documentTypeId, processId, protocol (As2/As4), url und certificate.
In manchen Fällen möchten Sie die automatische Kanalauswahl übersteuern. Das ist mit dem Queryparameter ?channel={hookId} an den Send-Endpoints möglich:
POST /api/v1/{partyId}/salesInvoice/send?channel=hook-123-abc
Dies zwingt die PSB, den angegebenen Kanal (Hook) zu verwenden, unabhängig von der automatischen Auswahl.
Eine häufig genutzte Kombination ist ein Peppol-Hook mit einem E-Mail-Hook als Fallback. Über Conditional Output Topics veröffentlicht der Peppol-Hook bei Zustellfehlern (HTTP 400, 404 oder 500) ein Send*Fallback-Topic, auf das der E-Mail-Hook hört. Wenn derselbe E-Mail-Hook auch explizit auf Send* hört (zusätzlich zu Send*Fallback), erscheint er automatisch als Kanal peppol-fallback in der queryRecipientParty-Antwort. Damit kann der aufrufende Code den Kanal über ?channel=peppol-fallback explizit wählen, was für Szenarien nützlich ist, in denen Peppol bewusst übersprungen wird.
eConnect transformiert UBL-Rechnungen automatisch in das cXML-Format, das Coupa erwartet. Die Verbindung erfordert:
Die Ariba-Verbindung arbeitet mit 1-zu-1-Handelsbeziehungen, anders als das offene Peppol-Netzwerk:
eConnect wandelt eine UBL-Rechnung in cXML um und liefert diese beim Ariba-Empfänger ab, auf die gleiche Weise wie bei der Coupa-Transformation oben. Der Onboarding-Prozess verläuft wie folgt:
SAP-Abonnementschwelle: für die automatisierte Versendung/den Empfang von cXML über Ihr eigenes ERP-System (über eConnect) ist mindestens das SAP-Abonnementniveau Silver (Enterprise) erforderlich. Dieses Niveau deckt Volumina von 25 bis 99 Dokumenten pro Jahr ab.
Die PSB konvertiert automatisch zwischen allen gängigen E-Rechnungsformaten. Wenn Sie eine Rechnung im NLCIUS-Format versenden, der Empfänger aber XRechnung erwartet, transformiert die PSB das Dokument automatisch. Dies funktioniert für alle unterstützten Standards: BIS Billing, NLCIUS, PINT, XRechnung, Svefaktura, ebInterface, DICO, SETU und weitere.
Die Transformation ist ab dem 10K-Paket verfügbar.
Die PSB unterstützt die Transformation in beide Richtungen zwischen SI 2.0 und SALES005:
Wichtig: SALES005-Rechnungen dürfen nicht über Peppol versendet werden. Das Versenden von SALES005 erfordert eine E-Mail-Kopplung. Multi-Channel-Zustellung löst dies: Sie senden primär über Peppol, mit automatischem Fallback auf E-Mail, wenn nötig.
Beim Versenden über E-Mail, SFTP oder HTTPS-Endpoint können Sie ein targetFormat angeben. Die PSB transformiert die Rechnung dann on-the-fly in das gewünschte Format. Ein Kunde, der eine UBL-Rechnung nach SALES005 konvertieren möchte, gibt beim Download oder Versand eine targetDocumentTypeId an -- die Rechnung wird dann automatisch transformiert.
Peppol unterstützt kein targetFormat (SALES005 ist über Peppol nicht zulässig). Auf allen anderen Kanälen -- E-Mail, SFTP, HTTPS -- ist targetFormat verfügbar.
Multi-channel Delivery ist nicht standardmäßig in der Basisdienstverlening enthalten und muss separat als eigenständiger Dienst/Konfiguration erworben werden. Wenden Sie sich an den TechSupport für die in Ihrer Situation verfügbaren Optionen.
Ein großes Unternehmen versendet Rechnungen an:
Alle Rechnungen werden über dieselbe API versendet (POST /api/v1/{partyId}/salesInvoice/send). Die PSB sorgt pro Rechnung für die richtige Zustellung, das richtige Format und den richtigen Kanal.
Die PSB wählt den Kanal anhand einer Prioritätsreihenfolge. PartyId-Level-Hooks haben Vorrang vor Environment-Level-Hooks, und spezifische Topics haben Vorrang vor Wildcards. Standardmäßig routet die PSB über Peppol. Wenn der Empfänger nicht auf Peppol ist, greift der konfigurierte Fallback (z. B. DICO, Coupa oder E-Mail).
Ja, mit dem Queryparameter ?channel={hookId} an den Send-Endpoints erzwingen Sie einen bestimmten Kanal. Dies überschreibt die automatische Kanalauswahl. Sie können vorab über queryRecipientParty prüfen, welchen Kanal die PSB wählen würde, und auf Basis dessen entscheiden, ob Sie übersteuern möchten.
Ja, Multi-Channel-Routing funktioniert für alle Dokumenttypen, die die PSB unterstützt, wie Gutschriften, Bestellungen und Bestellbestätigungen. Alle Dokumente werden über dieselbe API versendet, und die PSB sorgt pro Dokument für die richtige Zustellung, das richtige Format und den richtigen Kanal.
Benötigen Sie Hilfe bei der Einrichtung der Multi-Channel-Zustellung? Kontaktieren Sie TechSupport.
API-Referenz öffnen