XML / JSON Formate für API 1.0

Last modified: 5. Mai 2022

Die hierarchischen Ausgabeformate XML und JSON werden hier zusammengefasst, da sie sich im Aufbau stark ähneln und die Inhalte identisch sind.

Das Root-Element ist products und jedes Produkt steht in einem eigenen product-Element.Die enthaltenen Felder sind bereits bei den CSV-Formaten ausführlicher besprochen worden.

ausführlich (full.xml, full.json)

Dieses Format steht nur für API-Aufrufe zur Verfügung, nicht für Exporte. API-Abruf erfolgt mit „full.xml“ oder „full.json“.

Das große Datenvolumen des ausführlichen XML-Formats führt dazu, dass es imExport nicht verwendet werden kann. Sollen sämtliche Produktdaten über den Export herausgeschrieben werden, muss daher das ausführliche CSV-Datenformat „CSV alle Daten 2 (zip)“ benutzt werden.

Neben Produktdaten enthält das Format Unterelemente zu folgenden referenzierten Objekten: Produkttyp, Hersteller, Bezugsquelle, alle Content-Typen. Bezugsquellen und Content-Typen können jeweils mehrfach auftreten. Die Felder der jeweiligen Unterlemente sind ausführlicher in dem Format „CSV alle Daten 2 (zip)“ beschrieben.

FeldBeschreibung
product/puideindeutige Produkt-ID (ITscope Produkt-ID)
product/set/der Produkttyp, der das Produkt zugewiesen ist
product/man/der Hersteller des Produktes
product/supplierItem/ein Element für jede Bezugsquelle
product/keyContent/Key Content, s. Tabelle in „CSV alle Daten 2 (zip)“
product/mediaContent/Media Content, s. Tabelle in „CSV alle Daten 2 (zip)“
product/ratingContent/Rating Content, s. Tabelle in „CSV alle Daten 2 (zip)“
product/refContent/Ref Content, s. Tabelle in „CSV alle Daten 2 (zip)“
product/textContent/Text Content, s. Tabelle in „CSV alle Daten 2 (zip)“
product/rankallgemeiner ITscope Rank (eine hohe Zahl entspricht einem schlechten Ranking)
product/relevanceSuchtreffer Relevanz
product/qualificationQualifizierung des Produkts
product/eanEAN
product/manufacturerSKUHersteller Artikelnummer
product/shortInfoKurzbezeichner
product/productNameProduktname, Langbezeichner
product/deeplinkDeeplink auf die ITscope.com Plattform
product/recRetailPriceUVP des Herstellers
product/vatMehrwehrtsteuer
product/estimateGrossWeightGewicht
product/grossDimXLänge des Produkts
product/grossDimYHöhe des Produks
product/grossDimZBreite des Produkts
product/entryDateab wann ist das Produkt auf der Plattform
product/minPriceInfo/ab Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/maxPriceInfo/max Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/featureAttribute1Eigenschaftswert für das Attribute aus Set.attributeTypeId1
product/featureAttribute2Eigenschaftswert für das Attribute aus Set.attributeTypeId2
product/featureAttribute3Eigenschaftswert für das Attribute aus Set.attributeTypeId3
product/featureAttribute4Eigenschaftswert für das Attribute aus Set.attributeTypeId4
product/featureAttribute5Eigenschaftswert für das Attribute aus Set.attributeTypeId5
product/productTypeBauart Eigenschaft
product/productLineProduktlinie
product/productModelProduktmodell

kurz (small.xml, small.json)

Dieses Format steht im Export zur Verfügung. API-Abruf erfolgt mit „small.xml“ oder „small.json“.

Neben Produktdaten enthält das Format den Produkttyp und den Hersteller.

