PunchOut for Magento 2: OCI &amp; cXML via free extension | PunchCommerce                       ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

  [Skip to content](#main-content)

  Integration · Magento 2 / Adobe Commerce PunchOut for Magento 2. Your customer requires PunchOut, you run Magento. You deliver with a free extension.
==============================================================================================================

 Your key account wants to order in your shop straight from its procurement system, via OCI, cXML or IDS Connect. With the free PunchCommerce extension for Magento 2 and Adobe Commerce your shop stays as it is: you install the extension, create the customer in PunchCommerce and store its customer identifier in Magento.

 [ 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 extension €0

 per customer per month, plus VAT €49

 Extension

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

The extension connects your Magento shop to the PunchCommerce gateway; you need neither a separate front end nor interface development. The gateway talks to your customer's procurement system via [OCI PunchOut](https://www.punchcommerce.de/en/oci-punchout) or [cXML PunchOut](https://www.punchcommerce.de/en/cxml-punchout), for example [SAP Ariba](https://www.punchcommerce.de/en/punchout-sap-ariba), [SAP SRM](https://www.punchcommerce.de/en/punchout-sap-srm) or Coupa, checks the login and then forwards the buyer to your shop. You connect plumbing, heating and electrical trade businesses from the same installation via [IDS Connect](https://www.punchcommerce.de/en/ids-connect).

 For Magento 2 and Adobe Commerce shops### PunchCommerce for Magento 2

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

- Customer identifier on the Magento customer
- Operation inside the procurement system's iFrame
- Product mapping in the Magento configuration

  Version Magento 2 / Adobe Commerce

 Source Download on the integrations page

 License free of charge

 Account PunchCommerce Business or Enterprise

  [  To the download ](https://www.punchcommerce.de/en/integrations) [Extension documentation](https://www.punchcommerce.de/en/documentation/magento-2-module)

 Installation via Composer or app/code

 ```
# Option 1: place the module in a path repository, then
composer require ecentral/module-punchcommerce

# Option 2: copy the module files to
app/code/Ecentral/PunchCommerce

# Then, in both cases
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
```

 The buyer jumps into your shop via the entry address: your shop address plus `/punchcommerce/authenticate/index/?sId={{sID}}&uId={{uID}}`, including both placeholders. There the buyer shops with the Magento customer account you have linked to them.

 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 Magento 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 extension to go-live in six steps
--------------------------------------

Four steps come from the extension documentation; testing and handover take place in PunchCommerce. For the installation you need command-line access to your Magento server, but neither an IT project nor an agency.

1. 1 You · shop### Install the extension

    Download the current version on our integrations page and install the module via Composer or under app/code. Then run setup:upgrade, setup:di:compile and setup:static-content:deploy.
2. 2 You · PunchCommerce### Create the customer

    Create your customer in PunchCommerce in OCI, cXML or IDS Connect gateway mode. As the entry address, enter your shop address with the path `/punchcommerce/authenticate/index/` and both placeholders, plus the customer identifier.
3. 3 You · shop### Configure Magento

    Enter the customer identifier in the PunchCommerce Customer ID attribute of the Magento customer, activate the extension under Stores &gt; Configuration &gt; PunchCommerce and adjust the product mapping.
4. 4 You · web server### Adjust the web server

    So that your shop loads in the procurement system's iFrame, remove the X-Frame-Options SAMEORIGIN header from pub/.htaccess (Apache). On nginx, check whether the same header is set. Then enter the domain in the Frame Ancestor field.
5. 5 You · PunchCommerce### Test the connection

    Test the purchase and the cart return with the PunchCommerce simulator before your customer sets up the connection in its procurement system.
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 extension brings to your PunchOut customers
----------------------------------------------------

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

### Customer identifier on the Magento customer

Every PunchOut customer is a customer in your shop. The customer identifier from PunchCommerce is stored in the PunchCommerce Customer ID attribute, and the buyer shops with this customer account.

### Cart on a new session

You decide whether the buyer is asked, before the session is refreshed, whether the cart should be emptied.

### Operation in an iFrame

In the Frame Ancestor field you enter the domain that provides the iFrame. You separate several domains with spaces.

### Product mapping

You map attributes of the product or the cart item, or static values, to the fields. Required are brand, price, tax\_rate, purchase\_unit, packaging\_unit and shipping\_time.

### Web server with a security note

For the iFrame you remove X-Frame-Options SAMEORIGIN from pub/.htaccess (Apache). On nginx, check whether the same header is set. Make sure your shop remains protected against clickjacking, so that third-party pages cannot embed your shop unnoticed.

### Hook URL for Enterprise

Optionally, the hook URL points to your PunchCommerce server instance. You only need to change the value as a PunchCommerce Enterprise user.

 Pricing

What PunchOut for Magento costs
-------------------------------

The extension 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 Magento 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 Magento
-----------------------------------------------------

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

 ###   Where do I get the PunchCommerce extension for Magento? +

 The extension is free of charge and available as a direct download on our integrations page. That is where you find the current version; the documentation describes installation and configuration step by step.

###   How do I install the extension in Magento 2? +

 In one of two ways: you place the module in a path repository for Composer and run composer require ecentral/module-punchcommerce, or you copy the module files to app/code/Ecentral/PunchCommerce. In both cases you then run bin/magento setup:upgrade, setup:di:compile and setup:static-content:deploy. After that you activate the extension under Stores &gt; Configuration &gt; PunchCommerce.

###   Which PunchOut protocols does the Magento extension support? +

 The extension connects your shop to the PunchCommerce gateway, and the gateway speaks OCI, cXML and [IDS Connect](https://www.punchcommerce.de/en/ids-connect). You set the protocol per customer in PunchCommerce. This way you supply, for example, one customer on SAP SRM via OCI and another on SAP Ariba via cXML from the same Magento shop.

###   Why does my Magento shop not load in my customer's procurement system? +

 Procurement systems usually display your shop in an iFrame. By default Magento prevents this with the X-Frame-Options SAMEORIGIN header. Remove or comment out the line in pub/.htaccess (Apache). On nginx, check whether the same header is set. Also enter the domain that provides the iFrame in the extension's Frame Ancestor field. 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 extension 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 Magento cost? +

 The extension 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 Magento shop.
---------------------------------------------------------------------------

 €49 per customer per month, plus VAT. Install the extension, create the customer, store the customer identifier in Magento, 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
