Formatbeschreibung für Produkte Datenformat standard

Last modified: 19. Oktober 2021

Datenbankdiagramm

Abhängigkeitsdiagram beim csv Ausgabeformat, inklusive SQL Skripte zum Erzeugen der Tabellen und zum Laden der Daten mit load data local infile am Ende des Beitrags.


Übersicht der Datenformat-Elemente

Im csv Ausgabeformat sind diese Elemente Dateien, im xml oder json Ausgabeformat sind es Knoten. 

Das Datenformat Standard besteht aus folgenden Elementen:

  • product: – Produkt des ITscope-Katalogs.
  • supplierItem: – Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.
  • project: – Informationen, Preis und Verfügbarkeit eines Projektartikels
  • attribute: – Eigenschaften zu einem Produkt.
  • attributeCluster: – Eigenschaftscluster, in denen das Produkt für Merkmalssuchen gefunden werden kann. Kann je nach Menge mehrere Eigenschaftsausprägungen in Intervallen zusammenfassen, z.B. 64-128MB RAM
  • accessory: – Originalzubehör und kompatibles Zubehör zu einem Produkt
  • historicalDataItem: – Wöchentlich oder monatlich aggregierte historische Daten, abhängig vom gewünschten Zeitraum und Aggregation

Die mit einem Globus markierten Elemente ändern sich je nach gewählter Exportsprache:

Felder, die mit einem * gekennzeichnet wurden, sind neu hinzugekommen gegenüber der API 2.0, Felder mit ** wurden innerhalb der Datei nur an eine andere Stelle verschoben. Felder mit *** wurden umbenannt.

product

Produkt des ITscope-Katalogs.