FeldBeschreibung
product/puideindeutige Produkt-ID (ITscope Produkt-ID)
product/set/der Produkttyp, der das Produkt zugewiesen ist
product/man/der Hersteller des Produktes
product/rankallgemeiner ITscope Rank (eine hohe Zahl entspricht einem schlechten Ranking)
product/relevanceSuchtreffer Relevanz
product/qualificationQualifizierung des Produkts
product/eanEAN
product/manufacturerSKUHersteller Artikelnummer
product/shortInfoKurzbezeichner
product/productNameProduktname, Langbezeichner
product/deeplinkDeeplink auf die ITscope.com Plattform
product/recRetailPriceUVP des Herstellers
product/vatMehrwehrtsteuer
product/estimateGrossWeightGewicht
product/grossDimXLänge des Produkts
product/grossDimYHöhe des Produks
product/grossDimZBreite des Produkts
product/entryDateab wann ist das Produkt auf der Plattform
product/minPriceInfo/ab Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/maxPriceInfo/max Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/aggregatedStatusbester Verfügbarkeitsstatus
product/aggregatedStatusTextbester lesbarer Verfügbarkeitsstatus
product/aggregatedStockSumme aller Lagerbestände
product/aggregatedSupplierItemsSumme aller Distributoren zu diesem Produkt

PreisLagerUpdate (prices.xml, prices.json)

Dieses Format steht im Export zur Verfügung. API-Abruf erfolgt mit „prices.xml“ oder „prices.json“

Für jedes Produkt werden aggregierte Preis-/Lagerdaten, sowie für sämtliche Bezugsquellen die jeweiligen Preis- und Lagerdaten ausgegeben.

FeldBeschreibung
product/puideindeutige Produkt-ID (ITscope Produkt-ID)
product/eanEAN
product/manufacturerSKUHersteller Artikelnummer
product/minPriceInfo/ab Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/maxPriceInfo/max Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/aggregatedStatusbester Verfügbarkeitsstatus
product/aggregatedStatusTextbester lesbarer Verfügbarkeitsstatus
product/aggregatedStockSumme aller Lagerbestände
product/aggregatedSupplierItemsSumme aller Distributoren zu diesem Produkt
product/supplierItem/ein Element für jede Bezugsquelle
product/supplierItem/ideindeutiger Kennzeichner der Bezugsquelle
product/supplierItem/supplier/Daten zum Lieferanten
product/supplierItem/supplierItemIdArtikelnummer des Lieferanten
product/supplierItem/stockBestand in dieser Bezugsquelle
product/supplierItem/lastStockUpdateZeitpunkt der letzten Aktualisierung des Lagerbestandes
product/supplierItem/stockStatusKennung für Status des Lagerbestands (bezieht sich auf stockStatusText)
product/supplierItem/stockStatusTextlesbarer Lagerbestandsstatus
product/supplierItem/stockSourceIdKennung für die Herkunft der Preis und Bestandsinformation (bezieht sich auf stockSourceName)
product/supplierItem/stockSourceNamelesbarer Text zur Herkunft der Bestandsinformation (Lagerliste,…)
product/supplierItem/stockUnlimitedtrue=unbegrenzter Lagerbestand, false=nicht unbegrenzt
product/supplierItem/priceInfo/ein Element pro vorhandenem Preis, enthält die Preisinformationen (s. SupplierItemPriceInfo-Tabelle bei „CSV alle Daten 2 (zip)“)

Bezugsquellenliste inkl. PreisLagerUpdate (sources.xml, sources.json)

Dieses Format steht im Export zur Verfügung. API-Abruf erfolgt mit „sources.xml“ oder „sources.json“

Für jedes Produkt werden aggregierte Preis-/Lagerdaten, sowie sämtlicheBezugsquellendaten inklusive den jeweiligen Preis- und Lagerdaten ausgegeben.

FeldBeschreibung
product/puideindeutige Produkt-ID (ITscope Produkt-ID)
product/eanEAN
product/manufacturerSKUHersteller Artikelnummer
product/minPriceInfo/ab Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/maxPriceInfo/max Preis ProductPriceInfo, s. Tabelle in „CSV alle Daten 2 (zip)“
product/aggregatedStatusbester Verfügbarkeitsstatus
product/aggregatedStatusTextbester lesbarer Verfügbarkeitsstatus
product/aggregatedStockSumme aller Lagerbestände
product/aggregatedSupplierItemsSumme aller Distributoren zu diesem Produkt
product/supplierItem/ein Element für jede Bezugsquelle
Was this article helpful?
Dislike 0
Views: 216