IWS/API IWS3/productLookup REST

Aus ITscope GmbH - Wissensbasis

Wechseln zu: Navigation, Suche
productLookup
aktuelle Version

Inhaltsverzeichnis

1 Beschreibung

productLookup liefert Produktdaten und Suchkontexte (Cluster mit Vorschauzahlen für Hersteller, Kategorien, Distributoren und Eigenschaften) nach in der ITscope-Datenbank assoziierten Produktidentifikatoren. Die Datenbank umfasst 1 Million Produkte aus IT, Telekommunikation und Unterhaltunselektronik inkl. Technischen Daten, Bilddaten, Zubehörreferenzen und stundenaktuelle Daten von 150 Großhändlern.

2 Migration von IWS2

  • Die browseNodeId wird durch iwsIds ersetzt
  • maxResults, resultsPerPage und page werden durch startIdx und maxResults ersetzt
  • Die Methode productSearch fällt weg, keywords, searchMode und clusterExpression können in productLookup angegeben werden

3 Ähnliche Methoden

4 Parameter

4.1 Allgemeine Parameter

Die folgenden Parameter können für jede Methode verwendet werden.

Name des Parameters Beschreibung Benötigt Zulässige Werte
validate Ist validate = true, wird die Anfrage nicht ausgeführt, sondern nur auf syntaktische und inhaltliche Korrektheit überprüft (z.B. ob Parameterwerte stimmen oder plausibel sind) Optional
  • true
  • false (default)
iwsKey Der Webservice-Nutzungskey für ITscope-Kunden. Nur mit diesem Key können Web Service Requests ausgeführt werden. Ja Ihr IWS-Key, zum Beispiel: 
qnAGOar2dsAIo1EnThWsKA
. Sie erhalten den Key bei der Registrierung als Enterprise-User bei ITscope.

4.2 Allgemeine Parameter für Produktabfragen

Name des Parameters Beschreibung Benötigt Zulässige Werte
genProfileId Die ID des im MarketViewer eingerichteten Veröffentlichungsprofils(genProfileId) inklusive des Deployments FTP, EMail Nein z.B. 45c50020-b4f4-11db-bef0-cf785ec7b2f1
ignoreReturnFile wird nur zur Generierung von Produktportfolios verwendet. Bei true werden bereits existierende generierte Dateien nicht zurückgegeben Nein
  • true
  • false (default)
profileId Das Profil bestimmt das Format des Ergebnisses. Hier eine Liste der freien IWS Datenprofile Ja ProfilIds von Datenexportprofilen
sendFilterNodes Liefert zu einem Produktergebnis weitere einschränkende Filterkriterien und die entsprechende Vorschauzahl. Nein
  • true
  • false (default)
expandedResultComps Bestimmt das Verhalten der Filterknoten und Eigenschaftscluster, mehrere Resultatscomponenten als kommaseparierte Liste Nein
  • ECO: Eigenschaftscluster
  • MAN: Hersteller
  • PRL: Lieferanten
  • CAT: Kategorien
  • SET: Produkttypen
  • VIE: v2 Produktlisten (derzeit noch keine Filterknoten möglich)
  • EXS: v2 Produktportfolios (derzeit noch keine Filterknoten möglich)
  • CNT: v3 Produktcontainer (derzeit noch keine Filterknoten möglich)

4.2.1 genProfileId und ignoreReturnFile

Stößt die Generierung und das Deployment von Produktportfolios an, ohne das Resultat tatsächlich als Response zurückzugeben (ignoreReturnFile=true). Voraussetzung dafür ist ein im MarketViewer eingerichtetes Generierungsprofil (genProfileId) inklusive Deployments - hier werden alle eingerichteten Deployments dann ausgeführt (Email, FTP). 

/**
* asynchrone Generierung und Deployment eines Portfolio ohne Response-Rückgabe der Produktdaten
*
*/
http://iws.itscope.de:80/csvService?method=productLookup&iwsKey=<IhrWebserviceKey>&genProfileId=fac3f6ad-3924-11dd-98a9-c52ee2e76370&browseNodeId=EXS15dcc906-d62c-21dc-9564-81e01e84e684&ignoreReturnFile=true


4.2.2 profileId

Das Profil bestimmt das Format des Ergebnisses. Verwendet werden können voreingestellte Standardprofile und selbst erstelle Profile.

Im MarketViewer unter Export - "Datenprofile verwalten" können eigene Formate definiert werden. Siehe auch Datenexportprofile

Dimensionen des Formats:

  • HTTP Content Type (text/html, text/csv, text/xml, application/zip)
  • Datenumfang (XML-Ergebnis einschränken, CSV-Spalten definieren)
  • Transformation (XSLT Stylesheet für HTML-Umwandlung)

Wichtig: Beachten sie, daß je nach Profiltyp eine andere Service URL verwendet werden muß 

für reine XML-Responses
* http://iws.itscope.de/rest 
 
für XML, HTML, PDF-Responses und andere per XSLT mögliche Transformationen (ist ohne Angabe von XSLT gleich dem rest-Endpoint)
* http://iws.itscope.de/xslt 
 
