Zum Hauptinhalt springen
IDS-Connect ist die Schnittstelle der Firma ITEK, über die Handwerkersysteme und Onlineshops Warenkörbe in beide Richtungen austauschen. Für den Handwerker entsteht dadurch ein durchgehender Weg: Er sieht Produkte aus seinem System heraus im Shop, stellt dort einen Warenkorb zusammen, übernimmt ihn als Angebot in sein System, und löst nach der Zusage seines Kunden die Bestellung wieder im Shop aus. Der Shop stellt dafür vier Funktionen bereit: die automatische Anmeldung, einen Deep-Link auf ein Produkt, den Versand des Warenkorbs an das Handwerkersystem und die Entgegennahme eines Warenkorbs aus dem Handwerkersystem.

​
Automatische Anmeldung im Shop

Das Handwerkersystem hängt die Shop-Zugangsdaten des Handwerkers an den Shop-Aufruf an, entweder die E-Mail-Adresse oder die Kundennummer, jeweils mit Passwort. Der Handwerker ist damit im Shop angemeldet. Zwei Voraussetzungen müssen erfüllt sein: Der Handwerker braucht bereits ein Kundenkonto im Shop, und der Aufruf muss über SSL erfolgen. Bei einem Aufruf über http lehnt der Shop die Anmeldung ab. Mit E-Mail-Adresse:
Mit Kundennummer:
Mit beidem:
Mit dem Parameter action=ADL und einer Produktnummer verlinkt das Handwerkersystem direkt auf ein Produkt. Die Zugangsdaten lassen sich mitgeben, der Handwerker landet dann angemeldet auf der Produktseite.

​
Shop sendet Warenkorb an das Handwerkersystem

Das Handwerkersystem ruft den Shop mit action=WKE für Warenkorb empfangen und zusätzlich mit dem Parameter hookurl auf:
Der Handwerker legt im Shop Produkte in den Warenkorb und durchläuft den Checkout, wo er bei Bedarf eine abweichende Lieferadresse sowie Zahlungs- und Versandart wählt. Auf der Bestellübersichtsseite ws_place_order.htm erscheint neben Zahlungspflichtig bestellen ein zweiter Button: Warenkorb zum Handwerkersystem per IDS senden. Ein Klick darauf schickt den Warenkorb per POST an die zuvor übergebene Hook-URL, statt die Bestellung auszulösen. Der Shop sendet dabei diese Daten:
Die wichtigsten Felder je Position: ModeOfShipment enthält Lieferung oder Abholung, je nach der im Checkout gewählten Zustellung. DeliveryPlaceInfo erscheint nur, wenn die Lieferadresse von der Rechnungsadresse abweicht. Beachten Sie, dass Preise sich auf die Bestellmenge beziehen und nicht auf ein einzelnes Stück. Wer OfferPrice als Stückpreis interpretiert, rechnet bei jeder Position mit Menge größer eins falsch.

​
Handwerkersystem sendet Warenkorb an den Shop

Ein im Handwerkersystem hinterlegter Warenkorb lässt sich per POST an den Shop schicken und löst dort eine Bestellung aus. Dazu dient action=WKS:
Der Parameter hookurl muss auch hier mitgesendet werden. Ohne ihn ist keine Rückübertragung möglich. Der Shop verarbeitet diese Daten, die deutlich schlanker sind als in der Gegenrichtung:
Je Position genügen Produktnummer und Menge. Preise übernimmt der Shop aus seinen eigenen Daten, nicht aus dem übergebenen Warenkorb.

​
Verwandte Themen