====== IDS-Connect ======

In einem gemeinsamen Projekt für die Verbände Bundesverband Bausoftware e.V. (BVBS) und Deutscher Großhandelsverband Haustechnik (DG-Haustechnik) hat die Firma ITEK eine Schnittstelle zur Anbindung der Großhandels-Systeme an die Handwerkssoftware definiert. Damit wurde ein Standard etabliert, der einen Zugang aus den Softwaresystemen des Handwerks zu den Shop-Systemen des Großhandels ermöglicht. Gegenwärtig werden folgende Prozesse unterstützt:
  * Warenkorb empfangen
  * Warenkorb senden
  * Artikel-Deep-Link

Die Handwerkersoftware selbst wird individuell konfiguriert. Die APP selbst beinhaltet eine umfangreiche Dokumentation, die hier noch einmal angezeigt wird.

==== Anlage des Kunden ====

Der Kunde, aus Shopsicht betrachtet, benötigt keine Zuweisung einer IDS Schnittstelle über die Benutzerverwaltung. Die Erkennung erfolgt automatisch bei der Übergabe entsprechender Parameter.


==== Anlage in der Handwerkersoftware durch den Kunden ====
Damit der Multishop per IDS-Connect in eine Handwerker-Software integriert werden kann, müssen Sie sich als verfügbarer Großhändler / Lieferant in einem Verzeichnisdienst/Portal eintragen lassen.
Die Einrichtung des Zugriffs per IDS-Connect erfolgt per Abruf über diese Verzeichnisdienste.
Hier werden dem Handwerker sämtliche verfügbaren Großhändler / Lieferanten aufgelistet.
Nach Auswahl eines Großhändlers / Lieferanten werden die Aufrufadresse, etc. automatisiert innerhalb der Handwerksoftware eingerichtet und der Handwerker muss nur noch seine individuellen Daten (Login / Passwort) eintragen.

Der komplette Aufruflink Ihres Multishops:

http://localhost/shop/index_oci.php?mode=IDS&Version=2.0&name_kunde=**USERNAME**&pw_kunde=**PASSWORT**&hookurl=Beispiel-HookURL

USERNAME und PASSWORT bitte durch die Zugangsdaten des Kunden ersetzen.
Beispiel-HookURL wird von der Handwerkersoftware automatisch hinterlegt.
Somit ergibt sich in gekürzter Form folgende URL, welche als Parameter zu hinterlegen ist:

http://localhost/shop/index_oci.php?mode=IDS&Version=2.0


==== Testaufruf und Testbestellung.====
Nach dem Aufruf des Kataloges aus der Handwerkersoftware heraus, weiß das Shopsystem, dass es sich, bedingt durch die HOOKURL um einen Fremdaufruf mit Rücksprungmarke (IDS) handelt. Dadurch verändert sich die Programmierung am Warenkorb wie folgt:
Je nach ausgewählter Option wird entweder im Bereich des Warenkorbes der 'Zur Kasse'-Button durch eine Übermittelung an die Handwerker-Software ausgetauscht oder es erfolgt eine automatische Übermittelung nach Abschluß des Bestellprozesses.

==== Speziell für den Shopbetreiber ====

Datentechnisch müssen evtl. vom Betreiber noch z.B. ECLASS Nummer den jeweiligen Artikeln zuordnen, ebenso die ICOCODES oder weitere kundenspezifische Hinterlegungen vorgenommen werden. Diesen Schritt müssen Sie evtl. über die [[backend:artikeldetail|Artikelverwaltung]] durchführen.


==== Parameter für weitere Funktionen ====

Warenkorb senden:
action = WKS
warenkorb = XML ihres Warenkorbes

Warenkorb Empfangen:
action = WKE

Deeplink:
action = ADL
ghnummer = Angabe der Großhandelsartikelnummer

Logininformationen:
action = LI

Schnittstellenversion:
action = SV