für CSV, Excel
* http://iws.itscope.de/csv
/**
* XML kurz mit Produktstammdaten und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO&itsPid=117313000
 
 
/**
* HTML Bezugsquellenübersicht  und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRICES&itsPid=117313000
 
 
/**
* CSV einfache Produktliste und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/csv/productLookup?iwsKey=<IhrWebserviceKey>&profileId=CSVPRODUCTSIMPLE&itsPid=117313000
 
 
/**
* Um bspw. die Bezugsquellen einzuschränken, kann das Profil abgewandelt werden und dann die eigene ID angegeben werden
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=<ihre_profilid>

4.2.3 sendFilterNodes

Liefert zu einem Produktergebnis weitere einschränkende Filterkriterien und die entsprechende Vorschauzahl (sendFilterNodes=true). Standardwert ist false. Diese sogenannten Filterknoten werden z.B. im MarketViewer verwendet, um die IWS/Beispiele/Profisuche und die Filterboxen je nach Suchergebnis zur füllen.

Um die Klassifizierung für die Kategorie-Knoten zu setzen, muß die IWSID der Klassifizierung unter iwsIds mitgeschickt werden, z.B. iwsIds=CLS1 für die CommerceDB. Alle Klassifizierungen können mit der Webservice-Methode getClassifications abgerufen werden. 

/**
* alle Eigenschaftscluster und andere Filterknoten für Produkte vom Typ Notebook
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195&maxResults=-1&sendFilterNodes=true&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO


Beispiel einer Reponse 

...
<its3:attributeCluster>
	<its:uid>CLU9321</its:uid>
	<its:eigKonkret>ECO1195010200</its:eigKonkret>
	<its:valueFrom>154618822656</its:valueFrom>
	<its:valueTo>193273528320</its:valueFrom>
	<its:displayName>160 GB</its:displayName>
	<its:clusterSearch>154618822656-193273528320</its:clusterSearch>
	<its:index>10</its:index>
	<its:qualCount>208</its:qualCount>
	<its:unqualCount>11</its:unqualCount>
</its3:attributeCluster>
<its3:attributeCluster>
	<its:uid>CLU9331</its:uid>
	<its:eigKonkret>ECO1195010200</its:eigKonkret>
	<its:valueFrom>193273528320</its:valueFrom>
	<its:valueTo>236223201280</its:valueFrom>
	<its:displayName>200 GB</its:displayName>
	<its:clusterSearch>193273528320-236223201280</its:clusterSearch>
	<its:index>11</its:index>
	<its:qualCount>5</its:qualCount>
	<its:unqualCount>0</its:unqualCount>
</its3:attributeCluster>
...
<its3:attributeCluster>
<its:uid>CLU27611</its:uid>
<its:eigKonkret>ECO1</its:eigKonkret>
<its:valueFrom>HLINIE_52932__</its:valueFrom>
<its:displayName>Lenovo ThinkPad Edge Serie</its:displayName>
<its:clusterSearch>HLINIE_52932__</its:clusterSearch>
<its:index>927</its:index>
<its:qualCount>23</its:qualCount>
<its:unqualCount>0</its:unqualCount>
</its3:attributeCluster>
...
<its3:filterNode>
	<its:browseNodeId>CAT446731</its:browseNodeId>
	<its:browseNodeName>17 Zoll</its:browseNodeName>
	<its:contentCount>625</its:contentCount>
	<its:contentTypeId>PRO</its:contentTypeId>
	<its:extContentCount>-1</its:extContentCount>
	<its:hasChildren>false</its:hasChildren>
	<its:imageKey>FOLDER</its:imageKey>
	<its:typePrefix>CAT</its:typePrefix>
</its3:filterNode>
...
<its3:filterNode>
	<its:browseNodeId>MAN306</its:browseNodeId>
	<its:browseNodeName>Dell</its:browseNodeName>
	<its:contentCount>535</its:contentCount>
	<its:contentTypeId>PRO</its:contentTypeId>
	<its:extContentCount>-1</its:extContentCount>
	<its:hasChildren>false</its:hasChildren>
	<its:imageKey>OBJECT_HERSTELLER</its:imageKey>
	<its:typePrefix>MAN</its:typePrefix>
</its3:filterNode>
...
<its3:filterNode>
	<its:browseNodeId>SET195</its:browseNodeId>
	<its:browseNodeName>Notebooks</its:browseNodeName>
	<its:contentCount>6724</its:contentCount>
	<its:contentTypeId>PRO</its:contentTypeId>
	<its:extContentCount>-1</its:extContentCount>
	<its:hasChildren>false</its:hasChildren>
	<its:imageKey>FILE</its:imageKey>
	<its:typePrefix>SET</its:typePrefix>
</its3:filterNode>
...
<its3:filterNode>
	<its:browseNodeId>PRL14</its:browseNodeId>
	<its:browseNodeName>Ingram Micro</its:browseNodeName>
	<its:contentCount>918</its:contentCount>
	<its:contentTypeId>PRO</its:contentTypeId>
	<its:extContentCount>918</its:extContentCount>
	<its:hasChildren>false</its:hasChildren>
	<its:imageKey>TreeNode.NS_HERSTELLER_IMAGE</its:imageKey>
	<its:typePrefix>PRL</its:typePrefix>
</its3:filterNode>
...
<its3:filterNode>
	<its:browseNodeId>QUA3</its:browseNodeId>
	<its:browseNodeName>manuell qualifiziert</its:browseNodeName>
	<its:contentCount>2452</its:contentCount>
	<its:extContentCount>-1</its:extContentCount>
	<its:hasChildren>true</its:hasChildren>
	<its:imageKey>FOLDER</its:imageKey>
	<its:typePrefix>GENERIC</its:typePrefix>
</its3:filterNode>
...
<its3:filterNode>
	<its:browseNodeId>SFNOLD</its:browseNodeId>
	<its:browseNodeName>Alte Produkte</its:browseNodeName>
	<its:contentCount>36277</its:contentCount>
	<its:extContentCount>-1</its:extContentCount>
	<its:hasChildren>true</its:hasChildren>
	<its:imageKey>FOLDER</its:imageKey>
	<its:typePrefix>GENERIC</its:typePrefix>
</its3:filterNode>


Folgende Filterkriterien werden zurückgeliefert:

  • AttributeCluster
  • FilterNode
4.2.3.1 Attribute-Cluster / Merkmals-Cluster

Wichtige Daten eines Merkmals-Cluster its3:attributeCluster (Einschränkungen gleicher Eigenschaften auf einen Wertebereich) sind:

  • its:eigKonkret - ID des Merkmaltyps (Ausprägungen / Eigenschaften von Produkten )
  • its:valuefrom - Wertebereich von (wird immer gesetzt, z.b. bei Genre Ego-Shooter)
  • its:valueTo - Wertebereich bis (wird nicht gesetzt wenn der Wertebereich keine Zahl ist, z.B. Genre)
  • its:displayName - Darstellungstext
  • its:clusterSearch - Text für die Produktsuche (siehe auch IWS/Dokumentation/Syntax_für_Suche#Suchsyntax)
  • its:index - Sortierreihenfolge aufsteigend
  • its:qualCount - Anzahl qualifizierter Produkte (DCI und Itscope Qualifiziert)
  • its:unqualCount - Anzahl unqalifizierter Produkte (Itscope Unqualifiziert und Preislistenzeilen)
  • its:uid - Eindeutige ID (Präfix CLU)
Achtung: Ein Suche über Merkmalscluster Ids sollte nicht verwendet werden. Die Cluster-ID ist temporär und kann sich täglich ändern. z.B. CLUxxx war eingeteilt in einen Wertebereich von 1 bis 100. Durch eine Verfeinerung des Clusters wurde der CLUxxx in CLUyyy (Wertebereich von 1 bis 50) und CLUzzz (Wertebereich von 51 bis 100). Cluster sollten nur für den Parameter expandedResultComps verwendet werden.
4.2.3.2 FilterNode

Wichtige Daten eines Filterkriteriums its3:filterNode sind:

Siehe auch Filter über IWS-Ids (Der Filter über IWS-IDs ist der mächtigste Produktfilter)

4.2.4 expandedResultComps

Ergänzt den Parameter sendFilterNodes. Für bestimmte Einsatzzwecke ist es sinnvoll, trotz einer Einschränkung eines Kriteriums, z.B. einer Eigenschaft oder eines Produkttyps, dennoch alle Cluster und Vorschauzahlen zu erhalten, die herauskommen würden, wenn das Kriterium nicht eingeschränkt worden wäre. Dieses Verhalten zur Bestimmung der Filterknoten und Eigenschaftscluster bestimmt der Parameter expandedResultComps. Eine Resultatskomponente (=ResultComp) ist die Produktergebnismenge von Filtern desselben Typs (z.B. alle Produkte der gesetzten Kategorie, Produkttypen, Clustern des gleichen Merkmals (!!), Herstellern etc.) - derselbe Typ, das heißt, die Kriterien werden mit ODER verknüpft. Wird nun beispielsweise eine Resultatkomponente (z.B. MAN für Hersteller) erweitert (= expanded), wird zur Bestimmung der Hersteller-Filterknoten das Gesamtergebnis OHNE Anwendung des Herstellerfilters herangezogen. Das heißt, man sieht die Hersteller-Filterknoten so, als ob kein Herstellerkriterium gesetzt wäre, sondern nur die übrigen gesetzten Filterkriterien.

Liste der möglichen Komponenten:

  • ECO: Eigenschaftscluster
  • MAN: Hersteller
  • PRL: Lieferanten
  • CAT: Kategorien
  • SET: Produkttypen
  • VIE: v2 Produktlisten (derzeit noch keine Filterknoten möglich)
  • EXS: v2 Produktportfolios (derzeit noch keine Filterknoten möglich)
  • CNT: v3 Produktcontainer (derzeit noch keine Filterknoten möglich)

Hinweis:Für jede Resultatskomponente muß expandedResultComps gesondert angegeben werden, mehrere werden mit Komma getrennt, z.B. expandedResultComps=ECO,MAN für Merkmale und Hersteller. 


/**
* alle Eigenschaftscluster und Filterknoten für Notebooks mit Vista Business 64bit, Eigenschaftskriterium (ECO) aufgehoben, um auch alle alternativen Betriebssystem-Cluster für Notebooks zu erhalten
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195,CLU45771&expandedResultComps=ECO&maxResults=-1&sendFilterNodes=true&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3 Filter Parameter

Ein Wort vorweg zur logischen Verknüpfung der Filter-Parameter

  • Werden mehrere Parameter bei einer Abfrage angegeben, werden sie mit UND verknüpft.z.B: merchantId=10000104&merchantSKU=41233 sucht also nach Artikelnummer 41233 im Sortiment des Lieferanten mit der ID 10000104.
  • Mehrere durch Komma getrennte Parameter gleichen Typs werden hingegen mit ODER verknüpft. z.B. itsPid=142300,142301 liefert beide Produkte zurück.
Name des Parameters Beschreibung Benötigt Zulässige Werte
iwsIds IWS-IDs sind Identifikatoren von Ressourcen Nein siehe Kapitel iwsIds
qual Filtert das Suchergebnis nach Produktqualifizierung Nein

Kommaseparierte Liste, default ist 1,2,3

  • 3 DCI qualifizert
  • 2 ITscope qualifiziert
  • 1 ITscope unqualifiziert
  • 0 Preislistenzeile
categoryId Alle Produkte einer bestimmten Kategorie Nein Numerisch, siehe IWS Methode getCategories
merchantId DistributorId, alle Produkte eines bestimmten Distributors Nein Numerisch, siehe auch IWS Methode getDistributors
merchantSKU Sucht nach einer bestimmten Lieferanten-Artikelnummer Nein Text, mehrere Artikelnummern als komasepariert Liste
manufacturerId Herstellernummer, alle Produkte eines bestimmten Hersteller Nein Numerisch, siehe auch IWS Methode getManufacturers
manufacturerSKU Sucht nach einer bestimmten Hersteller-Artikelnummer Nein Text, mehrere Artikelnummern als komasepariert Liste
itsPid Sucht nach bestimmten ITscope-Artikelnummern (auch als GUID oder PUID bezeichnet) Nein Numerisch, mehrere ITscope Unique Produkt-IDs als komasepariert Liste
ean EAN/UPC, europäische Artikelnummer Nein exakte EAN, z.B. 0088698753361
cnetPid Artikelnummer des cnet Channel Content Nein siebenstellige cnet-Artikelnummer mit Präfix S, z.B. S2720311
dciPid Artikelnummer des DCI-Content Nein siebenstellige DCI-Artikelnummer, z.B. 1299235
icecatPid Artikelnummer des IceCat-Content Nein IceCat -Artikelnummer, z.B. 1882669-5422

4.3.1 iwsIds

Der Filter über sogenannte IWS-IDs ist der mächtigste Produktfilter. IWS-IDs sind Identifikatoren von Ressourcen, die jeweils einen Teilkatalog von Produkten referenzieren, z.B. Kategorien und Hersteller, aber auch alle Arten von Produktlisten und Portfolios.

Eine IWS-ID besteht aus einem Typ-Präfix, der den Typ der Ressource anzeigt und einer ID, die die Ressource selbst identifiziert. Die ID ist entweder eine ganze Zahl oder eine UID (36-Zeichen-Seriennummer) Folgende Typ-Präfixe sind für den iwsIds-Parameter registriert:

  • Kategorie: CAT
  • Distributor: PRL
  • Hersteller: MAN
  • Produktliste: VIE
  • Produktportfolios: EXS
  • Eigenschaftscluster: CLU
  • Produkttyp: SET
  • Klassifizierung: CLS (wird benötigt, um die Klassifizierung der Kategorie-Filterknoten zu bestimmen, die mit sendFilterNodes=true geliefert werden)
  • von ITscope vordefinierte Produktfilter: SFN
    • SFNOLD: Alte / End-of-Life-Produkte mit einschließen
    • SFNNOACC: Kein Zubehör
    • SFNRECENT: Nur Produkte, die in den letzten 3 Wochen in die Datenbank aufgenommen wurden
    • SFNAVAIL: Nur bei mindestens einem Distributor verfügbar Produkte


Die IWS-IDs, nach denen gefiltert werden soll, werden mit Komma getrennt angegeben. Ressourcen gleichen Typs werden mit ODER verknüpft, Ressourcen verschiedenen Typs mit UND. Beispiel: CAT10870,MAN120,MAN480: Kategorie Grafikkarten (CommerceDB) UND (Hersteller Asus ODER Hersteller Gigabyte)


Zusätzlich können im Datenprofil weitere Filter auf Basis der Produktdaten gesetzt werden. Diese Filter müssen hier dann nicht zusätzlich angegeben werden, sondern werden automatisch bei Verwendung des Datenprofils angewandt. 

/**
* Alle Produkte Kategorie Grafikkarten (CommerceDB) UND (Hersteller Asus ODER Hersteller Gigabyte)
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=CAT10870,MAN120,MAN480&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Im MV zusammengestellte Produktliste
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=VIE289137&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Im MV zusammengestelltes Portfolio
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=EXS25dcc906-d62c-21dc-9564-81e01e84e684&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Alle Produkte vom Typ Notebook
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Alle Produkte vom Typ Notebook mit Windows Vista Business
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195,CLU45311&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.2 qual

Filtert das Suchergebnis nach Produktqualifizierung. Erwartet wird eine kommagetrennte Liste der Qualifizierungscodes. Erfordert mindestens einen weiteren Filterparameter, sonst ist das Ergebnis leer. 

/**
* Nur itscope- und DCI-qualifizierte Produkte (Code 2 und 3)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&qual=2,3&profileId=XMLFIND_ONLY4DEMO


4.3.3 categoryId

Alle Produkte einer bestimmten Kategorie. Es kann nur maximal eine Kategorie einer beliebigen Klassifizierung angegeben werden. Mehrere Kategorien können über den Parameter iwsIds angegeben werden.

Die ID der Produktgruppe erhalten Sie in der MarketViewer-Navigation per Rechtsklick "Eigenschaften". Dort finden Sie z.B. die Angabe BrowseNodeId = NBN0_CTL1_NBN10001_PRL10000006_CAT113287. Die passende Kategorie-ID für diesen Parameter ist in diesem Fall 113287.

Siehe auch Webservice Methode getCategories für KategorieIds 

/**
* Alle Produkte der Kategorie Grafikkarten PCI Express 256 MB
*
*/
http://iws.itscope.de/rest/productLookup?categoryId=11015&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.4 merchantId

