IDS 2.5 Test Forms - IntelliShop

⚙️ Globale Konfiguration

IDS Endpoint URL:

QM Basic Auth:

Custom URL:

Kundennummer (kndnr):

Benutzername (name_kunde):

Passwort (pw_kunde):

Action Parameter senden:

📋 WKE - Warenkorb Empfangen (Session Start)

Zweck: Startet eine PunchOut Session und öffnet den Shop

Response: Redirect zur Shop-Startseite mit Session-Cookie

Verwendung: Handwerker startet den Shop aus seiner Software

📦 WKS - Warenkorb Senden

Zweck: Sendet einen Warenkorb (XML) vom Handwerker zum Shop

Response: Redirect zur Warenkorb-Ansicht im Shop

Verwendung: Handwerker überträgt Angebot/Bestellung zum Shop zur Bearbeitung

Pflichtfelder

Hook URL PFLICHT

Warenkorb Optionen

RueckgabeKZ (Return Type): Warenkorbrückgabe = Nur Empfangsbestätigung | Warenkorbrückgabe mit Bestellung = User kann im Shop weitereinkaufen

Warenkorb XML XML REQUIRED

Warenkorb (warenkorb parameter):

🔗 ADL - Artikel-Deeplink

Zweck: Zeigt direkt eine Produktdetailseite an

Response: Redirect zur Produktseite

Verwendung: Handwerker will schnell ein Produkt nachschlagen

⚠️ Wichtig: ghnummer muss existieren!

Die Großhandelsnummer muss in eurem System als SKU, EAN oder in Produktattributen vorhanden sein.

🔍 AS - Artikel-Suche

Zweck: Öffnet die Suchfunktion mit vorgegebenem Suchbegriff

Response: Redirect zur Suchergebnis-Seite

Verwendung: Handwerker sucht Artikel und kann sie zur Software zurückschicken

Pflichtfelder

Suchbegriff (searchterm) PFLICHT Mehrere Begriffe mit Leerzeichen trennen

Hook URL PFLICHT

Test-Suchbegriffe

Beispiele:
- "Heizung Gas"              → Einfache Suche
- "Brennwertkessel 24 kW"    → Mit technischen Daten
- "Vaillant EcoTec"          → Marke + Modell
- "Thermostat digital"       → Produktkategorie + Eigenschaft
                    

🏷️ HLS - Heatinglabel Senden

Zweck: Sendet Artikelliste zur ErP-Label Berechnung

Response: Redirect zur Heatinglabel-Plattform

Verwendung: Berechnung von Verbundlabels für Heizungsanlagen

⚠️ Work in Progress

HLS ist zu 70% implementiert. PDF-Generierung fehlt noch.

Pflichtfelder

Hook URL PFLICHT

Heatinglabel XML XML REQUIRED

Heatinglabel (heatinglabel parameter):

<?xml version="1.0" encoding="UTF-8"?>
<Heatinglabel>
    <HeatinglabelInfo>
        <Date>2025-11-17</Date>
        <Time>14:30:00</Time>
        <Version>2.5</Version>
        <LabelTransmit>true</LabelTransmit>
    </HeatinglabelInfo>
    <Package>
        <PackageFunction>A</PackageFunction>
        <PackageType>COLL</PackageType>
        <Position>
            <LineNo>1</LineNo>
            <RefItem>
                <RefItemID>POS-001</RefItemID>
            </RefItem>
            <SupplierPartID>VAILLANT-VC246</SupplierPartID>
            <ShortText>Vaillant ecoTEC plus VC 246/5-5</ShortText>
            <ProductType>RHG-NT</ProductType>
            <LoadProfile>XL</LoadProfile>
            <EnergyClass>A+</EnergyClass>
            <QTY>
                <Amount>1.000</Amount>
                <UOM>STK</UOM>
            </QTY>
        </Position>
        <Position>
            <LineNo>2</LineNo>
            <RefItem>
                <RefItemID>POS-002</RefItemID>
            </RefItem>
            <SupplierPartID>VAILLANT-VIH300</SupplierPartID>
            <ShortText>Vaillant uniSTOR VIH R 300</ShortText>
            <ProductType>WWB-S</ProductType>
            <EnergyClass>B</EnergyClass>
            <QTY>
                <Amount>1.000</Amount>
                <UOM>STK</UOM>
            </QTY>
        </Position>
    </Package>
</Heatinglabel>

ℹ️ LI - Login-Informationen

Zweck: Fragt ab, welche Login-Felder der Shop benötigt

Response: XML mit true/false für Kundennummer, Benutzername, Passwort

Verwendung: Handwerkssoftware will wissen, welche Felder sie anzeigen muss

📋 SV - Schnittstellenversion

Zweck: Fragt ab, welche IDS Versionen der Shop unterstützt

Response: XML mit Liste der unterstützten Versionen

Verwendung: Handwerkssoftware prüft Kompatibilität

🔧 IDS 2.5 Test Forms

⚙️ Globale Konfiguration

📋 WKE - Warenkorb Empfangen (Session Start)

Pflichtfelder

📦 WKS - Warenkorb Senden

Pflichtfelder

Warenkorb Optionen

Warenkorb XML XML REQUIRED

🔗 ADL - Artikel-Deeplink

⚠️ Wichtig: ghnummer muss existieren!

Pflichtfelder

Test-Beispiele

🔍 AS - Artikel-Suche

Pflichtfelder

Test-Suchbegriffe

🏷️ HLS - Heatinglabel Senden

⚠️ Work in Progress

Pflichtfelder

Heatinglabel XML XML REQUIRED

ℹ️ LI - Login-Informationen

Keine zusätzlichen Parameter nötig

📋 SV - Schnittstellenversion

Keine zusätzlichen Parameter nötig