NamePflichtfeldDatentypBeschreibung
puidJaLongEindeutiger Key
ean String (18)EAN
manufacturerSKU String (150)Herstellerartikelnummer [vor 18.10.2021 String(40)]
icecatId String (255)IceCat ID
cnetId String (255)CNET ID
bechlemId String (255)Bechlem ID
eClass String (255)eClass ID Version 5.1.2
eClassV7 * String (255)eClass ID Version 7.0
customsTariffNumber ** String (255)Zolltarifnummer
UNSPSC * String (14)UNSPSC Classification Code
manufacturerIdJaLongReferenz auf den Hersteller dieses Produktes (n:1 auf Manufacturer.id)
manufacturerName String (255)Name des Herstellers
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productName ***JaStringProduktbezeichner, per Default inklusive Herstellername, kann jedoch nur über den Export konfiguriert werden, so dass der Herstellername entfernt wird 
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png shortDescription Stringper Default Kurzbezeichner des Produktes, kann jedoch nur über den Export zusätzlich konfiguriert werden
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png longDescription StringLangtext des Produktes
productTypeIdJaLongReferenz auf den Produkttyp dieses Produktes
productTypeGroupIdJaString (3)Referenz auf Produkttyp-Gruppe (ProductTypeGroup.id, n:1)
productTypeGroupNameJaString (255)Name der Gruppe von Produkttypen, z.B. Netzwerktechnik. Kann als 1. Kategorieebene verwendet werden.
productTypeNameJaString (255)Bezeichner des Produkttyps. Kann als 2. Kategorieebene verwendet werden.
attributeTypeId1 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName1 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId2 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName2 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId3 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName3 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId4 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName4 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
attributeTypeId5 LongEindeutiger Attribut Key, um eine mögliche Unterkategorie aufzubauen, verweist 1:n auf AttributeCluster.attributeTypeId
attributeTypeName5 String (255)Bezeichner des Attributes, um eine mögliche Unterkategorie aufzubauen
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue1 String (1024)Eigenschaftswert für das Attribut aus ProductType.attributeTypeId1. Kann, falls vorhanden, als 3. Kategorieebene verwendet werden.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue2 String (1024)Eigenschaftswert für das Attribut aus ProductType.attributeTypeId2. Kann, falls vorhanden, als 4. Kategorieebene verwendet werden.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue3 String (1024)Eigenschaftswert für das Attribut aus ProductType.attributeTypeId3. Kann, falls vorhanden, als 5. Kategorieebene verwendet werden.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue4 String (1024)Eigenschaftswert für das Attribut aus ProductType.attributeTypeId4
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeValue5 String (1024)Eigenschaftswert für das Attribut aus ProductType.attributeTypeId5
productSubTypeId String (1024)ID der Bauart-Eigenschaft
productSubType String (1024)Bauart-Eigenschaft des Produktes, z.B. Maus oder Tastatur für Eingabegeräte. Sollte nicht als 3. Kategorieebene verwendet werden.
productLineId LongID der Produktlinie
productLine String (1024)Produktlinie
productModel String (1024)Produktmodellbezeichner
colorFamilyId * String (255)ID der Farbfamilie
colorFamily * String (255)Farbfamilie
estimateGrossWeight DoubleGewicht in Kilogramm
grossDimX String (1024)Länge des Produkts inklusive Maßeinheit
grossDimY String (1024)Höhe des Produks inklusive Maßeinheit
grossDimZ String (1024)Breite des Produkts inklusive Maßeinheit
combinedLengthAndGirth * String (36)Gurtmaß
netWeight * String (36)Nettogewicht
netDimX * String (36)Nettomaß X
netDimY * String (36)Nettomaß Y
netDimZ * String (36)Nettomaß Z
valueAddedTaxGermany * IntegerDeutscher Umsatzsteuersatz
deeplinkJaString (2048)Deeplink auf die ITscope.com Plattform
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png standardHtmlDatasheetJaString (2048)URL, Link auf HTML Standard-Datenblatt
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png standardPdfDatasheet String (2048)URL, Link auf PDF Standard-Datenblatt
manufacturerSite String (1024)URL, Link auf Herstellerseite
manufacturerDatasheet String (1024)URL, Link auf Herstellerdatenblatt
imageThumb String (1024)Vorschau des besten Produktbildes
imageThumbWidth IntegerBreite des Bild Mediums in Pixel
imageThumbHeight IntegerHöhe des Bild Mediums in Pixel
imageHighRes1 *** String (1024)Link auf bestmögliches Bild, in der größten Ausführung
imageWidth1 IntegerBreite des Bild Mediums in Pixel
imageHeight1 IntegerHöhe des Bild Mediums in Pixel
image2 String (1024)Link auf ein weiteres gutes Produktbild, bevorzugt das einer Produktverpackung (nie das gleiche wie das erste Bild)
imageWidth2 IntegerBreite des Bild Mediums in Pixel
imageHeight2 IntegerHöhe des Bild Mediums in Pixel
image3 String (1024)Link auf erstes Bild in der Galerie (niemals eines der bereits aufgeführten)
imageWidth3 IntegerBreite des Bild Mediums in Pixel
imageHeight3 IntegerHöhe des Bild Mediums in Pixel
image4 String (1024)Link auf zweites Bild in der Galerie (niemals eines der bereits aufgeführten)
imageWidth4 IntegerBreite des Bild Mediums in Pixel
imageHeight4 IntegerHöhe des Bild Mediums in Pixel
image5 String (1024)Link auf drittes Bild in der Galerie (niemals eines der bereits aufgeführten)
imageWidth5 IntegerBreite des Bild Mediums in Pixel
imageHeight5 IntegerHöhe des Bild Mediums in Pixel
energyLabel String (1024)Link auf das Energielabel Bild
energyEfficiencyClass * String (10)Energieeffizienzklasse
entryDateJaDateAb wann ist das Produkt auf der Plattform
rank IntegerAllgemeiner Beliebtheitsrang (Rang 1 bis n, eine hohe Zahl entspricht einem schlechten Ranking)
qualification IntegerQualifizierung des Produkts
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png warrantyText StringGarantietext des Produktes
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png marketingText StringMarketingtext für das Produkt
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png keySellingPoints * StringKey Selling Points
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png packageContents * StringLieferumfang
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productFeatures * StringProduktfeatures
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png htmlMainSpecs * StringTechnische Eigenschaften des Produktes in Kurzform, getrennt mit br-Tags
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png htmlSpecs StringTechnische Eigenschaften des Produktes, im HTML Format
recommendedRetailPriceNet DoubleUVP des Herstellers
price BigDecimalPreisbasis für den kalkulierten Preis
priceCalc BigDecimalKalkulierter Preis, auf Grundlage der individuellen Preiskalkulation
currencyCode String (3)Währungseinheit, die für diese Preisinformation gilt
priceCalcVat BigDecimalUmsatzsteuersatz, der zur Berechnung des kalkulierten Preises benutzt wurde
priceLastUpdate DateZeitpunkt der letzten Aktualisierungs der Preisinformation
priceSupplierId LongReferenz auf einen Lieferanten (1:1), der die Bezugsquelle mit dieser Preisinformation bereitgestellt hat
priceSupplierName String (255)Name des Lieferanten, der diese Bezugsquelle bereitgestellt hat
priceSupplierItemId LongReferenz auf eine Bezugsquelle (n:1); wenn dieses Feld null ist, dann bezieht sich die Preisinformation auf ein Produkt (Bezugsquellenrefernz und Produktrefernz schließen sich gegenseitig aus)
priceSupplierSKU String (150)Produktbezeichner des Lieferanten, der diese Bezugsquelle bereitgestellt hat [vor 18.10.2021 String(40)]
stockSupplierText String (40)Textuelle Bestandsinformation des Lieferanten, direkt übernommen, ohne Interpretation
stockStatus IntegerNumerischer Schlüssel des Lieferstatus dieser Bestandsinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockStatusText String (255)Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“
stock IntegerBestandsmenge des in dieser Struktur angegebenen Lieferstatus
externalStock IntegerIm Außenlager befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
incomingStock IntegerIm Zulauf befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
stockAvailabilityDate DateLiefertermin für nicht auf Lager befindliche Ware
stockLastUpdate DateZeitpunkt der letzten Aktualisierung der Bestandsinformation
aggregatedStatus IntegerBester Verfügbarkeitsstatus
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png aggregatedStatusText String (255)Bester Verfügbarkeitsstatus
aggregatedStock IntegerSumme aller Lagerbestände
aggregatedSupplierItems IntegerSumme aller Distributoren zu diesem Produkt
contractTypeId * IntegerDie Id des Vertragstyps bei Lizenz- , Service, CTO und Ersatzteilprodukten
contractTypeName * String (255)Der Name des Vertragstyps bei Lizenz- , Service, CTO und Ersatzteilprodukten
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png supplierItem List<supplierItem>Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attribute List<attribute>Eigenschaften zu einem Produkt.
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeCluster List<attributeCluster>Eigenschaftscluster, in denen das Produkt für Merkmalssuchen gefunden werden kann. Kann je nach Menge mehrere Eigenschaftsausprägungen in Intervallen zusammenfassen, z.B. 64-128MB RAM
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png accessory List<accessory>Originalzubehör und kompatibles Zubehör zu einem Produkt

