PunchOut für Vendure: OCI &amp; cXML per Open-Source-Plugin | PunchCommerce                       ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

  [Zum Inhalt springen](#main-content)

  Integration · Vendure 3 PunchOut für Vendure. Ihr Kunde fordert einen PunchOut, Sie haben Vendure. Sie liefern per Plugin.
====================================================================================================

 Ihr Großkunde will aus seinem Beschaffungssystem in Ihrem Shop bestellen, per OCI, cXML oder IDS Connect. Mit dem Open-Source-Plugin aus den Community-Plugins von Vendure binden Sie Ihren Shop an das Gateway an: Sie installieren das Plugin, ergänzen Ihre Storefront um Einstieg und Warenkorbübergabe und legen den Kunden in PunchCommerce an.

 [ Kostenlos testen ](https://www.punchcommerce.de/register) [ Einrichtung ansehen ](#einrichtung)

30 Tage kostenlos · keine Kreditkarte · jederzeit kündbar

  Protokolle: OCI, cXML und IDS Connect 3

 kostet das Open-Source-Plugin 0 €

 je Kunde und Monat, zzgl. MwSt. 49 €

 Plugin

Ein Plugin für Ihr Vendure-Backend, das Gateway für Ihren Kunden
----------------------------------------------------------------

Das Plugin verbindet Ihr Vendure-Backend mit dem PunchCommerce-Gateway; es tauscht mit PunchCommerce nur JSON über HTTPS aus, die Protokoll-Kommunikation übernimmt PunchCommerce.

 Für Vendure 3### PunchOut Gateway Plugin für Vendure

Open-Source-Plugin für die Gateway-Anbindung per OCI, cXML und IDS Connect, dazu:

- Parallele PunchOut-Sessions mit getrennten Warenkörben
- Versandkosten als eigene Warenkorbposition, einstellbar
- Mengeneinheit, Verpackungseinheit und Gewicht je Variante

  Version Vendure ab 3.0

 Laufzeit eine Storefront, die Sie anpassen können

 Bezugsquelle npm-Paket `@vendure-community/punchout-gateway-plugin`, Quellcode im Repository vendurehq/community-plugins auf GitHub

 Lizenz GPL-3.0-or-later, kostenlos

 Account aktiver PunchCommerce-Account

  [ Auf GitHub ansehen (öffnet in neuem Fenster) ](https://github.com/vendurehq/community-plugins/tree/main/packages/punchout-gateway-plugin) [Dokumentation zum Plugin](https://www.punchcommerce.de/de/documentation/vendure-punchout-erweiterung) [Vendure-Dokumentation (öffnet in neuem Fenster)](https://docs.vendure.io/current/community-plugins/punch-out-gateway-plugin)

 Konfiguration vendure-config.ts

 ```
import { PunchOutGatewayPlugin } from
    '@vendure-community/punchout-gateway-plugin';

export const config: VendureConfig = {
    plugins: [
        PunchOutGatewayPlugin.init({
            // ohne Optionen gelten die Standardwerte
        }),
    ],
};
```

Im Vendure-Admin tragen Sie beim Kunden im Feld „PunchOut Customer ID (uID)“ denselben Wert ein wie in PunchCommerce als Kundenkennung.

 Weil Vendure headless arbeitet, also nur das Backend liefert und die Storefront bei Ihnen liegt, übernimmt Ihre Storefront drei Aufgaben: Sie empfängt den Einkäufer auf einer PunchOut-Landingpage, zum Beispiel unter Ihrer Storefront-Adresse plus `/punchout`, führt seinen Warenkorb je PunchOut-Session und gibt ihn per Button an das Beschaffungssystem zurück. Eine vollständige Beispiel-Storefront stellt das Vendure-Team als [punchcommerce-storefront-demo (öffnet in neuem Fenster)](https://github.com/vendurehq/punchcommerce-storefront-demo) auf GitHub bereit.

 Die Protokolle übernimmt das Gateway: Es spricht mit dem Beschaffungssystem Ihres Kunden, etwa SAP Ariba, Coupa, Jaggaer oder SAP SRM, per [OCI-PunchOut](https://www.punchcommerce.de/de/oci-punchout) oder [cXML-PunchOut](https://www.punchcommerce.de/de/cxml-punchout) und gibt den Warenkorb im passenden Format zurück. Welches Protokoll gilt, legen Sie in PunchCommerce je Kunde fest. Handwerksbetriebe aus SHK und Elektro binden Sie aus derselben Vendure-Installation per [IDS Connect](https://www.punchcommerce.de/de/ids-connect) an.

 Sie betreiben weitere Shops auf anderen Systemen? Unter [Integrationen](https://www.punchcommerce.de/de/integrations) finden Sie alle Plugins, Erweiterungen und Anbindungswege.

 Einrichtung

In sechs Schritten vom Plugin zum Go-Live
-----------------------------------------

Alle Schritte stammen aus der Dokumentation zum Plugin. Die Schritte zwei bis vier betreffen Ihre Storefront, dort liegt bei Vendure der größte Teil der Arbeit. Ein PunchOut-Protokoll müssen Sie dafür nicht umsetzen.

1. 1 Sie · Backend### Plugin installieren

    Installieren Sie das npm-Paket `@vendure-community/punchout-gateway-plugin` und registrieren Sie das Plugin in der vendure-config.ts. Die Standardwerte reichen für den Start.
2. 2 Sie · Storefront### Landingpage anlegen

    Legen Sie in Ihrer Storefront eine Route wie `/punchout` an. Sie liest die Session-ID (sID) und die Kundenkennung (uID) aus der Adresse, legt die sID im sessionStorage ab und meldet den Einkäufer über die GraphQL-Mutation authenticate an.
3. 3 Sie · Storefront### Warenkorb an die Session binden

    Geben Sie bei allen Bestelloperationen activeOrderInput mit der sID mit. Sonst landen die Artikel im normalen Warenkorb des Kunden statt im Warenkorb der PunchOut-Session.
4. 4 Sie · Storefront### Checkout durch Übergabe ersetzen

    Ersetzen Sie den Checkout durch einen Button, der den Warenkorb per transferPunchOutCart übergibt. Läuft Ihr Shop im iFrame, setzen Sie die Session-Cookies auf SameSite=None; Secure und entfernen während der PunchOut-Session den Header X-Frame-Options.
5. 5 Sie · PunchCommerce### Kunden anlegen

    Legen Sie Ihren Kunden in PunchCommerce mit dem Protokoll OCI, cXML oder IDS Connect, einer eindeutigen Kundenkennung und der Adresse Ihrer Landingpage als Einsprungadresse an. Denselben Wert wie die Kundenkennung tragen Sie im Vendure-Admin im Feld „PunchOut Customer ID (uID)“ ein.
6. 6 Sie · PunchCommerce### Testen und übergeben

    Ordnen Sie im Feldmapping zu, welche Shop-Daten in welchem PunchOut-Feld ankommen, und testen Sie den Ablauf mit dem PunchOut-Simulator. Danach geben Sie die Zugangsdaten an Ihren Kunden weiter.

###   Das brauchen Sie von Ihrem Kunden

- Das Protokoll seines Beschaffungssystems: OCI, cXML oder IDS Connect
- Den Warengruppen-Schlüssel, den sein System erwartet
- Die Mengeneinheiten, in denen er bestellt
- Einen Zugang zu seinem Testsystem für den Probelauf

###   Das schicken Sie Ihrem Kunden

- Die PunchOut-URL aus PunchCommerce
- Die Zugangsdaten, bei cXML `Identity` und `SharedSecret`
- Die Zugangsanleitung als PDF aus PunchCommerce

 Funktionen

Was das Plugin für Ihre PunchOut-Kunden mitbringt
-------------------------------------------------

Alle Funktionen stammen aus der Dokumentation zum Plugin. Nach der Übergabe wechselt die Bestellung in Vendure in den Status „Transferred“ und bleibt dort erhalten.

### Anmeldung über die uID

Das Plugin ergänzt Kunden in Vendure um das Feld „PunchOut Customer ID (uID)“. Stimmt der Wert mit der Kundenkennung in PunchCommerce überein, meldet Ihre Landingpage den Einkäufer an.

### Parallele Sessions

Jede PunchOut-Session bekommt einen eigenen, leeren Warenkorb. Derselbe Kunde kann mehrere Sessions gleichzeitig öffnen, ohne dass sich die Warenkörbe mischen.

### Brutto- und Nettopreise

Preise gehen als Brutto- und Nettowert an PunchCommerce. Die Cent-Beträge aus Vendure rechnet das Plugin in Dezimalwerte um.

### Versandkosten als Position

Sie stellen ein, ob Versandkosten immer, nur bei einem Wert über null oder nie als eigene Position im Warenkorb stehen.

### Einheiten und Gewicht je Variante

Mengeneinheit, Verpackungseinheit und Gewicht ordnen Sie festen Werten oder Custom Fields Ihrer Produktvarianten zu, mit Standardwert als Rückfall.

### Feldmapping und Simulator

Welche Daten in welchem Feld beim Kunden ankommen, ordnen Sie in PunchCommerce je Kunde zu. Den Ablauf prüfen Sie vorab mit dem PunchOut-Simulator.

  Nicht unterstützt: die Aufrufe detail, search und background-search, mit denen das Beschaffungssystem einzelne Artikel oder Suchergebnisse direkt aus Ihrem Shop abruft. Einsprung und Warenkorbübergabe sind davon nicht betroffen.

 Kosten

Was PunchOut für Vendure kostet
-------------------------------

Das Plugin ist Open Source und kostenlos. Sie zahlen je Kunde, den Sie in PunchCommerce anbinden. Gehostet wird DSGVO-konform in Deutschland.

 Für Ihren Fall Lieferant · selbst einrichten### PunchCommerce Business

Gateway-Anbindung Ihres Vendure-Shops per OCI, cXML und IDS Connect, eingerichtet von Ihnen, ohne Agentur. Drei angebundene Kunden kosten 147 € im Monat, zzgl. MwSt.

 49 € je Kunde und Monat, zzgl. MwSt.

Ohne eigenen Shop: plus Add-On Hosted Catalog, 50 € je Kunde und Monat, zzgl. MwSt.

 [ Kostenlos testen ](https://www.punchcommerce.de/register)30 Tage kostenlos · keine Kreditkarte · jederzeit kündbar

 [Tarife und Preise vergleichen](https://www.punchcommerce.de/de/features-and-pricing)

 Mit SLA &amp; Betriebsverantwortung### PunchCommerce Enterprise

Für Lieferanten, die Verfügbarkeit mit Uptime-Garantie, feste Eskalationswege und einen Verantwortlichen für den Betrieb ihrer PunchOut-Anbindungen brauchen.

 Individuell nach SLA-Level und Anzahl der Verbindungen

 [ Beratungstermin vereinbaren (öffnet in neuem Fenster) ](https://account.netzdirektion.de/appointments/punchcommerce)30 Min · remote · mit dem Gründer

 [PunchCommerce Enterprise ansehen](https://www.punchcommerce.de/de/enterprise)

 FAQ

Häufige Fragen zu PunchOut für Vendure
--------------------------------------

Was Vendure-Teams vor der ersten PunchOut-Anbindung wissen wollen.

 ###   Wo bekomme ich das PunchOut-Plugin für Vendure? +

 Das Plugin heißt @vendure-community/punchout-gateway-plugin und wird als npm-Paket installiert. Der Quellcode liegt im Repository vendurehq/community-plugins auf GitHub, die Lizenz ist GPL-3.0-or-later. Das Plugin ist kostenlos und setzt einen aktiven PunchCommerce-Account voraus.

###   Welche Voraussetzungen muss mein Vendure-Shop erfüllen? +

 Sie brauchen Vendure ab Version 3.0 und eine Storefront, die Sie anpassen können. Weil Vendure headless arbeitet, gehören eine PunchOut-Landingpage, ein an die PunchOut-Session gebundener Warenkorb und ein Button zur Warenkorbübergabe in Ihre Storefront.

###   Welche PunchOut-Protokolle unterstützt das Vendure-Plugin? +

 Das Plugin verbindet Ihren Shop mit dem PunchCommerce-Gateway, und das Gateway spricht OCI, cXML und [IDS Connect](https://www.punchcommerce.de/de/ids-connect). Welches Protokoll gilt, legen Sie in PunchCommerce je Kunde fest. Das Plugin selbst tauscht mit PunchCommerce nur JSON über HTTPS aus, die Kommunikation mit dem System Ihres Kunden übernimmt PunchCommerce.

###   Wie erkennt der Shop, welcher Kunde gerade einkauft? +

 Das Plugin ergänzt Kunden in Vendure um das Feld „PunchOut Customer ID (uID)“. Dort tragen Sie denselben Wert ein wie in PunchCommerce als Kundenkennung. Beim Einsprung hängt PunchCommerce die Parameter sID und uID an Ihre Einsprungadresse; Ihre Landingpage meldet den Einkäufer damit über die Mutation authenticate an.

###   Was prüfe ich, wenn Einsprung oder Warenkorbübergabe nicht funktionieren? +

 Schlägt die Anmeldung fehl, prüfen Sie zuerst, ob die uID mit der Kundenkennung in PunchCommerce übereinstimmt. Bleibt der Warenkorb leer, fehlt bei einer Bestelloperation activeOrderInput mit der Session-ID. Schlägt eine zweite Übergabe fehl, ist das erwartbar: Je Session ist nur eine Übergabe möglich. Überschreiben sich parallele Sessions, gehört die sID in den sessionStorage statt in ein Cookie. Lädt der Shop nicht im iFrame des Beschaffungssystems, setzen Sie die Session-Cookies auf SameSite=None; Secure und entfernen den Header X-Frame-Options während der PunchOut-Session. Prüfen Sie dabei, wie Ihr Shop weiterhin vor Clickjacking geschützt bleibt, damit fremde Seiten ihn nicht unbemerkt einbetten.

###   Was passiert mit meinen PunchOut-Kunden, wenn ich das Shopsystem wechsle? +

 Nichts, was Ihre Kunden betrifft. Zugangsdaten, Protokoll, Feldzuordnung und die Adresse, die ihr Beschaffungssystem aufruft, liegen im PunchCommerce-Gateway, nicht im Shop. Sie installieren das Plugin im neuen Shop, stellen die Einsprungadresse je Kunde um und testen mit dem Simulator. Wie das Schritt für Schritt geht, zeigt die Seite [PunchOut beim Shop-Wechsel](https://www.punchcommerce.de/de/punchout-gateway-replatforming).

###   Was kostet PunchOut für Vendure? +

 Das Plugin ist Open Source und kostenlos. PunchCommerce Business kostet 49 € je angebundenem Kunden und Monat, zzgl. MwSt. Drei Kunden kosten also 147 € im Monat, zzgl. MwSt. Brauchen Sie ein SLA und Betriebsverantwortung, ist PunchCommerce Enterprise der passende Tarif.

  Jetzt starten

 Ihr Kunde wartet auf PunchOut. Liefern Sie es aus Ihrem Vendure‑Shop.
-----------------------------------------------------------------------

 49 € je Kunde und Monat, zzgl. MwSt. Plugin installieren, Storefront anpassen, Kunden anlegen, Zugangsdaten verschicken, fertig.

 [ Kostenlos testen ](https://www.punchcommerce.de/register)30 Tage kostenlos · keine Kreditkarte · jederzeit kündbar

 ![Patrick Dornbusch, Gründer von PunchCommerce](https://www.punchcommerce.de/static/patrick-dornbusch.webp)Patrick Dornbusch

Gründer von PunchCommerce

Lieber erst sprechen? Wir klären in 30 Minuten, welcher Weg zu Ihrem Shop, Ihrem ERP und den Einkaufssystemen Ihrer Kunden passt.

 [ Beratungstermin vereinbaren  (öffnet in neuem Fenster) ](https://account.netzdirektion.de/appointments/punchcommerce)30 Min · remote · mit dem Gründer

 PunchCommerce® ist ein Produkt der [ ![netzdirektion | Gesellschaft für digitale Wertarbeit mbH](https://www.punchcommerce.de/static/netzdirektion-logo.png) (öffnet in neuem Fenster) ](https://netzdirektion.de) ![DEKRA-Siegel: Qualitätsmanagement nach ISO 9001](https://www.punchcommerce.de/static/dekra-netzdirektion-iso-9001.png) **ISO 9001:2015**
zertifiziertes Qualitätsmanagement

 netzdirektion | Gesellschaft für digitale Wertarbeit mbH · © 2020 - 2026
