Unsere kostenlose Erweiterung für JTL Shop Version 5 ermöglicht Ihne die Nutzung unseres OCI- oder cXML-Gateway-PunchOuts in Verbindung mit Ihrem JTL-Onlineshop.
Ihre Vorteile
- Bis zu 10 benutzerdefinierte Felder, konfigurierbare Preisrundung und automatische Warenkorbübergabe
- OCI, cXML & IDS Connect Support – Beide gängigen B2B-PunchOut-Protokolle in einem Plugin.
- Einfache Einrichtung – Plugin installieren, konfigurieren, fertig – ohne Coding.
- Flexibles Datenmapping – Weites Mapping und Transformation von Daten in der PunchCommerce App
- Sichere Authentifizierung – Session-basiertes Login mit konfigurierbarem Kundenattribut.
Diese Erweiterung verbindet Ihren JTL-Shop mit dem PunchCommerce-Gateway und ermöglicht OCI- und cXML-PunchOut-Sitzungen für B2B-Kunden. Die Nutzung setzt einen aktiven PunchCommerce-Account voraus (separat über www.punchcommerce.de zu beziehen).
Das Plugin selbst stellt die Schnittstelle zwischen JTL-Shop und dem PunchCommerce-Gateway her – die Gateway-Konfiguration, Kundenverwaltung und Protokollsteuerung erfolgt über die PunchCommerce-Plattform. Unterstützt werden die Protokolle OCI (Open Catalog Interface), cXML (Commerce eXtensible Markup Language) und IDS Connect.
Key Facts
-
Prozessoptimierung
PunchCommerce verbindet jeden JTL Shop nahtlos mit allen gängigen E-Procurement-Lösungen ohne das der Shop-Betreiber sich mit den komplizierten Anforderungen der Syteme auseinandersetzen muss.
-
Kompatibel mit JTL-Wawi ab
Keine Abhängigkeit
-
Kompatibel mit JTL-Shop 5 ab
5.0.0 - 5.6.1
Installation & Einrichtung1. Plugin beziehen
Das Plugin über den JTL-Extension Store oder direkt über das PunchCommerce-Ticketsystem anfordern.
2. Plugin installieren und aktivieren
Im JTL-Shop-Adminbereich unter System > Plugins das PunchCommerce-Plugin hochladen, installieren und aktivieren.
3. .htaccess anpassen
Die Zeile Header set X-Frame-Options "SAMEORIGIN" entfernen oder durch Header unset X-Frame-Options ersetzen, damit der Shop im iFrame des Beschaffungssystems geladen werden kann.
4. Cookie-Einstellung ändern
In den globalen JTL-Shop-Einstellungen die SameSite-Cookie-Policy auf „None" setzen, damit die Authentifizierung innerhalb des iFrames funktioniert.
5. PunchCommerce konfigurieren
- Unter www.punchcommerce.de einen Kunden-Account anlegen
- Das gewünschte Protokoll wählen (OCI oder cXML)
- Das Modul „Gateway" auswählen
- Die Einstiegs-URL konfigurieren:
https:///punchcommerce-authenticate
- Die Kundenkennung (z.B. Kundennummer) hinterlegen
6. Plugin im JTL-Admin konfigurieren
- PunchCommerce-URL: Standard beibehalten (
https://www.punchcommerce.de), nur auf Anweisung des Supports ändern
- Kundenattribut: Feld wählen, über das Nutzer authentifiziert werden (Standard:
cKundenNr)
- Preisrundung (optional): Rundung und Dezimalstellen für die Preisübertragung aktivieren
- Benutzerdefinierte Felder (optional): Bis zu 10 zusätzliche Produktattribute via Dot-Notation mappen
7. Zugangsdaten verteilen
Die von PunchCommerce generierten PDF-Zugangsanleitungen an die B2B-Kunden weitergeben.
NutzungsvoraussetzungenAktiver PunchCommerce-Account (www.punchcommerce.de) mit konfiguriertem Gateway-Modul (OCI oder cXML). Im JTL-Shop muss ein Kundenkonto für jeden Beschaffungssystem-Nutzer angelegt sein. Die Authentifizierung erfolgt über ein konfigurierbares Kundenattribut (z.B. Kundennummer). Für den Betrieb im iFrame muss die X-Frame-Options-Einstellung in der .htaccess angepasst und die globale Cookie-SameSite-Policy auf „None" gesetzt werden.
Systemvoraussetzungen
- JTL-Shop ab Version 5.6.0
- PHP 8.2 oder höher
- SSL-Zertifikat (HTTPS erforderlich)
- Zugriff auf .htaccess (Apache) zur Anpassung der X-Frame-Options
- PHP-Erweiterung: ext-json
- Kompatibel mit allen gängigen JTL-Shop-Templates (NOVA u.a.)
- Internetverbindung zum PunchCommerce-Gateway (ausgehende HTTPS-Requests)
Externe DokumentationenInstallationKonfiguration
1.3.1 - 25.03.2026- Kompatibel mit JTL-Wawi: Keine Abhängigkeit
- Kompatibel mit JTL-Shop 5:von 5.6.0 - 5.6.1
- Kompatibel mit PHP:von 8.2 bis 8.4
Kompatibilität mit JTL-Shop 5.6
1.2.8 - 25.03.2026- Kompatibel mit JTL-Wawi: Keine Abhängigkeit
- Kompatibel mit JTL-Shop 5:von 5.0.0 - 5.5.3
- Kompatibel mit PHP:von 8.2 bis 8.2
Initiales Release
Log History
-
1.3.125.03.2026
-
1.2.825.03.2026
