MV2/Realtime-Abfragen

Aus ITscope GmbH - Wissensbasis

< MV2
Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

1 Realtime-Abfragen

Realtime-Abfragen holen Lagerbestände und Preise für einen abgefragten Artikel direkt über eine Schnittstelle des Distributors, so dass diese minutenaktuell sind. Sind für einen Lieferanten keine aktualisierungsfähigen Konten im MarketViewer hinterlegt, wird der Standardpreis aus der ITscope-Datenbank geholt, zusammen mit dem (meist stündlich) aktualisierten Lagerbestand oder Status. Dies gilt nur für Allgemeine Preislisten. Für individuelle Preislisten gilt dies nicht.

Die Realtime-Abfrage kann über das Bezugsquellenfenster ein- bzw. ausgeschaltet werden.

Realtime-Abfragen

Hinweis: Durch die Realtime-Abfragen können sich die Preise und Bestände vom MarketViewer und Ihrem Webshop unterscheiden.

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.

1.1 Preise über die Realtime-Abfragen

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!

1.2 Realtime-Datenabfragen für exisitierende HTML-Profile

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

1.3 Echtzeit-Verfügbarkeitsabfrage für Webshops

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,588
  • HTML-Beispiel Festplatte, nur Ingram Micro: 
http://www.wsrealtime.de/xsltService?method=productLookup&iwsKey=<IHRIWSKEY>&profileId=HTMLREALTIMESTATUS&itsPid=90549000&pp_suppliers=148

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 http://www.itscope.de/wiki/IWS3/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.

1.4 Lieferanten in der Echtzeit-Bestandsabfrage

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.

1.5 Verwenden einer eigenen HTML-Vorlage für die Echtzeit-Bestandsabfrage

Schicken Sie uns eine HTML-Vorlage, wie das Abfrageergebnis formatiert werden soll und wir bauen dies für Sie in den Webservice ein.

2 Siehe auch

Von „http://www.itscope.de/wiki/MV2/Realtime-Abfragen“