Magento 2 / Adobe Commerce

Our free extension for Magento 2 enables you to use our OCI or cXML gateway PunchOut in conjunction with your Magento online shop. In this scenario, we handle communication with your customers or their systems (Ariba, Oracle or SAP) and, following successful authentication, redirect the customer to your online shop.

Setting up the Gateway PunchOut

Download the latest version of the extension and install it in your Magento 2 online shop. You can find the latest version of our module here

Configuration in PunchCommerce

1. Create a new customer and select OCI or cXML gateway as the mode
2. Complete the customer configuration in PunchCommerce by setting up the entry URL (to your online shop), including the placeholders {{uID}} and {{sID}}, and the customer ID

Note Configure the entry URL as the URL of your online shop using the following format:

https://../punchcommerce/authenticate/index/?sId={{sID}}&uId={{uID}}

Installation in Magento 2

The module can be installed in two different ways:

• Option 1: Place the module in a Composer path repository and run the following command: composer require ecentral/module-punchcommerce
• Option 2: Copy the module files into the directory ./app/code/Ecentral/PunchCommerce

Next, regardless of which of the two options you have chosen, you must run the following commands:

bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy

Configuration in Magento 2

1. Create a Magento customer and set a PunchCommerce ID in the “PunchCommerce Customer ID” attribute.
2. Enable the module under “Stores > Configuration > PunchCommerce > PunchCommerce Settings”
3. Specify whether the user should be asked if the shopping basket should be cleared before refreshing the session.
4. To run the punchout in an iFrame, you must set the “Frame Ancestor” configuration field to the domain that provides the iFrame. You can specify multiple domains, separated by spaces.
5. Customise the product mapping. The relevant documentation can also be found below the configuration field in the Magento backend.
6. Optional Set the hook URL to point to your PunchCommerce server instance. You only need to adjust this value if you are a PunchCommerce Enterprise user.

Example configuration for field mapping in Magento

{
  "field1": {
    "type": <"map" (default; may be omitted) or "static">
    "target": <"product" or "item". Only used for type "map". Sets product or quote item as mapping target>
    "value": <Literal value for type "static" or attribute code to be mapped from target>
  },
  "field2": {
    ...
  },
  ...
}
// Must contain definitions for the following fields: brand, price, tax_rate, purchase_unit, packaging_unit, shipping_time

Adjustments to your web server

As your online shop is usually displayed as an iFrame within your customer’s e-procurement application during a PunchOut, you will need to adjust your web server configuration.

Apache

You must remove or comment out line 289 in the pub/.htaccess file:

Header set X-Frame-Options SAMEORIGIN

This line prevents the website from being loaded in iFrames.

Note: Ensure that this change does not create any security risks. It may be necessary to strengthen other security measures to maintain protection against clickjacking attacks.

Nginx

The following line may also prevent the website from being loaded in iFrames:

add_header X-Frame-Options "SAMEORIGIN";

Note: As this configuration has not yet been tested, it is advisable to carry out tests to ensure that no website functionality is compromised. It may be necessary to adjust the configuration or implement alternative security measures.