supplierItem

Bezugsquelle eines ITscope-Produkts. Ein konkretes Angebot eines auf ITscope gelisteten Distributors.

NamePflichtfeldDatentypBeschreibung
idJaLongEindeutiger Key
ean String (18)EAN-Angabe des Lieferanten
manufacturerSKU String (150)Hersteller-Artikelnummer-Angabe des Lieferanten (muss nicht mit ITscope übereinstimmen) [vor 18.10.2021 String(40)]
supplierSKU String (150)Produktnummer des Lieferanten [vor 18.10.2021 String(40)]
supplierIdJaLongVerweist 1:1 auf Supplier.id
supplierName String (255)Name des Lieferanten
manufacturerName String (80)Herstellername wie beim Lieferant angegeben
productName String (255)Genauer Bezeichner des Artikels, wie vom Lieferanten übermittelt
longDescription String (60000)Erweiterte Artikelbeschreibung des Lieferanten
conditionIdJaIntegerNumerischer Code des Zustand des Artikels
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png conditionNameJaString (255)Zustand des Artikels (neu, gebraucht, B-Ware, Refurbished, usw.)
eolProductJaBooleanKennung: Auslaufartikel
matchQualityJaIntegerZuordnungsqualität des Artikels zum ITscope-Produktkatalog
eanValidJaBooleanFlag, ob die EAN des Lieferanten valide nach den EAN-Kriterien ist
specialOfferJaBooleanFlag, ob Artikel Sonderangebot ist
promotion String (40)Name der Promo-Aktion des Lieferanten
vat IntegerMwSt-Satz für den Artikel
copyrightLevy DoubleUrheberrechtsabgabe
customsTariffNumber String (50)Zolltarifnummer
countryOfOrigin String (20)Ursprungsland des Artikels
grossDimX DoubleLÄnge des Produkts inklusive Maßeinheit
grossDimY DoubleHöhe des Produks inklusive Maßeinheit
grossDimZ DoubleBreite des Produkts inklusive Maßeinheit
warrantyText String (40)Garantieangaben des Lieferanten
deeplink String (1024)Link zum Artikel beim Lieferanten
recommendedRetailPriceNet DoubleUVP-Angabe des Lieferanten
priceJaBigDecimalPreis
priceCalcJaBigDecimalKalkulierter Preis, auf Grundlage der individuellen Preiskalkulation
currencyCodeJaString (3)Währungseinheit, die für diese Preisinformation gilt
priceCalcVatJaBigDecimalUmsatzsteuersatz, der zur Berechnung des kalkulierten Preises benutzt wurde
priceLastUpdateJaDateZeitpunkt der letzten Aktualisierungs der Preisinformation
stockSupplierText StringBestandsinformation zur Bezugsquelle, wie vom Lieferanten übermittelt
stockStatus IntegerNumerischer Schlüssel des Lieferstatus dieser Bestandsinformation
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png stockStatusText String (255)Lieferstatus dieser Bestandsinformation, z.B. „auf Lager“ oder „im Außenlager“
stock IntegerBestandsmenge
externalStock IntegerIm Außenlager befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
incomingStock IntegerIm Zulauf befindliche Bestandsmenge (Zusatzinformation einiger Lieferanten in Strukturen des Lieferstatus „auf Lager“)
stockAvailabilityDate DateLiefertermin für nicht auf Lager befindliche Ware
lastStockUpdate DateZeitpunkt der letzten Aktualisierung der Bestandsinformation
contractTypeId * IntegerDie Id des Vertragstyps bei Lizenz- , Service, CTO und Ersatzteilprodukten
contractTypeName * String (20)Der Name des Vertragstyps bei Lizenz- , Service, CTO und Ersatzteilprodukten

