IWS/Dokumentation/Merkmale und Leistungsfähigkeit
Aus ITscope GmbH - Wissensbasis
1 Allgemein
Beispiele werden im allgemeinen für REST im XML-Format und der Anfrage als URL gezeigt. Alternativ sind SOAP und csv Services möglich.
Serviceübersicht
API Methoden
Fragen:
- Welche Daten?
- Welche Formate?
- Welche Einbindungsmöglichkeiten?
Antwort:
2 Produkt nachschlagen im ITK-Katalog mit 500.000 Produkten
Suche nach Produktidentifikatoren
/** * Nachschlagen nach Herstellernummer HL2030G1 (Brother HL 2030): * */ http://iws.itscope.de/rest?productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLPROD_ONLY4DEMO&manufacturerSKU=HL2030G1 /** * Nachschlagen nach Herstellernummer HL2030G1 (Brother HL 2030): * */ mehrere Nummern einfach per Komma trennen: <source lang="text"> http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLSUPP_ONLY4DEMO&manufacturerSKU=HL2030G1,HL2040G1 /** * Nachschlagen nach Herstellernummer HL2030G1 (Brother HL 2030): * */ Nachschlagen nach ITscope-Artikelnummer: http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLSUPP_ONLY4DEMO&itsPid=136056000 /** * Nachschlagen nach EAN * */ http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLSUPP_ONLY4DEMO&ean=4977766630313
Weitere Beispiele siehe
Welche Daten können abgefragt werden?
- Alle Produktstammdaten
- technische Daten
- Datenblätter und Bilder
- DCI-Links
- Zubehör und andere Referenzen
- Bezugsquellen (Wer liefert was?)
- Mehrere Klassifizierungen
Anwendungsbeispiele
- Übersichtsseite für Fremdsystem Integrationen
- Best Practices für Fremdsystem Integrationen (Warenwirtschaften, CRM, Onlineshops)
- Profisuche (Technische Dokumentation der Produktsuche nach Merkmalen)
- Anbindung einer externen Anwendung direkt in den MarketViewer
- Lieferantenvergleich
3 Produktsuche im Katalog nach Schlüsselwörtern und Eigenschaften
Suche nach:
- Produktidentifikatoren
- Lieferant
- Hersteller
- Schlüsselwörter, Keywords
- Produkteigenschaften
Siehe auch Suchsyntax Dokumentation
/** * Suche nach "radeon x1650 pro" * */ http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRODUCTIMAGES&resultsPerPage=20&keywords=radeon%20x1650%20pro /** * Suche nach Distributor-SKU xyz von Actebis Peacock * */ http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRODUCTIMAGES&resultsPerPage=20&keywords=dpid:1326726 oder http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRODUCTIMAGES&resultsPerPage=20&keywords=1326726 /** * Mächtige Parametersuche: Suche nach allen 17" - 19" TFT-Monitoren mit Lautsprechern * */ http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRODUCTIMAGES&resultsPerPage=20&keywords=sid:107%20ek107010600:(16500-19500)%20ek107101010:(AUD_BA_LAUTSPRECHER__)
Weitere Beispiele siehe
Anwendungsbeispiele
- Plugins für Warenwirtschaften zur Produktsuche
- Suchtechnologie für produktorientierte Portale (z.B. Computerpresse, Shoppingportale, Onlineshops etc.)
4 Format des Katalogergebnisses beliebig einstellbar (Cross Media Publishing)
Übersicher der Schnittstellen
- Vordefinierte Formate für CSV-Listen und Excel
- XML mit unterschiedlichem Umfang
- HTML-Listen mit Bild
z.B. Kurz-Produktübersicht mit Bild und Kurzinfo
/** * Suche nach "radeon x1650 pro" * */ http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRODUCTIMAGES&manufacturerSKU=HL2030G1
5 Produktlisten erstellen, ändern, löschen und in beliebigen Formaten anzeigen
Erstellen, Abfragen, Ändern und Löschen (CRUD) von Produktlisten
6 Produktdatenblätter für alle Produkte des Katalogs
Bei DCI-qualifizierten Produkten mit DCI-Datenblatt. Siehe auch Content-Lizenzfragen und Verwendungsrichtlinien.
Ansonsten ITscope-Datenblätter in einheitlicher Optik, für ALLE 500.000 Produkte Datenblatt kann mit individuellem Design des Kunden angepaßt werden
/** * Suche nach "radeon x1650 pro" * */ http://iws.itscope.de/rest/getDataSheet?iwsKey=<IhrWebserviceKey>&productId=136056000&customSheet=true /** * Optional Generierung als PDF für Angebote, Emails etc. * */ http://iws.itscope.de/rest/getDataSheet?iwsKey=<IhrWebserviceKey>&productId=136056000&customSheet=true&pdf=true
Weitere Beispiele siehe
7 Produktportfolios exportieren - für Webshops, Warenwirtschaften u.a.
- Im MarketViewer ein Produktportfolio aus Produktgruppen beliebiger Klassifizierungen und selbst erstellten Produktlisten anlegen
- Ein entsprechendes Exportprofil definieren (Datenumfang und Format) oder ein vordefiniertes nutzen
- Beim Web Service-Abruf die ID des Portfolios angeben: So kann die Einbindung in externe Applikationen geschehen
Größere Portfolios werden über Nacht per FTP und/oder auf Anforderung generiert und stehen somit tagesaktuell zur Verfügung.
8 Zukünftige Features
- Deeplink-Service zum direkten Verlinken der Produkte zu den Distri-Onlineshops
- Bilder-Service zum direkten Verlinken von Bildern unterschiedlicher Größe
- Statistik-Service zum Abruf von produkt- und segmentbezogenen Statistiken (Preistrends, Produktlebenszyklus, Statushistorien etc.)