IDS Connect 2.5 explained: plumbing &amp; electrical wholesale | PunchCommerce                       ![](//analytics.punchcommerce.de/matomo.php?idsite=1&rec=1)

  [Skip to content](#main-content)

  Know-how · IDS Connect IDS Connect 2.5 explained. Your trade customers order from their trade software. You deliver IDS Connect.
===========================================================================================================

 IDS Connect 2.5 is the interface between trade software and wholesale shops in the plumbing, heating and air conditioning trade and in electrical wholesale: the business opens your shop from its software, selects items and transfers the cart, with your prices, back into its software. This page shows which actions and fields are involved and how you provide the IDS Connect interface without an IT project.

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

30 days free · no credit card · cancel anytime

  IDS Connect version 2.5

 setup, no IT project &lt; 1 h

 free trial 30 days

 What is IDS Connect

 The ordering interface of trade software
------------------------------------------

In short

 IDS Connect 2.5 is the interface between trade software and wholesale shops: the business logs in to your shop from its software with username, password and customer number, selects items at its negotiated prices and takes the cart back as IDS XML into its quote, job or order.

 IDS Connect links two systems that otherwise work separately: the trade software a business uses to price quotes, plan jobs and order material, and the online shop of its wholesaler. Instead of typing in item numbers, the installer or office staff jump from the software into your shop, search at the business’s negotiated prices and bring the selected items, prices included, back into the quote or order.

 The standard emerged among German building services trade associations, DG Haustechnik among them, and is mainly used in the plumbing, heating and air conditioning trade. Some electrical wholesalers use it as well; this page does not cover ELBRIDGE, the electrical industry’s own standard. PunchCommerce implements version 2.5. It defines how the software calls your shop, which actions exist and in which XML format the cart comes back. If you also supply industrial and commercial customers who order from a procurement system, IDS Connect does not apply there, but OCI or cXML; what that means for wholesalers is explained in [PunchOut for wholesalers](https://www.punchcommerce.de/en/punchout-wholesale).

 Two things set IDS Connect apart from corporate purchasing systems. First, your counterpart is not a purchasing department with an e-procurement system but trade software, and hardly anyone in the industry uses the term PunchOut, even though the process is the same as in a PunchOut (see the [PunchOut basics](https://www.punchcommerce.de/en/punchout)); people talk about the IDS interface or the shop connection. Second, every customer is a trade business that logs in with a username, a password and the customer number it has with you.

 Technically, IDS Connect resembles the [OCI PunchOut](https://www.punchcommerce.de/en/oci-punchout): the call and the return run through the browser, and the cart is posted to a return address via a form. Unlike the [cXML PunchOut](https://www.punchcommerce.de/en/cxml-punchout), the software does not negotiate a session address in advance but calls your IDS address directly with the credentials. The format is its own, though: an XML cart with IDS-specific field names and units.

### Trade software instead of a purchasing system

The call comes from the software the business uses to price and order, not from an SAP system. Your shop stays the same.

### Login with customer number

Username, password and the customer number this business has with you. If any of them is missing or wrong, PunchCommerce rejects the call.

 Process

How a purchase via IDS Connect works
------------------------------------

The standard case is the receive cart action (WKE): the business opens your shop, selects items and transfers the cart back. Beforehand, the software can query what your interface expects.

1. 1 Trade software### Preliminary queries

    With `LI` and `SV`, the software asks which credentials are required and which version your interface supports. PunchCommerce reports customer number, username, password and version 2.5.
2. 2 Business### Call with WKE

    The business clicks on your shop in its software, which calls your IDS address with the credentials and the return address `hookurl`.
3. 3 Your shop### Login

    PunchCommerce checks username, password and customer number and assigns the call to the right trade business.
4. 4 Business### Shopping in your shop

    The business searches your shop at its negotiated prices and adds items to the cart, just like any web order.
5. 5 Your shop### Returning the cart

    PunchCommerce creates the cart as IDS XML and posts it to the `hookurl` in the form field `warenkorb`.
6. 6 Trade software### Import into the software

    The trade software reads the line items and imports them with prices into the quote, job or order.

 Actions and fields

What PunchCommerce handles with IDS Connect
-------------------------------------------

IDS Connect 2.5 defines seven actions. PunchCommerce supports six of them:

- `LI` login information: preliminary query for the required credentials
- `SV` interface version: preliminary query for the version your interface supports
- `WKE` receive cart: shopping in your shop with the cart returned
- `WKS` send cart: the software sends a cart to your shop
- `ADL` item deep link: direct entry to an item page
- `AS` item search: search in your shop with a search term

- `HLS` send heating label: not supported

Besides the two preliminary queries (LI, SV) and shopping (WKE), PunchCommerce handles these three actions:

### WKS: Send cart

The software sends a cart to your shop, for example from a quote. PunchCommerce passes on item numbers and quantities so the items end up in the shop cart. An empty cart is allowed.

### ADL: Item deep link

The software opens the detail page of an item directly, based on your item number in the parameter `ghnummer`.

### AS: Item search

The software starts a search in your shop with the search term from the parameter `searchterm`.

### The fields in the cart

Each line item in the XML cart carries fields with fixed names; the currency appears once in the header. The “In PunchCommerce” column shows which fields PunchCommerce fills as required fields in its default configuration and which you map to a source from your shop per customer; the “Meaning” column tells you where the value comes from.

  IDS Connect cart fields with classification in the default configuration of PunchCommerce, sample value and meaning   Field In PunchCommerce Example Meaning      ArtNo  Required  Example: 4711-09 Your item number, by default the item’s SKU.   Required  4711-09 Your item number, by default the item’s SKU.    Qty  Required  Example: 2 Quantity of the line item.   Required  2 Quantity of the line item.    QU  Required  Example: Stk Unit of measure as an IDS abbreviation, translated from the packaging unit by default. If it is missing, PunchCommerce sets Stk.   Required  Stk Unit of measure as an IDS abbreviation, translated from the packaging unit by default. If it is missing, PunchCommerce sets Stk.    Kurztext  Required  Example: Nitrile protective glove, size 9 Short item name, by default the item title.   Required  Nitrile protective glove, size 9 Short item name, by default the item title.    NetPrice  Required  Example: 12.90 Net price per unit, by default the net price of the cart line item divided by the quantity.   Required  12.90 Net price per unit, by default the net price of the cart line item divided by the quantity.    Langtext  optional  Detailed item description.   optional   Detailed item description.    EAN  optional  EAN code of the item.   optional   EAN code of the item.    Cur  optional  Example: EUR Currency in the cart header, EUR by default.   optional  EUR Currency in the cart header, EUR by default.    ItemChara  optional, via mapping  Item characteristics, if you map the field to a source from your shop.   optional, via mapping   Item characteristics, if you map the field to a source from your shop.    RefItems  optional, via mapping  References to related items, via mapping.   optional, via mapping   References to related items, via mapping.    TechnClarification  optional, via mapping  Technical clarification for the line item, via mapping.   optional, via mapping   Technical clarification for the line item, via mapping.    Kommission  optional, via mapping  The business’s job reference, via mapping.   optional, via mapping   The business’s job reference, via mapping.    ZusatzText  optional, via mapping  Additional text for the line item, via mapping.   optional, via mapping   Additional text for the line item, via mapping.

### Unit mapping

PunchCommerce automatically translates the unit of measure into the IDS abbreviations, for example as follows; you adjust the mapping per customer:

  Mapping of units of measure from the shop to IDS abbreviations   Unit in the shop IDS abbreviation     Stück, PCE, EA Stk   MTR, Meter m   Liter l   Karton Krt   Palette Pal

 Implementation

How to provide IDS Connect with PunchCommerce
---------------------------------------------

You do not have to implement the standard yourself. PunchCommerce answers the preliminary queries, checks the login, opens your product range and returns the cart in IDS format. Setup usually takes under an hour, and hosting is GDPR-compliant in Germany.

 With your own online shop### Gateway connection of your shop

PunchCommerce sits between the trade software and your shop. The business shops in your existing shop at its negotiated prices, and PunchCommerce translates the cart into the IDS format. 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).

PunchCommerce Business: €49 per customer per month, plus VAT.

 [See 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 as a list to the PunchCommerce Hosted Catalog. The business jumps into this catalog, searches, selects items and transfers the cart back just as from a shop.

Business plus the Hosted Catalog add-on for €50 per customer per month, each plus VAT.

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

### Credentials for your customer

Each trade business is a separate customer in PunchCommerce.

- Username and password, which you create for the business in PunchCommerce
- The customer number the business has with you
- Your IDS address, which the business enters in its software together with the credentials
- A test of the connection with the PunchCommerce simulator before the business enters the details

### Trade software with IDS Connect 2.5

A selection of programs that support IDS Connect according to their vendors:

- kwp-bnWin.net
- Streit V.1
- Taifun Handwerk
- pds Software
- topkontor Handwerk
- Labelwin
- Powerbird
- HERO Software
- PASST.prime
- HAPAK

 Do you supply many businesses and need an SLA and dedicated infrastructure? Then the [make-or-buy analysis](https://www.punchcommerce.de/en/punchout-make-or-buy) compares in-house development and PunchCommerce Enterprise over five years.

 FAQ

Frequently asked questions about IDS Connect
--------------------------------------------

What wholesalers want to know before their first IDS Connect interface goes live.

 ###   My customer wants to send heating labels via IDS Connect. Is that possible? +

 No. PunchCommerce does not support the HLS action for sending heating labels; the interface answers it with HTTP status 501. The other actions are not affected: shopping, sending a cart, item deep links and item search work as usual. Check with your customer before setup whether they actually need HLS.

###   A business orders via IDS Connect for several branches with their own customer numbers. How do I set that up? +

 Each customer in PunchCommerce has exactly one customer number, which is checked at every login. If branches order under their own customer numbers, create a separate customer with its own credentials for each branch. You can then adjust the field mapping per branch where needed. Each branch set up this way counts as a separate connected customer.

###   How do I test the IDS Connect interface before the business sets it up? +

 Start the PunchCommerce simulator for the customer you created. It calls your interface like trade software would, using the WKE action and the stored credentials. You shop, transfer the cart and see the line items as well as the generated IDS XML. You can edit the XML and send it back to the shop as a WKS request.

###   What does IDS Connect with PunchCommerce cost if I connect many trade customers? +

 PunchCommerce Business costs €49 per connected trade business per month, plus VAT. Costs grow with the number of connected businesses, i.e. the customers you create in PunchCommerce: 20 businesses cost €980 per month, plus VAT. The Hosted Catalog add-on only applies if you provide your items there instead of in your own shop.

###   How does IDS Connect pass shipping costs to the trade software? +

 If shipping costs apply, they go to the trade software as a separate line item in the cart, with their own item number, name and price. IDS Connect cannot represent a breakdown of shipping costs into individual amounts, so PunchCommerce transfers only the total. The software imports the line item like any other item.

###   Besides IDS Connect customers, I also supply corporate customers via OCI or cXML. Do I need a second account? +

 No. You set the protocol per customer in PunchCommerce. A trade business orders via IDS Connect, a corporate customer orders from its procurement system via OCI or cXML, both from the same shop or Hosted Catalog. All three protocols are included in PunchCommerce Business, and there is no surcharge for IDS Connect.

  Get started

 Your trade customers are waiting for IDS Connect. Deliver the interface today.
--------------------------------------------------------------------------------

 €49 per connected trade business per month, plus VAT. Connect your shop or upload items to the Hosted Catalog, create one customer per business with its customer number, send the credentials, 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