project

Informationen, Preis und Verfügbarkeit eines Projektartikels

NamePflichtfeldDatentypBeschreibung
supplierProjectId String (40)Projektnummer des Lieferanten
manufacturerProjectIdJaString (40)Projektnummer des Herstellers (eindeutiger Key)
projectName String (255)Projektbezeichnung
endCustomer String (255)Endkunde des Projektartikels
priceJaBigDecimalProjektpreis
validFrom DateDatum, ab dem die Projektkonditionen gelten
validTo DateDatum, ab dem die Projektkonditionen ungültig werden
targetQuantity IntegerVereinbarte Menge im Projektrahmen
remainingQuantityJaIntegerVerbleibendes Kontingent
minQuantity IntegerMindestbestellmenge für dieses Projekt
projectLastUpdate DateZeitpunkt der letzten Aktualisierung der Projektinformationen

attribute

Eigenschaften zu einem Produkt.

NamePflichtfeldDatentypBeschreibung
value * String (1024)Der Basiswert (siehe auch Basiseinheit) der Eigenschaft, bei Text als Textbaustein, bei Zahlen als kleinste Angabe
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png displayValue String (1024)Der lesbare Wert der Eigenschaft, inklusive Einheit
attributeTypeId LongEindeutige Kennung eines konkreten Eigenschafttyps
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeName String (255)Name des konkreten Eigenschafttyps
attributeTypeRank LongRanking des Eigenschafttyps, kann z.B. zur Sortierung verwendet werden
attributeTypeGroupId LongKennung einer Eigenschaftsgruppe, kein Tabellenverweis, sondern identifiziert attributeTypeGroupName eindeutig
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeGroupName String (255)Name der Eigenschaftsgruppe