Alle Produkte eines bestimmten Distributors. Es kann nur maximal ein Distributor angegeben werden. Mehrere Distributoren können über den Parameter iwsIds angegeben werden.

Die ID des Lieferanten erhalten Sie in der MarketViewer-Navigation per Rechtsklick "Eigenschaften". Dort finden Sie z.B. die Angabe BrowseNodeId = NBN0_CTL1_NBN10001_PRL10000006. Die passende Lieferanten-ID für diesen Parameter ist in diesem Fall 10000006.

Siehe auch Webservice Methode getDistributors für DistributorenIDs 

/**
* Alle Produkte von api
*
*/
http://iws.itscope.de/rest/productLookup?merchantId=10000026&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.5 merchantSKU

Sucht nach einer bestimmten Lieferanten-Artikelnummer. Kann durch merchantId ergänzt werden, wenn der Distributor bekannt ist. Mehrere Artikelnummern können mit Komma getrennt werden. 

/**
* Produkt mit Artikelnummer B994832 von Ingram Micro
*
*/
http://iws.itscope.de/rest/productLookup?merchantId=14&merchantSKU=B994832&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkte mit mehrere Artikelnummern von Ingram Micro
*
*/
http://iws.itscope.de/rest/productLookup?merchantId=14&merchantSKU=B994832,B993439&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.6 manufacturerId

