Realtime retrieval

Last modified: 8. December 2020

General information

If you update your online shop stock levels/prices in realtime, then directly connecting your online systems with ITscope makes sense.

The ideal case therefore provides that only the specification of the existing login / password combination (e.g for the online shop) is necessary for the retrieval of realtime prices and availability.

If your online system requires a special Web Service Account or similar, ITscope users should receive it.

Important: ITscope obtained no information on accounts nor carried price or availability schedules.

All communication takes place exclusively between the client and your (web) server.

The following variants are possible:

Type of interfaceParticularities
XML interfacePlease provide us with test access and the official interface documentation
HTTP interfacePlease let us know the format of the HTTP/GET request

Retrieval example

The following two example HTTP calls demonstrate how the two supported file types CSV and XML can be processed.

1. CSV example

Example retrieval link: http://ihredomain.de/pricelist/user=smith&password=xxxzzz&article=123456

Answer received:

article;quantity;price;deliverydate;quantity-ext
123456;36;110.80;21.09.2016;25
67890;61;215.90;26.09.2016;12

Mandatory fields are:

  • article
  • quantity
  • price

2. XML example

Example retrieval link: http://service.yourdomain.de/?user=111222&passwort=abcdefgh&article=123456

<Realtime>
<Result ID=”0″>ok</Result>
<Article>
<ID>123456</ID>
<PRICE CURRENCY=”EUR”>110.80</PRICE>
<QUANTITY>36</QUANTITY>
<DELIVERYDATE>21.09.2016</DELIVERYDATE>
<QUANTITY-EXT>25</QUANTITY-EXT>
</Article>
<Article>
<ID>67890</ID>
<PRICE CURRENCY=”EUR”>215.90</PRICE>
<QUANTITY>21</QUANTITY>
<DELIVERYDATE>26.09.2016</DELIVERYDATE>
<QUANTITY-EXT>12</QUANTITY-EXT>
</Article>
</Realtime>

Mandatory fields are:

  • Result ID -> corresponds to the result code (see further information below)
  • ID -> corresponds to the unique article number (SKU)
  • Price -> selling price of the product

The other fields, including DELIVERYDATE (delivery date) and QUANTITY-EXT (external warehouse stock level), are optional.

The following states can, for example, be transmitted with the ‘Result ID‘ codes:

  • Successfully OK
  • Authentication errors
  • Item not found

In general, the number of articles contained in the result may, of course, also include more than one article.

Was this article helpful?
Dislike 0
Views: 157