Shopware 6 plugin

Our free extension for Shopware 6 allows you to use our OCI or cXML gateway punch-out in connection with your Shopware 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

First, download, install and activate the plugin from the Shopware store.

In PunchCommerce

  1. Create a new customer and select OCI or cXML gateway as the mode
  2. Complete the configuration of the customer in PunchCommerce by configuring the entry address (to your online shop) and the customer ID

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

> https://<ihre-domain>.<tld>/<opt. sales-channel>/punchcommerce/authenticate

In Shopware

  1. Open a customer who should access your shop via OCI or cXML
  2. Enter the customer ID assigned in PunchCommerce in the "PunchCommerce uID" field
  3. Send your customer the access instructions generated in PunchCommerce as a PDF

Setting up a redirect URL

Within the administration, the input field “Redirect URL after authentication” is available to you in the plugin configuration. Please note that this option is exclusively reserved for Shopware administrators.

Here you can enter a URL to which the customer should be redirected after they have successfully logged in. As soon as a URL is entered, it is checked for correctness. If there is an error within the URL, a corresponding error message will be displayed.

Change field assignment for PunchCommerce additional fields in Shopware

Here you can transfer any product fields from Shopware to PunchCommerce as an additional field [2 - 10] during the PunchOut. The additional fields are then available to you within PunchCommerce and can be assigned to the respective protocol field using “field mapping” (menu: Customers -> Field assignments).

Transmission of shipping costs

If shipping costs apply to your order, these will also be transferred by default with PunchOut. If shipping costs are defined, they will always be transferred. Shipping costs with a value of €0.00 will also be transferred during PunchOut. If you do not want the shipping costs to be transferred, this can be prevented in two ways:

  1. Deactivation of shipping costs per sales channel via the plugin setting "Prevent shipping costs transfer" https://www.punchcommerce.de/storage/media/support-articles/punchcommerce-shipping-costs-settings-shopware-6.png
  2. No valid shipping method must be defined for the shopping cart. In this case, Shopware will issue a warning in the shopping cart, which is not relevant for the PunchOut

In addition, there is the option to adjust the ID to be transferred to the shipping method. There is a corresponding additional field for this in the shipping methods: https://www.punchcommerce.de/storage/media/support-articles/punchcommerce-shipping-costs-custom-field-shopware-6.png

A successful transfer of shipping costs looks like this: https://www.punchcommerce.de/storage/media/support-articles/transmission-of-shippings-costs-shopware-6.png

Create new field mapping option

https://www.punchcommerce.de/storage/media/support-articles/custom-field-configuration-for-punchout-in-shopware-6.png

If the existing options are not enough for you, for example because you want to transfer a CustomField of the product, you have the option of creating your own field mapping options.

Example:

You have stored the CustomField "additionInformation" on the product in Shopware and now want this field to be transferred as part of the PunchOut. To do this, proceed as follows:

  1. In the plugin configuration in Shopware we create a new field mapping option. The option corresponds to the mapping of a field in Shopware. By default, only the “product” entity is available here. For our CustomField "additionInformation" we define the option as follows: "product.customFields.additionInformation"

Explanation:

  "product": Corresponds to the name of the Shopware entity
  "customFields": Is the identifier for additional fields in Shopware
  "additionInformation": Is the name of your CustomField
  1. Then assign the fields to PunchCommerce. In our example we would use the “Additional field 2”. Accordingly, we now select the option “product.customFields.additionInformation” in the plugin configuration for “Additional Field 2”, which we have just created. The field is now passed to PunchCommerce as “Additional Field 2” in PunchOut.

  2. So that your CustomField "additionInformation" is now transferred from PunchCommerce to your OCI system, you must create a mapping in PunchCommerce (menu: Customers -> Field Mappings) and assign the "Additional Field 2" to the desired protocol value.

Compatibility with custom products for Shopware

All options configured for a product are mapped to the custom_field1 field in our data model according to the following scheme:

  {
  "product": {
        [...]
        "custom_field1":"With additional So\u00dfe: on; Desired Text: My desired product; Datum: 2022-07-14T00:00:00+00:00; Color: red,blue; Number: 99; "
       [...]
  }

Only configurator options with one of the following types are mapped:

[
    'checkbox',
    'colorselect',
    'datetime',
    'textfield',
    'numberfield',
    'select',
    'textarea',
    'timestamp'
]

The scheme corresponds to:

Option-Name . ': ' . Option-Value '; '[...]
PunchCommerce® ist ein Produkt der Netzdirektion GmbH