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 shop systems.

The interface automatically logs the craftsman into the online shop. The craftsman can then compile his goods in the 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 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 shop in his system
  (Craftsman → Shop)

• create offers in his system for his customers from the shop
  (Shopping cart: Shop → Craftsman)

• execute orders in the shop from his system
  (Shopping cart: Craftsman → Shop)

Flowchart

Open

Interface functions

The following functions are implemented by the shop:

• Automatic login to the shop

• Deep link to the product

• Shop sends shopping cart to craftsman

• Craftsman sends shopping cart to the shop

Automatic login in the shop

The craftsman system adds the craftsman's shop login data (e-mail address or customer number and password) in the shop call. The craftsman is then automatically logged into the shop.

The prerequisite is that the craftsman already has his own customer account in the online shop and the shop is called up via SSL (https://...), otherwise the login is rejected by the shop.

Example shop call with e-mail address

Example shop call with customer number

Example shop call with e-mail address and customer number

Article deep link to a product

The craftsman system links to a product in the shop. The login data can be transferred as well.

Example shop call with action parameter ADL and product number

Shop sends shopping cart to the craftsman system

The craftsman system calls the 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 shop call with action parameter WKE and hook-URL

In the shop, 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 shop call-up URL.

The following data is sent via POST from the shop to the hook URL:

Craftsman system sends shopping cart to the shop

A shopping cart stored in the craftsman system can be sent to the online shop via POST and thus trigger an order.

Example shop call with action parameter WKS, hook URL and the shopping cart data

The hookurl parameter must be sent in any case, because only then a retransmission is possible.

The following XML shopping cart data is processed by the shop: