Magento 2 module

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 take over the communication with your customer or their system (Ariba, Oracle or SAP) and forward the customer to your online shop after successful authentication.

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 current version of our module here

Setup in PunchCommerce

1. create a new customer and select OCI or cXML Gateway as the mode
2. finalise the configuration of the customer in PunchCommerce by configuring the entry address (in your online shop) including the placeholders {{uID}} and {{sID}} and the customer ID

Note Configure the URL of your online shop as the entry address according to the following scheme:

https://<host>.<domain>.<tld>/punchcommerce/authenticate/index/?sId={{sID}}&uId={{uID}}

Installation in Magento 2

The module can be installed in two different ways:

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

In the next step, you must execute the following commands, regardless of which of the two variants you have selected:

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 define a PunchCommerce ID in the "PunchCommerce customer ID" attribute.
2. activate the module under "Stores > Configuration > PunchCommerce > PunchCommerce settings"
3. specify whether the user should be asked whether the shopping basket should be forcibly emptied before refreshing the session
4. to execute the Punchout in an iFrame, you must set the "Frame Ancestor" configuration field to the domain that provides the iFrame. You can define several domains separated by spaces. 5) Customise the product assignment. The corresponding documentation can also be found below the configuration field in the Magento backend.
5. 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 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 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 with a PunchOut, the web server configuration needs to be adapted.

**Apache

It is necessary to remove or comment line 289 in the pub/.htaccess file:

Header set X-Frame-Options SAMEORIGIN

This line prevents the website from being loaded in iFrames.

Note: Make sure 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 could also prevent the website from loading in iFrames:

add_header X-Frame-Options "SAMEORIGIN";

Note: As this configuration has not yet been tested, it is recommended to perform tests to ensure that no functionality of the website is affected. It may be necessary to adjust the configuration or take alternative security measures.