Shopware 5 plugin | Create OCI and cXML PunchOut Catalogues | PunchCommerce                            ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

Shopware 5 plugin
=================

   ![](data:image/jpeg;base64,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) This video is embedded in YouTube/s extended data protection mode, which blocks the setting of YouTube cookies until you actively click on playback. By clicking on the play button, you give your consent for YouTube to set cookies on the end device you are using, which can also be used to analyze usage behavior for market research and marketing purposes. You can find more information about the use of cookies by YouTube in Google/s cookie policy at https://policies.google.com/technologies/types?hl=de.

 Got it, show me the video

Our free extension for Shopware 5 enables you to transfer products to PunchCommerce. The plugin also allows you to use our OCI or cXML gateway PunchOuts in conjunction with your Shopware online shop.

### Transferring products from Shopware

To transfer products from your Shopware installation, first download the plugin from the [Shopware Store](https://store.shopware.com/netzd94997432810f/punchcommerce-fuer-shopware-5.html). Create a customer in PunchCommerce and select “API” as the product source.

1. Launch the PunchCommerce app via the ‘Customers’ menu item in your Shopware administration panel
2. Create a new customer and configure the name, API key, customer group, currency and the product stream from which the products are to be retrieved
3. Switch to the ‘Products’ tab, click the ‘Import new products’ button, and then click ‘Synchronise’
4. The products will be transferred to PunchCommerce

**Note** Product transfer is only available for customers who do not use gateway mode. A short video demonstrating the upload process can be found here:

### Using gateway mode with your own Shopware online shop

After installing the Shopware plugin, you will find the new “Punchout-Identity” attribute for each customer. Enter the customer ID defined in PunchCommerce here. To configure the entry URL, use the URL of your online shop in the following format:

https://./punchcommerce/authenticate

### Defining delivery charges when using the OCI Punchout

To be able to transfer delivery charges via the OCI PunchOut, a corresponding delivery method must be defined within the Shopware 5 backend. To ensure this delivery method is recognised correctly, the setting “Delivery method type: Surcharge delivery rule (as a separate item)” must be selected.

The transfer of delivery charges to PunchCommerce then looks as follows: ![Transfer of delivery charges](https://www.punchcommerce.de/storage/media/support-articles/transmission-of-shipping-costs.png)

### Mapping of additional fields

Within the Shopware 5 backend, a mapping for additional fields can be defined in the plugin configuration. The additional fields are populated according to the configuration and transferred to the PunchCommerce gateway together with the shopping basket.

![Defining additional fields](https://www.punchcommerce.de/storage/media/support-articles/definition-of-custom-fields.png)

 [ PunchCommerce® ist ein Produkt der ![Netzdirektion GmbH](https://www.punchcommerce.de/static/netzdirektion-logo.png "PunchCommerce® ist ein Produkt der netzdirektion | Gesellschaft für digitale Wertarbeit mbH") ](https://netzdirektion.de)

 [Give feedback now - your opinion helps us to become even better!](https://easy-feedback.de/umfrage/1883200/5FuM95 "Your opinion helps us to become even better!")