| Scroll export button | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
| Scroll ignore | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
General description
The IDS-Connect interface of the company ITEK makes it possible to transfer shopping carts bidirectionally between the software systems of the craftsmen and the online store shop systems.
the The interface automatically logs the craftsman into the online storeshop. The craftsman can then compile his goods in the store shop and transfer them back to his system, for example, to create an offer. After the craftsman's customer has accepted the offer, the order for the selected goods in the online store shop can be triggered directly from the craftsman software. The order data is then transferred back to the craftsman's system.
A craftsman can
view products in the store shop in his system
(Craftsman → Shop)create offers in his system for his customers from the store shop
(Shopping cart: Shop → Craftsman)execute orders in the store shop from his system
(shopping Shopping cart: craftsman Craftsman → storeShop)
Flowchart
| Inc drawio | ||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Interface functions
...
Interface functions
The following functions are implemented by the shop:
Automatic login to the storeshop
Deep link to the product
Store Shop sends shopping cart to craftsman
Craftsman sends shopping cart to the storeshop
Automatic login in the
...
shop
The craftsman system adds the craftsman's store shop login data (e-mail address or customer number and password) in the store shop call. The craftsman is then automatically logged into the storeshop.
The prerequisite is that the craftsman already has his own customer account in the online store shop and the store shop is called up via SSL (https://...), otherwise the login is rejected by the storeshop.
Example store shop call with e-mail address
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort> |
Example store shop call with customer number
| Code Block |
|---|
https://www.shopdomain.de/?kndnr=<Kundennummer>&pw_kunde=<Passwort> |
Example store shop call with e-mail address and customer number
...
The craftsman system links to a product in the storeshop. The login data can be transferred as well.
Example store shop call with action parameter ADL and product number
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort>&action=ADL&ghnummer=<Produktnummer> |
...
Shop sends shopping cart to the craftsman system
The craftsman system calls the store shop (in addition to the parameters for automatic login) with the action parameter and the value WKE (shopping cart received) and with the hookurl parameter.
Example store shop call with action parameter WKE and hook-URL
| Code Block |
|---|
https://www.shopdomain.de/?name_kunde=<E-Mail>&pw_kunde=<Passwort>&action=WKE&hookurl=<Hook-URL> |
In the storeshop, the craftsman selects one or more products and adds them to his shopping cart. In the checkout process, the craftsperson can specify a different delivery address if necessary and select the payment and shipping method.
On the order overview page (ws_place_order.htm), another button "Send shopping cart to craftsman system via IDS" is offered next to the "Order subject to payment" button. When you click on this button, the shopping cart is sent to the craftsman system via the HOOK URL previously transferred in the store shop call-up URL.
The following data is sent via POST from the store shop to the 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> |
Craftsman system sends shopping cart to the
...
shop
A shopping cart stored in the craftsman system can be sent to the online store shop via POST and thus trigger an order.
Example store shop call with action parameter WKS, hook URL and the shopping cart data
...
The following XML shopping cart data is processed by the storeshop:
| 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 | ||||
|---|---|---|---|---|
|