Alle Produkte eines bestimmten Hersteller. Es kann nur maximal ein Hersteller angegeben werden. Mehrere Hersteller können über den Parameter iwsIds angegeben werden.

Die ID des Herstellers erhalten Sie in der MarketViewer-Navigation per Rechtsklick "Eigenschaften". Dort finden Sie z.B. die Angabe BrowseNodeId = NBN0_CTL1_CLS1_CAT10476_CAT10870_MAN480. Die passende Hersteller-ID für diesen Parameter ist in diesem Fall 480.

Siehe auch Webservice Methode getManufacturers für DistributorenIDs 

/**
* Alle Produkte von Adobe Systems
*
*/
http://iws.itscope.de/rest/productLookup?manufacturerId=37&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.7 manufacturerSKU

Sucht nach einer bestimmten Hersteller-Artikelnummer. Kann durch manufacturerId ergänzt werden, wenn der Hersteller bekannt ist. Mehrere Artikelnummern können mit Komma getrennt werden. 

/**
* Produkt mit Artikelnummer 967688-0102 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?manufacturerSKU=967688-0102&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkte mit von mehrere Artikelnummern mit Angabe des Hersteller American Megatrends
*
*/
http://iws.itscope.de/rest/productLookup?manufacturerSKU=967688-0102,967688-0510&manufacturerId=686&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.8 itsPid

