{"id":1965,"date":"2020-09-23T07:10:07","date_gmt":"2020-09-23T07:10:07","guid":{"rendered":"https:\/\/support.itscope.hostpress.me\/?post_type=kb&#038;p=1965"},"modified":"2025-03-13T14:23:20","modified_gmt":"2025-03-13T12:23:20","slug":"real-time-retrieval","status":"publish","type":"kb","link":"https:\/\/guide.itscope.com\/en\/kb\/real-time-retrieval\/","title":{"rendered":"Realtime retrieval"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\" id=\"1\">General information<\/h2>\n\n\n\n<p>If you update your online shop stock levels\/prices in realtime, then directly connecting your online systems with ITscope makes sense.<\/p>\n\n\n\n<p>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.<\/p>\n\n\n\n<p>If your online system requires a special Web Service Account or similar, ITscope users should receive it.<\/p>\n\n\n\n<p><strong>Important:<\/strong> ITscope obtained no information on accounts nor carried price or availability schedules.<\/p>\n\n\n\n<p>All communication takes place exclusively between the client and your (web) server.<\/p>\n\n\n\n<p>The following variants are possible:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><tbody><tr><td>Type of interface<\/td><td>Particularities<\/td><\/tr><tr><td>XML interface<\/td><td>Please provide us with test access and the official interface documentation<\/td><\/tr><tr><td>HTTPS interface<\/td><td>Please let us know the format of the HTTP\/GET request<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\" id=\"2\">Retrieval example<\/h2>\n\n\n\n<p>The following two example HTTP calls demonstrate how the two supported file types <strong>CSV<\/strong> and <strong>XML<\/strong> can be processed.<\/p>\n\n\n\n<p><strong>1. CSV example<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>Example retrieval link:\u00a0<\/strong>https:\/\/ihredomain.de\/pricelist\/<strong>user<\/strong>=smith&amp;<strong>password<\/strong>=xxxzzz&amp;<strong>article<\/strong>=123456<\/code><\/pre>\n\n\n\n<p>Answer received:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>article;<\/strong><strong>quantity;<\/strong><strong>price;d<\/strong><strong>eliverydate;<\/strong><strong>quantity-ext<\/strong><br>123456;36;110.80;21.09.2016;25<br>67890;61;215.90;26.09.2016;12<\/code><\/pre>\n\n\n\n<p>Mandatory fields are:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>article<\/li>\n\n\n\n<li>quantity<\/li>\n\n\n\n<li>price<br><\/li>\n<\/ul>\n\n\n\n<p><strong>2. XML example<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code><strong>Example retrieval link:<\/strong> https:\/\/service.yourdomain.de\/?user=111222&amp;passwort=abcdefgh&amp;article=123456<\/code><\/pre>\n\n\n\n<pre class=\"wp-block-code\"><code>&lt;Realtime>\n&lt;Result ID=\"0\">ok&lt;\/Result>\n  &lt;Article>\n   &lt;ID>123456&lt;\/ID>\n   &lt;PRICE CURRENCY=\"EUR\">110.80&lt;\/PRICE>\n   &lt;QUANTITY>36&lt;\/QUANTITY>\n   &lt;DELIVERYDATE>21.09.2026&lt;\/DELIVERYDATE>\n   &lt;QUANTITY-EXT>25&lt;\/QUANTITY-EXT>\n  &lt;\/Article>\n &lt;Article>\n  &lt;ID>67890&lt;\/ID>\n  &lt;PRICE CURRENCY=\"EUR\">215.90&lt;\/PRICE>\n  &lt;QUANTITY>21&lt;\/QUANTITY>\n  &lt;DELIVERYDATE>26.09.2026&lt;\/DELIVERYDATE>\n  &lt;QUANTITY-EXT>12&lt;\/QUANTITY-EXT>\n &lt;\/Article>\n&lt;\/Realtime><\/code><\/pre>\n\n\n\n<p>Mandatory fields are:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Result ID<\/strong> -> corresponds to the result code (see further information below)<\/li>\n\n\n\n<li><strong>ID<\/strong> -> corresponds to the unique article number (SKU)<\/li>\n\n\n\n<li><strong>Price<\/strong> -> selling price of the product<\/li>\n<\/ul>\n\n\n\n<p>The other fields, including&nbsp;<strong>DELIVERYDATE<\/strong> (delivery date) and <strong>QUANTITY-EXT <\/strong>(external warehouse stock level), are optional.<\/p>\n\n\n\n<p>The following states can, for example, be transmitted with the&nbsp;<strong>&#8216;Result ID<\/strong>&#8216; codes:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Successfully OK<\/li>\n\n\n\n<li>Authentication errors<\/li>\n\n\n\n<li>Item not found<\/li>\n<\/ul>\n\n\n\n<p>In general, the number of articles contained in the result may, of course, also include more than one article.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>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 &#8230;<\/p>\n","protected":false},"author":5,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"footnotes":""},"kbtopic":[228],"kbtag":[],"class_list":["post-1965","kb","type-kb","status-publish","hentry","kbtopic-listing-options-layout-and-eservices"],"_links":{"self":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/1965","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb"}],"about":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/types\/kb"}],"author":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/comments?post=1965"}],"version-history":[{"count":4,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/1965\/revisions"}],"predecessor-version":[{"id":17862,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kb\/1965\/revisions\/17862"}],"wp:attachment":[{"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/media?parent=1965"}],"wp:term":[{"taxonomy":"kbtopic","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtopic?post=1965"},{"taxonomy":"kbtag","embeddable":true,"href":"https:\/\/guide.itscope.com\/en\/wp-json\/wp\/v2\/kbtag?post=1965"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}