FAQ/Export/Realtime-Abfragen
Aus ITscope GmbH - Wissensbasis
1 Was sind Realtime-Abfragen?
Realtime-Abfragen holen Lagerbestände und Preise für einen abgefragten Artikel direkt über eine Schnittstelle des Distributors, so daß diese minutenaktuell sind. Sind für einen Lieferanten keine aktualisierungsfähige Konten im MarketViewer hinterlegt, wird der Standardpreis aus der ITscope-Datenbank geholt, zusammen mit dem (meist alle 20 min bis 1h) aktualisierten Lagerbestand oder Status.
Einschränkungen: Um die Last auf die Distributorenserver zu reduzieren, werden je Anfrage maximal 30 einzelne Requests abgesetzt. Das heißt, eine Anfrage über 5 Produkte mit je 6 realtimefähigen Accounts würde das "Kontingent" erschöpfen. Da die Realtime-Profile ONDEMAND-Profile sind, können generell nicht mehr als 10 Artikel auf einmal abgefragt werden.
2 Wie erhalte ich über die Realtime-Abfragen auch Preise?
Dazu müssen Sie eine der Realtime-Vorlagen (XML oder HTML) instanziieren, also ein eigenes Profil erstellen. Unter Datenformat modellieren müssen Sie die gewünschten zusätzlichen Felder markieren, z.B. unterhalb von source alles, was mit preis zu tun hat. Oder auch eine Preiskalkulation (welche Preisregel verwendet werden soll, können Sie ebenfalls in dem Profil unter "Parameter" am gewohnten Platz angeben, für die Kalkulation werden dann auch die Realtimepreise verwendet).
Bei der Realtimeabfrage geben Sie im Link unter
profileId=XMLREALTIMESTATUS
statt XMLREALTIMESTATUS die Profil-ID Ihres neu instanziierten Profils an.
Die Parameter können mittels pp-Präfix im Link auch dynamisch gesetzt werden, die bei XMLREALTIMESTATUS, z.B. könnte mittels
pp_pcId=PREISREGELID
eine andere Preisregel gesetzt werden oder mit pp_suppliers die berücksichtigten Lieferanten eingeschränkt werden.
Vorsicht: Bei Einschränkung der Lieferanten verändert sich ggf. auch der kalkulierte Preis!
3 Wie kann ich für existierende HTML-Profile Realtime-Daten abfragen?
Sie müssen den Parameter pp_realtime an den Link anhängen. Wenn die Realtimeabfragen auf bestimmte Distributoren beschränkt werden soll, müssen Sie auch pp_suppliers anhängen.
Dies funktioniert zum Beispiel für HTMLPRICES oder HTMLSTATUS oder HTMLRCONNECTOR:
http://iws.itscope.de/xsltService?method=productLookup&iwsKey=YOURKEY&profileId=HTMLPRICES&itsPid=98190000&pp_realtime=true
4 Gibt es eine Echtzeit-Verfügbarkeitsabfrage für Webshops?
Ja, ITscope bietet eine gecachte Realtime-Bestandsabfrage für Webshops im HTML- und XML-Format an. Die Links dazu können Sie über das vordefinierte Feld cont_realtimeLinkItscope exportieren. Sie können diesen Link auf Ihre Produktseiten im Webshop einbauen und haben somit immer eine aktuelle Verfügbarkeitsanzeige. Das angezeigte HTML kann nach Ihren Vorstellungen angepaßt werden, Sie können auch eigene XSL-Vorlagen liefern.
Nähere Informationen:
- XML-Beispiel Festplatte, Ingram Micro und Tech Data aggregiert:
http://www.wsrealtime.de/xsltService?method=productLookup&iwsKey=<IHRIWSKEY>&profileId=XMLREALTIMESTATUS&itsPid=90549000&pp_suppliers=14,58
- HTML-Beispiel Festplatte, nur Ingram Micro:
http://www.wsrealtime.de/xsltService?method=productLookup&iwsKey=<IHRIWSKEY>&profileId=HTMLREALTIMESTATUS&itsPid=90549000&pp_suppliers=14
Hinweis: <IHRIWSKEY> muß durch Ihren ITscope Webservice-Key, den Sie bei der Registrierung erhalten haben, ersetzt werden. Um von den entsprechenden Lieferanten die Abfrage nutzen zu können, müssen Ihre Zugangsdaten hinterlegt sein!
Sie können als Abfrageparameter jede beliebige ID verwenden, nicht nur die ITscope-Artikelnummer (itsPid): Möglich sind auch Lieferantennummern, Herstellernummern, EAN oder DCI-Nummern. Dokumentation dazu siehe productLookup.
Für den Export: Wir haben ein neues vordefiniertes Feld angelegt mit Namen "cont_realtimeStatusLink", das den Link für den entsprechenden Realtimeabruf eines Artikels enthält. Der Lieferant wird dynamisch aus der Preiskalkulation gesetzt, so daß nur die Verfügbarkeit des Lieferanten verwendet wird, mit dem der Preis kalkuliert wurde. Dies ist aber beliebig anpaßbar: der Lieferantenparameter kann auch statisch sein.
5 Wie kann ich die Lieferanten der Echtzeit-Bestandsabfrage einstellen?
Dazu gibt es 2 Möglichkeiten:
1) Bei Verwendung der Vorlagen XML/HTMLREALTIMESTATUS: Sie können die Lieferanten-IDs per URL-Parameter mit übergeben (Parameter pp_suppliers), wie im vorherigen Beispiel
2) Instanziieren eines der Templates und dortige Einstellung der Lieferanten. Diese Instanz muß dann für die Realtimeabfragen verwendet werden.
6 Wie kann ich eine eigene HTML-Vorlage für die Echtzeit-Bestandsabfrage verwenden?
Schicken Sie uns eine HTML-Vorlage, wie das Abfrageergebnis formatiert werden soll und wir bauen dies für Sie in den Webservice ein.