PunchOut for Onventis: provide an OCI catalog and a catalog file | PunchCommerce                       ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

  [Skip to content](#main-content)

   Procurement system · Onventis    Live in production

 PunchOut for Onventis. Your customer buys through Onventis and requires a PunchOut catalog. You deliver via OCI or cXML, with a catalog file on request.
==========================================================================================================================================================

 Your customer runs purchasing through Onventis, a cloud-based procurement system, and wants your items available there. There are two ways to do this, which they can require separately or together: a PunchOut catalog, where the buyer jumps from Onventis into your catalog and transfers the cart back, and a catalog file that your customer uploads to Onventis. For the PunchOut, Onventis speaks OCI and cXML. PunchCommerce generates the catalog file from the Hosted Catalog in the JSON format, a text-based data format that Onventis reads in directly. This page shows what your customer expects, which steps lead to the first purchase and what the connection costs.

 [ Start free trial ](https://www.punchcommerce.de/register) [ See the setup ](#setup)

30 days free · no credit card · cancel anytime

  Onventis protocols OCI · cXML

 Setup without an IT project &lt; 1 h

 per customer per month, plus VAT €49

 Requirements

What your customer on Onventis expects from you
-----------------------------------------------

 For Onventis you deliver an [OCI PunchOut](https://www.punchcommerce.de/en/oci-punchout), plus a catalog file on request. How a catalog file differs from a PunchOut is shown in the comparison [PunchOut vs. content catalog](https://www.punchcommerce.de/en/punchout-vs-content-catalog). Onventis also speaks cXML; if your customer expects this protocol, the PunchOut follows what the page [cXML PunchOut](https://www.punchcommerce.de/en/cxml-punchout) describes. Which protocol other systems speak is shown in the overview of [procurement systems](https://www.punchcommerce.de/en/procurement-systems).

### A PunchOut via OCI or cXML

Onventis calls your catalog via OCI and sends along the HOOK\_URL, the return address for the cart; the cart returns to this address as NEW\_ITEM fields, that is, as form fields per line item. With cXML, the Ariba standard, it returns as an XML document.

### A catalog file in the JSON format for Onventis

If your customer requires a catalog to upload, you generate the catalog type “Onventis OCI 5.0 JSON Catalog” in PunchCommerce: a file in the JSON format, a text-based data format, with one entry per item. It is based on the active items you keep for this customer in the Hosted Catalog.

### The field names Onventis expects

The file uses the Onventis field names, such as DESCRIPTION and LONGTEXT for short and long text, VENDORMAT for your item number and MANUFACTNAME for the manufacturer. PunchCommerce shortens the short description to under 40 characters and adds the language code; the long text comes without HTML. Main image and attachment are listed under ATTACHMENTS.

### A separate field mapping for the export

Which item data goes into which field is defined by the field mapping “Onventis Catalog Export”. When generating the file, you choose the default mapping or one of your own. The default mapping maps German unit names such as “Stück”, “Stck.” or “St.” (piece) to PCE, the code for piece.

 Setup

Five steps to the first purchase from Onventis
----------------------------------------------

You complete three steps yourself, your customer takes care of the fourth in Onventis, and in the last one you both test. You usually set up your side of the connection in under an hour, without custom integration work.

1. 1 You · your customer### Ask for the requirement and protocol

    Ask your customer whether they expect a PunchOut, a catalog file or both, and for the PunchOut, whether their Onventis configuration uses OCI or cXML. A HOOK\_URL, the return address for the cart, points to OCI.
2. 2 You · PunchCommerce### Choose the catalog source and create the customer

    For the PunchOut, install the plugin for your shop system or provide your items in the Hosted Catalog; for the catalog file, keep the items in the Hosted Catalog. Then create your customer with the matching protocol, OCI for the catalog file, and define product range, prices and field mapping.
3. 3 You · your customer### Hand over credentials and catalog file

    You send your customer the PunchOut URL and the credentials. If they require the catalog file, you create the catalog export “Onventis OCI 5.0 JSON Catalog” for the customer under “Handover to Your Customer”, download it and send it along.
4. 4 Your customer · Onventis### Register the catalog in Onventis

    Your customer stores the PunchOut URL and the credentials in Onventis and uploads the catalog file if required.
5. 5 You · your customer### Test and release

    With the simulator you check the cart before the first real purchase. Then your customer tests from Onventis and releases the catalog to their buyers.

###   What you need from your customer

- The protocol of their Onventis configuration: OCI or cXML
- Whether they need a catalog file to upload in addition to the PunchOut

###   What you send your customer

- The PunchOut URL and the credentials for the catalog
- If required, the catalog file “Onventis OCI 5.0 JSON Catalog” from the Hosted Catalog

 Catalog source

With your own shop or without: Onventis receives the same cart
--------------------------------------------------------------

 For Onventis, it makes no difference where your items come from. In both cases the buyer opens a catalog and transfers the cart back via OCI or cXML. The catalog file for Onventis, by contrast, is generated only from the Hosted Catalog. Hosting is GDPR-compliant in Germany.

 With your own online shop### Your shop becomes the Onventis catalog

 Ready-made plugins are available for nine shop systems, including [PunchOut for Spryker](https://www.punchcommerce.de/en/spryker), [PunchOut for Shopware](https://www.punchcommerce.de/en/punchout-shopware), [PunchOut for Magento](https://www.punchcommerce.de/en/punchout-magento), [PunchOut for Vendure](https://www.punchcommerce.de/en/punchout-vendure), [PunchOut for JTL-Shop](https://www.punchcommerce.de/en/punchout-jtl) and [PunchOut for Medusa](https://www.punchcommerce.de/en/punchout-medusa). The buyer jumps from Onventis straight into your shop and sees their prices and the product range you release for them.

 [See the plugins for your shop system](https://www.punchcommerce.de/en/integrations)

 Without your own online shop### Provide items in the Hosted Catalog

 You upload your items to the Hosted Catalog as a list or transfer them via API. The buyer jumps from Onventis into this catalog. PunchCommerce generates the catalog file for Onventis from the same items; the catalog export is created only from the Hosted Catalog, not from your shop.

 [See the Hosted Catalog](https://www.punchcommerce.de/en/hosted-catalog)

 Pricing

What PunchOut for Onventis costs
--------------------------------

You pay per customer you connect in PunchCommerce. Whether your customer expects OCI or cXML does not change the price. Hosting is GDPR-compliant in Germany.

 For your case Supplier · self-service setup### PunchCommerce Business

Connection to Onventis via OCI or cXML, 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 or for the Onventis catalog file: 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 Onventis
------------------------------------------------------

What suppliers want to know when their customer requires a PunchOut catalog or a catalog file for Onventis.

 ###   My Onventis customer wants a catalog file instead of PunchOut – is that possible? +

 Yes. A catalog file, also called a content catalog, contains your items as a file that your customer uploads to Onventis; a PunchOut, by contrast, calls up your catalog live with every purchase. PunchCommerce generates the file as “Onventis OCI 5.0 JSON Catalog”, that is, in the JSON format, a text-based data format that Onventis reads in directly, from your items in the Hosted Catalog; you download it and give it to your customer. If prices or the product range change, you generate a new file. How the two approaches differ is shown in the comparison [PunchOut vs. content catalog](https://www.punchcommerce.de/en/punchout-vs-content-catalog).

###   Which fields does the Onventis catalog contain? +

 One entry per item with the field names Onventis expects: DESCRIPTION for the short description, shortened to under 40 characters and with a language code, LONGTEXT for the long text without HTML, plus PRICE, CURRENCY and UNIT, VENDORMAT for your item number, EXT_PRODUCT_ID for the product ID, MANUFACTNAME for the manufacturer, MINORDER_QTY for the minimum order quantity and PRICE_QUANTITY for the quantity the price refers to. Main image and attachment are listed under ATTACHMENTS. Which item data goes into which field is defined by the field mapping “Onventis Catalog Export”.

###   Do I need the Hosted Catalog for the Onventis catalog if I have a shop? +

 For the catalog file, yes: PunchCommerce generates it only from the items in the Hosted Catalog, not from your shop. You then serve this customer entirely through the Hosted Catalog, including their PunchOut, and the Hosted Catalog add-on applies. If your customer only requires the PunchOut, your shop with the plugin for your shop system is enough.

###   OCI or cXML: which protocol applies to Onventis? +

 Onventis speaks both protocols; your customer’s configuration decides which one applies. With OCI, the SAP standard, the cart returns as form fields to the HOOK_URL, the return address Onventis sends along with the call; cXML transfers it as an XML document. The catalog file requires OCI: PunchCommerce offers the catalog type for Onventis only for customers with OCI. Both protocols are included in the same plan.

###   Is PunchCommerce part of Onventis? +

 No. PunchCommerce is an independent solution for suppliers and not a component of Onventis. The PunchOut runs via the established standards OCI and cXML, the catalog file via a file in the JSON format, a text-based data format, with the field names Onventis uses for catalogs.

###   What does PunchOut for Onventis cost? +

 PunchCommerce Business costs €49 per connected customer per month, plus VAT, with OCI and cXML. Without your own shop or for the catalog file, the Hosted Catalog add-on is added at €50 per customer per month, also plus VAT. You test the first 30 days free of charge and without a credit card. If you need an SLA and operational responsibility, PunchCommerce Enterprise is the right plan.

  Get started

 Your customer is waiting for the Onventis catalog. Deliver it today.
----------------------------------------------------------------------

 €49 per customer per month; without your own shop, plus the Hosted Catalog add-on at €50 per customer per month, plus VAT in each case. Ask for the protocol, create the customer, send the credentials and, on request, the catalog file to your customer, 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