attributeCluster

Eigenschaftscluster, in denen das Produkt für Merkmalssuchen gefunden werden kann. Kann je nach Menge mehrere Eigenschaftsausprägungen in Intervallen zusammenfassen, z.B. 64-128MB RAM

NamePflichtfeldDatentypBeschreibung
id LongEindeutiger ITscope Key
productTypeId LongReferenz auf den Produkttyp, optional
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png productTypeName String (255)Name des Produkttyps, zu dem diese Eigenschaftsausprägung gehört, optional
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeName String (255)Name einer Eigenschaft. Kann analog dem Namen aus ProductType.attributeTypeName(1..5) sein
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png attributeTypeGroupName String (255)Name einer Eigenschaftsgruppe
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png name String (255)Bezeichner der Ausprägung (z.B. 2 GB, 15″, 80 W – 120 W)
rank LongRang der Eigenschaft

accessory

Originalzubehör und kompatibles Zubehör zu einem Produkt

NamePflichtfeldDatentypBeschreibung
referencedProductId LongReferenz auf ein Bezugsprodukt, z.B. ein Produkt das als Originalzubehör geführt wird
typeId IntegerInterne Kennung für die Art des Bezugsproduktes
Dieses Bild hat ein leeres Alt-Attribut. Der Dateiname ist globus-1.png type String (255)Bezeichner für die Art des Bezugsproduktes, z.B. Original-Zubehör, Kompatibles Zubehör, usw.

historicalDataItem

Wöchentlich oder monatlich aggregierte historische Daten, abhängig vom gewünschten Zeitraum und Aggregation

NamePflichtfeldDatentypBeschreibung
date StringStartdatum der Woche oder Monat abhängig von der gewünschten Aggregation
priceMin BigDecimalPreis Minimum innerhalb eines entsprechenden Zeitraums
priceMax BigDecimalPreis Maximum innerhalb eines entsprechenden Zeitraums
priceMedian BigDecimalPreis Median innerhalb eines entsprechenden Zeitraums
priceMedianInStock BigDecimalPreis Median für lagernde Artikel innerhalb eines entsprechenden Zeitraums
priceAvg BigDecimalPreis Durchschnitt innerhalb eines entsprechenden Zeitraums
priceAvgInStock BigDecimalPreis Durchschnitt für lagernde Artikel innerhalb eines entsprechenden Zeitraums
supplierCount IntegerAnzahl der Lieferanten innerhalb eines entsprechenden Zeitraums
supplierCountInStock IntegerAnzahl der Lieferanten mit Lagerbestand innerhalb eines entsprechenden Zeitraums
stockSum IntegerSumme der Lagerartikel innerhalb eines entsprechenden Zeitraums
salesTrend IntegerVerkaufstendenz innerhalb eines entsprechenden Zeitraums

Datenbank Skripte für CSV

Was this article helpful?
Dislike 0
Views: 748