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

  [Zum Inhalt springen](#main-content)

  Integration · JTL-Shop 5 PunchOut für JTL-Shop 5. Ihr Kunde fordert einen PunchOut, Sie haben JTL-Shop. Sie liefern per Plugin.
========================================================================================================

 Ihr Großkunde will aus seinem Beschaffungssystem in Ihrem Shop bestellen, per OCI, cXML oder IDS Connect. Mit dem kostenlosen PunchCommerce-Plugin aus dem JTL Extension Store bleibt Ihr Shop, wie er ist: Sie installieren das Plugin, legen den Kunden in PunchCommerce an und bestimmen das Kundenattribut, an dem der Shop ihn erkennt.

 [ 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 Ihren Shop, das Gateway für Ihren Kunden
-------------------------------------------------------

Das Plugin verbindet Ihren JTL-Shop mit dem PunchCommerce-Gateway; ein eigenes Frontend oder eine Schnittstellenentwicklung brauchen Sie nicht.

 Für JTL-Shop 5### PunchCommerce für JTL-Shop 5

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

- Anmeldung über ein konfigurierbares Kundenattribut
- Bis zu 10 eigene Felder je Warenkorbposition
- Nachkommastellen und Preisrundung einstellbar

  Version JTL-Shop ab 5.6.0

 Laufzeit PHP ab 8.2 und HTTPS, JTL-Wawi nicht nötig

 Bezugsquelle JTL Extension Store, alternativ als ZIP-Datei auf der Integrationsseite

 Lizenz kostenlos

 Account aktiver PunchCommerce-Account

  [ Im JTL Extension Store ansehen (öffnet in neuem Fenster) ](https://www.jtl-software.de/extension-store/punchcommerce-oci-cxml-und-ids-connect-punchout-gateway-fuer-jtl-shop-jtl-shop-5) [Dokumentation zum Plugin](https://www.punchcommerce.de/de/documentation/jtl-shop-version-5-plugin)

 Webserver .htaccess im Shop-Root

 ```
# iFrame erlauben: Zeile mit
# X-Frame-Options entfernen
# oder ersetzen durch
Header unset X-Frame-Options
```

Zusätzlich stellen Sie die SameSite-Cookie-Policy in JTL-Shop global auf „None“, damit der Einkäufer im eingebetteten Shop angemeldet bleibt.

 Der Einkäufer springt über die Einsprungadresse in Ihren Shop: Ihre Shop-Adresse plus `/punchcommerce-authenticate`. Dort meldet ihn das Plugin mit dem Kundenkonto an, das Sie mit ihm verknüpft haben, und gibt den Warenkorb am Ende automatisch an das Beschaffungssystem zurück.

 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 JTL-Shop-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. Sie brauchen Zugriff auf die .htaccess und das Backend Ihres JTL-Shops, ein IT-Projekt oder eine Agentur brauchen Sie nicht.

1. 1 Sie · Webserver### iFrame erlauben

    Entfernen Sie in der .htaccess im Root-Verzeichnis Ihres Shops die Zeile mit X-Frame-Options oder ersetzen Sie sie durch Header unset X-Frame-Options. Erst dann lädt Ihr Shop im iFrame des Beschaffungssystems.
2. 2 Sie · Shop### Cookie-Policy setzen

    Stellen Sie die SameSite-Cookie-Policy in JTL-Shop global auf „None“. JTL-Shop erlaubt kein Cookie-Handling je Session, deshalb gilt die Einstellung für den ganzen Shop.
3. 3 Sie · PunchCommerce### Kunden anlegen

    Legen Sie Ihren Kunden in PunchCommerce mit dem Protokoll OCI, cXML oder IDS Connect und dem Modul Gateway an. Als Einsprungadresse tragen Sie Ihre Shop-Adresse mit dem Pfad `/punchcommerce-authenticate` ein, dazu die Kundenkennung, standardmäßig die Kundennummer aus dem Feld cKundenNr.
4. 4 Sie · Shop### Plugin installieren

    Installieren und aktivieren Sie das Plugin aus dem JTL Extension Store in Ihrem JTL-Shop. Spätere Updates kommen über den Update-Mechanismus von JTL.
5. 5 Sie · Shop### Plugin konfigurieren

    Legen Sie fest, an welchem Kundenattribut das Plugin den Einkäufer erkennt, standardmäßig cKundenNr. Optional erweitern Sie das Datenmodell der Warenkorbpositionen um eigene Felder.
6. 6 Ihr Kunde### Zugangsdaten übergeben

    Geben Sie die in PunchCommerce erzeugte Zugangsanleitung als PDF an Ihren Kunden weiter. Er trägt die Daten in seinem Beschaffungssystem ein und bestellt ab dann aus Ihrem Shop.

###   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. Protokoll und Einsprungadresse legen Sie je Kunde in PunchCommerce fest.

### Anmeldung über ein Kundenattribut

Das Plugin meldet den Einkäufer sessionbasiert mit seinem Kundenkonto an. Welches Kundenattribut dafür gilt, legen Sie fest, standardmäßig die Kundennummer cKundenNr.

### Automatische Warenkorbübergabe

Schließt der Einkäufer seinen Einkauf ab, geht der Warenkorb automatisch an das Beschaffungssystem Ihres Kunden zurück.

### Bis zu 10 eigene Felder

Braucht Ihr Kunde mehr Angaben je Position, erweitern Sie das Datenmodell der Warenkorbpositionen um bis zu 10 benutzerdefinierte Felder.

### Nachkommastellen und Preisrundung

Sie stellen ein, mit wie vielen Nachkommastellen und mit welcher Rundung Preise an das Beschaffungssystem gehen.

### Feldmapping je Kunde

Welche Daten in welchem Feld beim Kunden ankommen, ordnen Sie in PunchCommerce je Kunde visuell zu, ohne Code.

### Protokoll-Kommunikation inklusive

Die Kommunikation mit dem System Ihres Kunden per OCI, cXML oder IDS Connect übernimmt PunchCommerce. Ihr Shop muss die Protokolle nicht selbst sprechen.

 Kosten

Was PunchOut für JTL-Shop kostet
--------------------------------

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

Was JTL-Händler vor der ersten PunchOut-Anbindung wissen wollen.

 ###   Wo bekomme ich das PunchCommerce-Plugin für JTL-Shop? +

 Das Plugin ist kostenlos im JTL Extension Store erhältlich und setzt einen aktiven PunchCommerce-Account voraus. Installation, Verwaltung und Updates laufen über den Extension Store und den Update-Mechanismus von JTL. Alternativ laden Sie das Plugin als ZIP-Datei auf unserer Integrationsseite herunter.

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

 Sie brauchen JTL-Shop ab Version 5.6.0, PHP ab Version 8.2 und HTTPS. Das Plugin hängt nicht von JTL-Wawi ab und ist mit gängigen Templates wie NOVA kompatibel.

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

 Das Plugin verbindet Ihren Shop mit dem PunchCommerce-Gateway, und das Gateway spricht OCI in den Versionen 4.0 und 5.0, cXML und [IDS Connect](https://www.punchcommerce.de/de/ids-connect). Welches Protokoll gilt, legen Sie in PunchCommerce je Kunde fest. Die Kommunikation mit dem System Ihres Kunden übernimmt PunchCommerce.

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

 Das PunchCommerce-Plugin für JTL-Shop erkennt den Einkäufer über ein Kundenattribut, das Sie im Plugin festlegen. Standard ist das Feld cKundenNr, also die Kundennummer in JTL-Shop. Denselben Wert tragen Sie in PunchCommerce als Kundenkennung ein. Beim Einsprung meldet das Plugin den Einkäufer sessionbasiert mit diesem Kundenkonto an.

###   Warum lädt mein JTL-Shop nicht im Beschaffungssystem meines Kunden? +

 Beschaffungssysteme zeigen Ihren Shop in der Regel in einem iFrame an. Entfernen Sie dafür in der .htaccess im Root-Verzeichnis Ihres Shops die Zeile mit X-Frame-Options oder ersetzen Sie sie durch Header unset X-Frame-Options. Stellen Sie außerdem die SameSite-Cookie-Policy global auf None, denn JTL-Shop erlaubt kein Cookie-Handling je Session; so bleibt der Einkäufer im eingebetteten Shop angemeldet. Prüfen Sie dabei, wie Ihr Shop weiterhin vor Clickjacking geschützt bleibt, damit fremde Seiten Ihren Shop 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 JTL-Shop? +

 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 JTL‑Shop.
-------------------------------------------------------------------

 49 € je Kunde und Monat, zzgl. MwSt. Plugin installieren, Kunden anlegen, Kundenattribut festlegen, 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
