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 interface | Particularities |
| XML interface | Please provide us with test access and the official interface documentation |
| HTTP interface | Please 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.