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

  [Zum Inhalt springen](#main-content)

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

 Ihr Großkunde will aus seinem Beschaffungssystem in Ihrem Shop bestellen, per OCI, cXML oder IDS Connect. Mit dem PunchCommerce-Plugin für Medusa v2 binden Sie Ihren Shop an das Gateway an: Sie installieren das Plugin im Backend, 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 Plugin 0 €

 je Kunde und Monat, zzgl. MwSt. 49 €

 Plugin

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

Das Plugin verbindet Ihr Medusa-Backend mit dem PunchCommerce-Gateway; Ihre Storefront übergibt den Warenkorb im Format von PunchCommerce, die Protokoll-Kommunikation übernimmt PunchCommerce.

 Für Medusa v2### PunchCommerce-Plugin für Medusa

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

- Parallele PunchOut-Sessions mit getrennten Warenkörben
- Kunden-Verknüpfung per Widget im Medusa-Admin
- Artikelaufruf, Suche und Warenkorb-Wiederherstellung aus dem Beschaffungssystem

  Version Medusa ab 2.13.6

 Laufzeit Node.js ab 20 und eine Storefront, die Sie anpassen können

 Bezugsquelle npm-Paket `@punchcommerce/punchcommerce-medusa-plugin`

 Lizenz PunchCommerce Standard Module License, kostenlos in Verbindung mit PunchCommerce

 Account PunchCommerce Business oder Enterprise

  [ Auf npm ansehen (öffnet in neuem Fenster) ](https://www.npmjs.com/package/@punchcommerce/punchcommerce-medusa-plugin) [Dokumentation zum Plugin](https://www.punchcommerce.de/de/documentation/medusa-plugin)

 Konfiguration medusa-config.ts

 ```
plugins: [
  {
    resolve:
      "@punchcommerce/punchcommerce-medusa-plugin",
    // optional
  },
],
```

Zusätzlich registrieren Sie im Auth-Modul den Auth-Provider des Plugins mit der id „punchcommerce“. Im Medusa-Admin verknüpfen Sie den Kunden über das PunchCommerce-Widget mit derselben uID wie in PunchCommerce.

 Medusa trennt Backend und Storefront, also die Oberfläche, in der Ihre Kunden einkaufen. Das Plugin arbeitet nur im Backend, deshalb übernimmt Ihre Storefront drei Aufgaben: Sie empfängt den Einkäufer auf einer Einsprung-Route, zum Beispiel `//punchcommerce/authenticate`, legt für jede PunchOut-Session einen eigenen Warenkorb an und zeigt statt des Checkouts eine Seite, die den Warenkorb per Button an das Beschaffungssystem übergibt. Die Beispiele der Dokumentation bauen auf dem [Next.js Starter Template von Medusa (öffnet in neuem Fenster)](https://github.com/medusajs/nextjs-starter-medusa) auf.

 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 Medusa-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
-----------------------------------------

Die ersten fünf Schritte stammen aus der Dokumentation zum Plugin, Feldmapping und Simulator kommen aus PunchCommerce dazu. Die Schritte drei und vier betreffen Ihre Storefront, dort liegt bei Medusa 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 `@punchcommerce/punchcommerce-medusa-plugin` und tragen Sie es in der medusa-config.ts als Plugin ein. Ohne die Option punchcommerceUrl verbindet sich das Plugin mit punchcommerce.de.
2. 2 Sie · Backend### Auth-Provider registrieren

    Registrieren Sie im Auth-Modul zusätzlich den Auth-Provider des Plugins mit der id `punchcommerce`. Die Option disableSessionValidation ist nur für die lokale Entwicklung gedacht und bleibt im Live-Betrieb ausgeschaltet.
3. 3 Sie · Storefront### Einsprung-Route anlegen

    Legen Sie in Ihrer Storefront eine Route wie `//punchcommerce/authenticate` an. Sie liest die Session-ID (sID) und die Kundenkennung (uID) aus der Adresse, meldet den Einkäufer über das Medusa SDK an, legt einen neuen Warenkorb an und speichert die sID in dessen Metadaten.
4. 4 Sie · Storefront### Checkout durch Übergabe ersetzen

    Ersetzen Sie den Checkout durch eine PunchOut-Seite. Sie lädt den vorbereiteten Warenkorb über `/store/punchout/basket`, zeigt ihn zur Prüfung an und sendet ihn per Button an die Adresse, die das Plugin dazu ausgibt.
5. 5 Sie · PunchCommerce### Kunden anlegen und verknüpfen

    Legen Sie Ihren Kunden in PunchCommerce mit dem Protokoll OCI, cXML oder IDS Connect, einer eindeutigen Kundenkennung und der Adresse Ihrer Einsprung-Route als Einsprungadresse an. Im Medusa-Admin tragen Sie dieselbe Kundenkennung als uID im PunchCommerce-Widget auf der Kundenseite ein.
6. 6 Sie · PunchCommerce### Testen und übergeben

    Ordnen Sie im grafischen Feldmapping zu, welche Shop-Daten in welchem PunchOut-Feld ankommen, und testen Sie den Ablauf mit dem Simulator in PunchCommerce. 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
-------------------------------------------------

Die Funktionen stammen aus der Dokumentation zum Plugin, das Feldmapping aus PunchCommerce. Artikelnamen kürzt das Plugin wegen der Vorgaben von OCI und cXML auf 39 Zeichen; den vollen Titel überträgt es zusätzlich in den Produktdaten. Nach der Übergabe bleibt der Warenkorb in Medusa unverändert stehen; die Bestellung selbst kommt später über PunchCommerce aus dem System Ihres Kunden.

### Anmeldung über die uID

Das Plugin bringt einen eigenen Auth-Provider mit. Er prüft die Session-ID bei PunchCommerce und meldet den Einkäufer als den Medusa-Kunden an, der mit der übermittelten uID verknüpft ist.

### Verknüpfung im Medusa-Admin

Ein Widget auf der Kundenseite zeigt die Verknüpfung mit PunchCommerce. Ist eine uID schon einem anderen Kunden zugeordnet, meldet das Widget einen Fehler. Wird der Kunde gelöscht, entfällt die Verknüpfung.

### Parallele Sessions

Jede PunchOut-Session bekommt einen eigenen Warenkorb. Derselbe Kunde kann mehrere Sessions gleichzeitig öffnen; Warenkörbe, die er außerhalb von PunchOut angelegt hat, bleiben unberührt.

### Netto, brutto und Steuersatz

Jede Position geht mit Netto- und Bruttosumme, Netto-Einzelpreis und Steuersatz an PunchCommerce, dazu Artikelnummer, Titel, Beschreibung, Bild und Währung.

### Artikelaufruf, Suche, Wiederherstellung

Ruft das Beschaffungssystem einen Artikel direkt auf, sucht im Shop oder stellt einen früheren Warenkorb wieder her, verarbeitet das Plugin diese Aufrufe. Wohin der Einkäufer danach kommt, entscheidet Ihre Storefront.

### Grafisches Feldmapping

Welche Daten in welchem Feld beim Kunden ankommen, ordnen Sie in PunchCommerce je Kunde grafisch zu, statt es im Code zu konfigurieren.

  Nicht unterstützt: Mengeneinheiten je Variante, alle Positionen gehen derzeit als Stück, und Versandkosten als eigene Position. Unterstützt: Artikelaufruf, Suche und Warenkorb-Wiederherstellung aus dem Beschaffungssystem.

 Kosten

Was PunchOut für Medusa kostet
------------------------------

Das Plugin ist kostenlos; seine Lizenz erlaubt die Nutzung in Verbindung mit PunchCommerce. 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 Medusa-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 Medusa
-------------------------------------

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

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

 Das Plugin heißt @punchcommerce/punchcommerce-medusa-plugin und wird als npm-Paket installiert. Herausgeber ist die netzdirektion, das Unternehmen hinter PunchCommerce. Die Lizenz (PunchCommerce Standard Module License) erlaubt die kostenlose Nutzung, auch gewerblich, ausschließlich in Verbindung mit PunchCommerce.

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

 Sie brauchen Medusa ab Version 2.13.6, Node.js ab Version 20 und eine Storefront, die Sie anpassen können. Weil das Plugin nur im Backend arbeitet, gehören eine Einsprung-Route, ein eigener Warenkorb je PunchOut-Session und eine Übergabeseite anstelle des Checkouts in Ihre Storefront.

###   Welche PunchOut-Protokolle unterstützt das Medusa-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. Ihre Storefront übergibt den Warenkorb im Format von PunchCommerce, die Kommunikation mit dem System Ihres Kunden übernimmt PunchCommerce.

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

 Sie verknüpfen den Kunden im Medusa-Admin über das PunchCommerce-Widget mit derselben uID, die Sie in PunchCommerce als Kundenkennung eintragen. Beim Einsprung hängt PunchCommerce die Parameter sID (Session-ID) und uID an Ihre Einsprungadresse. Der Auth-Provider des Plugins prüft die sID bei PunchCommerce und meldet den verknüpften Kunden an.

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

 Meldet die Anmeldung „No PunchCommerce Identity found.“, ist in Medusa noch kein Kunde mit dieser uID verknüpft; prüfen Sie die Schreibweise in beiden Systemen. Lehnt das Plugin die Übergabe ab, fehlt am Warenkorb häufig die sID in den Metadaten (punchcommerce_session_id), etwa weil die Storefront einen bestehenden Warenkorb weiterverwendet statt einen neuen anzulegen. Kommt der Warenkorb nicht bei PunchCommerce an, prüfen Sie, ob Ihr Formular die Positionen in { basket: […] } verpackt. Die Option disableSessionValidation ist nur für die lokale Entwicklung gedacht und muss im Live-Betrieb ausgeschaltet sein.

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

 Das Plugin ist 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 Medusa‑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
