PunchOut for JTL-Shop 5: OCI &amp; cXML via free plugin | PunchCommerce                       ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

  [Skip to content](#main-content)

  Integration · JTL-Shop 5 PunchOut for JTL-Shop 5. Your customer requires PunchOut, you run JTL-Shop. You deliver with a plugin.
========================================================================================================

 Your key account wants to order in your shop straight from its procurement system, via OCI, cXML or IDS Connect. With the free PunchCommerce plugin from the JTL Extension Store your shop stays as it is: you install the plugin, create the customer in PunchCommerce and define the customer attribute by which the shop recognises them.

 [ Start free trial ](https://www.punchcommerce.de/register) [ See the setup ](#setup)

30 days free · no credit card · cancel anytime

  Protocols: OCI, cXML and IDS Connect 3

 for the plugin €0

 per customer per month, plus VAT €49

 Plugin

One plugin for your shop, the gateway for your customer
-------------------------------------------------------

The plugin connects your JTL-Shop to the PunchCommerce gateway; you need neither a separate front end nor interface development.

 For JTL-Shop 5### PunchCommerce for JTL-Shop 5

Free plugin for the gateway connection via OCI, cXML and IDS Connect, plus:

- Login via a configurable customer attribute
- Up to 10 custom fields per cart item
- Configurable decimal places and price rounding

  Version JTL-Shop 5.6.0 or later

 Runtime PHP 8.2 or later and HTTPS, no JTL-Wawi required

 Source JTL Extension Store, alternatively as a ZIP file on the integrations page

 License free of charge

 Account active PunchCommerce account

  [ View in JTL Extension Store (opens in a new window) ](https://www.jtl-software.de/extension-store/punchcommerce-oci-cxml-und-ids-connect-punchout-gateway-fuer-jtl-shop-jtl-shop-5) [Plugin documentation](https://www.punchcommerce.de/de/documentation/jtl-shop-version-5-plugin)

 Web server .htaccess in the shop root

 ```
# Allow the iFrame: remove
# the X-Frame-Options line
# or replace it with
Header unset X-Frame-Options
```

In addition, set the SameSite cookie policy in JTL-Shop globally to “None”, so that the buyer stays logged in while your shop runs embedded in the procurement system.

 The buyer jumps into your shop via the entry address: your shop address plus `/punchcommerce-authenticate`. There the plugin logs them in with the customer account you have linked to them and, at the end, returns the cart to the procurement system automatically.

 The gateway handles the protocols: it talks to your customer's procurement system, for example SAP Ariba, Coupa, Jaggaer or SAP SRM, via [OCI PunchOut](https://www.punchcommerce.de/en/oci-punchout) or [cXML PunchOut](https://www.punchcommerce.de/en/cxml-punchout) and returns the cart in the right format. You set the protocol per customer in PunchCommerce. You connect plumbing, heating and electrical trade businesses via [IDS Connect](https://www.punchcommerce.de/en/ids-connect) from the same JTL-Shop installation.

 Do you run further shops on other systems? Under [Integrations](https://www.punchcommerce.de/en/integrations) you will find all plugins, extensions and connection options.

 Setup

From plugin to go-live in six steps
-----------------------------------

All steps come from the plugin documentation. You need access to the .htaccess and the back end of your JTL-Shop, but neither an IT project nor an agency.

1. 1 You · web server### Allow the iFrame

    In the .htaccess in your shop's root directory, remove the X-Frame-Options line or replace it with Header unset X-Frame-Options. Only then does your shop load in the procurement system's iFrame.
2. 2 You · shop### Set the cookie policy

    Set the SameSite cookie policy in JTL-Shop globally to “None”. JTL-Shop does not allow session-specific cookie handling, so the setting applies to the whole shop.
3. 3 You · PunchCommerce### Create the customer

    Create your customer in PunchCommerce with the OCI, cXML or IDS Connect protocol and the Gateway module. As the entry address, enter your shop address with the path `/punchcommerce-authenticate`, plus the customer identifier, by default the customer number from the cKundenNr field.
4. 4 You · shop### Install the plugin

    Install and activate the plugin from the JTL Extension Store in your JTL-Shop. Later updates arrive through JTL's update mechanism.
5. 5 You · shop### Configure the plugin

    Define the customer attribute by which the plugin recognises the buyer, by default cKundenNr. Optionally, extend the data model of the cart items with custom fields.
6. 6 Your customer### Hand over the access details

    Pass the access guide generated by PunchCommerce on to your customer as a PDF. The customer enters the details in its procurement system and orders from your shop from then on.

###   What you need from your customer

- The protocol of their procurement system: OCI, cXML or IDS Connect
- The product classification key their system expects
- The units of measure they order in
- Access to their test system for the trial run

###   What you send your customer

- The PunchOut URL from PunchCommerce
- The access details, for cXML `Identity` and `SharedSecret`
- The access guide as a PDF from PunchCommerce

 Features

What the plugin offers your PunchOut customers
----------------------------------------------

All features are taken from the plugin documentation. You set the protocol and entry address per customer in PunchCommerce.

### Login via a customer attribute

The plugin logs the buyer in with their customer account for the session. You define which customer attribute applies, by default the customer number cKundenNr.

### Automatic cart transfer

When the buyer completes their purchase, the cart is returned automatically to your customer's procurement system.

### Up to 10 custom fields

If your customer needs more details per item, you extend the data model of the cart items with up to 10 custom fields.

### Decimal places and price rounding

You set how many decimal places and which rounding are used for the prices sent to the procurement system.

### Field mapping per customer

In PunchCommerce you map visually, per customer and without code, which data lands in which field on your customer's side.

### Protocol communication included

PunchCommerce handles the communication with your customer's system via OCI, cXML or IDS Connect. Your shop does not have to speak the protocols itself.

 Pricing

What PunchOut for JTL-Shop costs
--------------------------------

The plugin is free of charge. You pay per customer you connect in PunchCommerce. Hosting is GDPR-compliant in Germany.

 For your case Supplier · self-service setup### PunchCommerce Business

Gateway connection of your JTL-Shop via OCI, cXML and IDS Connect, set up by you, without an agency. Three connected customers cost €147 per month, plus VAT.

 €49 per customer per month, plus VAT

Without your own shop: plus the Hosted Catalog add-on, €50 per customer per month, plus VAT.

 [ Start free trial ](https://www.punchcommerce.de/register)30 days free · no credit card · cancel anytime

 [Compare plans and pricing](https://www.punchcommerce.de/en/features-and-pricing)

 With SLA &amp; operational responsibility### PunchCommerce Enterprise

For suppliers who need availability with an uptime guarantee, defined escalation paths and someone responsible for operating their PunchOut connections.

 Custom based on SLA level and number of connections

 [ Schedule a consultation (opens in a new window) ](https://account.netzdirektion.de/appointments/punchcommerce)30 min · remote · with the founder

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

 FAQ

Frequently asked questions about PunchOut for JTL‑Shop
------------------------------------------------------

What JTL merchants want to know before their first PunchOut connection.

 ###   Where do I get the PunchCommerce plugin for JTL-Shop? +

 The plugin is available free of charge in the JTL Extension Store and requires an active PunchCommerce account. Installation, management and updates run through the Extension Store and JTL's update mechanism. Alternatively, you can download the plugin as a ZIP file on our integrations page.

###   What are the requirements for my JTL-Shop? +

 You need JTL-Shop version 5.6.0 or later, PHP 8.2 or later and HTTPS. The plugin does not depend on JTL-Wawi and is compatible with common templates such as NOVA.

###   Which PunchOut protocols does the JTL plugin support? +

 The plugin connects your shop to the PunchCommerce gateway, and the gateway speaks OCI in versions 4.0 and 5.0, cXML and [IDS Connect](https://www.punchcommerce.de/en/ids-connect). You set the protocol per customer in PunchCommerce. PunchCommerce handles the communication with your customer's system.

###   How does the shop know which customer is buying? +

 The PunchCommerce plugin for JTL-Shop recognises the buyer through a customer attribute you define in the plugin. The default is the cKundenNr field, i.e. the customer number in JTL-Shop. You enter the same value in PunchCommerce as the customer identifier. On entry, the plugin logs the buyer in with this customer account for the session.

###   Why does my JTL-Shop not load in my customer's procurement system? +

 Procurement systems usually display your shop in an iFrame. To allow this, remove the X-Frame-Options line from the .htaccess in your shop's root directory or replace it with Header unset X-Frame-Options. Also set the SameSite cookie policy globally to None, because JTL-Shop does not allow session-specific cookie handling; this way the buyer stays logged in while your shop runs embedded in the procurement system. Make sure your shop remains protected against clickjacking, so that third-party pages cannot embed your shop unnoticed.

###   What happens to my PunchOut customers if I switch shop systems? +

 Nothing that affects your customers. Credentials, protocol, field mapping and the address their procurement system calls live in the PunchCommerce gateway, not in the shop. You install the plugin in the new shop, change the entry URL per customer and test with the simulator. How this works step by step is shown on the page [Replatforming with the gateway](https://www.punchcommerce.de/en/punchout-gateway-replatforming).

###   What does PunchOut for JTL-Shop cost? +

 The plugin is free of charge. PunchCommerce Business costs €49 per connected customer per month, plus VAT. Three customers therefore cost €147 per month, plus VAT. If you need an SLA and operational responsibility, PunchCommerce Enterprise is the right plan.

  Get started

 Your customer is waiting for PunchOut. Deliver it from your JTL‑Shop.
-----------------------------------------------------------------------

 €49 per customer per month, plus VAT. Install the plugin, create the customer, define the customer attribute, send the access details, done.

 [ Start free trial ](https://www.punchcommerce.de/register)30 days free · no credit card · cancel anytime

 ![Patrick Dornbusch, founder of PunchCommerce](https://www.punchcommerce.de/static/patrick-dornbusch.webp)Patrick Dornbusch

Founder of PunchCommerce

Prefer to talk first? In 30 minutes we’ll work out which option suits your shop, your ERP and your customers’ procurement systems.

 [ Schedule a consultation  (opens in a new window) ](https://account.netzdirektion.de/appointments/punchcommerce)30 min · remote · with the founder

 PunchCommerce® is a product of [ ![netzdirektion | Gesellschaft für digitale Wertarbeit mbH](https://www.punchcommerce.de/static/netzdirektion-logo.png) (opens in a new window) ](https://netzdirektion.de) ![DEKRA seal: quality management according to ISO 9001](https://www.punchcommerce.de/static/dekra-netzdirektion-iso-9001.png) **ISO 9001:2015**
certified quality management

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