Sucht nach bestimmten ITscope-Artikelnummern (auch als GUID oder PUID bezeichnet).

Mehrere Artikelnummern können mit Komma getrennt werden. Wir empfehlen 500 Produkte pro Anfrage. Die maximale Größe eines Anfrage Headers liegen bei unserem Webservice bei 16 kb.

Im MarketViewer finden Sie die PUID in der Spalte PUID der Produkttabelle oder unter Rechtsklick auf ein Produkt - Eigenschaften - GUID. Die ITscope-Artikelnummer ist eindeutig und wird nicht wiederverwendet, sobald das Produkt keine Bezugsquellen mehr hat.

  • End-of-Life-Artikel: Um ausgelaufene Artikel im MarketViewer weiterhin zu finden, müssen explizit "alte Produkte" in den Suchfilter mit einbezogen werden. Dafür gibt es 2 Möglichkeiten:
    • Im MarketViewer: Unter Profisuche - Produktfilter - alte Produkte aktivieren
    • Bei einer productLookup-Abfrage: im Parameter iwsIds muß der Statusfilter SFNOLD mitgeschickt werden 


/**
* Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=117313000&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* veraltetes Linksys-Produkt (VPN Router)
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=172659000&iwsIds=SFNOLD&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* mehrere Produkte
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=760287000,646976000,171054000,171052000&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* temporärer Artikel ohne Zuordnung mit negativer GUID (Qualifizierung 0, "übriges Produkt")
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=-9937894&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* temporärer Artikel ohne Zuordnung mit negativer GUID (Qualifizierung 0, "übriges Produkt")
* alternativ mit 999-Suffix für ID-Räume, die keine negativen Werte zulassen: 
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=9937894999&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.9 ean

Sucht nach einer EAN oder UPC (12/13-stellig). Die bei Produkten der ITscope CommerceDB hinterlegten EAN-Codes werden durch verschiedenste Prüfmechanismen gecheckt und regelmäßig auf Konsistenz kontrolliert. Die Rückgabe kann mehrere Produkte umfassen (Produktvarianten, verschiedene Brands für das gleiche Produkt)

Für die Suche nach Teilen von EAN-Codes verwenden Sie bitte den Parameter keywords (z.b. searchMode=5 und 426003*) 

/**
* Produkt mit EAN 
*
*/
http://iws.itscope.de/rest/productLookup?ean=4260039343790&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.10 cnetPid

