| Scroll export button | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
| Scroll ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Allgemeine Beschreibung
Die IDS-Connect-Schnittstelle der Firma ITEK ermöglicht es, Warenkörbe zwischen den Softwaresystemen des Handwerks und den ShopOnlineshop-Systemen des Großhandels bidirektional zu übertragen.
Über IDS (Integrierte Daten-Schnittstelle) besteht die Möglichkeit Warenwirtschafts-Software, die vor allem im Handwerk eingesetzt wird, schnell und einfach mit einem Onlineshop zu verbinden. Über die Schnittstelle erfolgt eine automatische Anmeldung des Handwerkers im Onlineshop. Danach kann dieser seine Waren im Shop zusammenstellen und zurück in sein System übermitteln um z. B. ein Angebot zu erstellen. Nachdem der Kunde des Handwerkers das Angebot angenommen hat, kann direkt aus der Handwerkersoftware die Bestellung der ausgewählten Ware im Onlineshop ausgelöst werden. Die Bestelldaten werden dann wieder zum Handwerkersystem zurück übertragen.
...
in seinem System Produkte im Shop ansehen
(Handwerker → Shop)aus dem Shop heraus Angebote in seinem System für seine Kunden erstellen
(Warenkorb: Shop → Handwerker)aus seinem System heraus Bestellungen im Shop ausführen
(Warenkorb: Handwerker → Shop)
Ablaufdiagramm
| Inc drawio | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Schnittstellenfunktionen
Folgende Funktionen werden vom Shop implementiert:
Automatische Anmeldung im Shop
Deep-Link zum Produkt
Shop sendet Warenkorb zum Handwerker
Handwerker sendet Warenkorb zum Shop
Automatische Anmeldung im Shop
Das Handwerkersystem fügt im Shop-Aufruf die Shop-Logindaten des Handwerkers hinzu (E-Mail-Adresse oder Kundennummer und das Passwort). Der Handwerker wird dann im Shop automatisch angemeldet.
Voraussetzung ist, dass der Handwerker bereits im Onlineshop über ein eigenes Kundenkonto verfügt und der Shop per SSL (https://...) aufgerufen wird, ansonsten wird die Anmeldung vom Shop abgelehnt.
Beispiel Shop-Aufruf mit E-Mail-Adresse
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort> |
Beispiel Shop-Aufruf mit Kundennummer
| Code Block |
|---|
https://www.shopdomain.de/?kndnr=<Kundennummer>&pw_kunde=<Passwort> |
Beispiel Shop-Aufruf mit E-Mail-Adresse und Kundennummer
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&kndnr=<Kundennummer>&pw_kunde=<Passwort> |
Artikel-Deep-Link auf ein Produkt
Das Handwerkersystem verlinkt auf ein Produkt im Shop. Die Login-Daten können mit übergeben werden.
Beispiel Shop-Aufruf mit action-Parameter ADL und Produktnummer
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort>&action=ADL&ghnummer=<Produktnummer> |
Shop sendet Warenkorb zum Handwerkersystem
Das Handwerkersystem ruft den Shop (zusätzlich zu den Parametern für die automatischen Anmeldung) mit dem Parameter action und dem Wert WKE (Warenkorb empfangen) und mit dem hookurl-Parameter auf.
Beispiel Shop-Aufruf mit action-Parameter WKE und Hook-URL
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort>&action=WKE&hookurl=<Hook-URL> |
...
| Code Block |
|---|
<?xml version="1.0" encoding="ISO-8859-1"?> <Warenkorb xmlns="http://www.itek.de/Shop-Anbindung/Warenkorb/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.itek.de/Shop-Anbindung/Warenkorb/ http://www.itek.de/Shop-Anbindung/Warenkorb/warenkorb_empfangen.xsd" ... > <WarenkorbInfo> <Date>2009-10-29</Date> <!-- Datum --> <Time>17:00:29</Time> <!-- Uhrzeit --> <Version>2.3</Version> <!-- Unterstützte IDS-Version --> </WarenkorbInfo> <Order> <OrderInfo> <ModeOfShipment>Lieferung</ModeOfShipment> <!-- Lieferung oder Abholung, abhängig von der gewählten Zustellung im Checkout--> <Cur>EUR</Cur> <!-- Währung --> </OrderInfo> <SupplierInfo> <!-- Adressdaten vom Shopbeteiber --> <Address> <Name1>Firma & Co. KG</Name1> <!-- Firma --> <Street>Musterweg 6</Street> <!-- Strasse und Hausnummer --> <PCode>58706</PCode> <!-- PLZ --> <City>Menden</City> <!-- Ort --> <Country>Deutschland</Country> <!-- Land --> <Phone>(0049) 02373-9296-0</Phone> <!-- Telefon --> <Email>info@shopdomain.de</Email> <!-- E-Mail --> </Address> </SupplierInfo> <CustomerInfo> <!-- Rechnungsadresse --> <IDNo>12345</IDNo> <!-- Kundennummer --> </CustomerInfo> <DeliveryPlaceInfo> <!-- Lieferadresse, falls abweichend von der Rechnungsadresse --> <Address> <Name1>Musterfirma GmbH</Name1> <!-- Firma --> <Name2></Name2> <!-- Firmenzusatz 1 --> <Name3></Name3> <!-- Firmenzusatz 2 --> <Street>Musterstrasse 1</Street> <!-- Strasse mit Hausnummer --> <PCode>12345</PCode> <!-- PLZ --> <City>Musterhausen</City> <!-- Ort --> <Country>Deutschland</Country> <!-- Land --> </Address> </DeliveryPlaceInfo> <OrderItem> <!-- Warenkorbposition --> <EAN>1234567890128</EAN> <!-- EAN, falls vorhanden --> <ArtNo>4711</ArtNo> <!-- Produktnummer --> <Qty>5</Qty> <!-- Bestellmenge als Integer --> <QU>PCE</QU> <!-- Mengeneinheit, ist immer Stück "PCE" --> <Kurztext>...</Kurztext> <!-- Produktname --> <Langtext>...</Langtext> <!-- Produktbeschreibung (max. 1000 Zeichen) --> <OfferPrice>119.00</OfferPrice> <!-- Brutto-Preis, bezogen auf die Bestellmenge --> <NetPrice>100.00</NetPrice> <!-- Netto-Preis, bezogen auf die Bestellmenge --> <PriceBasis>5</PriceBasis> <!-- Preis-Basis, bezogen auf die Bestellmenge --> <VAT>19.00</VAT> <!-- MwSt --> </OrderItem> <OrderItem> <!-- Nächste Warenkorbposition --> ... </OrderItem> <OrderItem> <!-- Nächste Warenkorbposition --> ... </OrderItem> ... </Order> </Warenkorb> |
Handwerkersystem sendet Warenkorb zum Shop
Ein im Handwerkersystem hinterlegter Warenkorb kann per POST an den Onlineshop gesendet und damit eine Bestellung ausgelöst werden.
Beispiel Shop-Aufruf mit action-Parameter WKS, Hook-URL und den Warenkorbdaten
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort>&action=WKS&hookurl=<Hook-URL>&warenkorb=<XML-Warenkorbdaten> |
...
| Code Block |
|---|
<?xml version="1.0" encoding="UTF-8"?> <Warenkorb xmlns="http://www.itek.de/Shop-Anbindung/Warenkorb/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.itek.de/Shop-Anbindung/Warenkorb/ http://www.itek.de/Shop-Anbindung/Warenkorb/warenkorb_senden.xsd" ... > <Order> <OrderItem> <!-- Warenkorbposition --> <ArtNo>471211</ArtNo> <!-- Produktnummer --> <Qty>1</Qty> <!-- Bestellmenge, als Integer --> </OrderItem> <OrderItem> <!-- Nächste Warenkorbposition --> ... </OrderItem> <OrderItem> <!-- Nächste Warenkorbposition --> ... </OrderItem> ... </Order> </Warenkorb> |
| Include Page | ||||
|---|---|---|---|---|
|