Was ist IDS Connect?

IDS Connect ist das standardisierte Schnittstellenprotokoll für den deutschen Großhandel – insbesondere in den Bereichen Sanitär, Heizung, Klima (SHK) und Elektro. Es ermöglicht Handwerksbetrieben und Fachunternehmen, Produkte direkt aus ihrer Branchensoftware heraus im Katalog eines Lieferanten zu suchen, auszuwählen und in den eigenen Warenkorb zu übernehmen.

Im Gegensatz zu OCI (SAP-Umfeld) und cXML (Ariba, Coupa) ist IDS Connect speziell auf die Anforderungen des technischen Großhandels in Deutschland zugeschnitten.

Neu: PunchCommerce unterstützt ab sofort IDS Connect als vollwertiges PunchOut-Protokoll im Gateway Mode.

Wie funktioniert der IDS Connect Gateway?

Im Gateway Mode fungiert PunchCommerce als Brücke zwischen der Branchensoftware Ihres Kunden und Ihrem bestehenden Onlineshop:

Aufruf: Der Einkäufer startet den PunchOut aus seiner Branchensoftware (z. B. einem ERP- oder Warenwirtschaftssystem mit IDS-Connect-Unterstützung).
Weiterleitung: PunchCommerce empfängt die IDS-Connect-Anfrage und leitet den Einkäufer an Ihren Shop weiter.
Produktauswahl: Der Einkäufer durchsucht Ihren Shop, wählt Produkte aus und legt sie in den Warenkorb.
Rückgabe: Beim Abschluss übergibt PunchCommerce den Warenkorb im IDS-Connect-Format zurück an die Branchensoftware – inklusive aller relevanten Artikeldaten.

Unterstützte IDS-Connect-Actions

Die IDS-Schnittstelle (Version 2.5) definiert sieben Aktionen. PunchCommerce unterstützt alle Aktionen mit Ausnahme von Heatinglabel senden (HLS).

Aktionscode	Aktion	Unterstützt	Beschreibung
`WKE`	Warenkorb empfangen	✅	Übernahme eines Warenkorbs aus dem Shop in die Handwerkssoftware.
`WKS`	Warenkorb senden	✅	Übergabe eines Warenkorbs aus der Handwerkssoftware an den Shop.
`ADL`	Artikeldeeplink	✅	Aufruf einer Artikeldetailseite im Shop anhand der Großhandelsartikelnummer.
`AS`	Artikelsuche	✅	Aufruf der Artikelsuche im Shop mit Suchbegriffsübergabe und Rückübertragung der ausgewählten Artikel.
`LI`	Logininformationen	✅	Abfrage, welche Login-Parameter (Kundennummer, Benutzername, Passwort) vom Shop benötigt werden.
`SV`	Schnittstellenversion	✅	Abfrage der unterstützten Versionen der IDS-Schnittstelle.
`HLS`	Heatinglabel senden	❌	Übermittlung einer Artikelliste an eine Plattform zur Berechnung des ErP-Verbundlabels für Heizungsanlagen.

Warum wird Heatinglabel senden nicht unterstützt?

Die Action HLS dient der Übergabe von Artikellisten an eine externe Plattform zur Berechnung von ErP-Energielabels für Verbundanlagen (Heizung, Warmwasser, Kombi). Diese Funktion erfordert eine spezialisierte Berechnungsplattform und liegt außerhalb des PunchOut-Katalog-Kontexts.

Unterstützte Shopsysteme

IDS Connect im Gateway Mode funktioniert mit allen PunchCommerce-Plugins:

Shopware 6
Shopware 5
Magento (Adobe Commerce)
Spryker
JTL Shop
Vendure
Medusa

Über die PunchCommerce-API lässt sich IDS Connect auch mit individuellen Shop- oder Kataloglösungen umsetzen.

Einrichtung

1. Plugin installieren und verbinden

Falls noch nicht geschehen: Installieren Sie das PunchCommerce-Plugin in Ihrem Shopsystem und verbinden Sie es mit Ihrem PunchCommerce-Account. Anleitungen finden Sie in der jeweiligen Plugin-Dokumentation.

2. Neuen Kunden anlegen

Legen Sie in PunchCommerce einen neuen Kunden an und wählen Sie als Protokoll IDS Connect aus.

3. Verbindungsdaten konfigurieren

Tragen Sie die IDS-Connect-spezifischen Parameter ein, die Sie von Ihrem Kunden erhalten haben. Dazu gehören unter anderem:

HOOK-URL: Die Rücksprungadresse, an die der Warenkorb nach Abschluss des PunchOut zurückgesendet wird.
Kundennummer / Benutzername / Passwort: Die Zugangsdaten für die automatische Anmeldung im Shop.

Die genauen Felder sehen Sie direkt in der Konfigurationsmaske.

4. Field-Mapping prüfen

Über das Field-Mapping ordnen Sie Ihre Shop-Attribute (z. B. EAN, Artikelnummer, Kurztext) den entsprechenden IDS-Connect-Feldern zu. PunchCommerce liefert sinnvolle Standardwerte mit – in vielen Fällen ist hier keine Anpassung nötig.

Wenn ein Pflichtfeld in Ihrem Shop nicht befüllt ist, greift automatisch der konfigurierte Fallback-Wert.

5. Verbindung testen

Nutzen Sie den integrierten PunchOut-Simulator, um die IDS-Connect-Anbindung zu testen – ohne auf die IT-Abteilung Ihres Kunden warten zu müssen. Der Simulator zeigt Ihnen, welche Daten übertragen werden und ob die Konfiguration korrekt ist.

Technische Details

Datenübertragung

IDS Connect nutzt HTTP-POST mit multipart/form-data als Encoding. Die Warenkorbdaten werden als XML-Struktur im Parameter warenkorb übertragen. Der Zeichensatz wird in der XML-Deklaration angegeben – Standard ist UTF-8.

Schnittstellenversion

PunchCommerce unterstützt die IDS-Schnittstelle in Version 2.5. Die unterstützten Versionen können über den Aktionscode SV abgefragt werden.

Rückkommunikation

Die Rückübertragung des Warenkorbs an die Handwerkssoftware erfolgt über die beim Aufruf übergebene HOOK-URL – analog zur OCI-Schnittstelle.

Häufige Fragen

Was unterscheidet IDS Connect von OCI und cXML?

OCI ist der Standard für SAP-Beschaffungssysteme, cXML wird in globalen Procurement-Netzwerken wie Ariba oder Coupa eingesetzt. IDS Connect wurde speziell für den deutschen Fachgroßhandel entwickelt und ist auf die Anforderungen von Handwerkersoftware und Branchenlösungen im SHK- und Elektro-Bereich ausgerichtet.

Kann ich IDS Connect und andere Protokolle parallel nutzen?

Ja. PunchCommerce unterstützt OCI, cXML und IDS Connect gleichzeitig. Sie können für jeden Kunden individuell festlegen, welches Protokoll verwendet wird.

Brauche ich für IDS Connect ein anderes Plugin?

Nein. Die bestehenden PunchCommerce-Plugins unterstützen alle drei Protokolle. Wenn Ihr Plugin bereits installiert ist, können Sie IDS Connect sofort nutzen – keine zusätzliche Installation erforderlich.

PunchOut über das IDS-Connect Gateway