Sucht nach einer bestimmten CNET-Nummer mit Präfix S. 

/**
* Produkt mit CNET-Nummer S3136026
*
*/
http://iws.itscope.de/rest/productLookup?cnetPid=S3136026&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.11 dciPid

Sucht nach einer bestimmten DCI-Nummer (Ganzzahlig). 

/**
* Produkt mit Produkt mit DCI-Nummer 1355132
*
*/
http://iws.itscope.de/rest/productLookup?dciPid=1355132&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.3.12 icecatPid

Sucht nach einer bestimmten IceCat-Nummer (Ganzzahlig). 

/**
* Produkt mit Produkt mit IceCat-Nummer 1882669-5422
*
*/
http://iws.itscope.de/rest/productLookup?icecatPid=1882669-5422&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.4 Filter über Suchausdrücke mit optimierten Indizes Parameter

Name des Parameters Beschreibung Benötigt Zulässige Werte
keywords Suchbegriffe, Schlüsselwörtern, siehe auch ITscope-Suchsyntax für Schlagwortsuche Nein Text
clusterExpression Suche nach Eigenschaftsclustern Nein Text
searchMode Der Suchmodus gibt an, in welchem Index der unter keywords angegebene Suchausdruck gesucht werden soll. Nein
  • 1 automatisch (default)
  • 2 Volltext
  • 3 Hersteller-Artikelnummer-Index
  • 4 Lieferanten-Artikelnummer-Index
  • 5 EAN-Index

4.4.1 keywords

Der Parameter keywords bietet folgende Suchmöglichkeiten:

  • Volltextsuche nach beliebigen Schlüsselwörtern
  • Suchsyntax, mit der die meisten anderen Filterparameter ersetzt werden können. Siehe ITscope-Suchsyntax für Schlagwortsuche.
  • Optimierte Suche nach Teilen von Artikelnummern (um auch bei nicht vollständiger Eingabe der Artikelnummer ein Ergebnis zu erzielen) 
/**
* Produktsuche nach syncmaster
*
*
/
http://iws.itscope.de/rest/productLookup?keywords=syncmaster&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach 90WG (Teil einer Herstellernummer)
*
*/
http://iws.itscope.de/rest/productLookup?keywords=90WG&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach allen syncmaster 224*
*
*/
http://iws.itscope.de/rest/productLookup?keywords=syncmaster%20224*&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach Acer-Notebooks (über Produkttyp) mit spezifischer Suchsyntax
*
*/
http://iws.itscope.de/rest/productLookup?keywords=sid:195%20hstid:23&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

4.4.2 clusterExpression

Kann analog zu keywords dazu verwendet werden, um nach Eigenschaftsclustern zu suchen, ohne die Cluster-IDs direkt zu kennen. Es genügt die ID des technischen Merkmals und das Wissen um dessen Basiseinheit. Daraus lassen sich dann Ausdrücke erstellen, um nach technischen Eigenschaften zu filtern.

Hinweis: Eigenschaften sind immer produkttyp-spezifisch. Das heißt, für die Bildschirmdiagonale von Notebooks wird eine andere Eigenschaft verwendet als für TFTs, obwohl es sich vom Konzept her um dasselbe Merkmal handelt. Sie müssen den Clusterausdruck also umschreiben, wenn Sie die Produkttypen wechseln.

Alternativ können Sie die Suche nach eid: aus der Suchsyntax verwenden (kann unter clusterExpression noch nicht angegeben werden!)

Format der Ausdrücke:

  • Suche nach Worteigenschaften: Eingabegeräte mit Trackball: ek109101090:(EING_BA_TRACKBL__)
  • Suche nach Zahleigenschaften: Notebook-Hauptspeicher bis ca. 1GB: ek195010201:(0-1100000000)

Mehrere Wörter oder Zahlintervalle können mit Komma getrennt in den Ausdruck in der Klammer eingefügt werden.

4.4.3 searchMode

Der Suchmodus gibt an, in welchem Index der unter keywords angegebene Suchausdruck gesucht werden soll. Standardwert ist 1 = automatisch. Folgende Werte sind möglich:

  • 1: automatische Auswahl des Index (geeignet in den meisten Fällen)
  • 2: Volltext: sucht explizit im Volltext ohne die speziellen Artikelnummer-Indizes zu berücksichtigen
  • 3: Hersteller-Artikelnummern-Index: sucht explizit nach Hersteller-Artikelnummern
  • 4: Lieferanten-Artikelnummern-Index: sucht explizit nach Lieferanten-Artikelnummern
  • 5: EAN-index: Sucht explizit nach EANs oder Teilen von EANs (z.B. Angabe mit *)

4.5 Ergebnismenge Parameter

Name des Parameters Beschreibung Benötigt Zulässige Werte
startIdx Legt fest, ab welchem Index das Ergebnis zurückgegeben wird Nein Numerisch (default 0)
maxResults Legt die Anzahl der Resultate ab startIdx zurück. Nein Numerisch (default 0)
sortBy Legt die Sortierung der Produkte fest. Nein
  • name
  • qual
  • exact

4.5.1 startIdx und maxResults

Beschränkt das Produktergebnis, realisiert ein Ergebnis-Paging:

  • startIdx: (Standardwert = 0) Legt fest, ab welchem Index das Ergebnis zurückgegeben wird
  • maxResults: (Standardwert = 0) Legt die Anzahl der Resultate ab startIdx zurück.

Systeminterne Grenzen für maxResults sind abhängig vom Format (siehe auch Schnittstellen:

  • 30 für On Demand-Profile (z.B. HTMLRCONNECTOR, Angebotsvorlagen)
  • 1.500 für HTML- oder PDF-Exporte
  • 65.000 für XML-Export
  • 220.000 für CSV/Excel-Exporte (mehr als 65.000 Datensätze bei Excelexporten werden auf mehrere Sheets verteilt)

Spezielle Werte für maxResults und deren Bedeutung

  • maxResults = -1: Kein Ergebnis, es werden keine Produktdaten, sondern nur der Header des Lookups zurückgegeben
  • maxResults = 0 oder kein maxResults angegeben: Unbeschränkt
  • maxResults > 0: Produktergebnis wird auf maxResults beschnitten 
/**
* startIdx, maxResults für die 3.Seite bei einem 20er Paging
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&startIdx=40&maxResults=20&profileId=XMLFIND_ONLY4DEMO

4.5.2 sort(B)y

Legt die Sortierung der Produkte fest. Die Standardsortierung ist:

  • bei einzelnen Produkt-IDs oder iwsIds die von ITscope vorgegeben Sortorder nach Hersteller und Produktbezeichner aufsteigend (-name): Eine ganze Zahl von 0 ab aufsteigend.
  • bei Suchen mit Angabe von keywords die Relevanz der Ergebnisse hinsichtlich der keywords: Eine Dezimalzahl zwischen -1 und 0, ebenfalls aufsteigend sortiert. Der Prozentwert der Relevanz kann ermittelt werden durch -1 * sortorder * 100 %.

Eingebaute Spezialsortierungen:

  • -qual: absteigend nach Produktqualifizierung sortieren (Premiumprodukte zuerst), nur bie XML-basierte Profile
  • exact: sortiert das Ergebnis in der Reihenfolge der Angabe der ProduktIDs - nur bei Verwendung des Parameters itsPid und nur bei XML-basierten Profilen 
/**
* Sortierung nach Angabe der ProduktIDs
*
*/
http://iws.itscope.de/rest/productLookup?sortBy=exact&iwsKey=<IhrWebserviceKey>&itsPid=192837000,129837000&profileId=XMLFIND_ONLY4DEMO

4.6 Profil-Override Parameter (Präfix pp_)

Name des Parameters Beschreibung Benötigt Zulässige Werte
pp_realtime Schaltet die Realtimeabfrage von Preisen und Verfügbarkeiten ein (pp_realtime=true). Nein
  • true
  • false (default)
pp_suppliers Überschreibt für die aktuelle Anfragen die in den Datenexportprofilen gesetzten Lieferanten in dem Parameter suppliers. Nein Kommaseparierte Liste von LieferantenIds

4.6.1 pp_realtime

Schaltet die Realtimeabfrage von Preisen und Verfügbarkeiten ein (pp_realtime=true).

Voraussetzung für die Realtime-Abfrage: 

/**
* Realtime eingeschaltet für die Abfrage
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRICES&itsPid=117313000&pp_realtime=true
 
/**
* Realtime abgeschaltet für die Abfrage
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRICES&itsPid=117313000&pp_realtime=false

4.6.2 pp_suppliers

Überschreibt für die aktuelle Anfragen die in den Datenxportprofilen gesetzten Lieferanten in dem Parameter suppliers.

Der Parameter ist eine Kommaseparierte Liste von LieferantenIds oder einer einzelen Id. 

/**
* Anfrage nur nach Lieferanten Ingram (14), TechData(58), Actebis (1000142)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRICES&itsPid=117313000&pp_suppliers=14,58,10000142
 
/**
* Anfrage nach allen gesetzten Lieferanten in dem Exportprofil HTMLPRICES
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRICES&itsPid=117313000

5 Beispielaufrufe

5.1 REST

5.1.1 Request 

/**
* IWS-Key und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&itsPid=117313000&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* XML kurz mit Produktstammdaten und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO&itsPid=117313000
 
 
/**
* XML vollständig mit allen Produktdaten und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLPROD_ONLY4DEMO&itsPid=117313000
 
 
/**
* XML nur mit Bezugsquellen und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLSUPP_ONLY4DEMO&itsPid=117313000
 
 
/**
* XML nur technische Daten (BETA / erfordert gesonderten Vertrag / nur nach Freischaltung) und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=XMLPROP_ONLY4DEMO&itsPid=117313000
 
 
/**
* HTML Bezugsquellenübersicht  und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLPRICES&itsPid=117313000
 
 
/**
* HTML Realtimedatenblatt und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/xslt/productLookup?iwsKey=<IhrWebserviceKey>&profileId=HTMLRCONNECTOR&itsPid=117313000
 
 
/**
* CSV einfache Produktliste und Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/csv/productLookup?iwsKey=<IhrWebserviceKey>&profileId=CSVPRODUCTSIMPLE&itsPid=117313000
 
 
/**
* Um bspw. die Bezugsquellen einzuschränken, kann das Profil abgewandelt werden und dann die eigene ID angegeben werden
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&profileId=<ihre_profilid>
 
 
/**
* alle Eigenschaftscluster und andere Filterknoten für Produkte vom Typ Notebook
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195&maxResults=-1&sendFilterNodes=true&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* alle Eigenschaftscluster und Filterknoten für Notebooks mit Vista Business 64bit, Eigenschaftskriterium (ECO) aufgehoben, um auch alle alternativen Betriebssystem-Cluster für Notebooks zu erhalten
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195,CLU45771&expandedResultComps=ECO&maxResults=-1&sendFilterNodes=true&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* asynchrone Generierung und Deployment eines Portfolio ohne Response-Rückgabe der Produktdaten
*
*/
http://iws.itscope.de:80/csvService?method=productLookup&iwsKey=<IhrWebserviceKey>&genProfileId=fac3f6ad-3924-11dd-98a9-c52ee2e76370&browseNodeId=EXS15dcc906-d62c-21dc-9564-81e01e84e684&ignoreReturnFile=true
 
 
/**
* startIdx, maxResults für die 3.Seite bei einem 20er Paging
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&startIdx=40&maxResults=20&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Sortierung nach Angabe der ProduktIDs
*
*/
http://iws.itscope.de/rest/productLookup?sortBy=exact&iwsKey=<IhrWebserviceKey>&itsPid=192837000,129837000&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach syncmaster
*
*
/
http://iws.itscope.de/rest/productLookup?keywords=syncmaster&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach 90WG (Teil einer Herstellernummer)
*
*/
http://iws.itscope.de/rest/productLookup?keywords=90WG&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach allen syncmaster 224*
*
*/
http://iws.itscope.de/rest/productLookup?keywords=syncmaster%20224*&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produktsuche nach Acer-Notebooks (über Produkttyp) mit spezifischer Suchsyntax
*
*/
http://iws.itscope.de/rest/productLookup?keywords=sid:195%20hstid:23&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Nur itscope- und DCI-qualifizierte Produkte (Code 2 und 3)
*
*/
http://iws.itscope.de/rest/productLookup?iwsKey=<IhrWebserviceKey>&qual=2,3&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Alle Produkte Kategorie Grafikkarten (CommerceDB) UND (Hersteller Asus ODER Hersteller Gigabyte)
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=CAT10870,MAN120,MAN480&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Im MV zusammengestellte Produktliste
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=VIE289137&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Im MV zusammengestelltes Portfolio
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=EXS25dcc906-d62c-21dc-9564-81e01e84e684&&profileId=XMLFIND_ONLY4DEMOiwsKey=<IhrWebserviceKey>
 
 
/**
* Alle Produkte vom Typ Notebook
*
*/
http://iws.itscope.de/rest/productLookup?iwsIds=SET195&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Alle Produkte vom Typ Notebook mit Windows Vista Business
*
*/
 
 
/**
* Alle Produkte der Kategorie Grafikkarten PCI Express 256 MB
*
*/
http://iws.itscope.de/rest/productLookup?categoryId=11015&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Alle Produkte von api
*
*/
http://iws.itscope.de/rest/productLookup?merchantId=10000026&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkte mit mehrere Artikelnummern von Ingram Micro
*
*/
http://iws.itscope.de/rest/productLookup?merchantId=14&merchantSKU=B994832,B993439&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Alle Produkte von Adobe Systems
*
*/
http://iws.itscope.de/rest/productLookup?manufacturerId=37&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkt mit Artikelnummer 967688-0102 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?manufacturerSKU=967688-0102&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkte mit von mehrere Artikelnummern mit Angabe des Hersteller American Megatrends
*
*/
http://iws.itscope.de/rest/productLookup?manufacturerSKU=967688-0102,967688-0510&manufacturerId=686&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkt mit Artikelnummer 117313000 (Logitech Cordless Desktop MX 3200)
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=117313000&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* veraltetes Linksys-Produkt (VPN Router)
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=172659000&iwsIds=SFNOLD&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* mehrere Produkte
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=760287000,646976000,171054000,171052000&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* temporärer Artikel ohne Zuordnung mit negativer GUID (Qualifizierung 0, "übriges Produkt")
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=-9937894&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* temporärer Artikel ohne Zuordnung mit negativer GUID (Qualifizierung 0, "übriges Produkt")
* alternativ mit 999-Suffix für ID-Räume, die keine negativen Werte zulassen: 
*
*/
http://iws.itscope.de/rest/productLookup?itsPid=9937894999&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkt mit EAN 
*
*/
http://iws.itscope.de/rest/productLookup?ean=4260039343790&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkt mit CNET-Nummer S3136026
*
*/
http://iws.itscope.de/rest/productLookup?cnetPid=S3136026&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkt mit Produkt mit DCI-Nummer 1355132
*
*/
http://iws.itscope.de/rest/productLookup?dciPid=1355132&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO
 
 
/**
* Produkt mit Produkt mit IceCat-Nummer 1882669-5422
*
*/
http://iws.itscope.de/rest/productLookup?icecatPid=1882669-5422&iwsKey=<IhrWebserviceKey>&profileId=XMLFIND_ONLY4DEMO

5.1.2 Response

Von „http://www.itscope.de/wiki/IWS/API_IWS3/productLookup_REST“